Local setup

Prerequisites

• Node.js 20+ (docs-site engines)
• PostgreSQL
• Backend on 4000, frontend on 3000, docs on 3001

Backend

cd backend
cp .env.example .env
npm install
npx prisma generate
npx prisma migrate deploy   # or migrate dev
npm run db:seed
npm run db:seed-rbac
npm run dev

Frontend

cd frontend
cp .env.example .env.local
# NEXT_PUBLIC_API_URL=http://localhost:4000/api/v1
npm install
npm run dev

Docs site

cd docs-site
npm install
npx playwright install chromium   # once — Mermaid SSR
npm start                         # http://localhost:3001

Optional: REALCREDI_APP_URL=https://your-app.example when building docs against a deployed app.

Seed users

After db:seed + db:seed-rbac:

Email	Password	Role
admin@realcredi.com	admin123	SUPER_ADMIN
instructor@realcredi.com	instructor123	INSTRUCTOR
student@realcredi.com	student123	STUDENT
corporate@realcredi.com	corporate123	CORPORATE

No seeded EMPLOYER — register at /auth/register/employer.

MVP demo script

1. Admin → tracks at /admin/career/tracks.
2. Instructor → coach setup until match ready.
3. Student → intake → evidence → publish /u/{slug}.
4. Employer → org → invoice → admin marks paid → search → intro.
5. Confirm /credentials/{code} vs /verify.