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.

OfferReview

OfferReview is a Next.js + Prisma workflow application for HR, Manager, and SMO candidate review and decisioning.

Stack

• Next.js 16 (App Router)
• React 19
• Prisma + PostgreSQL
• TypeScript

Repository Layout

• Primary working tree: prod
• Sibling trees: prod_hotfix_manager, prod_deploy_smo_hotfix
• Canonical context docs live in docs/PROJECT_CONTEXT.md and docs/PROJECT_CONTEXT_FULL.md

Local Setup

1. Install dependencies: npm install
2. Configure env in .env.local
3. Run migrations: npx prisma migrate dev
4. Seed data (optional): npx prisma db seed
5. Start dev server: npm run dev

App URL: http://localhost:3000

Build and Run

• Production build: npm run build
• Start server: npm run start
• Lint: npm run lint

Key Docs

• Agent context (AI bootstrap): AGENTS.md
• Role flow audit: docs/ROLE-FLOW-CHECK-2026-04-26.md
• Refactor plan: docs/CODEX-5.3-REFACTOR-PLAN.md
• Docs index: docs/00-index.md
• Project context: docs/PROJECT_CONTEXT.md
• Full context: docs/PROJECT_CONTEXT_FULL.md

Refactor Direction

Current active refactor track is documented in docs/CODEX-5.3-REFACTOR-PLAN.md.
All legacy week-by-week docs are kept as historical references until consolidation is complete.

Current Local Context

As of 2026-04-26:

• latest shipped main work includes evidence-based resume skills, grounded resume extraction, employer-context enrichment, SMO compare analytics, and a richer SMO interview workflow
• active local work is centered on candidate deep-dive questionnaires, manager-review magic-link access, required job descriptions for positions, and broader candidate/dashboard/settings cleanup
• start with docs/PROJECT_CONTEXT.md, then docs/ROLE-FLOW-CHECK-2026-04-26.md, before making changes

Current Workflow Notes

• Primary candidate path is now NEW -> HR_SCREENED -> MANAGER_EVAL_PENDING -> MANAGER_REVIEWED or CANDIDATE_DEEP_DIVE_PENDING -> TO_SMO -> APPROVED/REJECTED/KIV.
• CANDIDATE_DEEP_DIVE_PENDING is active in the schema and current worktree.
• Manager review assignment now generates a long-lived manager magic link at /manager-review/[token].
• Candidate deep-dive questionnaires are served through /candidate-deep-dive/[token] and the responses are SMO-only in the candidate detail UI.
• Evaluation AI prefill remains disabled; HR/manager evaluation forms should still be treated as manual-entry flows.