Extract infractions from the rulebook so they can be extended on for suspensions and customizations.

Requirements

• Scoresheet entry needs to be able to pull a list of infractions applicable to the branch

  • Currently outside of a game page (e.g., play profile) this isn’t exactly a simple as everything else as the rulebook is in the way

• Suspensions and sanctioning rules need to be able to reference infractions to target accumulation rules

  • Currently penalties are not using infraction ids, so forced to target based on code

• SQL-based reports need to be able to determine infraction names properly

  • Currently using initcap based on the infraction code to show infraction names and i18n is not possible

• Branches need to be able to customize infraction options and extend the HC rulebook

  • Currently should be possible, but hasn’t been tested in practice

  • QC requires an automatic Major when a Match is assessed (similar to Major+GM)

• Branches may need to be able to override how codes are displayed for each infraction (TBD)

  • Currently not supported

• Specific types of infractions need to be able to trigger other infractions (ejections) based on accumulation

  • Currently possible

  • Ice hockey requires ejection after 3x stick infraction or 3x head contact

  • Ball hockey requires ejection after 3x any penalty

• Scoresheet needs to be able to understand how infractions are grouped to keep editing accurate

  • When deleting a major penalty, the game misconduct should be deleted with it

  • This isn’t well solved below yet

Existing

Currently infractions exists within the rulebook only, and penalties reference infraction codes instead of ids. This makes it difficult to reference infractions in other contexts, especially providing a list of possible infractions.

        {
            "id": "head-contact",
            "name": "Head Contact",
            "choices": [
                {
                    "id": "712a9d97-dc28-4f44-a9bc-f65f464243d2",
                    "durations": [
                        {
                            "id": "3b660054-13da-4a10-baae-3726b2b1d5b8",
                            "code": "7.6(a)",
                            "durationId": "minor"
                        }
                    ]
                },
                {
                    "id": "45bd6df7-85cd-4ab3-a1f3-dd19ca403772",
                    "durations": [
                        {
                            "id": "fc33dd8e-25ca-473b-ab0c-a88d30f109b6",
                            "code": "7.6(a)",
                            "durationId": "minor"
                        },
                        {
                            "id": "41a36d01-a5f1-4041-af78-105b177b9ff5",
                            "code": "7.6(a)",
                            "durationId": "minor"
                        }
                    ]
                },
                {
                    "id": "b81cffef-c35d-4a34-9fab-10f259a922d1",
                    "durations": [
                        {
                            "id": "f056be20-062c-4495-b36c-71a4290f5de2",
                            "code": "7.6(b)",
                            "durationId": "major"
                        },
                        {
                            "id": "00db3d81-87aa-4b71-b63c-44d61fb2e2cf",
                            "code": "7.6(e)",
                            "durationId": "game-misconduct"
                        }
                    ]
                },
                {
                    "id": "8f13e831-9718-44f9-b3b1-5d9e4979ef30",
                    "durations": [
                        {
                            "id": "177df463-3903-42b1-8b69-35970b1bab67",
                            "code": "7.6(c)",
                            "durationId": "match"
                        }
                    ]
                }
            ],
            "category": "07 Physical Fouls"
        },

Infraction Models

Extracting the nested infractions of the rulebook into separate tables for simpler relations and querying.

Bit of a challenge coming up for the names of each part. Infractions have a Duration and belong to Rules which belong to Categories. Infractions are grouped as Options to require Major+GM or Double Minors to be selected together.

InfractionDuration

Minor, Major, Match, Misconduct, Game Misconduct

InfractionCategory

07 Physical Fouls

InfractionRule

Head Contact

Infraction

7.6(b) - Head Contact - Minor

Infraction Option Models

Options define how infractions are used by each office and what the scorekeeper can select.

The part that combines double minors or majors and game misconducts as one and results in a time offset.

This is very important when editing so you can make sure that double minors are deleted together or the GM is deleted together with the Major.

Also fun, HQ doesn’t combine majors and game misconducts, so this definitely needs to be configurable by branch.

InfractionOption

This is a container that represents the options the scorekeeper can select.

InfractionOptionMember

These are the effective infractions upon selecting the option. Order is significant and allows for sequencing penalties as consecutive (e.g., major = 0, GM = 1) or parallel (same order) for start times

Infraction Accumulation Models

When creating a penalty, we need to check for accumulation rules to stack an additional infraction.

Typical examples are 3x Stick Infraction → Game Ejection or 2x Misconduct → Game Ejection.

InfractionAccumulation

This acts as a grouping that defines the count of the member infractions necessary and what the resulting infraction is.

InfractionAccumulationMember

These are the list of infractions that are part of the accumulation group. Order is not significant; any member infraction counts towards the accumulation group.

So for stick infractions, receiving 9.1 (a), 9.2 (a) and 9.3 (a) would result in a game ejection upon receiving 9.3 (a).

Penalty Models

GamePenalty

Instances of an infraction in a game are called penalties. This is a scoresheet artifact.

Penalties are consisted linked if they have the same participantId, gameTime and optionId or have an accumulationId that matches.

Implementation

Scoresheets are effectively versioned by season. This is limited to 2024-25 and beyond seasons; 2023-24 and past seasons would maintain legacy rulebook support. Must maintain the same behaviour for past seasons (2018 - 2023), but new seasons would use the new models.

The /meta API should return all applicable infraction, infraction option and accumulation entities.