How ashwikha/communication-readiness-platform works
LatchUp is a communication-readiness and learning platform: students use role-specific portals to complete mock interviews, listening activities, and assessments, while staff manage programs, placements, and student progress. The backend handles sessions, evaluation, credits, and placement workflows; a Python AI service provides interview and learning endpoints plus agent-based capabilities. The source index supports several module relationships, but the README is empty and many product areas were not excerpted, so unverified links are omitted.
Main entry points: App.tsx Application shell · main.py AI API · llmEvaluationService.ts Streaming AI evaluation · index.ts Backend API
Components 32
User experience
- Application shell
frontend/src/App.tsx - App state
frontend/src/context/AppContext.tsx - Frontend API client
frontend/src/services/api.ts - 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 reports
frontend/src/components/student/DiagnosticReportView.tsx - Department administration
frontend/src/components/portals/DepartmentAdminPortal.tsx - Platform administration
frontend/src/components/portals/PlatformOwnerPortal.tsx - Super administration
frontend/src/components/portals/SuperAdminPortal.tsx - Class management
frontend/src/components/common/DepartmentClassesManager.tsx
Platform workflows
- Backend API
backend/src/index.ts - Route registry
backend/src/routes/index.ts - Interview sessions
backend/src/modules/sessions/sessions.routes.ts - Assessment attempts
backend/src/modules/attempts/attempts.routes.ts - Response evaluation
backend/src/modules/responses/responses.routes.ts - Placement eligibility
backend/src/modules/placement/eligibility.service.ts - Credit management
backend/src/modules/credits/credits.service.ts - Learning routes
backend/src/routes/learning.routes.ts - Streaming AI evaluation
backend/src/services/llmEvaluationService.ts - Domain events
backend/src/shared/events/events.ts
AI services
- AI API
ai-service/app/main.py - Interview endpoints
ai-service/app/routers/interview.py - AI learning endpoints
ai-service/app/routers/learning.py - Agent endpoints
ai-service/app/routers/agent.py - Agent runner
ai-service/app/agents/agent_runner.py - LLM client
ai-service/app/services/llm_client.py
State and persistence
- Agent run repository
ai-service/app/repositories/agent_repository.py - Shared PostgreSQL
ai-service/app/database/connection.py - Backend cache
backend/src/services/cacheService.ts - Redis cache
ai-service/app/cache/cache_service.py
Other components
- Students and staff
Connections 29
- Students and staff → Application shell: uses
- Application shell → App state: provides state
frontend/src/App.tsx - Application shell → Student dashboard: routes to
frontend/src/App.tsx - Application shell → Mock interview: routes to
frontend/src/App.tsx - Application shell → Listening room: routes to
frontend/src/App.tsx - Application shell → Diagnostic reports: routes to
frontend/src/App.tsx - Application shell → Department administration: routes to
frontend/src/App.tsx - Application shell → Platform administration: routes to
frontend/src/App.tsx - Application shell → Super administration: routes to
frontend/src/App.tsx - App state → Frontend API client: calls
frontend/src/context/AppContext.tsx - Department administration → Class management: manages
- Backend API → Route registry: registers
- Interview sessions → Streaming AI evaluation: uses evaluation
backend/src/modules/sessions/sessions.routes.ts - Response evaluation → Streaming AI evaluation: evaluates responses
- Streaming AI evaluation → AI API: posts evaluation
backend/src/services/llmEvaluationService.ts - Assessment attempts → Credit management: uses credits
backend/src/modules/attempts/attempts.routes.ts - Interview sessions → Domain events: publishes or reads
backend/src/modules/sessions/sessions.routes.ts - Placement eligibility → Credit management: checks eligibility
- Learning routes → AI API: requests AI
- AI API → Interview endpoints: mounts
ai-service/app/main.py - AI API → AI learning endpoints: mounts
ai-service/app/main.py - AI API → Agent endpoints: mounts
ai-service/app/main.py - Agent endpoints → Agent runner: calls
ai-service/app/routers/agent.py - Agent runner → Agent run repository: persists runs
ai-service/app/agents/agent_runner.py - Agent run repository → Shared PostgreSQL: queries
ai-service/app/repositories/agent_repository.py - Interview endpoints → LLM client: uses
ai-service/app/routers/interview.py - AI learning endpoints → LLM client: uses
- Backend API → Backend cache: uses cache
- AI API → Redis cache: initializes
ai-service/app/main.py