How darshani8/reep- works
REEP is a college placement-readiness platform for students, faculty, alumni, and the placement office. Users sign in through the Angular app, which routes role- and capability-scoped screens to the FastAPI API; the API applies domain logic and persists platform data in PostgreSQL. Major capabilities include student records and resumes, administration and governance, mock interviews, and optional AI assistance. The README and excerpts establish the main boundaries; unsampled domain internals and some runtime wiring are represented only where documented.
Main entry points: main.py FastAPI application · app.ts Web application · admin.py Placement administration · orchestrator.py AI assistant
Components 19
Angular user experience
- Web application
apps/web/src/app/app.ts - Role-based screens
apps/web/src/app/app.routes.ts - Session client
apps/web/src/app/core/auth.service.ts - Resume builder
apps/web/src/app/features/student/resume/resume-builder.service.ts
API and domain
- FastAPI application
apps/api-py/app/main.py - Authentication
apps/api-py/app/routers/auth.py - Student services
apps/api-py/app/routers/student.py - Placement administration
apps/api-py/app/routers/admin.py - Staff governance
apps/api-py/app/routers/governance.py - Identity and access
apps/api-py/app/identity.py
Interview and AI
- Interview experience
apps/web/src/app/core/interview.service.ts - Interview services
apps/api-py/app/interview_core.py - AI assistant
apps/api-py/app/ai/orchestrator.py - LLM adapter
apps/api-py/app/ai/llm.py - Voice platform
apps/api-py/app/voice_platform/engine/nova.py
Persistence and operations
- PostgreSQL
apps/api-py/app/db.py - Domain models
apps/api-py/app/models - Observability
apps/api-py/app/observability.py
Other components
- Platform users
Connections 21
- Platform users → Web application: use
- Web application → Role-based screens: routes through
apps/web/src/app/app.routes.ts - Role-based screens → Session client: guards access
apps/web/src/app/app.routes.ts - Session client → Authentication: calls auth endpoints
apps/web/src/app/core/auth.service.ts - Web application → FastAPI application: calls over HTTP
- FastAPI application → Authentication: mounts router
apps/api-py/app/main.py - FastAPI application → Student services: mounts router
apps/api-py/app/main.py - FastAPI application → Placement administration: mounts router
apps/api-py/app/main.py - FastAPI application → Staff governance: mounts router
apps/api-py/app/main.py - Placement administration → Staff governance: uses governance
apps/api-py/app/routers/admin.py - Authentication → Identity and access: uses identity
apps/api-py/app/routers/auth.py - Student services → PostgreSQL: accesses data
- Placement administration → PostgreSQL: accesses data
apps/api-py/app/routers/admin.py - PostgreSQL → Domain models: maps records
apps/api-py/app/db.py - Platform users → Resume builder: builds resumes
- Platform users → Interview experience: starts mock interview
- Interview experience → Interview services: uses API
- Platform users → AI assistant: chats
- AI assistant → LLM adapter: delegates completion
apps/api-py/app/ai/orchestrator.py - AI assistant → Voice platform: optional voice
- FastAPI application → Observability: configures
apps/api-py/app/main.py