# ooarchitect92/sessions architecture

> Architecture diagram of the GitHub repository ooarchitect92/sessions, 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/ooarchitect92/sessions
- Repository: https://github.com/ooarchitect92/sessions

## Overview

Sessions is a multi-tenant meeting and webinar platform with an authenticated workspace app, public event and booking journeys, and a NestJS API. The main workflow runs from workspace setup and session scheduling through live agendas and collaboration to governed recordings and meeting memory. Events and booking pages provide separate public registration and reservation journeys. The README documents PostgreSQL, Redis, outbox workers, LiveKit, and private object storage. Some domain modules are unsampled; their presence and capabilities are documented, but uncertain implementation links are omitted or dashed.

Main entry points: [`backend/src/sessions/sessions.service.ts`](https://github.com/ooarchitect92/sessions/blob/main/backend/src/sessions/sessions.service.ts) (Session lifecycle), [`frontend/src/api/client.ts`](https://github.com/ooarchitect92/sessions/blob/main/frontend/src/api/client.ts) (API client), [`website/src`](https://github.com/ooarchitect92/sessions/tree/main/website/src) (Public journeys), [`backend/src/events/events.service.ts`](https://github.com/ooarchitect92/sessions/blob/main/backend/src/events/events.service.ts) (Webinar events)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_product["Product apps"]
  node_app["Workspace app<br/>[App.tsx]"]
  node_api_client["API client<br/>[client.ts]"]
  node_session_ui["Session stage<br/>[SessionPage.tsx]"]
  node_collab_ui["Collaboration panel"]
  node_public_ui["Public journeys"]
end

subgraph group_identity["Identity and tenants"]
  node_auth["Authentication"]
  node_workspaces["Workspace management"]
end

subgraph group_meetings["Meetings and collaboration"]
  node_sessions["Session lifecycle"]
  node_agendas["Interactive agendas"]
  node_collaboration["Live collaboration"]
  node_media["Media access"]
  node_recordings["Recording governance"]
  node_memory["Meeting memory<br/>[memory.service.ts]"]
end

subgraph group_journeys["Events and bookings"]
  node_events["Webinar events<br/>[events.service.ts]"]
  node_bookings["Booking reservations"]
end

subgraph group_platform["Platform services"]
  node_tenant_db["Tenant data access"]
  node_pg[("PostgreSQL")]
  node_outbox["Transactional outbox<br/>[outbox.service.ts]"]
  node_redis[("Redis events<br/>[redis.service.ts]")]
  node_livekit["LiveKit media"]
  node_object_store[("Private object storage")]
  node_audit["Audit records<br/>[audit.service.ts]"]
end

node_member(("Workspace member"))
node_guest(("Public attendee"))

node_member -->|"uses"| node_app
node_app -->|"requests"| node_api_client
node_api_client -.->|"authenticates"| node_auth
node_api_client -.->|"calls API"| node_sessions
node_session_ui -->|"loads session"| node_api_client
node_session_ui -->|"renders"| node_collab_ui
node_collab_ui -->|"loads collaboration"| node_api_client
node_sessions -->|"uses tenant data"| node_tenant_db
node_sessions -->|"records actions"| node_audit
node_sessions -->|"updates memory"| node_memory
node_agendas -.->|"serves session agenda"| node_sessions
node_collaboration -.->|"broadcasts events"| node_redis
node_member -->|"joins media"| node_livekit
node_media -.->|"issues tokens"| node_livekit
node_recordings -->|"stores recordings"| node_object_store
node_livekit -->|"egress writes"| node_object_store
node_memory -->|"reads tenant data"| node_tenant_db
node_guest -->|"registers or books"| node_public_ui
node_public_ui -->|"submits registration"| node_events
node_public_ui -->|"reserves slot"| node_bookings
node_events -->|"creates webinar session"| node_sessions
node_bookings -->|"creates scheduled session"| node_sessions
node_events -->|"persists event data"| node_pg
node_bookings -->|"persists reservation"| node_pg
node_outbox -->|"publishes events"| node_redis
node_auth -->|"records auth actions"| node_audit
node_workspaces -.->|"uses tenant data"| node_tenant_db

click node_app "https://github.com/ooarchitect92/sessions/blob/main/frontend/src/App.tsx"
click node_api_client "https://github.com/ooarchitect92/sessions/blob/main/frontend/src/api/client.ts"
click node_session_ui "https://github.com/ooarchitect92/sessions/blob/main/frontend/src/pages/SessionPage.tsx"
click node_collab_ui "https://github.com/ooarchitect92/sessions/blob/main/frontend/src/components/SessionCollaborationPanel.tsx"
click node_public_ui "https://github.com/ooarchitect92/sessions/tree/main/website/src"
click node_auth "https://github.com/ooarchitect92/sessions/tree/main/backend/src/auth"
click node_workspaces "https://github.com/ooarchitect92/sessions/blob/main/backend/src/workspaces/workspaces.service.ts"
click node_tenant_db "https://github.com/ooarchitect92/sessions/blob/main/backend/src/database/tenant-database.service.ts"
click node_sessions "https://github.com/ooarchitect92/sessions/blob/main/backend/src/sessions/sessions.service.ts"
click node_agendas "https://github.com/ooarchitect92/sessions/tree/main/backend/src/agendas"
click node_collaboration "https://github.com/ooarchitect92/sessions/blob/main/backend/src/collaboration/collaboration.service.ts"
click node_media "https://github.com/ooarchitect92/sessions/tree/main/backend/src/media"
click node_recordings "https://github.com/ooarchitect92/sessions/tree/main/backend/src/recordings"
click node_memory "https://github.com/ooarchitect92/sessions/blob/main/backend/src/memory/memory.service.ts"
click node_events "https://github.com/ooarchitect92/sessions/blob/main/backend/src/events/events.service.ts"
click node_bookings "https://github.com/ooarchitect92/sessions/blob/main/backend/src/bookings/bookings.service.ts"
click node_outbox "https://github.com/ooarchitect92/sessions/blob/main/backend/src/outbox/outbox.service.ts"
click node_redis "https://github.com/ooarchitect92/sessions/blob/main/backend/src/infrastructure/redis.service.ts"
click node_object_store "https://github.com/ooarchitect92/sessions/blob/main/backend/src/recordings/s3-object-store.service.ts"
click node_audit "https://github.com/ooarchitect92/sessions/blob/main/backend/src/audit/audit.service.ts"

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_api_client,node_session_ui,node_collab_ui,node_public_ui toneBlue
class node_auth,node_workspaces toneAmber
class node_sessions,node_agendas,node_collaboration,node_media,node_recordings,node_memory toneMint
class node_events,node_bookings toneRose
class node_tenant_db,node_pg,node_outbox,node_redis,node_livekit,node_object_store,node_audit,node_member,node_guest toneIndigo
```

## Components

### Product apps

- [Workspace app](https://github.com/ooarchitect92/sessions/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`
- [API client](https://github.com/ooarchitect92/sessions/blob/main/frontend/src/api/client.ts): `frontend/src/api/client.ts`
- [Session stage](https://github.com/ooarchitect92/sessions/blob/main/frontend/src/pages/SessionPage.tsx): `frontend/src/pages/SessionPage.tsx`
- [Collaboration panel](https://github.com/ooarchitect92/sessions/blob/main/frontend/src/components/SessionCollaborationPanel.tsx): `frontend/src/components/SessionCollaborationPanel.tsx`
- [Public journeys](https://github.com/ooarchitect92/sessions/tree/main/website/src): `website/src`

### Identity and tenants

- [Authentication](https://github.com/ooarchitect92/sessions/tree/main/backend/src/auth): `backend/src/auth`
- [Workspace management](https://github.com/ooarchitect92/sessions/blob/main/backend/src/workspaces/workspaces.service.ts): `backend/src/workspaces/workspaces.service.ts`

### Meetings and collaboration

- [Session lifecycle](https://github.com/ooarchitect92/sessions/blob/main/backend/src/sessions/sessions.service.ts): `backend/src/sessions/sessions.service.ts`
- [Interactive agendas](https://github.com/ooarchitect92/sessions/tree/main/backend/src/agendas): `backend/src/agendas`
- [Live collaboration](https://github.com/ooarchitect92/sessions/blob/main/backend/src/collaboration/collaboration.service.ts): `backend/src/collaboration/collaboration.service.ts`
- [Media access](https://github.com/ooarchitect92/sessions/tree/main/backend/src/media): `backend/src/media`
- [Recording governance](https://github.com/ooarchitect92/sessions/tree/main/backend/src/recordings): `backend/src/recordings`
- [Meeting memory](https://github.com/ooarchitect92/sessions/blob/main/backend/src/memory/memory.service.ts): `backend/src/memory/memory.service.ts`

### Events and bookings

- [Webinar events](https://github.com/ooarchitect92/sessions/blob/main/backend/src/events/events.service.ts): `backend/src/events/events.service.ts`
- [Booking reservations](https://github.com/ooarchitect92/sessions/blob/main/backend/src/bookings/bookings.service.ts): `backend/src/bookings/bookings.service.ts`

### Platform services

- [Tenant data access](https://github.com/ooarchitect92/sessions/blob/main/backend/src/database/tenant-database.service.ts): `backend/src/database/tenant-database.service.ts`
- **PostgreSQL**
- [Transactional outbox](https://github.com/ooarchitect92/sessions/blob/main/backend/src/outbox/outbox.service.ts): `backend/src/outbox/outbox.service.ts`
- [Redis events](https://github.com/ooarchitect92/sessions/blob/main/backend/src/infrastructure/redis.service.ts): `backend/src/infrastructure/redis.service.ts`
- **LiveKit media**
- [Private object storage](https://github.com/ooarchitect92/sessions/blob/main/backend/src/recordings/s3-object-store.service.ts): `backend/src/recordings/s3-object-store.service.ts`
- [Audit records](https://github.com/ooarchitect92/sessions/blob/main/backend/src/audit/audit.service.ts): `backend/src/audit/audit.service.ts`

### Other components

- **Workspace member**
- **Public attendee**

## Connections

- Workspace member → Workspace app: uses (evidence: `README.md`)
- Workspace app → API client: requests (evidence: `frontend/src/App.tsx`)
- API client → Authentication: authenticates
- API client → Session lifecycle: calls API
- Session stage → API client: loads session (evidence: `frontend/src/pages/SessionPage.tsx`)
- Session stage → Collaboration panel: renders (evidence: `frontend/src/pages/SessionPage.tsx`)
- Collaboration panel → API client: loads collaboration (evidence: `frontend/src/components/SessionCollaborationPanel.tsx`)
- Session lifecycle → Tenant data access: uses tenant data (evidence: `backend/src/sessions/sessions.service.ts`)
- Session lifecycle → Audit records: records actions (evidence: `backend/src/sessions/sessions.service.ts`)
- Session lifecycle → Meeting memory: updates memory (evidence: `backend/src/sessions/sessions.service.ts`)
- Interactive agendas → Session lifecycle: serves session agenda
- Live collaboration → Redis events: broadcasts events
- Workspace member → LiveKit media: joins media (evidence: `README.md`)
- Media access → LiveKit media: issues tokens
- Recording governance → Private object storage: stores recordings (evidence: `README.md`)
- LiveKit media → Private object storage: egress writes (evidence: `README.md`)
- Meeting memory → Tenant data access: reads tenant data (evidence: `backend/src/memory/memory.service.ts`)
- Public attendee → Public journeys: registers or books (evidence: `README.md`)
- Public journeys → Webinar events: submits registration (evidence: `README.md`)
- Public journeys → Booking reservations: reserves slot (evidence: `README.md`)
- Webinar events → Session lifecycle: creates webinar session (evidence: `README.md`)
- Booking reservations → Session lifecycle: creates scheduled session (evidence: `README.md`)
- Webinar events → PostgreSQL: persists event data (evidence: `README.md`)
- Booking reservations → PostgreSQL: persists reservation (evidence: `README.md`)
- Transactional outbox → Redis events: publishes events (evidence: `backend/src/outbox/outbox.service.ts`)
- Authentication → Audit records: records auth actions (evidence: `backend/src/auth/auth.service.ts`)
- Workspace management → Tenant data access: uses tenant data
