shad0w/pelagia-portal
1
0
Fork 0
Code Issues 11 Pull requests 2 Projects Releases 2 Packages Wiki Activity Actions

docs(crewing): split Phase 2 — Epic A now; Epic K sign-off/experience → Phase 4 

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.
Hardik 2026-06-22 15:59:18 +05:30
parent bafb12cede
commit 4393b7303f
1 changed files with 16 additions and 3 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

19
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).