How brepublic/quorum works
Quorum is a self-hosted Model UN committee-management web application. Users enter through the browser UI and same-origin API; the server authenticates them, applies committee and proceedings rules, and persists changes in PostgreSQL. Its domain spans committee setup, live proceedings and voting, collaborative files, search, and storage administration. The optional Chair Local Agent connects through a separate server integration. The README documents the product workflow and capabilities; source excerpts and the SOURCE INDEX support the more specific server relationships shown. Unsampled subsystems are represented at their exact enclosing directories where details are limited.
Main entry points: app.ts HTTP API · file-service.ts File and upload services · stage4/service.ts Committee setup · stage3/service.ts Rules and operation
Components 22
Browser client
- Self-hosted UI
src/pages/self-hosted - API client
src/services/self-hosted-api.ts
Server and identity
- HTTP API
server/src/http/app.ts - Identity and sessions
server/src/modules/identity - PostgreSQL
- Shared contracts
packages/contracts/src/domain.ts
Committee workflow
- Committee setup
server/src/modules/stage4/service.ts - Rules and operation
server/src/modules/stage3/service.ts - Meetings and voting
server/src/modules/stage5/service.ts - Crisis management
server/src/modules/stage5/crises.ts - Search
server/src/modules/search
Files and storage
- Delegate file review
server/src/modules/delegate-files/service.ts - File and upload services
server/src/modules/storage/file-service.ts - Storage providers
server/src/modules/storage/service.ts - S3 configuration
server/src/modules/storage/s3-config-service.ts - Upload staging
server/src/modules/storage/staging.ts - Storage cache
server/src/modules/operations/storage-cache-service.ts - Archive and audit
server/src/modules/operations
Local agent
- Chair Local Agent
packages/storage-agent/src - Agent coordination
server/src/modules/storage-agent/service.ts - Agent event stream
server/src/http/storage-agent-sse.ts
Other components
- Committee user
Connections 27
- Committee user → Self-hosted UI: uses
README.md - Self-hosted UI → API client: requests API
src/pages/self-hosted/StorageAdminPanel.tsx - API client → HTTP API: calls same-origin API
README.md - HTTP API → Identity and sessions: authenticates requests
server/src/http/app.ts - HTTP API → Committee setup: routes committee actions
server/src/http/app.ts - HTTP API → Rules and operation: routes rule actions
server/src/http/app.ts - HTTP API → Meetings and voting: routes proceedings
server/src/http/app.ts - HTTP API → Delegate file review: routes file actions
server/src/http/app.ts - HTTP API → File and upload services: routes downloads
server/src/http/app.ts - HTTP API → Agent event stream: routes event stream
server/src/http/app.ts - Agent event stream → Agent coordination: streams events
server/src/http/storage-agent-sse.ts - Chair Local Agent → Agent coordination: connects optionally
- Committee setup → PostgreSQL: persists committee data
- Rules and operation → PostgreSQL: stores rule state
- Meetings and voting → PostgreSQL: records votes
- Committee setup → Shared contracts: uses shared types
server/src/modules/stage4/service.ts - Rules and operation → Crisis management: closes crisis groups
server/src/modules/stage3/service.ts - Meetings and voting → Crisis management: reconciles crisis results
server/src/modules/stage5/service.ts - Committee setup → Search: indexes workspace
server/src/modules/stage4/service.ts - Delegate file review → File and upload services: lists and reviews files
server/src/modules/delegate-files/service.ts - File and upload services → Storage providers: uses storage services
server/src/modules/storage/file-service.ts - File and upload services → Upload staging: uses upload staging
server/src/modules/storage/file-service.ts - File and upload services → S3 configuration: uses provider config
server/src/modules/storage/file-service.ts - Storage cache → PostgreSQL: reads cache state
server/src/modules/operations/storage-cache-service.ts - Archive and audit → PostgreSQL: records operations
- Agent coordination → Identity and sessions: checks manager access
server/src/modules/storage-agent/service.ts - HTTP API → Shared contracts: formats API responses
server/src/http/app.ts