This is to allow teams to request change to games and allow for an approval workflow.
Requirements
Teams can propose new dates/times/surfaces for any of their games
If allowed, leagues could disable this
Depending on configuration, the required parties (other team, league, association) will be notified and required to accept the change
This is configured on a per-schedule basis, using the office settings as a default
Once all required parties have accepted the proposed change, the game is automatically rescheduled and everyone is notified (as normal)
Future (Out of scope)
OMAHA won’t use this because they require games to fill out a form and pay a fee, so we’ll need transactions to convince them to use this (or a report?)
UX
Add a Reschedule button on the game page, if the game is allowed to be rescheduled.
This will pop up a modal to select the new time and surface. This can be toggled between a form or calendar
A comment may be provided. This would be included on the DraftGameApproval
If the game has any DraftGames, an alert is shown on the game page to show a game change is proposed
This can be expanded to show the status of each required party (DraftGameApproval)
Clicking on Accept/Decline will open a modal to confirm and attach an optional note
🚩 What if the user is both the league admin and team official and approval is required of both?
Models
Reschedule requests are stored as DraftGames, similar to producing a schedule. The API will automatically create DraftGameApprovals based on settings to determine who’s required to accept the change.
Office/ScheduleSettings
To configure who is required to approve game changes
Property | Type | Description |
---|---|---|
requests enabled | boolean | Determine if the feature is enabled |
team required | boolean | |
league required | boolean | |
associations required | boolean |
DraftGameApproval
To track required approvals
Property | Type | Description |
---|---|---|
draftId | uuid | Link to the DraftGameId |
targetType | string | Office/Team |
targetId | id | |
status | string | Pending | Accepted | Declined |
comment | string | Optional notes to append with the response |
Implementation
Settings control which required parties require approval. Typical office defaults to schedule settings
Requesting a change produces a DraftGame and automatically produces DraftGameApprovals based on the office settings
When a DraftGameApproval is changed to Accepted, check if all others are accepted. If so, update the game
The DraftGame modal mentioned in UX would also apply to games produced by leagues through the draft flow. This modal should only be visible for:
required parties to be approved
users with access to draft games (leagues, associations)