# snuhcs-course/swpp-2026-project-team-07 architecture

> Architecture diagram of the GitHub repository snuhcs-course/swpp-2026-project-team-07, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-07). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/snuhcs-course/swpp-2026-project-team-07
- Repository: https://github.com/snuhcs-course/swpp-2026-project-team-07

## Overview

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: [`backend/rehearsals/tasks.py`](https://github.com/snuhcs-course/swpp-2026-project-team-07/blob/main/backend/rehearsals/tasks.py) (Processing task), [`mobile/src/features/recording/RehearsalScreen.tsx`](https://github.com/snuhcs-course/swpp-2026-project-team-07/blob/main/mobile/src/features/recording/RehearsalScreen.tsx) (Rehearsal screen), [`mobile/src/features/pdf/LibraryScreen.tsx`](https://github.com/snuhcs-course/swpp-2026-project-team-07/blob/main/mobile/src/features/pdf/LibraryScreen.tsx) (Deck library), [`mobile/src/features/transcription/ResultsScreen.tsx`](https://github.com/snuhcs-course/swpp-2026-project-team-07/blob/main/mobile/src/features/transcription/ResultsScreen.tsx) (Transcript results)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_mobile["Mobile app"]
  node_library["Deck library<br/>[LibraryScreen.tsx]"]
  node_pdf_import["PDF import<br/>[service.ts]"]
  node_viewer["Slide viewer<br/>[ViewerScreen.tsx]"]
  node_slide_preview["Slide preview<br/>[SlidePreview.tsx]"]
  node_rehearsal["Rehearsal screen"]
  node_recording["Recording service<br/>[service.ts]"]
  node_contracts["Wire contracts<br/>[index.ts]"]
  node_transcription_client["Transcription client<br/>[client.ts]"]
  node_transcription_service["Transcription service<br/>[service.ts]"]
  node_results["Transcript results<br/>[ResultsScreen.tsx]"]
  node_playback["Audio playback<br/>[playback.ts]"]
end

subgraph group_backend["Backend processing"]
  node_api["Django API<br/>[views.py]"]
  node_worker["Processing task<br/>[tasks.py]"]
  node_transcription["Whisper transcription<br/>[transcription.py]"]
  node_alignment["Slide alignment<br/>[alignment.py]"]
  node_feedback["AI feedback<br/>[feedback.py]"]
  node_pdf_service["PDF service<br/>[pdf.py]"]
  node_celery["Task dispatch<br/>[celery.py]"]
end

subgraph group_domain["Rehearsal data"]
  node_attempt_data[("Attempt storage<br/>[models.py]")]
end

node_presenter(("Presenter"))
node_database[("PostgreSQL")]
node_broker["Redis broker"]

node_presenter -->|"opens"| node_library
node_library -.->|"requests import"| node_pdf_import
node_library -->|"opens viewer"| node_viewer
node_viewer -->|"renders"| node_slide_preview
node_presenter -->|"starts rehearsal"| node_rehearsal
node_rehearsal -->|"renders"| node_slide_preview
node_rehearsal -.->|"captures session"| node_recording
node_rehearsal -->|"opens preview"| node_results
node_transcription_service -->|"configures"| node_transcription_client
node_transcription_service -->|"sends requests"| node_api
node_transcription_client -->|"validates types"| node_contracts
node_results -->|"uses playback"| node_playback
node_results -->|"displays results"| node_contracts
node_api -.->|"queues processing"| node_worker
node_worker -.->|"transcribes"| node_transcription
node_worker -.->|"aligns words"| node_alignment
node_worker -.->|"generates feedback"| node_feedback
node_worker -.->|"persists results"| node_attempt_data
node_pdf_import -.->|"uploads deck"| node_pdf_service
node_attempt_data -->|"stored in"| node_database
node_celery -->|"uses broker"| node_broker

click node_library "https://github.com/snuhcs-course/swpp-2026-project-team-07/blob/main/mobile/src/features/pdf/LibraryScreen.tsx"
click node_pdf_import "https://github.com/snuhcs-course/swpp-2026-project-team-07/blob/main/mobile/src/features/pdf/service.ts"
click node_viewer "https://github.com/snuhcs-course/swpp-2026-project-team-07/blob/main/mobile/src/features/pdf/ViewerScreen.tsx"
click node_slide_preview "https://github.com/snuhcs-course/swpp-2026-project-team-07/blob/main/mobile/src/features/pdf/SlidePreview.tsx"
click node_rehearsal "https://github.com/snuhcs-course/swpp-2026-project-team-07/blob/main/mobile/src/features/recording/RehearsalScreen.tsx"
click node_recording "https://github.com/snuhcs-course/swpp-2026-project-team-07/blob/main/mobile/src/features/recording/service.ts"
click node_contracts "https://github.com/snuhcs-course/swpp-2026-project-team-07/blob/main/mobile/src/contracts/index.ts"
click node_transcription_client "https://github.com/snuhcs-course/swpp-2026-project-team-07/blob/main/mobile/src/features/transcription/client.ts"
click node_transcription_service "https://github.com/snuhcs-course/swpp-2026-project-team-07/blob/main/mobile/src/features/transcription/service.ts"
click node_results "https://github.com/snuhcs-course/swpp-2026-project-team-07/blob/main/mobile/src/features/transcription/ResultsScreen.tsx"
click node_playback "https://github.com/snuhcs-course/swpp-2026-project-team-07/blob/main/mobile/src/features/transcription/playback.ts"
click node_api "https://github.com/snuhcs-course/swpp-2026-project-team-07/blob/main/backend/rehearsals/views.py"
click node_worker "https://github.com/snuhcs-course/swpp-2026-project-team-07/blob/main/backend/rehearsals/tasks.py"
click node_transcription "https://github.com/snuhcs-course/swpp-2026-project-team-07/blob/main/backend/rehearsals/services/transcription.py"
click node_alignment "https://github.com/snuhcs-course/swpp-2026-project-team-07/blob/main/backend/rehearsals/services/alignment.py"
click node_feedback "https://github.com/snuhcs-course/swpp-2026-project-team-07/blob/main/backend/rehearsals/services/feedback.py"
click node_pdf_service "https://github.com/snuhcs-course/swpp-2026-project-team-07/blob/main/backend/rehearsals/services/pdf.py"
click node_attempt_data "https://github.com/snuhcs-course/swpp-2026-project-team-07/blob/main/backend/rehearsals/models.py"
click node_celery "https://github.com/snuhcs-course/swpp-2026-project-team-07/blob/main/backend/config/celery.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_library,node_pdf_import,node_viewer,node_slide_preview,node_rehearsal,node_recording,node_contracts,node_transcription_client,node_transcription_service,node_results,node_playback toneBlue
class node_api,node_worker,node_transcription,node_alignment,node_feedback,node_pdf_service,node_celery,node_database,node_broker toneAmber
class node_attempt_data toneMint
class node_presenter toneIndigo
```

## Components

### Mobile app

- [Deck library](https://github.com/snuhcs-course/swpp-2026-project-team-07/blob/main/mobile/src/features/pdf/LibraryScreen.tsx): `mobile/src/features/pdf/LibraryScreen.tsx`
- [PDF import](https://github.com/snuhcs-course/swpp-2026-project-team-07/blob/main/mobile/src/features/pdf/service.ts): `mobile/src/features/pdf/service.ts`
- [Slide viewer](https://github.com/snuhcs-course/swpp-2026-project-team-07/blob/main/mobile/src/features/pdf/ViewerScreen.tsx): `mobile/src/features/pdf/ViewerScreen.tsx`
- [Slide preview](https://github.com/snuhcs-course/swpp-2026-project-team-07/blob/main/mobile/src/features/pdf/SlidePreview.tsx): `mobile/src/features/pdf/SlidePreview.tsx`
- [Rehearsal screen](https://github.com/snuhcs-course/swpp-2026-project-team-07/blob/main/mobile/src/features/recording/RehearsalScreen.tsx): `mobile/src/features/recording/RehearsalScreen.tsx`
- [Recording service](https://github.com/snuhcs-course/swpp-2026-project-team-07/blob/main/mobile/src/features/recording/service.ts): `mobile/src/features/recording/service.ts`
- [Wire contracts](https://github.com/snuhcs-course/swpp-2026-project-team-07/blob/main/mobile/src/contracts/index.ts): `mobile/src/contracts/index.ts`
- [Transcription client](https://github.com/snuhcs-course/swpp-2026-project-team-07/blob/main/mobile/src/features/transcription/client.ts): `mobile/src/features/transcription/client.ts`
- [Transcription service](https://github.com/snuhcs-course/swpp-2026-project-team-07/blob/main/mobile/src/features/transcription/service.ts): `mobile/src/features/transcription/service.ts`
- [Transcript results](https://github.com/snuhcs-course/swpp-2026-project-team-07/blob/main/mobile/src/features/transcription/ResultsScreen.tsx): `mobile/src/features/transcription/ResultsScreen.tsx`
- [Audio playback](https://github.com/snuhcs-course/swpp-2026-project-team-07/blob/main/mobile/src/features/transcription/playback.ts): `mobile/src/features/transcription/playback.ts`

### Backend processing

- [Django API](https://github.com/snuhcs-course/swpp-2026-project-team-07/blob/main/backend/rehearsals/views.py): `backend/rehearsals/views.py`
- [Processing task](https://github.com/snuhcs-course/swpp-2026-project-team-07/blob/main/backend/rehearsals/tasks.py): `backend/rehearsals/tasks.py`
- [Whisper transcription](https://github.com/snuhcs-course/swpp-2026-project-team-07/blob/main/backend/rehearsals/services/transcription.py): `backend/rehearsals/services/transcription.py`
- [Slide alignment](https://github.com/snuhcs-course/swpp-2026-project-team-07/blob/main/backend/rehearsals/services/alignment.py): `backend/rehearsals/services/alignment.py`
- [AI feedback](https://github.com/snuhcs-course/swpp-2026-project-team-07/blob/main/backend/rehearsals/services/feedback.py): `backend/rehearsals/services/feedback.py`
- [PDF service](https://github.com/snuhcs-course/swpp-2026-project-team-07/blob/main/backend/rehearsals/services/pdf.py): `backend/rehearsals/services/pdf.py`
- [Task dispatch](https://github.com/snuhcs-course/swpp-2026-project-team-07/blob/main/backend/config/celery.py): `backend/config/celery.py`

### Rehearsal data

- [Attempt storage](https://github.com/snuhcs-course/swpp-2026-project-team-07/blob/main/backend/rehearsals/models.py): `backend/rehearsals/models.py`

### Other components

- **Presenter**
- **PostgreSQL**
- **Redis broker**

## Connections

- Presenter → Deck library: opens (evidence: `README.md`)
- Deck library → PDF import: requests import (evidence: `mobile/src/features/pdf/LibraryScreen.tsx`)
- Deck library → Slide viewer: opens viewer (evidence: `mobile/src/features/pdf/LibraryScreen.tsx`)
- Slide viewer → Slide preview: renders (evidence: `mobile/src/features/pdf/ViewerScreen.tsx`)
- Presenter → Rehearsal screen: starts rehearsal (evidence: `README.md`)
- Rehearsal screen → Slide preview: renders (evidence: `mobile/src/features/recording/RehearsalScreen.tsx`)
- Rehearsal screen → Recording service: captures session
- Rehearsal screen → Transcript results: opens preview (evidence: `mobile/src/features/recording/RehearsalScreen.tsx`)
- Transcription service → Transcription client: configures (evidence: `mobile/src/features/transcription/service.ts`)
- Transcription service → Django API: sends requests (evidence: `mobile/src/features/transcription/service.ts`)
- Transcription client → Wire contracts: validates types (evidence: `mobile/src/features/transcription/client.ts`)
- Transcript results → Audio playback: uses playback (evidence: `mobile/src/features/transcription/ResultsScreen.tsx`)
- Transcript results → Wire contracts: displays results (evidence: `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 (evidence: `README.md`)
- Task dispatch → Redis broker: uses broker (evidence: `README.md`)
