Assignment Submission Statement

sequenceDiagram
    participant B as Browser
    participant C as SubmissionController
    participant R as SubmitForGradingRequest
    participant S as SubmissionService
    participant SR as StatementResolver
    participant AR as AdminConfigRepository
    participant DB as MySQL (config_plugins)
    participant SR2 as SubmissionRepository
    participant E as Event Dispatcher
    participant M as ForwardEventToMoodle

    B->>C: POST /assignments/{id}/submission/submit
{accepted_statement: true}
    C->>R: Validate input
    R-->>C: SubmitForGradingDTO
    C->>S: submitForGrading(dto)

    S->>S: loadAuthorizedAssignment()
    Note over S: Checks enrolment, visibility,
access restrictions, team guard

    S->>SR: isRequired(assignment)
    SR->>AR: assignSettings()
    AR->>DB: SELECT name, value
FROM config_plugins
WHERE plugin='assign'
    DB-->>AR: Collection
    AR-->>SR: name-value map
    SR->>SR: resolve(): pick variant key
(single/team/team-all)
    SR-->>S: true (flag=1 AND text non-empty)

    alt Statement required AND not accepted
        S-->>C: throw StatementRequiredException
        C-->>B: 422 {code: 4010}
    end

    S->>S: guardWriteAllowed()
    Note over S: Cutoff date + lock check

    S->>SR2: findCurrent() + setStatus(submitted)
    SR2->>DB: UPDATE assign_submission SET status='submitted'

    S->>E: dispatch(AssignmentSubmittedForGrading)
    E->>M: Queue: forward to Moodle plugin

    S->>E: dispatch(AssignmentStatementAccepted)
    E->>M: Queue: forward statement_accepted

    S-->>C: MoodleAssignSubmission
    C-->>B: 200 {data: {...}}
      

flowchart TD
    A([POST /submission/submit
or POST /submission]) --> B{Which endpoint?}
    B -->|submit-for-grading| C[Load assignment + auth guard]
    B -->|save-draft| D[Load assignment + auth guard]

    C --> E{statementResolver
.isRequired?}
    D --> F{submissiondrafts = 0?}

    F -->|Yes: save == submit| G{statementResolver
.isRequired?}
    F -->|No: normal draft| H[Save plugin payloads]
    H --> I[Set status = draft]
    I --> J[Dispatch DraftSaved events]
    J --> Z([200 OK])

    G -->|Yes| G2{accepted_statement?}
    G2 -->|No| REJECT([422 / 4010
STATEMENT_REQUIRED])
    G2 -->|Yes| H2[Save plugin payloads]
    H2 --> I2[Set status = submitted]
    I2 --> J2[Dispatch SubmittedForGrading]
    J2 --> K2[Dispatch StatementAccepted]
    K2 --> Z

    G -->|No: waived| H2

    E -->|Yes| E2{accepted_statement?}
    E2 -->|No| REJECT
    E2 -->|Yes| L[guardWriteAllowed]

    E -->|No: waived/off| L

    L --> M{Cutoff passed?}
    M -->|Yes| CUTOFF([403 Cutoff])
    M -->|No| N{Locked?}
    N -->|Yes| LOCKED([403 Locked])
    N -->|No| O[Set status = submitted]
    O --> P[Dispatch SubmittedForGrading]
    P --> Q{Statement accepted?}
    Q -->|Yes| R[Dispatch StatementAccepted]
    R --> Z
    Q -->|No| Z

    style REJECT fill:#7f1d1d,stroke:#ef4444,color:#fca5a5
    style CUTOFF fill:#7f1d1d,stroke:#ef4444,color:#fca5a5
    style LOCKED fill:#7f1d1d,stroke:#ef4444,color:#fca5a5
    style Z fill:#064e3b,stroke:#10b981,color:#6ee7b7