# opeoluwa-muritala/vent architecture

> Architecture diagram of the GitHub repository opeoluwa-muritala/vent, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/opeoluwa-muritala/vent
- Repository: https://github.com/opeoluwa-muritala/vent

## Overview

Vent is a multiplatform conference companion: attendees sign in, browse sessions, reserve seats, check in, and use quests and passes; organizers configure events, manage attendees, plan seating, and control sessions. The shared Compose app routes users into feature screens and uses view-model, API, and local-store layers; the Ktor service exposes authenticated event and schedule operations backed by PostgreSQL. The README documents offline Android use and server-backed web/iOS sign-in. Some feature-to-service details are unsampled, so those links are omitted rather than inferred.

Main entry points: [`frontend/composeApp/src/commonMain/kotlin/app/vent/VentApp.kt`](https://github.com/opeoluwa-muritala/vent/blob/main/frontend/composeApp/src/commonMain/kotlin/app/vent/VentApp.kt) (App navigation), [`server/src/main/kotlin/app/vent/server/Main.kt`](https://github.com/opeoluwa-muritala/vent/blob/main/server/src/main/kotlin/app/vent/server/Main.kt) (HTTP application), [`frontend/composeApp/src/commonMain/kotlin/app/vent/VentViewModel.kt`](https://github.com/opeoluwa-muritala/vent/blob/main/frontend/composeApp/src/commonMain/kotlin/app/vent/VentViewModel.kt) (App state), [`frontend/composeApp/src/commonMain/kotlin/app/vent/AuthFlow.kt`](https://github.com/opeoluwa-muritala/vent/blob/main/frontend/composeApp/src/commonMain/kotlin/app/vent/AuthFlow.kt) (Sign-in flow)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Multiplatform client"]
  node_app["App navigation<br/>[VentApp.kt]"]
  node_auth["Sign-in flow<br/>[AuthFlow.kt]"]
  node_viewmodel["App state<br/>[VentViewModel.kt]"]
  node_api["API client<br/>[VentApiClient.kt]"]
  node_local[("Local state<br/>[VentLocalStore.kt]")]
  node_sync["Preference sync"]
end

subgraph group_features["Event experiences"]
  node_sessions["Session agenda<br/>[SessionsHome.kt]"]
  node_seats["Seat selection"]
  node_organizerops["Organizer tools"]
  node_summit["Summit pass<br/>[SummitSession.kt]"]
  node_scanner["Check-in scanner"]
  node_imports["Attendee import"]
end

subgraph group_shared["Shared domain"]
  node_contracts["API contracts<br/>[Contracts.kt]"]
  node_rules["Domain rules<br/>[Rules.kt]"]
  node_palette["Event palette<br/>[EventPalette.kt]"]
end

subgraph group_service["Ktor service"]
  node_server["HTTP application<br/>[Main.kt]"]
  node_routes["Event routes<br/>[VentRoutes.kt]"]
  node_authservice["Authentication<br/>[AuthService.kt]"]
end

subgraph group_storage["Persistence"]
  node_schedule["Schedule repository"]
  node_authrepo["Auth repository<br/>[AuthRepository.kt]"]
  node_database[("PostgreSQL<br/>[DatabaseFactory.kt]")]
end

node_attendee(("Attendee"))
node_organizer(("Organizer"))

node_attendee -->|"signs in"| node_auth
node_organizer -->|"signs in"| node_auth
node_auth -->|"enters app"| node_app
node_app -->|"creates state"| node_viewmodel
node_app -->|"routes to"| node_sessions
node_app -->|"routes to"| node_seats
node_app -->|"routes to"| node_organizerops
node_app -->|"routes to"| node_summit
node_viewmodel -.->|"uses state"| node_local
node_viewmodel -.->|"requests data"| node_api
node_sync -.->|"syncs state"| node_local
node_api -->|"calls API"| node_server
node_server -->|"connects"| node_database
node_server -->|"handles auth"| node_authservice
node_server -->|"registers routes"| node_routes
node_server -->|"constructs"| node_schedule
node_authservice -->|"stores OTPs"| node_authrepo
node_routes -->|"reads events"| node_schedule
node_server -->|"uses DTOs"| node_contracts
node_attendee -->|"browses agenda"| node_sessions
node_attendee -->|"reserves seats"| node_seats
node_attendee -->|"checks in"| node_scanner
node_organizer -->|"manages event"| node_organizerops
node_organizer -->|"manages attendees"| node_imports
node_sessions -->|"opens session"| node_summit

click node_app "https://github.com/opeoluwa-muritala/vent/blob/main/frontend/composeApp/src/commonMain/kotlin/app/vent/VentApp.kt"
click node_auth "https://github.com/opeoluwa-muritala/vent/blob/main/frontend/composeApp/src/commonMain/kotlin/app/vent/AuthFlow.kt"
click node_viewmodel "https://github.com/opeoluwa-muritala/vent/blob/main/frontend/composeApp/src/commonMain/kotlin/app/vent/VentViewModel.kt"
click node_api "https://github.com/opeoluwa-muritala/vent/blob/main/frontend/composeApp/src/commonMain/kotlin/app/vent/data/VentApiClient.kt"
click node_local "https://github.com/opeoluwa-muritala/vent/blob/main/frontend/composeApp/src/commonMain/kotlin/app/vent/data/VentLocalStore.kt"
click node_sync "https://github.com/opeoluwa-muritala/vent/blob/main/frontend/composeApp/src/commonMain/kotlin/app/vent/data/SyncingVentLocalStore.kt"
click node_sessions "https://github.com/opeoluwa-muritala/vent/blob/main/frontend/composeApp/src/commonMain/kotlin/app/vent/SessionsHome.kt"
click node_seats "https://github.com/opeoluwa-muritala/vent/blob/main/frontend/composeApp/src/commonMain/kotlin/app/vent/SeatSelectionScreen.kt"
click node_organizerops "https://github.com/opeoluwa-muritala/vent/blob/main/frontend/composeApp/src/commonMain/kotlin/app/vent/OrganizerOperations.kt"
click node_summit "https://github.com/opeoluwa-muritala/vent/blob/main/frontend/composeApp/src/commonMain/kotlin/app/vent/SummitSession.kt"
click node_scanner "https://github.com/opeoluwa-muritala/vent/blob/main/frontend/composeApp/src/commonMain/kotlin/app/vent/scanner/ScannerViewModel.kt"
click node_imports "https://github.com/opeoluwa-muritala/vent/blob/main/frontend/composeApp/src/commonMain/kotlin/app/vent/imports/AttendeeImportViewModel.kt"
click node_contracts "https://github.com/opeoluwa-muritala/vent/blob/main/shared-api/src/commonMain/kotlin/app/vent/api/Contracts.kt"
click node_rules "https://github.com/opeoluwa-muritala/vent/blob/main/shared-domain/src/commonMain/kotlin/app/vent/domain/Rules.kt"
click node_palette "https://github.com/opeoluwa-muritala/vent/blob/main/shared-domain/src/commonMain/kotlin/app/vent/domain/EventPalette.kt"
click node_server "https://github.com/opeoluwa-muritala/vent/blob/main/server/src/main/kotlin/app/vent/server/Main.kt"
click node_routes "https://github.com/opeoluwa-muritala/vent/blob/main/server/src/main/kotlin/app/vent/server/VentRoutes.kt"
click node_authservice "https://github.com/opeoluwa-muritala/vent/blob/main/server/src/main/kotlin/app/vent/server/AuthService.kt"
click node_schedule "https://github.com/opeoluwa-muritala/vent/blob/main/server/src/main/kotlin/app/vent/server/ScheduleRepository.kt"
click node_authrepo "https://github.com/opeoluwa-muritala/vent/blob/main/server/src/main/kotlin/app/vent/server/AuthRepository.kt"
click node_database "https://github.com/opeoluwa-muritala/vent/blob/main/server/src/main/kotlin/app/vent/server/DatabaseFactory.kt"

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_app,node_auth,node_viewmodel,node_api,node_local,node_sync toneBlue
class node_sessions,node_seats,node_organizerops,node_summit,node_scanner,node_imports toneAmber
class node_contracts,node_rules,node_palette toneMint
class node_server,node_routes,node_authservice toneRose
class node_schedule,node_authrepo,node_database,node_attendee,node_organizer toneIndigo
```

## Components

### Multiplatform client

- [App navigation](https://github.com/opeoluwa-muritala/vent/blob/main/frontend/composeApp/src/commonMain/kotlin/app/vent/VentApp.kt): `frontend/composeApp/src/commonMain/kotlin/app/vent/VentApp.kt`
- [Sign-in flow](https://github.com/opeoluwa-muritala/vent/blob/main/frontend/composeApp/src/commonMain/kotlin/app/vent/AuthFlow.kt): `frontend/composeApp/src/commonMain/kotlin/app/vent/AuthFlow.kt`
- [App state](https://github.com/opeoluwa-muritala/vent/blob/main/frontend/composeApp/src/commonMain/kotlin/app/vent/VentViewModel.kt): `frontend/composeApp/src/commonMain/kotlin/app/vent/VentViewModel.kt`
- [API client](https://github.com/opeoluwa-muritala/vent/blob/main/frontend/composeApp/src/commonMain/kotlin/app/vent/data/VentApiClient.kt): `frontend/composeApp/src/commonMain/kotlin/app/vent/data/VentApiClient.kt`
- [Local state](https://github.com/opeoluwa-muritala/vent/blob/main/frontend/composeApp/src/commonMain/kotlin/app/vent/data/VentLocalStore.kt): `frontend/composeApp/src/commonMain/kotlin/app/vent/data/VentLocalStore.kt`
- [Preference sync](https://github.com/opeoluwa-muritala/vent/blob/main/frontend/composeApp/src/commonMain/kotlin/app/vent/data/SyncingVentLocalStore.kt): `frontend/composeApp/src/commonMain/kotlin/app/vent/data/SyncingVentLocalStore.kt`

### Event experiences

- [Session agenda](https://github.com/opeoluwa-muritala/vent/blob/main/frontend/composeApp/src/commonMain/kotlin/app/vent/SessionsHome.kt): `frontend/composeApp/src/commonMain/kotlin/app/vent/SessionsHome.kt`
- [Seat selection](https://github.com/opeoluwa-muritala/vent/blob/main/frontend/composeApp/src/commonMain/kotlin/app/vent/SeatSelectionScreen.kt): `frontend/composeApp/src/commonMain/kotlin/app/vent/SeatSelectionScreen.kt`
- [Organizer tools](https://github.com/opeoluwa-muritala/vent/blob/main/frontend/composeApp/src/commonMain/kotlin/app/vent/OrganizerOperations.kt): `frontend/composeApp/src/commonMain/kotlin/app/vent/OrganizerOperations.kt`
- [Summit pass](https://github.com/opeoluwa-muritala/vent/blob/main/frontend/composeApp/src/commonMain/kotlin/app/vent/SummitSession.kt): `frontend/composeApp/src/commonMain/kotlin/app/vent/SummitSession.kt`
- [Check-in scanner](https://github.com/opeoluwa-muritala/vent/blob/main/frontend/composeApp/src/commonMain/kotlin/app/vent/scanner/ScannerViewModel.kt): `frontend/composeApp/src/commonMain/kotlin/app/vent/scanner/ScannerViewModel.kt`
- [Attendee import](https://github.com/opeoluwa-muritala/vent/blob/main/frontend/composeApp/src/commonMain/kotlin/app/vent/imports/AttendeeImportViewModel.kt): `frontend/composeApp/src/commonMain/kotlin/app/vent/imports/AttendeeImportViewModel.kt`

### Shared domain

- [API contracts](https://github.com/opeoluwa-muritala/vent/blob/main/shared-api/src/commonMain/kotlin/app/vent/api/Contracts.kt): `shared-api/src/commonMain/kotlin/app/vent/api/Contracts.kt`
- [Domain rules](https://github.com/opeoluwa-muritala/vent/blob/main/shared-domain/src/commonMain/kotlin/app/vent/domain/Rules.kt): `shared-domain/src/commonMain/kotlin/app/vent/domain/Rules.kt`
- [Event palette](https://github.com/opeoluwa-muritala/vent/blob/main/shared-domain/src/commonMain/kotlin/app/vent/domain/EventPalette.kt): `shared-domain/src/commonMain/kotlin/app/vent/domain/EventPalette.kt`

### Ktor service

- [HTTP application](https://github.com/opeoluwa-muritala/vent/blob/main/server/src/main/kotlin/app/vent/server/Main.kt): `server/src/main/kotlin/app/vent/server/Main.kt`
- [Event routes](https://github.com/opeoluwa-muritala/vent/blob/main/server/src/main/kotlin/app/vent/server/VentRoutes.kt): `server/src/main/kotlin/app/vent/server/VentRoutes.kt`
- [Authentication](https://github.com/opeoluwa-muritala/vent/blob/main/server/src/main/kotlin/app/vent/server/AuthService.kt): `server/src/main/kotlin/app/vent/server/AuthService.kt`

### Persistence

- [Schedule repository](https://github.com/opeoluwa-muritala/vent/blob/main/server/src/main/kotlin/app/vent/server/ScheduleRepository.kt): `server/src/main/kotlin/app/vent/server/ScheduleRepository.kt`
- [Auth repository](https://github.com/opeoluwa-muritala/vent/blob/main/server/src/main/kotlin/app/vent/server/AuthRepository.kt): `server/src/main/kotlin/app/vent/server/AuthRepository.kt`
- [PostgreSQL](https://github.com/opeoluwa-muritala/vent/blob/main/server/src/main/kotlin/app/vent/server/DatabaseFactory.kt): `server/src/main/kotlin/app/vent/server/DatabaseFactory.kt`

### Other components

- **Attendee**
- **Organizer**

## Connections

- Attendee → Sign-in flow: signs in (evidence: `README.md`)
- Organizer → Sign-in flow: signs in (evidence: `README.md`)
- Sign-in flow → App navigation: enters app (evidence: `frontend/composeApp/src/commonMain/kotlin/app/vent/VentApp.kt`)
- App navigation → App state: creates state (evidence: `frontend/composeApp/src/commonMain/kotlin/app/vent/VentApp.kt`)
- App navigation → Session agenda: routes to (evidence: `frontend/composeApp/src/commonMain/kotlin/app/vent/VentApp.kt`)
- App navigation → Seat selection: routes to (evidence: `frontend/composeApp/src/commonMain/kotlin/app/vent/VentApp.kt`)
- App navigation → Organizer tools: routes to (evidence: `frontend/composeApp/src/commonMain/kotlin/app/vent/VentApp.kt`)
- App navigation → Summit pass: routes to (evidence: `frontend/composeApp/src/commonMain/kotlin/app/vent/VentApp.kt`)
- App state → Local state: uses state
- App state → API client: requests data
- Preference sync → Local state: syncs state
- API client → HTTP application: calls API (evidence: `README.md`)
- HTTP application → PostgreSQL: connects (evidence: `server/src/main/kotlin/app/vent/server/Main.kt`)
- HTTP application → Authentication: handles auth (evidence: `server/src/main/kotlin/app/vent/server/Main.kt`)
- HTTP application → Event routes: registers routes (evidence: `server/src/main/kotlin/app/vent/server/Main.kt`)
- HTTP application → Schedule repository: constructs (evidence: `server/src/main/kotlin/app/vent/server/Main.kt`)
- Authentication → Auth repository: stores OTPs (evidence: `server/src/main/kotlin/app/vent/server/AuthService.kt`)
- Event routes → Schedule repository: reads events (evidence: `server/src/main/kotlin/app/vent/server/VentRoutes.kt`)
- HTTP application → API contracts: uses DTOs (evidence: `server/src/main/kotlin/app/vent/server/Main.kt`)
- Attendee → Session agenda: browses agenda (evidence: `README.md`)
- Attendee → Seat selection: reserves seats (evidence: `README.md`)
- Attendee → Check-in scanner: checks in (evidence: `README.md`)
- Organizer → Organizer tools: manages event (evidence: `README.md`)
- Organizer → Attendee import: manages attendees (evidence: `README.md`)
- Session agenda → Summit pass: opens session (evidence: `frontend/composeApp/src/commonMain/kotlin/app/vent/SessionsHome.kt`)
