How sanjanagadamsetty/placement-communication-readiness-platform works
This repository combines a student-facing placement-readiness platform with a TypeScript API and a Python AI service. The main documented journey is: students enter the portal, complete voice interview or listening practice, and review readiness feedback; staff portals manage cohorts and mentor-verified checklists. The API also implements assessment sessions, evaluation, credits, and eligibility, while the AI service provides agent and learning endpoints. Some links reflect README descriptions or source-index references rather than inspected implementation; those limits are noted by omitting uncertain connections.
Main entry points: App.tsx App Router · main.py AI Service API · database.ts Platform Database · sessions.routes.ts Assessment Sessions
Components 23
Student and Staff UI
- App Router
frontend/src/App.tsx - App State
frontend/src/context/AppContext.tsx - Student Dashboard
frontend/src/components/student/StudentDashboard.tsx - Mock Interview
frontend/src/components/student/MockInterviewRoom.tsx - Listening Room
frontend/src/components/student/ListeningRoom.tsx - Diagnostic Report
frontend/src/components/student/DiagnosticReportView.tsx - Staff Portals
frontend/src/components/portals - Frontend API Client
frontend/src/services/api.ts
Platform API
- Authentication
backend/src/middleware/authenticate.ts - Assessment Sessions
backend/src/modules/sessions/sessions.routes.ts - Responses and Scoring
backend/src/modules/responses/responses.routes.ts - Mentor Checklist
backend/src/modules/checklist/checklist.routes.ts - Placement Eligibility
backend/src/modules/placement/eligibility.service.ts - Credits
backend/src/modules/credits/credits.service.ts - Question Bank
backend/src/modules/question-bank/question-bank.routes.ts
AI Service
- AI Service API
ai-service/app/main.py - Agent Endpoints
ai-service/app/routers/agent.py - Learning Endpoints
ai-service/app/routers/learning.py - LLM Client
ai-service/app/services/llm_client.py - Agent Runner
ai-service/app/agents/agent_runner.py - Agent Job Queue
ai-service/app/workers/queue.py
Platform Services
- Platform Database
backend/src/config/database.ts
Other components
- Candidate
Connections 28
- Candidate → App Router: uses portal
README.md - App Router → App State: provides context
frontend/src/App.tsx - App Router → Student Dashboard: routes to
frontend/src/App.tsx - App Router → Mock Interview: routes to
frontend/src/App.tsx - App Router → Listening Room: routes to
frontend/src/App.tsx - App Router → Diagnostic Report: routes to
frontend/src/App.tsx - App Router → Staff Portals: routes to
frontend/src/App.tsx - Student Dashboard → Mock Interview: starts practice
- Student Dashboard → Listening Room: starts practice
- Mock Interview → Diagnostic Report: reviews results
- App State → Frontend API Client: calls
frontend/src/context/AppContext.tsx - Candidate → Assessment Sessions: starts assessment
README.md - Assessment Sessions → Authentication: authenticates with
backend/src/modules/sessions/sessions.routes.ts - Assessment Sessions → Platform Database: reads and writes
backend/src/modules/sessions/sessions.routes.ts - Assessment Sessions → Responses and Scoring: aggregates evaluations
backend/src/modules/sessions/sessions.routes.ts - Responses and Scoring → Platform Database: reads and writes
backend/src/modules/responses/responses.routes.ts - Responses and Scoring → Question Bank: uses questions
- Mentor Checklist → Placement Eligibility: checks eligibility
backend/src/modules/checklist/checklist.routes.ts - Mentor Checklist → Platform Database: reads and writes
backend/src/modules/checklist/checklist.routes.ts - Placement Eligibility → Platform Database: queries
backend/src/modules/placement/eligibility.service.ts - Credits → Platform Database: reads and writes
backend/src/modules/credits/credits.service.ts - Question Bank → Platform Database: reads and writes
backend/src/modules/question-bank/question-bank.routes.ts - AI Service API → Agent Endpoints: registers router
ai-service/app/main.py - AI Service API → Learning Endpoints: registers router
ai-service/app/main.py - AI Service API → LLM Client: initializes
ai-service/app/main.py - AI Service API → Agent Runner: recovers runs
ai-service/app/main.py - AI Service API → Agent Job Queue: checks queue
ai-service/app/main.py - Agent Runner → LLM Client: requests completions