# numerique-gouv/b3desk architecture

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

- Interactive diagram: https://gitdiagram.com/numerique-gouv/b3desk
- Repository: https://github.com/numerique-gouv/b3desk

## Overview

B3Desk is an OIDC-facing application for creating and configuring BigBlueButton meetings, retaining their settings for reuse, and viewing recordings. A typical workflow is an authenticated user managing a meeting, then joining it or using its files; BBB handles conferencing and recording, with callbacks and background work supporting recording notifications. The source index establishes several module references, but many endpoint implementations were not sampled, so uncertain internal calls are omitted. Major documented capabilities are represented without inferring their precise route-level wiring.

Main entry points: [`web/b3desk/__init__.py`](https://github.com/numerique-gouv/b3desk/blob/main/web/b3desk/__init__.py) (Flask application), [`web/b3desk/models/meetings.py`](https://github.com/numerique-gouv/b3desk/blob/main/web/b3desk/models/meetings.py) (Meeting records), [`web/b3desk/tasks.py`](https://github.com/numerique-gouv/b3desk/blob/main/web/b3desk/tasks.py) (Async tasks), [`web/b3desk/models/bbb.py`](https://github.com/numerique-gouv/b3desk/blob/main/web/b3desk/models/bbb.py) (BigBlueButton API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web application"]
  node_app["Flask application<br/>[__init__.py]"]
  node_meeting_routes["Meeting management<br/>[meetings.py]"]
  node_join_routes["Join flow<br/>[join.py]"]
  node_file_routes["Meeting files<br/>[meeting_files.py]"]
  node_admin_routes["Administration<br/>[admin.py]"]
  node_callbacks["BBB callbacks<br/>[bbb_callback.py]"]
end

subgraph group_domain["Identity and meeting domain"]
  node_oidc["OIDC identity<br/>[session.py]"]
  node_users["Users and groups<br/>[users.py]"]
  node_groups["Group rules<br/>[groups.py]"]
  node_meetings[("Meeting records<br/>[meetings.py]")]
  node_roles["Access roles<br/>[roles.py]"]
  node_forms["Meeting forms<br/>[forms.py]"]
  node_store[("Application database<br/>[__init__.py]")]
end

subgraph group_integrations["Conference and files"]
  node_bbb["BigBlueButton API<br/>[bbb.py]"]
  node_nextcloud["Nextcloud integration<br/>[nextcloud.py]"]
  node_recordings["Recording processing<br/>[bbb.py]"]
end

subgraph group_async["Background work"]
  node_tasks["Async tasks<br/>[tasks.py]"]
  node_cache[("Cache<br/>[__init__.py]")]
end

node_user(("Meeting user"))
node_bbb_service(("BigBlueButton service"))

node_user -->|"uses"| node_app
node_app -->|"registers routes"| node_meeting_routes
node_app -->|"registers routes"| node_join_routes
node_app -->|"registers routes"| node_file_routes
node_app -->|"registers routes"| node_admin_routes
node_app -->|"registers routes"| node_callbacks
node_app -->|"initializes sessions"| node_oidc
node_meeting_routes -.->|"uses forms"| node_forms
node_meeting_routes -.->|"manages settings"| node_meetings
node_join_routes -.->|"supports joining"| node_bbb
node_file_routes -->|"associates files"| node_meetings
node_file_routes -->|"uses integration"| node_nextcloud
node_oidc -.->|"resolves identity"| node_users
node_users -->|"queries memberships"| node_groups
node_users -->|"queries access"| node_meetings
node_meetings -->|"uses access levels"| node_roles
node_meetings -->|"uses conference API"| node_bbb
node_bbb -->|"sends API requests"| node_bbb_service
node_callbacks -.->|"schedules work"| node_tasks
node_tasks -->|"fetches recordings"| node_bbb
node_tasks -->|"checks playback"| node_recordings
node_tasks -->|"tracks notifications"| node_cache
node_tasks -->|"loads meeting"| node_meetings
node_meetings -.->|"persists records"| node_store

click node_app "https://github.com/numerique-gouv/b3desk/blob/main/web/b3desk/__init__.py"
click node_meeting_routes "https://github.com/numerique-gouv/b3desk/blob/main/web/b3desk/endpoints/meetings.py"
click node_join_routes "https://github.com/numerique-gouv/b3desk/blob/main/web/b3desk/endpoints/join.py"
click node_file_routes "https://github.com/numerique-gouv/b3desk/blob/main/web/b3desk/endpoints/meeting_files.py"
click node_admin_routes "https://github.com/numerique-gouv/b3desk/blob/main/web/b3desk/endpoints/admin.py"
click node_callbacks "https://github.com/numerique-gouv/b3desk/blob/main/web/b3desk/endpoints/bbb_callback.py"
click node_oidc "https://github.com/numerique-gouv/b3desk/blob/main/web/b3desk/session.py"
click node_users "https://github.com/numerique-gouv/b3desk/blob/main/web/b3desk/models/users.py"
click node_groups "https://github.com/numerique-gouv/b3desk/blob/main/web/b3desk/models/groups.py"
click node_meetings "https://github.com/numerique-gouv/b3desk/blob/main/web/b3desk/models/meetings.py"
click node_roles "https://github.com/numerique-gouv/b3desk/blob/main/web/b3desk/models/roles.py"
click node_forms "https://github.com/numerique-gouv/b3desk/blob/main/web/b3desk/forms.py"
click node_bbb "https://github.com/numerique-gouv/b3desk/blob/main/web/b3desk/models/bbb.py"
click node_nextcloud "https://github.com/numerique-gouv/b3desk/blob/main/web/b3desk/nextcloud.py"
click node_recordings "https://github.com/numerique-gouv/b3desk/blob/main/web/b3desk/models/bbb.py"
click node_tasks "https://github.com/numerique-gouv/b3desk/blob/main/web/b3desk/tasks.py"
click node_store "https://github.com/numerique-gouv/b3desk/blob/main/web/b3desk/models/__init__.py"
click node_cache "https://github.com/numerique-gouv/b3desk/blob/main/web/b3desk/__init__.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_app,node_meeting_routes,node_join_routes,node_file_routes,node_admin_routes,node_callbacks,node_user toneBlue
class node_oidc,node_users,node_groups,node_meetings,node_roles,node_forms,node_store toneAmber
class node_bbb,node_nextcloud,node_recordings toneMint
class node_tasks,node_cache toneRose
class node_bbb_service toneIndigo
```

## Components

### Web application

- [Flask application](https://github.com/numerique-gouv/b3desk/blob/main/web/b3desk/__init__.py): `web/b3desk/__init__.py`
- [Meeting management](https://github.com/numerique-gouv/b3desk/blob/main/web/b3desk/endpoints/meetings.py): `web/b3desk/endpoints/meetings.py`
- [Join flow](https://github.com/numerique-gouv/b3desk/blob/main/web/b3desk/endpoints/join.py): `web/b3desk/endpoints/join.py`
- [Meeting files](https://github.com/numerique-gouv/b3desk/blob/main/web/b3desk/endpoints/meeting_files.py): `web/b3desk/endpoints/meeting_files.py`
- [Administration](https://github.com/numerique-gouv/b3desk/blob/main/web/b3desk/endpoints/admin.py): `web/b3desk/endpoints/admin.py`
- [BBB callbacks](https://github.com/numerique-gouv/b3desk/blob/main/web/b3desk/endpoints/bbb_callback.py): `web/b3desk/endpoints/bbb_callback.py`

### Identity and meeting domain

- [OIDC identity](https://github.com/numerique-gouv/b3desk/blob/main/web/b3desk/session.py): `web/b3desk/session.py`
- [Users and groups](https://github.com/numerique-gouv/b3desk/blob/main/web/b3desk/models/users.py): `web/b3desk/models/users.py`
- [Group rules](https://github.com/numerique-gouv/b3desk/blob/main/web/b3desk/models/groups.py): `web/b3desk/models/groups.py`
- [Meeting records](https://github.com/numerique-gouv/b3desk/blob/main/web/b3desk/models/meetings.py): `web/b3desk/models/meetings.py`
- [Access roles](https://github.com/numerique-gouv/b3desk/blob/main/web/b3desk/models/roles.py): `web/b3desk/models/roles.py`
- [Meeting forms](https://github.com/numerique-gouv/b3desk/blob/main/web/b3desk/forms.py): `web/b3desk/forms.py`
- [Application database](https://github.com/numerique-gouv/b3desk/blob/main/web/b3desk/models/__init__.py): `web/b3desk/models/__init__.py`

### Conference and files

- [BigBlueButton API](https://github.com/numerique-gouv/b3desk/blob/main/web/b3desk/models/bbb.py): `web/b3desk/models/bbb.py`
- [Nextcloud integration](https://github.com/numerique-gouv/b3desk/blob/main/web/b3desk/nextcloud.py): `web/b3desk/nextcloud.py`
- [Recording processing](https://github.com/numerique-gouv/b3desk/blob/main/web/b3desk/models/bbb.py): `web/b3desk/models/bbb.py`

### Background work

- [Async tasks](https://github.com/numerique-gouv/b3desk/blob/main/web/b3desk/tasks.py): `web/b3desk/tasks.py`
- [Cache](https://github.com/numerique-gouv/b3desk/blob/main/web/b3desk/__init__.py): `web/b3desk/__init__.py`

### Other components

- **Meeting user**
- **BigBlueButton service**

## Connections

- Meeting user → Flask application: uses
- Flask application → Meeting management: registers routes (evidence: `web/b3desk/__init__.py`)
- Flask application → Join flow: registers routes (evidence: `web/b3desk/__init__.py`)
- Flask application → Meeting files: registers routes (evidence: `web/b3desk/__init__.py`)
- Flask application → Administration: registers routes (evidence: `web/b3desk/__init__.py`)
- Flask application → BBB callbacks: registers routes (evidence: `web/b3desk/__init__.py`)
- Flask application → OIDC identity: initializes sessions (evidence: `web/b3desk/__init__.py`)
- Meeting management → Meeting forms: uses forms
- Meeting management → Meeting records: manages settings
- Join flow → BigBlueButton API: supports joining
- Meeting files → Meeting records: associates files (evidence: `web/b3desk/endpoints/meeting_files.py`)
- Meeting files → Nextcloud integration: uses integration (evidence: `web/b3desk/endpoints/meeting_files.py`)
- OIDC identity → Users and groups: resolves identity
- Users and groups → Group rules: queries memberships (evidence: `web/b3desk/models/users.py`)
- Users and groups → Meeting records: queries access (evidence: `web/b3desk/models/users.py`)
- Meeting records → Access roles: uses access levels (evidence: `web/b3desk/models/meetings.py`)
- Meeting records → BigBlueButton API: uses conference API (evidence: `web/b3desk/models/meetings.py`)
- BigBlueButton API → BigBlueButton service: sends API requests
- BBB callbacks → Async tasks: schedules work
- Async tasks → BigBlueButton API: fetches recordings (evidence: `web/b3desk/tasks.py`)
- Async tasks → Recording processing: checks playback (evidence: `web/b3desk/tasks.py`)
- Async tasks → Cache: tracks notifications (evidence: `web/b3desk/tasks.py`)
- Async tasks → Meeting records: loads meeting (evidence: `web/b3desk/tasks.py`)
- Meeting records → Application database: persists records (evidence: `web/b3desk/models/meetings.py`)
