Local Dev Setup

:::info Source Sourced from services/assessment-service/LOCAL_DEV_SETUP.md in the documentation repo. :::

1. Prerequisites

Node 20, pnpm 9, Docker 24.

2. Quick Start

cd services/assessment-service
cp .env.example .env.local
pnpm install
docker compose -f docker-compose.dev.yml up -d
pnpm db:migrate
pnpm seed
pnpm dev            # :3050
pnpm dev:worker

3. Dependencies

Service	Port
postgres	5432
redis	6379
nats	4222
ai-gateway-mock	3020
localstack (KMS)	4566

4. Environment

PORT=3050
DATABASE_URL=postgres://assessment:assessment@localhost:5432/assessment
REDIS_URL=redis://localhost:6379/50
NATS_URL=nats://localhost:4222
NATS_STREAM=ASSESSMENT
AI_GATEWAY_URL=http://localhost:3020
KMS_ENDPOINT=http://localhost:4566
RUBRIC_AI_CONFIDENCE_THRESHOLD=0.85
SCORING_TIMEOUT_MS=30000

5. Seed

• 3 quiz banks (simple MCQ, multi-select, text-response).
• 1 branching scenario (5-level depth).
• 5 sample attempts in various outcome states.

6. Commands

pnpm dev
pnpm test
pnpm test:integration
pnpm test:ai:grading
pnpm test:branching:dag
pnpm quiz:serve <quizBankId> <attemptId>
pnpm rubric:grade <responseId>

7. Debugging

• pnpm quiz:inspect <id> dumps quiz bank + answer key (dev only).
• pnpm scenario:graph <id> renders scenario DAG.