Architecture Diagrams

These diagrams exist so anyone can understand how the IDP system fits together before reading implementation details. They provide a shared visual model for users, implementers, operators, and maintainers.

The repository uses the C4 model and Mermaid C4 syntax so the same source can be read in GitHub Markdown and in Docusaurus.

User-First Path

• Level 1: User System Context (Current)
• Level 1: User System Context (Target)
• Level 2: User Capability Containers (Current and Target)
• Level 3: User Workflow Components (Current and Target)

Delivery and Implementation Path

• Level 1: Delivery Context (Current and Target)
• Level 2: Implementer Containers (Go net/http stack)
• Level 2: Implementer Containers (Node.js React + Fastify stack)
• Level 2: Implementer Containers (MCP Server)
• Level 3: Component View (Node.js BFF)

Supporting References

• Architecture Decisions

Maintenance Workflow

Diagram source files live in docs/content/architecture/diagrams/.

Generate static SVG assets for external consumers:

make -C docs generate-diagrams

Validate the generation pipeline:

make -C docs check-diagrams