How rammelz-v2/vocalink-web works
VocaLink’s web application is the teacher-facing console for classroom sessions: teachers sign in, review student activity, manage students, broadcast speech or text, and inspect live-caption/session logs. The React app routes these workflows through page components and polling hooks to a FastAPI service; authentication is handled separately through the auth context. The README also documents a student mobile app and backend capabilities such as AAC prediction and Whisper transcription, but their implementations are outside this repository. Edges reflect the excerpts, source-index references, or documented relationships; unsampled features are not expanded into unsupported code paths.
Main entry points: App.tsx App routing · api.ts API client · Broadcast.tsx Broadcast page · AuthContext.tsx Auth context
Components 21
Teacher web app
- App routing
src/App.tsx - Teacher settings
src/pages/Settings.tsx
Identity
- Auth pages
src/pages/auth - Auth context
src/context/AuthContext.tsx - Auth service
src/services/authService.ts
Classroom workflows
- Dashboard
src/pages/Dashboard.tsx - Dashboard data
src/hooks/useDashboardData.ts - Student management
src/pages/Students.tsx - Broadcast page
src/pages/Broadcast.tsx - Broadcast session
src/hooks/useBroadcastSession.ts - Broadcast controls
src/components/broadcast/ControlBar.tsx - Student requests
src/components/broadcast/RequestsPanel.tsx - Live CC page
src/pages/LiveCC.tsx - Session log polling
src/hooks/useLiveCCSessions.ts - Session selector
src/components/livecc/SessionSelector.tsx
Service boundary
- API client
src/services/api.ts - FastAPI backend
Other components
- Teacher
- Student mobile app
- Browser speech recognition
- PostgreSQL
Connections 25
- Teacher → App routing: uses console
README.md - App routing → Auth pages: routes to
src/App.tsx - App routing → Dashboard: routes to
src/App.tsx - App routing → Student management: routes to
src/App.tsx - App routing → Broadcast page: routes to
src/App.tsx - App routing → Live CC page: routes to
src/App.tsx - App routing → Teacher settings: routes to
src/App.tsx - Auth pages → Auth context: authenticates via
- Auth context → FastAPI backend: sends auth requests
src/context/AuthContext.tsx - Auth context → API client: provides auth state
- Dashboard → Dashboard data: loads data via
src/pages/Dashboard.tsx - Dashboard data → API client: requests data
src/hooks/useDashboardData.ts - Student management → API client: requests student data
src/pages/Students.tsx - Broadcast page → Broadcast session: uses session state
src/pages/Broadcast.tsx - Broadcast page → Broadcast controls: renders controls
src/pages/Broadcast.tsx - Broadcast page → Student requests: renders requests
src/pages/Broadcast.tsx - Broadcast session → API client: polls and posts
src/hooks/useBroadcastSession.ts - Broadcast session → Browser speech recognition: recognizes speech
README.md - Live CC page → Session log polling: loads session logs
src/pages/LiveCC.tsx - Live CC page → Session selector: renders selector
src/pages/LiveCC.tsx - Session log polling → API client: polls session logs
src/hooks/useLiveCCSessions.ts - Teacher settings → API client: loads profile
src/pages/Settings.tsx - API client → FastAPI backend: sends API requests
src/services/api.ts - FastAPI backend → PostgreSQL: reads and writes
README.md - Student mobile app → FastAPI backend: uses AAC and sessions
README.md