Handover workspace

ERS, Todo, OfferReview, and Docu in one view

Imported from live server docs, code structure, and deployment notes.

May 31, 2026, 11:17 AM

OfferReview

OfferReview Agent Context

Use this file as the first context checkpoint for any AI session in this repository. It is the short bootstrap only; the current high-signal state lives in `docs/PROJECT_CONTEXT.md`.

AGENTS.md

Updated Apr 26, 2026, 8:01 AM

OfferReview Agent Context

Use this file as the first context checkpoint for any AI session in this repository. It is the short bootstrap only; the current high-signal state lives in docs/PROJECT_CONTEXT.md.

Project Identity

  • Project name: OfferReview
  • Primary repo path (this machine): /srv/apps/offerreview/prod
  • Parent workspace path: /srv/apps/offerreview
  • Workspace sibling trees: /srv/apps/offerreview/prod_hotfix_manager, /srv/apps/offerreview/prod_deploy_smo_hotfix
  • Production server path: /var/www/offerreview
  • Default branch: main

Stack and Runtime

  • Next.js 16 (App Router) + React 19 + TypeScript
  • Prisma ORM + PostgreSQL
  • Node.js 20.x
  • PM2 process in production: offerreview

Canonical Docs (Read in this order)

  1. docs/PROJECT_CONTEXT.md (high-signal summary)
  2. docs/ROLE-FLOW-CHECK-2026-04-26.md (current role-flow audit)
  3. docs/PROJECT_CONTEXT_FULL.md (full operational context)
  4. docs/CODEX-5.3-REFACTOR-PLAN.md (active refactor plan)
  5. README.md (quick setup and script reference)
  6. Week-by-week W*.md docs only when a task needs historical implementation detail

Current Repo Snapshot (2026-04-26)

  • Current prod HEAD: 4b9615c (feat: ground resume extraction and add evidence-based skills)
  • prod is the primary working tree, but it currently has local in-progress changes. Check git status --short before editing.
  • Recent shipped slices:
    • 4b9615c resume extraction grounded to resume evidence plus evidence-based skills UI
    • 0f793ba SMO analytics compare workflow and richer SMO interview flow
    • b70b127 employer-context enrichment via OpenAI web search
  • Active local work is now concentrated in candidate deep-dive workflows, manager-review magic-link access, job-description analysis, candidate detail tabs, dashboard/settings polish, and supporting Prisma schema changes.
  • prod_hotfix_manager also has local changes. prod_deploy_smo_hotfix is currently the clean sibling tree.
  • Primary context source for future sessions is docs/PROJECT_CONTEXT.md; update that file and docs/PROJECT_CONTEXT_FULL.md whenever the local workstream meaningfully changes.

Daily Commands

  • Install deps: npm install
  • Dev server: npm run dev
  • Build: npm run build
  • Start (prod mode): npm run start
  • Prisma generate: npx prisma generate
  • Prisma migrate deploy: npx prisma migrate deploy

Environment Expectations

  • Local env file: .env.local
  • Production env file: .env
  • Critical vars: DATABASE_URL, JWT_SECRET
  • Email vars: RESEND_API_KEY, RESEND_FROM_EMAIL (or RESEND_FROM)

Operational Guardrails

  • Do not commit secrets from .env*.
  • Keep Prisma datasource on PostgreSQL unless there is an explicit migration plan.
  • For deployment/troubleshooting, prefer commands and notes in docs/PROJECT_CONTEXT.md.
  • Historical W*.md files are retained as delivery history; treat the docs in docs/ plus this file as the living canonical set.