📊 Architecture Diagrams

System Architecture Diagrams

Visual representations of BlueRobin's architecture using Mermaid diagrams. Each diagram is interactive and can be embedded in documentation or presentations.

📐 Full C4 Model Available

For the complete interactive C4 model with drill-down navigation (System Context → Container → Component → Deployment), use the Structurizr DSL file:


/architecture/bluerobin.dsl

Open at structurizr.com/dsl or export to PlantUML with structurizr-cli.

🤖 AI

RAG Query Pipeline

Sequence diagram showing the Retrieval Augmented Generation (RAG) query flow

Sequence Diagram View Diagram →

📄 Architecture

Document Ingestion Pipeline

Flowchart showing the complete document processing pipeline from upload to searchable

Flowchart View Diagram →

📬 Architecture

Event-Driven Architecture

Sequence diagram showing NATS JetStream event flow for document processing

Sequence Diagram View Diagram →

☸️ Infrastructure

Kubernetes Deployment

Architecture diagram showing K3s cluster deployment topology and namespace organization

Architecture Diagram View Diagram →

🏛️ DDD

Domain Model

Class diagram showing the DDD domain model with aggregates, entities, and value objects

Class Diagram View Diagram →

🔄 DevOps

CI/CD Pipeline

Flowchart showing the GitOps-based CI/CD pipeline with GitHub Actions and FluxCD

Flowchart View Diagram →

🔗 Architecture

Microservices Communication

C4 Container diagram showing service-to-service communication patterns

C4 Diagram View Diagram →

⚡ Architecture

CQRS Pattern

Component diagram showing Command Query Responsibility Segregation implementation

Component Diagram View Diagram →

Diagram Types Used

Sequence Diagrams

Show interactions between components over time

Flowcharts

Illustrate process flows and decision points

Class Diagrams

Model domain entities and relationships

C4 Diagrams

Multi-level architecture visualization

Using These Diagrams

Embedding in Documentation

All diagrams use Mermaid syntax and can be embedded in:

GitHub README files (native Mermaid support)
Notion pages (via Mermaid code blocks)
Confluence (via Mermaid macro)
MkDocs (via mermaid2 plugin)

Exporting to Images

Use the Mermaid CLI to export:

npx @mermaid-js/mermaid-cli -i diagram.md -o diagram.svg

Structurizr DSL

The comprehensive C4 model in /architecture/bluerobin.dsl can be:

Rendered interactively at structurizr.com
Exported to PlantUML, PNG, or SVG
Embedded in architecture documentation