From 4393b7303f6cd5b7c698b253d520ab0bfb42b44d Mon Sep 17 00:00:00 2001 From: Hardik Date: Mon, 22 Jun 2026 15:59:18 +0530 Subject: [PATCH] =?UTF-8?q?docs(crewing):=20split=20Phase=202=20=E2=80=94?= =?UTF-8?q?=20Epic=20A=20now;=20Epic=20K=20sign-off/experience=20=E2=86=92?= =?UTF-8?q?=20Phase=204?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Phase 2 ships Epic A (Requisitions + relief) plus the shared autoRaiseRequisition backfill helper. The sign-off/experience portion of Epic K is moved to Phase 4 because it transitions an assignment (→ SIGNED_OFF) and writes an EXPERIENCE_RECORD, which depend on the onboarding (Phase 3) and assignment (Phase 4) schema. Updates §12 build order (items 2 & 4 + a status note) and the §5.3 sign-off note. --- Crewing-Implementation-Spec.md | 19 ++++++++++++++++--- 1 file changed, 16 insertions(+), 3 deletions(-) diff --git a/Crewing-Implementation-Spec.md b/Crewing-Implementation-Spec.md index dfacfd1..b30a079 100644 --- a/Crewing-Implementation-Spec.md +++ b/Crewing-Implementation-Spec.md @@ -155,7 +155,10 @@ assignment `ON_LEAVE`). On approval the assignment machine checks rank cover ove the window; if it would drop **below the rank’s required strength**, it **auto-raises** `Requisition(OPEN, reason=LEAVE, autoRaised)` and notifies the office. **Sign-off** appends an `EXPERIENCE_RECORD` and auto-raises a backfill -requisition; the person returns to **Candidates** as an **ex-hand**. +requisition; the person returns to **Candidates** as an **ex-hand**. *(Phasing: +the auto-raised backfill requisition ships in **Phase 2** via the shared +`autoRaiseRequisition` helper; sign-off itself + the `EXPERIENCE_RECORD` ship in +**Phase 4** with the assignment lifecycle — see §12.)* ### 5.4 Appraisal & wage - **Appraisal:** `DRAFT → SUBMITTED →(MPO) MPO_VERIFIED →(Manager) MANAGER_APPROVED`; returns to `REJECTED`/`DRAFT` with remarks. @@ -394,10 +397,20 @@ with these reconciliations: --- ## 12. Build order + +> **Implementation status (reconciled 2026-06-22):** Phase 1 ✅ shipped. Phase 2 +> ✅ ships **Epic A (Requisitions + relief)** plus the shared auto-backfill helper +> (`autoRaiseRequisition`). The **sign-off/experience portion of Epic K has been +> moved to Phase 4** — sign-off transitions an *assignment* (`→ SIGNED_OFF`) and +> writes an `EXPERIENCE_RECORD`, neither of which exists until onboarding (D, +> Phase 3) and the assignment lifecycle (Phase 4) land. The auto-raised backfill +> requisition it relies on is already built in Phase 2, so Epic K is purely +> additive when it arrives. + 1. **Foundations** — `SITE_STAFF` role; crewing schema + enums; permissions; `CREWING_ENABLED` flag; nav scaffold; reference data (Ranks, RankDocRequirements). -2. **Requisitions + sign-off/experience** (Epics A, K) — incl. auto-backfill. +2. **Requisitions + relief** (Epic A) — requisition lifecycle, relief requests, and the shared `autoRaiseRequisition` backfill helper. *(Epic K sign-off/experience originally sat here; moved to Phase 4 — see status note above, as it depends on the onboarding/assignment schema.)* 3. **Candidate intake + 7-stage pipeline + onboarding** (B, C, D) — incl. salary→Manager approval, explicit waiver. -4. **Crew records, PPE, leave/attendance** (E, F, G) — leave→Manager, MPO no attendance, clash auto-req + relief requests. +4. **Crew records, PPE, leave/attendance + sign-off/experience** (E, F, G, **K**) — leave→Manager, MPO no attendance, clash auto-req + relief requests; **sign-off** transitions the assignment to `SIGNED_OFF`, appends an `EXPERIENCE_RECORD`, and auto-raises a backfill requisition (reusing the Phase-2 `autoRaiseRequisition` helper); the person returns to **Candidates** as an ex-hand. 5. **Verification + appraisal** (I, H). 6. **Payroll (Pay-status tab + Approvals "Wage"), dashboards, notifications** (J, M).