Codex 5.3 Refactor Note: Canonical refactor plan: docs/CODEX-5.3-REFACTOR-PLAN.md. This document is retained for historical and implementation context during the refactor.

System Flow

Access & Onboarding

flowchart TD
  A[User opens system] --> B[Login]
  B -->|Forgot Password| FP[Forgot Password]
  B -->|Request Access| RA[Request Access]
  RA -->|Submit| AR[(AccessRequest: PENDING)]
  AR --> N1[Notify Admin/HR]
  N1 --> ADM[Admin reviews]
  ADM -->|Approve| U[(User Created + Role Assigned)]
  ADM -->|Reject| RJ[(Request Rejected)]
  U --> E1[Send setup/reset email]
  E1 --> B

Candidate Workflow

flowchart TD
  HRD[HR Dashboard] --> UPL[Upload Resume]
  UPL --> C0[(Candidate: NEW + Resume)]
  C0 --> HR7[HR Screening]
  HR7 -->|Complete| C1[(HR_SCREENED)]
  C1 -->|Assign Manager| C2[(MANAGER_EVAL_PENDING)]
  C2 --> NM[Notify Manager]
  NM --> M8[Manager Review]
  M8 -->|Submit| C3[(MANAGER_REVIEWED)]
  C3 -->|Escalate| C4[(TO_SMO)]
  C4 --> NS[Notify SMO]
  NS --> S10[SMO Decision]
  S10 -->|Approve| CA[(APPROVED)]
  S10 -->|Reject| CR[(REJECTED)]
  S10 -->|KIV| CK[(KIV)]
  CA --> BCAST[Internal Broadcast: Company-All]
  CR --> BCAST
  CK --> BCAST

Audit & Notifications Outbox

flowchart LR
  ACTION[User Action] --> AUD[(Audit Log Append)]
  ACTION --> EVT[(Domain Event)]
  EVT --> OUT[(Outbox)]
  OUT --> DELIV[(Outbox Log)]
  DELIV --> INAPP[In-app Notification]
  DELIV --> EMAIL[Email via Resend]