How numerique-gouv/b3desk works
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: __init__.py Flask application · meetings.py Meeting records · tasks.py Async tasks · bbb.py BigBlueButton API
Components 20
Web application
- Flask application
web/b3desk/__init__.py - Meeting management
web/b3desk/endpoints/meetings.py - Join flow
web/b3desk/endpoints/join.py - Meeting files
web/b3desk/endpoints/meeting_files.py - Administration
web/b3desk/endpoints/admin.py - BBB callbacks
web/b3desk/endpoints/bbb_callback.py
Identity and meeting domain
- OIDC identity
web/b3desk/session.py - Users and groups
web/b3desk/models/users.py - Group rules
web/b3desk/models/groups.py - Meeting records
web/b3desk/models/meetings.py - Access roles
web/b3desk/models/roles.py - Meeting forms
web/b3desk/forms.py - Application database
web/b3desk/models/__init__.py
Conference and files
- BigBlueButton API
web/b3desk/models/bbb.py - Nextcloud integration
web/b3desk/nextcloud.py - Recording processing
web/b3desk/models/bbb.py
Background work
- Async tasks
web/b3desk/tasks.py - Cache
web/b3desk/__init__.py
Other components
- Meeting user
- BigBlueButton service
Connections 24
- Meeting user → Flask application: uses
- Flask application → Meeting management: registers routes
web/b3desk/__init__.py - Flask application → Join flow: registers routes
web/b3desk/__init__.py - Flask application → Meeting files: registers routes
web/b3desk/__init__.py - Flask application → Administration: registers routes
web/b3desk/__init__.py - Flask application → BBB callbacks: registers routes
web/b3desk/__init__.py - Flask application → OIDC identity: initializes sessions
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
web/b3desk/endpoints/meeting_files.py - Meeting files → Nextcloud integration: uses integration
web/b3desk/endpoints/meeting_files.py - OIDC identity → Users and groups: resolves identity
- Users and groups → Group rules: queries memberships
web/b3desk/models/users.py - Users and groups → Meeting records: queries access
web/b3desk/models/users.py - Meeting records → Access roles: uses access levels
web/b3desk/models/meetings.py - Meeting records → BigBlueButton API: uses conference API
web/b3desk/models/meetings.py - BigBlueButton API → BigBlueButton service: sends API requests
- BBB callbacks → Async tasks: schedules work
- Async tasks → BigBlueButton API: fetches recordings
web/b3desk/tasks.py - Async tasks → Recording processing: checks playback
web/b3desk/tasks.py - Async tasks → Cache: tracks notifications
web/b3desk/tasks.py - Async tasks → Meeting records: loads meeting
web/b3desk/tasks.py - Meeting records → Application database: persists records
web/b3desk/models/meetings.py