T6F SC-STUDENT Approved Product Contract¶
| Field | Value |
|---|---|
| Approver | Requesting user via current conversation (Kesiswaan / SC-STUDENT production enable) |
| Date | 2026-08-31 |
| Scope | SC-STUDENT / W15 / PKG-STUDENT-W15 only |
| Status | APPROVED_BY_REQUESTING_USER_CONVERSATION |
| Core V1 impact | None |
| Production authority | Exact demo candidate → UAT → GBN code promote, then separate SCOLA_CERTIFIED_ADDON_SKUS delta for SC-STUDENT |
Bound platform decisions: DEC-001, DEC-003, DEC-005, DEC-007, DEC-009, STAB-002, STAB-024.
1. Package boundary¶
- SKU: SC-STUDENT /
PKG-STUDENT-W15 - Workflow: W15 — Counseling case lifecycle (report → review → respond → resolve → close)
- Installer:
scola_bundle_student_services→scola_counseling,scola_student_activity,scola_rules - Prerequisites: W00 PASS; W02 student master for reporter FK
- Overlay
GT-OVL-SC-STUDENT: peer optional SKUs off for cert profile - Extracurricular/permit/incident breadth: out of scope (RT-PKG-GAP-09 deferred)
2. Case lifecycle (authoritative)¶
Counseling report states:
draft → in_review → in_progress → resolved → closed
Allowed transitions (fail closed otherwise):
| Action | From | To | Actor |
|---|---|---|---|
start_review |
draft |
in_review |
counselor / discipline manage |
start_progress |
in_review |
in_progress |
counselor / discipline manage |
resolve |
in_progress |
resolved |
counselor / discipline manage |
close |
resolved |
closed |
counselor / discipline manage (requires outcome) |
Forbidden: direct state write via save; cross-company student FK; view-only mutation.
3. Portal read scope¶
- Student/parent portal list/detail/responses only for own/linked children
- No domain manage routes without counselor group or
discipline.violations.manage
4. Responses¶
- Counselor creates response linked to in-scope report
- Response list scoped by report company
5. Idempotency and recovery (DEC-005)¶
- Repeat workflow action on terminal state → explicit
invalid_state - Detail/list stable after disconnect (no partial orphan)
6. Roles and capabilities (DEC-003)¶
| Action | Authority |
|---|---|
| Domain list/detail | counselor group OR discipline.counseling.view |
| Domain save/response/action | counselor group OR counseling manager OR discipline.violations.manage |
| Portal list/detail | student self / linked parent |
Feature flag: surfaces require scola_student_services effective (entitled ∩ certified ∩ installed).
7. Downstream effects (XMD)¶
- No automatic points/attendance/notification side effects in this W15 certificate
- Referral save allowed but not required for PASS path
8. Evidence¶
- Harness:
scripts/golden/w15_runtime_certify.py - 11 cases
RT-W15-*×2 consecutive PASS (QG-17) - Evidence dir:
execution/T6F-evidence/
9. Production enable¶
After code promote: add SC-STUDENT to SCOLA_CERTIFIED_ADDON_SKUS (separate step from promote script default).