OfferReview Agent Context

Use this file as the first context checkpoint for any AI session in this repository.

Project Identity

• Project name: OfferReview
• Primary repo path (this machine): /srv/apps/offerreview/prod
• Parent workspace path: /srv/apps/offerreview
• 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/PROJECT_CONTEXT_FULL.md (full operational context)
3. docs/CODEX-5.3-REFACTOR-PLAN.md (active refactor plan)
4. README.md (quick setup and script reference)

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.