CODEBASE MAP — Quick Understanding

PROJECT STRUCTURE:
/src — application code (1,200 lines)
/tests — unit + integration tests (600 lines)
/lib — shared utilities and helpers
/config — environment and settings
/docs — setup and architecture notes

KEY ENTRY POINTS:
Main: src/index.ts (initializes app, loads config)
API: src/server.ts (Express routes, port 3000)
Worker: src/jobs/processor.ts (background task queue)

DEPENDENCIES (top 5):
Express 4.18 — HTTP server and routing
PostgreSQL 13 — persistence layer
BullMQ — job queue for async work
TypeScript 5 — type safety
Jest — testing framework

CORE MODULES:
1. Authentication (src/auth/) — JWT tokens, session management
2. Data models (src/models/) — User, Task, Project entities
3. API handlers (src/routes/) — REST endpoints
4. Job queue (src/jobs/) — async notification, reporting tasks
5. Middleware (src/middleware/) — logging, error handling, auth guards

DATA FLOW:
Client request → Express route → auth middleware → business logic → database query → response

COMPILE & RUN:
npm run dev (localhost:3000)
npm test (Jest suite)
npm run build (production bundle)

KEY FILES TO READ FIRST:
1. src/index.ts (2 min read)
2. src/server.ts (3 min read)
3. src/models/ overview (5 min read)
4. docs/ARCHITECTURE.md (10 min read)

ESTIMATED ONBOARDING TIME: 20-30 minutes to production readiness