First slice of Phase 4 (stacked on 3c onboarding). The Crew directory and tabbed crew profile with documents, bank/EPF (role-masked), next of kin, PPE and experience, per Crewing-Implementation-Spec §8.7–8.8. Behind NEXT_PUBLIC_CREWING_ENABLED; production unchanged. What's in - Schema (crewing_crew_records migration): SeafarerDocument, NextOfKin (isEmergency), ExperienceRecord, PpeIssue (PpeItem enum) — all on CrewMember; CrewActionType += DOCUMENT_UPLOADED/RECORD_UPDATED/PPE_ISSUED/PPE_RETURNED/ EXPERIENCE_ADDED. - PII masking (lib/crew-pii.ts, §6/§8.8): bank account + Aadhaar full only for Accounts/SuperUser, masked otherwise; salary hidden from site staff. Applied server-side before crossing to the client. - Actions (crewing/crew/actions.ts): uploadDocument/deleteDocument, saveBankEpf, addNextOfKin/deleteNextOfKin, issuePpe/returnPpe, addExperience — guarded by upload_crew_records / issue_ppe, each writes a CrewAction. - Screens: /crewing/crew (directory, search + vessel filter, ex-hands excluded) and /crewing/crew/[id] (tabbed profile: Documents · Bank & EPF · Next of kin · PPE · Experience · Pay status). Crew added to the flag-gated nav (MGR/MPO/Site/ Accounts). Tests & docs - Unit: crew-pii.test.ts (6). Integration: crew-records.test.ts (7) — documents, bank/EPF upsert, NoK, PPE issue/return, experience + permission gating. type-check clean; full unit (240) + integration (175) green. - CLAUDE.md updated with the Phase 4a surface. Deferred: site-staff own-site scoping (needs a User↔Site link); the records verify queue (§8.11, Phase 5); Pay-status shows the salary structure only until payroll (Phase 6). Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
28 lines
1.1 KiB
TypeScript
28 lines
1.1 KiB
TypeScript
import type { Role } from "@prisma/client";
|
|
|
|
// PII visibility rules for the crew profile (Crewing-Implementation-Spec §6/§8.8).
|
|
// Bank account / EPF identity numbers are full only for Accounts (and SuperUser);
|
|
// masked for everyone else. Salary is hidden from site staff (office-only).
|
|
|
|
export function canViewFullBankEpf(role: Role): boolean {
|
|
return role === "ACCOUNTS" || role === "SUPERUSER";
|
|
}
|
|
|
|
export function canViewSalary(role: Role): boolean {
|
|
// Office roles see salary; site staff see status only (§6, R7).
|
|
return role !== "SITE_STAFF";
|
|
}
|
|
|
|
// "•••• 4471" — keep only the last `visible` chars; null/short values render "—".
|
|
export function maskTail(value: string | null | undefined, visible = 4): string {
|
|
if (!value) return "—";
|
|
const v = value.trim();
|
|
if (v.length <= visible) return "••••";
|
|
return `•••• ${v.slice(-visible)}`;
|
|
}
|
|
|
|
// Show the value in full only when allowed, else mask it.
|
|
export function bankEpfValue(value: string | null | undefined, role: Role): string {
|
|
if (!value) return "—";
|
|
return canViewFullBankEpf(role) ? value : maskTail(value);
|
|
}
|