How snuhcs-course/swpp-2026-project-team-07 works
OutLoud is an Android presentation-practice app intended to connect slide decks, rehearsal recordings, slide-aligned transcripts, and feedback. The intended user journey is to choose slides, rehearse while recording slide changes, submit the recording, and review synchronized transcript and feedback. This checkout is explicitly an iteration-one scaffold: PDF import, recording, backend processing, and feedback are unfinished or unwired. The graph preserves those documented stages without implying they run end to end; edges are limited to shown imports, calls, or README statements.
Main entry points: tasks.py Processing task · RehearsalScreen.tsx Rehearsal screen · LibraryScreen.tsx Deck library · ResultsScreen.tsx Transcript results
Components 22
Mobile app
- Deck library
mobile/src/features/pdf/LibraryScreen.tsx - PDF import
mobile/src/features/pdf/service.ts - Slide viewer
mobile/src/features/pdf/ViewerScreen.tsx - Slide preview
mobile/src/features/pdf/SlidePreview.tsx - Rehearsal screen
mobile/src/features/recording/RehearsalScreen.tsx - Recording service
mobile/src/features/recording/service.ts - Wire contracts
mobile/src/contracts/index.ts - Transcription client
mobile/src/features/transcription/client.ts - Transcription service
mobile/src/features/transcription/service.ts - Transcript results
mobile/src/features/transcription/ResultsScreen.tsx - Audio playback
mobile/src/features/transcription/playback.ts
Backend processing
- Django API
backend/rehearsals/views.py - Processing task
backend/rehearsals/tasks.py - Whisper transcription
backend/rehearsals/services/transcription.py - Slide alignment
backend/rehearsals/services/alignment.py - AI feedback
backend/rehearsals/services/feedback.py - PDF service
backend/rehearsals/services/pdf.py - Task dispatch
backend/config/celery.py
Rehearsal data
- Attempt storage
backend/rehearsals/models.py
Other components
- Presenter
- PostgreSQL
- Redis broker
Connections 21
- Presenter → Deck library: opens
README.md - Deck library → PDF import: requests import
mobile/src/features/pdf/LibraryScreen.tsx - Deck library → Slide viewer: opens viewer
mobile/src/features/pdf/LibraryScreen.tsx - Slide viewer → Slide preview: renders
mobile/src/features/pdf/ViewerScreen.tsx - Presenter → Rehearsal screen: starts rehearsal
README.md - Rehearsal screen → Slide preview: renders
mobile/src/features/recording/RehearsalScreen.tsx - Rehearsal screen → Recording service: captures session
- Rehearsal screen → Transcript results: opens preview
mobile/src/features/recording/RehearsalScreen.tsx - Transcription service → Transcription client: configures
mobile/src/features/transcription/service.ts - Transcription service → Django API: sends requests
mobile/src/features/transcription/service.ts - Transcription client → Wire contracts: validates types
mobile/src/features/transcription/client.ts - Transcript results → Audio playback: uses playback
mobile/src/features/transcription/ResultsScreen.tsx - Transcript results → Wire contracts: displays results
mobile/src/features/transcription/ResultsScreen.tsx - Django API → Processing task: queues processing
- Processing task → Whisper transcription: transcribes
- Processing task → Slide alignment: aligns words
- Processing task → AI feedback: generates feedback
- Processing task → Attempt storage: persists results
- PDF import → PDF service: uploads deck
- Attempt storage → PostgreSQL: stored in
README.md - Task dispatch → Redis broker: uses broker
README.md