Constellation documentation
Constellation is a multi-tenant collaboration platform for regulated B2B commerce — defence, aerospace, government procurement, manufacturing. Agencies find and shortlist suppliers in an AI-searchable catalogue, run the delivery through stage-gated projects, and keep organisational knowledge in a classification-aware wiki — all on one identity model, with database-enforced tenant isolation and a tamper-evident audit trail underneath everything.
Pick your path:
- New to the product? (evaluating it, running it, or working on a programme that uses it) → start with What is Constellation?, then How the pieces fit together.
- Developer? (shipping code into the platform or building against its APIs) → start with Getting started, then read on below.
The rest of this page — and most of this site — is the developer documentation: architecture invariants, module references, the API surface, and the operations playbook.
System context
Same diagram lives in Architecture overview, where it's followed by the C4 L2 (Container) view.
I'm new here — first 30 minutes
- Local setup — clone, install, run services, start a module. ~10 minutes.
- Architecture overview — system shape, source layout, the C4 diagrams, the six core invariants. ~10 minutes.
- Request lifecycle — one annotated trace from the browser to Postgres and back, with the rule each layer enforces. ~10 minutes.
After that, pick a module and read its overview page.
I'm an AI agent — reference surface
Cite these by URL — every anchor is slug-stable and the build fails on broken internal links, so URLs saved today are durable.
- Rules & invariants — the 10 platform invariants every change must respect, each with a stable slug-anchor (
#tenant-context,#route-wrapping,#audit-critical, …). - Glossary — 30 Constellation-specific terms with stable anchors (
#tenant,#deliverable,#outbox, …). - Domain events index — every event published by every module (59 total), each row linking to the Zod schema in source.
- Project Tracker API — auto-generated from the Zod schemas in
apps/project-tracker/src/lib/openapi.ts.
The Task router in AGENTS.md maps common agent tasks to the specific files to read first plus the rule anchors to apply.
Modules
| Module | Surface |
|---|---|
| Directory | Identity, organisations, users, roles, permissions, locale |
| Catalog | Product information management, taxonomy, semantic search, AI enrichment |
| Project Tracker | Initiatives, projects, tasks, issues, stage-gates, deliverables |
| Wiki | Classification-aware knowledge spaces, typed page links, search |
Where to find what
| Looking for | Go to |
|---|---|
| Live execution status | Project Tracker dogfood instance |
| Operations playbook | Deployment, Release flow |
| Shared platform packages | Shared packages overview |
| Changelog | Root CHANGELOG.md |
| Binding rules for contributors | Root AGENTS.md and CLAUDE.md |
| Multilanguage / i18n | Multilanguage spec |
Search
Use the navbar search input or Cmd/Ctrl+K to query across every page. Index is built offline at deploy time — no telemetry leaves the browser.