docs(crewing): rewrite design-page bodies to the reconciled model
Bring the Crewing design pages in line with Crewing-Implementation-Spec
(no longer just banners): leave is Manager-approved (MPO removed from
leave and the planner); interview waiver is an explicit Manager-approved
action with no auto path; only MPO/Manager raise requisitions (site staff
request relief cover, new RELIEF_REQUEST model + ReliefRequestStatus); the
Application pipeline is the 7-stage board (competency & references merged,
docs before salary, JOINING folded into onboard); SalaryStructure is
effective-dated (mid-assignment changes prorate); victualing is a separate
wage line; verify_site_records drops leave.
Updates state/sequence diagrams, the ER model + enums, the permission
matrix, the use-case diagram/catalogue, and the user-story backlog. Each
page's banner is reduced to a plain pointer to the spec.
docs(crewing): add reconciled Implementation Spec; link under Planned
Reconcile the Crewing wiki design pages with the design handoff prototype,
using the Crewing CHANGELOG as tiebreaker, into one authoritative
Crewing-Implementation-Spec page: reconciliation decisions (R1-R11),
director Q&A folded in, how it slots into PPMS, codebase changes, the
final roles/permission + nav matrices, domain/state-machine deltas, a
detailed role-aware screen spec, modals, user-story reconciliations,
cross-cutting concerns, build order and open questions.
Key reconciled rulings: leave is Manager-approved (not MPO); interview
waiver is an explicit Manager-approved action (never auto for ex-hands);
only MPO/Manager raise requisitions (site staff request relief cover);
7-stage pipeline; MPO has no attendance access; effective-dated salary.
Add an authoritative-spec banner to each Crewing design page and link the
spec from the Module hub, Planned Features and the sidebar.
- Leave is applied by the Site in-charge on behalf of crew (crew are not
portal users), not self-service.
- Attendance is visible to site staff + Manager only; the MPO has no
attendance access. Drop MPO from record_attendance and (consequently)
generate_wage_report; add a view_attendance permission.
- A leave clash (approved leaves overlapping below a rank's required
strength) auto-raises a LEAVE requisition; documented across module,
design decisions, data model, workflows (new sequence), use cases,
user stories, roles matrix and the architecture diagram.