...
Property | Type | Description | |
---|---|---|---|
id | uuid | ||
sanctionId | id | ||
offense | number | 1, 2, 3… | |
Behaviour | |||
durationType | enum | Definite or Indefinite | |
games | number | Total games required to serve | |
lastMinutesGames | number | Optional - Total games required to serve when end of game or overtime (will hardcode to last 10 minutes for now) (undefined → fall back to totalGames) | |
injuryGames | number | Optional - Total games required to serve when penalty has an injury (undefined → fall back to totalGames) | |
days | number | Optional - Number of days to calculate the expiry date | |
lastMinutesDays | number | Optional - Number of days to calculate the expiry date in the last 10 minutes | |
injuryDays | number | Optional - Number of days to calculate the expiry date when penalty has an injury | |
Accumulation | |||
| enum[] | Optional - Applicable to players or bench staff | |
| Default to 1 | ||
|
|
| |
|
|
| |
|
|
|
Settings Models
OfficeBreak (V2)
Required to define breaks when calculating the suspension expiry date for the season. Could also be used for the scheduler.
...
Property | Type | Description |
---|---|---|
lastMinutesDuration (V2) | number | Number of minutes before the end of the game when Hockey Canada defines this as 10 minutes; QC defines this as 5 minutes |
suspensionActivation | enum |
...
Property | Type | Description |
---|---|---|
id | uuid | |
gameId | id | Game the suspension originated in |
participantId | id | Participant that was suspended |
teamId | id | Team that the participant is suspended in |
penaltyId | id | Penalty that resulted in the suspension |
positionGroup | enum | Position that this participant was suspended in. Player, Staff |
sanctionId | id | Sanction that was determined by the rulebook sanction rules |
|
|
|
durationType | enum | Definite or Indefinite. This is required to be the same as the sanction duration |
requiredGames | number | Number of games required to complete the suspension. Optional when Indefinite duration type, but may be set with it |
expiry | date | Optional - Date when the suspension will expire if the games requirement isn’t met |
status | enum | Pending, Appealed, Active, Completed, Cancelled, Expired |
externalId | uuid | For syncing with Spordle ID |
Legacy suspension options (deprecated) | ||
| enum | Deprecated, replaced by sanctionId |
Suspension Discipline
Property | Type | Description |
---|---|---|
id | uuid | |
suspensionId | id | Suspension |
additionalGames | number |
Number of additional games to the suspension | ||
durationType | enum | Definite or Indefinite. To allow infinite duration |
status | enum | Pending | Active | Inactive |
comments | string | Comment section to allow the discipline committee to note changes |
reviewedBy | string array | Array of members that reviewed the suspension |
...
reviewedAt |
Unhardcoding
Status | ||||
---|---|---|---|---|
|
Handle indefinite and expiry dates
Jira Legacy server System Jira serverId 03e16d48-9e59-3010-89f5-a1a3500d66b7 key SPR-646
Replace code with sanctions
Jira Legacy server System Jira serverId 03e16d48-9e59-3010-89f5-a1a3500d66b7 key SPR-985
Accumulation
Status | ||||
---|---|---|---|---|
|
Jira Legacy | ||||||
---|---|---|---|---|---|---|
|
...
When the game is completed (or certified, depending on settings), get all sanctions for the schedule office
...
Find matching sanctions based on the sanction members that match the penalties
...
Find all past penalties and suspensions of all suspend-able players in the same season
In soccer, limit both to same office
...
Determine the sanction(s) based on the accumulation rules
Sanctions with higher priority cancel out lower priority sanctions
All sanctions are added unless there is an exclusive sanction
...
Suspension length will be defined as games or lastMinutesGames with injuryGames has additional games.
endGames is only applicable when the penalty is in the last 10 minutes (per office settings)
injuryGames is only applicable when the penalty is marked as injured
...
timestamp | The date / time when goes from Pending to Active or Inactive |
EffectiveSuspension (View)
Exact same properties as the Suspension + the ones bellow. When fetching suspensions (GET /suspensions) it will return the effective suspensions. On save (POST / PATCH /suspensions), it persists to the Suspension table.
Property | Type | Description |
---|---|---|
effectiveRequiredGames | number | requiredGames (Suspension) + additionalGames (SuspensionDiscipline) = effectiveRequiredGames
|
effectiveDurationType | enum | durationType (SuspensionDiscipline), if none → durationType (Suspension) |
disciplineAdditionalGames | additionalGames (SuspensionDiscipline) | |
disciplineDurationType | enum | durationType (SuspensionDiscipline) Definite or Indefinite. To allow infinite duration |
disciplineStatus | enum | status (SuspensionDiscipline) |
...
Implementation
New Scopes
Scope | Access | Implementation |
---|---|---|
| Can access the suspension show page or lists | Suspension model: allow Any role that currently contains |
| Can edit suspensions | Suspension model: allow Any role that currently contains |
| Can see the suspension discipline card on a suspension | Suspension: allow SuspensionDiscipline: |
| Can edit the suspension discipline on a suspension | Suspension: allow SuspensionDiscipline: |
| Has access to create a SuspensionDiscipline on a Suspension in pending status (custom endpoint) | Custom endpoint on SuspensionDiscipline model: |
Unhardcoding
Status | ||||
---|---|---|---|---|
|
Handle indefinite and expiry dates
Jira Legacy server System Jira serverId 03e16d48-9e59-3010-89f5-a1a3500d66b7 key SPR-
646
Replace code with sanctions
Jira Legacy server System Jira serverId 03e16d48-9e59-3010-89f5-a1a3500d66b7 key SPR-
985
...
Accumulation
Status | ||||
---|---|---|---|---|
|
...
As a league administrator, I want to be able to go into a suspension and increase the required number of games. I also want to see a list of all the suspensions that required discipline committee actions.
...
Jira Legacy | ||||||
---|---|---|---|---|---|---|
|
...
SuspensionDiscipline Model
Jira Legacy | ||||||
---|---|---|---|---|---|---|
|
Migration to add table
Add new model to API (one-to-one relation with Suspension)
Need to be able to do an include SuspensionDiscipline when fetching a suspension
Add scope scoresheets:discipline
...
|
When the game is completed (or certified, depending on settings), get all sanctions for the schedule office
Find matching sanctions based on the sanction members that match the penalties
Find all past penalties and suspensions of all suspend-able players in the same season
In soccer, limit both to same office
Determine the sanction(s) based on the accumulation rules
Sanctions with higher priority cancel out lower priority sanctions
All sanctions are added unless there is an exclusive sanction
Suspension length will be defined as games or lastMinutesGames with injuryGames has additional games.
endGames is only applicable when the penalty is in the last 10 minutes (per office settings)
injuryGames is only applicable when the penalty is marked as injured
When creating the suspension, send a notification to the player, team officials and office admins (except player, will be based on notification setting)
Jira Legacy server System Jira serverId 03e16d48-9e59-3010-89f5-a1a3500d66b7 key SPR-1345 When purging sum
requiredGames
andadditionalGames
If required games is indefinite count as zero when summing
If no required games is indefinite and there aren’t any additionalGames → indefinite suspension
Card to display and edit discipline committee information
1285 Add ability to deactivate suspensions
Jira Legacy server System Jira serverId 03e16d48-9e59-3010-89f5-a1a3500d66b7 key SPR-1336
Discipline Committee
Status | ||||
---|---|---|---|---|
|
Jira Legacy | ||||||
---|---|---|---|---|---|---|
|
...
Add requireDisciplineCommittee on sanction offense
On create of a suspension off a sanction, if requireDisciplineCommittee is true, create a suspension discipline record with a pending status.
Lineup Status
Status | ||||
---|---|---|---|---|
|
Get all Active suspensions for each player
Status colour Green title COMPLETE In soccer, exclude suspensions for other offices
Status colour Green title COMPLETE
If the suspension is for another team, it cannot be purged
Status colour Green title COMPLETE
Assigning
Status | ||||
---|---|---|---|---|
|
If an official has any active suspension, they should be flagged as Suspended
Status | ||||
---|---|---|---|---|
|
...
|
As a league administrator, I want to be able to go into a suspension and increase the required number of games. I also want to see a list of all the suspensions that required discipline committee actions.
SuspensionDiscipline Model
Jira Legacy server System Jira serverId 03e16d48-9e59-3010-89f5-a1a3500d66b7 key SPR-1279 Migration to add table
Add new model to API (one-to-one relation with Suspension)
Add scopes:
suspensions:view
,suspensions:manage
,discipline:view
,discipline:manage
,discipline:trigger
All roles that have
scoresheets:view
should now also havesuspensions:view
All roles that have
scoresheets:manage
should now also havesuspensions:manage
Change the current suspension model to have
suspensions:view
/suspensions:manage
instead ofscoresheets:view
/scoresheets:manage
New
SuspensionDiscipline
table should havediscipline:view
,discipline:manage
anddiscipline:trigger
scopes.
EffectiveSuspension (View)
655Jira Legacy server System Jira serverId 03e16d48-9e59-3010-89f5-a1a3500d66b7 key SPR-
Completion
Status | ||||
---|---|---|---|---|
|
If the suspension type is Indefinite, the suspension can never automatically be completed
Status colour Green title COMPLETE1348 EffectiveSuspension to get suspension total games to purge
https://spordle.atlassian.net/wiki/spaces/SPR/pages/edit-v2/2952200206#EffectiveSuspension-(View)
Adjust purging logic to account for SuspensionDiscipline
Jira Legacy server System Jira serverId 03e16d48-9e59-3010-89f5-a1a3500d66b7 key SPR-1345 Where ever we show the total number of games in the UI (ex. when purging, use effectiveRequiredGames and effectiveDurationType)
In backend, use effectiveRequiredGames and effectiveDurationType for purging logic
Metabase reports → use EffectiveSuspension → effectiveRequiredGames
646Jira Legacy server System Jira serverId 03e16d48-9e59-3010-89f5-a1a3500d66b7 key SPR- If there is an expiry date, the suspension is considered Expired once that date passes if it is not yet completed based on the required games
This will require a task to run at midnight daily (based on the timezone of the office)Status colour Green title COMPLETE Status colour Green title COMPLETE1349 Card to display and edit discipline committee information
Jira Legacy server System Jira serverId 03e16d48-9e59-3010-89f5-a1a3500d66b7 key SPR-1346 Add new card for Discipline Suspension (should only be viewable by
suspensions:discipline
scope rolesAdd the following fields on the suspension grid:
Original required games (can be indefinite)
Discipline additional games (can be indefinite)
Effective required games (can be indefinite)
Required Discipline Committee option on Sanction Offense
646Jira Legacy server System Jira serverId 03e16d48-9e59-3010-89f5-a1a3500d66b7 key SPR- A suspension completes once the suspension has the required amount of purges that are completed games
Status colour Green title COMPLETE
Syncing
Status | ||||
---|---|---|---|---|
|
Will need a two-way sync with ID
Jira Legacy 1344 Add requireDisciplineCommittee on sanction offense
On create of a suspension off a sanction, if requireDisciplineCommittee is true, create a suspension discipline record with a pending status.
Notifications for requireDisciplineCommittee suspensions
664Jira Legacy server System Jira serverId 03e16d48-9e59-3010-89f5-a1a3500d66b7 key SPR- This will remove the need to query suspensions in member validation
1350 Will be part of the suspension email we currently send
View for
suspensions:{}
scope roles to see list of Pending SuspensionDiscipline records. Potentially a Suspension Tab / List.Jira Legacy server System Jira serverId 03e16d48-9e59-3010-89f5-a1a3500d66b7 key SPR-1351 Have ability to filter on
Pending
suspension discipline forsuspensions:discipline
scope
If suspension discipline goes from
Pending
toActive
and Suspension isCompleted
. Move suspension fromCompleted
back toActive
. (to revise, edge case)
Lineup Status
Status | ||||
---|---|---|---|---|
|
Get all Active suspensions for each player
Status colour Green title COMPLETE In soccer, exclude suspensions for other offices
Status colour Green title COMPLETE
If the suspension is for another team, it cannot be purged
Status colour Green title COMPLETE
Assigning
Status | ||||
---|---|---|---|---|
|
If an official has any active suspension, they should be flagged as Suspended
Status colour Green title COMPLETE Jira Legacy server System Jira serverId 03e16d48-9e59-3010-89f5-a1a3500d66b7 key SPR-655
Completion
Status | ||||
---|---|---|---|---|
|
If the suspension type is Indefinite, the suspension can never automatically be completed
Status colour Green title COMPLETE Jira Legacy server System Jira serverId 03e16d48-9e59-3010-89f5-a1a3500d66b7 key SPR-646
If there is an expiry date, the suspension is considered Expired once that date passes if it is not yet completed based on the required games
Status colour Green title COMPLETE This will require a task to run at midnight daily (based on the timezone of the office)
Status colour Green title COMPLETE Jira Legacy server System Jira serverId 03e16d48-9e59-3010-89f5-a1a3500d66b7 key SPR-646
A suspension completes once the suspension has the required amount of purges that are completed games
Status colour Green title COMPLETE
Syncing
Status | ||||
---|---|---|---|---|
|
Will need a two-way sync with ID
Jira Legacy server System Jira serverId 03e16d48-9e59-3010-89f5-a1a3500d66b7 key SPR-664
This will remove the need to query suspensions in member validation
Additional notes JP
Once the new module will be completed, this will replace the Game Incident Report and the suspension module inside HCR,. We need to plan a sync process from Play to ID before we go live with that module.
The notification process to fill out the form is important. The people that are part of the discipline committee need a notification to let them know they have to fill or review a form. This will replace the actual distribution list in HCR. In an office in ID multiple person can be attached to the discipline committee notification and it’s hierarchical, so we need to build the same concept in Spordle Play
Multiple incident in the same game needs to be added to the same report.
Extra incident can be added manually ( not linked to a on ice infraction)
The pdf report is not mandatory to be sent by email , but needs to be available inside play. Notification can be enough