# demartinomarco/compogen architecture

> Architecture diagram of the GitHub repository demartinomarco/compogen, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/demartinomarco/compogen
- Repository: https://github.com/demartinomarco/compogen

## Overview

CompoGen is a web workbench for turning software specifications into PlantUML component diagrams and evaluating their quality. The documented user flow is browser configuration and dataset selection, generation through the Python API, and streamed diagram output for viewing; agentic generation adds iterative tool checks. Separate evaluation capabilities cover syntax, CodeBLEU, embeddings, LLM judging, and graph similarity. Edges are limited to relationships shown in excerpts or documented in the README; some unsampled subsystem links are therefore omitted.

Main entry points: [`backend/src/uml_generator/api/generation_service.py`](https://github.com/demartinomarco/compogen/blob/main/backend/src/uml_generator/api/generation_service.py) (Generation service), [`backend/src/uml_generator/evalutation/plantuml_extractor.py`](https://github.com/demartinomarco/compogen/blob/main/backend/src/uml_generator/evalutation/plantuml_extractor.py) (PlantUML extraction), [`frontend/src/lib/features/diagram-generation/components`](https://github.com/demartinomarco/compogen/tree/main/frontend/src/lib/features/diagram-generation/components) (Generation interface), [`backend/src/uml_generator/api/app.py`](https://github.com/demartinomarco/compogen/blob/main/backend/src/uml_generator/api/app.py) (Python REST API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workbench["Web workbench"]
  node_page["Workbench page<br/>[+page.svelte]"]
  node_feature["Generation interface"]
  node_proxy["Svelte API routes"]
  node_render["Diagram rendering route<br/>[+server.ts]"]
end

subgraph group_service["API and orchestration"]
  node_api["Python REST API<br/>[app.py]"]
  node_catalog["Models and datasets<br/>[catalog.py]"]
  node_generation_service["Generation service"]
  node_streaming["Stream aggregation<br/>[streaming.py]"]
end

subgraph group_generation["Diagram generation"]
  node_prompt["Prompt construction<br/>[builders.py]"]
  node_executor["Generation executor"]
  node_registry["Provider registry"]
  node_client["Provider clients<br/>[base.py]"]
  node_tools["Agentic verification tools"]
end

subgraph group_evaluation["Evaluation"]
  node_plantuml["PlantUML extraction"]
  node_syntax["Syntax evaluation<br/>[parser.py]"]
  node_codebleu["CodeBLEU metric"]
  node_embedding["Embedding similarity<br/>[code_embedding.py]"]
  node_graph_similarity["Graph similarity"]
  node_llm_eval["LLM judge<br/>[llm_evaluator.py]"]
  node_eval_presets["Evaluation presets"]
end

subgraph group_state["Data and models"]
  node_inference_domain["Inference data models<br/>[inference.py]"]
  node_model_domain["Model configuration<br/>[models.py]"]
  node_dataset[("Dataset store<br/>[dataset_store.py]")]
  node_evaluation_domain["Evaluation models"]
  node_evaluation_payloads["Evaluation payloads"]
end

node_user(("Workbench user"))
node_model_services{{"Model providers"}}
node_plantuml_renderer{{"PlantUML renderer"}}

node_user -->|"configures"| node_page
node_page -.->|"uses"| node_feature
node_feature -.->|"requests"| node_proxy
node_proxy -->|"HTTP requests"| node_api
node_api -->|"streams generation"| node_generation_service
node_api -->|"loads catalog"| node_catalog
node_api -->|"reads summaries"| node_dataset
node_generation_service -->|"builds prompts"| node_prompt
node_generation_service -->|"runs generation"| node_executor
node_generation_service -->|"selects provider"| node_registry
node_registry -->|"registers clients"| node_client
node_client -->|"calls models"| node_model_services
node_executor -.->|"checks candidates"| node_tools
node_executor -.->|"produces events"| node_inference_domain
node_generation_service -.->|"aggregates events"| node_streaming
node_streaming -->|"SSE stream"| node_proxy
node_feature -.->|"requests rendering"| node_render
node_render -.->|"renders diagram"| node_plantuml_renderer
node_feature -.->|"selects dataset"| node_dataset
node_eval_presets -->|"loads evaluation data"| node_dataset
node_eval_presets -->|"runs judge"| node_llm_eval
node_llm_eval -->|"extracts diagram"| node_plantuml
node_llm_eval -->|"builds judge prompt"| node_prompt
node_llm_eval -->|"obtains client"| node_registry
node_evaluation_domain -->|"uses payload types"| node_evaluation_payloads
node_plantuml -.->|"feeds syntax checks"| node_syntax
node_plantuml -.->|"feeds metric"| node_codebleu
node_plantuml -.->|"feeds similarity"| node_embedding
node_plantuml -.->|"feeds graph matching"| node_graph_similarity
node_model_domain -->|"configures requests"| node_generation_service

click node_page "https://github.com/demartinomarco/compogen/blob/main/frontend/src/routes/%2Bpage.svelte"
click node_feature "https://github.com/demartinomarco/compogen/tree/main/frontend/src/lib/features/diagram-generation/components"
click node_proxy "https://github.com/demartinomarco/compogen/tree/main/frontend/src/routes/api/diagrams"
click node_render "https://github.com/demartinomarco/compogen/blob/main/frontend/src/routes/api/diagrams/render/%2Bserver.ts"
click node_api "https://github.com/demartinomarco/compogen/blob/main/backend/src/uml_generator/api/app.py"
click node_catalog "https://github.com/demartinomarco/compogen/blob/main/backend/src/uml_generator/api/catalog.py"
click node_generation_service "https://github.com/demartinomarco/compogen/blob/main/backend/src/uml_generator/api/generation_service.py"
click node_streaming "https://github.com/demartinomarco/compogen/blob/main/backend/src/uml_generator/inference/streaming.py"
click node_prompt "https://github.com/demartinomarco/compogen/blob/main/backend/src/uml_generator/prompts/builders.py"
click node_executor "https://github.com/demartinomarco/compogen/blob/main/backend/src/uml_generator/inference/generation_executor.py"
click node_registry "https://github.com/demartinomarco/compogen/blob/main/backend/src/uml_generator/inference/provider_registry.py"
click node_client "https://github.com/demartinomarco/compogen/blob/main/backend/src/uml_generator/inference/clients/base.py"
click node_tools "https://github.com/demartinomarco/compogen/tree/main/backend/src/uml_generator/inference/diagram_tools"
click node_inference_domain "https://github.com/demartinomarco/compogen/blob/main/backend/src/uml_generator/domains/inference.py"
click node_model_domain "https://github.com/demartinomarco/compogen/blob/main/backend/src/uml_generator/domains/models.py"
click node_dataset "https://github.com/demartinomarco/compogen/blob/main/backend/src/uml_generator/storage/dataset_store.py"
click node_evaluation_domain "https://github.com/demartinomarco/compogen/blob/main/backend/src/uml_generator/domains/evaluation_models.py"
click node_evaluation_payloads "https://github.com/demartinomarco/compogen/blob/main/backend/src/uml_generator/domains/evaluation_payloads.py"
click node_plantuml "https://github.com/demartinomarco/compogen/blob/main/backend/src/uml_generator/evalutation/plantuml_extractor.py"
click node_syntax "https://github.com/demartinomarco/compogen/blob/main/backend/src/uml_generator/evalutation/plantuml_parser/parser.py"
click node_codebleu "https://github.com/demartinomarco/compogen/blob/main/backend/src/uml_generator/evalutation/codebleu_diagram_evaluator.py"
click node_embedding "https://github.com/demartinomarco/compogen/blob/main/backend/src/uml_generator/evalutation/code_embedding.py"
click node_graph_similarity "https://github.com/demartinomarco/compogen/blob/main/backend/src/uml_generator/evalutation/graph_similarity.py"
click node_llm_eval "https://github.com/demartinomarco/compogen/blob/main/backend/src/uml_generator/inference/llm_evaluator.py"
click node_eval_presets "https://github.com/demartinomarco/compogen/tree/main/backend/src/uml_generator/presets/evaluation"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_page,node_feature,node_proxy,node_render,node_user toneBlue
class node_api,node_catalog,node_generation_service,node_streaming toneAmber
class node_prompt,node_executor,node_registry,node_client,node_tools toneMint
class node_plantuml,node_syntax,node_codebleu,node_embedding,node_graph_similarity,node_llm_eval,node_eval_presets toneRose
class node_inference_domain,node_model_domain,node_dataset,node_evaluation_domain,node_evaluation_payloads,node_model_services,node_plantuml_renderer toneIndigo
```

## Components

### Web workbench

- [Workbench page](https://github.com/demartinomarco/compogen/blob/main/frontend/src/routes/%2Bpage.svelte): `frontend/src/routes/+page.svelte`
- [Generation interface](https://github.com/demartinomarco/compogen/tree/main/frontend/src/lib/features/diagram-generation/components): `frontend/src/lib/features/diagram-generation/components`
- [Svelte API routes](https://github.com/demartinomarco/compogen/tree/main/frontend/src/routes/api/diagrams): `frontend/src/routes/api/diagrams`
- [Diagram rendering route](https://github.com/demartinomarco/compogen/blob/main/frontend/src/routes/api/diagrams/render/%2Bserver.ts): `frontend/src/routes/api/diagrams/render/+server.ts`

### API and orchestration

- [Python REST API](https://github.com/demartinomarco/compogen/blob/main/backend/src/uml_generator/api/app.py): `backend/src/uml_generator/api/app.py`
- [Models and datasets](https://github.com/demartinomarco/compogen/blob/main/backend/src/uml_generator/api/catalog.py): `backend/src/uml_generator/api/catalog.py`
- [Generation service](https://github.com/demartinomarco/compogen/blob/main/backend/src/uml_generator/api/generation_service.py): `backend/src/uml_generator/api/generation_service.py`
- [Stream aggregation](https://github.com/demartinomarco/compogen/blob/main/backend/src/uml_generator/inference/streaming.py): `backend/src/uml_generator/inference/streaming.py`

### Diagram generation

- [Prompt construction](https://github.com/demartinomarco/compogen/blob/main/backend/src/uml_generator/prompts/builders.py): `backend/src/uml_generator/prompts/builders.py`
- [Generation executor](https://github.com/demartinomarco/compogen/blob/main/backend/src/uml_generator/inference/generation_executor.py): `backend/src/uml_generator/inference/generation_executor.py`
- [Provider registry](https://github.com/demartinomarco/compogen/blob/main/backend/src/uml_generator/inference/provider_registry.py): `backend/src/uml_generator/inference/provider_registry.py`
- [Provider clients](https://github.com/demartinomarco/compogen/blob/main/backend/src/uml_generator/inference/clients/base.py): `backend/src/uml_generator/inference/clients/base.py`
- [Agentic verification tools](https://github.com/demartinomarco/compogen/tree/main/backend/src/uml_generator/inference/diagram_tools): `backend/src/uml_generator/inference/diagram_tools`

### Evaluation

- [PlantUML extraction](https://github.com/demartinomarco/compogen/blob/main/backend/src/uml_generator/evalutation/plantuml_extractor.py): `backend/src/uml_generator/evalutation/plantuml_extractor.py`
- [Syntax evaluation](https://github.com/demartinomarco/compogen/blob/main/backend/src/uml_generator/evalutation/plantuml_parser/parser.py): `backend/src/uml_generator/evalutation/plantuml_parser/parser.py`
- [CodeBLEU metric](https://github.com/demartinomarco/compogen/blob/main/backend/src/uml_generator/evalutation/codebleu_diagram_evaluator.py): `backend/src/uml_generator/evalutation/codebleu_diagram_evaluator.py`
- [Embedding similarity](https://github.com/demartinomarco/compogen/blob/main/backend/src/uml_generator/evalutation/code_embedding.py): `backend/src/uml_generator/evalutation/code_embedding.py`
- [Graph similarity](https://github.com/demartinomarco/compogen/blob/main/backend/src/uml_generator/evalutation/graph_similarity.py): `backend/src/uml_generator/evalutation/graph_similarity.py`
- [LLM judge](https://github.com/demartinomarco/compogen/blob/main/backend/src/uml_generator/inference/llm_evaluator.py): `backend/src/uml_generator/inference/llm_evaluator.py`
- [Evaluation presets](https://github.com/demartinomarco/compogen/tree/main/backend/src/uml_generator/presets/evaluation): `backend/src/uml_generator/presets/evaluation`

### Data and models

- [Inference data models](https://github.com/demartinomarco/compogen/blob/main/backend/src/uml_generator/domains/inference.py): `backend/src/uml_generator/domains/inference.py`
- [Model configuration](https://github.com/demartinomarco/compogen/blob/main/backend/src/uml_generator/domains/models.py): `backend/src/uml_generator/domains/models.py`
- [Dataset store](https://github.com/demartinomarco/compogen/blob/main/backend/src/uml_generator/storage/dataset_store.py): `backend/src/uml_generator/storage/dataset_store.py`
- [Evaluation models](https://github.com/demartinomarco/compogen/blob/main/backend/src/uml_generator/domains/evaluation_models.py): `backend/src/uml_generator/domains/evaluation_models.py`
- [Evaluation payloads](https://github.com/demartinomarco/compogen/blob/main/backend/src/uml_generator/domains/evaluation_payloads.py): `backend/src/uml_generator/domains/evaluation_payloads.py`

### Other components

- **Workbench user**
- **Model providers**
- **PlantUML renderer**

## Connections

- Workbench user → Workbench page: configures (evidence: `README.md`)
- Workbench page → Generation interface: uses
- Generation interface → Svelte API routes: requests
- Svelte API routes → Python REST API: HTTP requests (evidence: `README.md`)
- Python REST API → Generation service: streams generation (evidence: `backend/src/uml_generator/api/app.py`)
- Python REST API → Models and datasets: loads catalog (evidence: `backend/src/uml_generator/api/app.py`)
- Python REST API → Dataset store: reads summaries (evidence: `backend/src/uml_generator/api/app.py`)
- Generation service → Prompt construction: builds prompts (evidence: `backend/src/uml_generator/api/generation_service.py`)
- Generation service → Generation executor: runs generation (evidence: `backend/src/uml_generator/api/generation_service.py`)
- Generation service → Provider registry: selects provider (evidence: `backend/src/uml_generator/api/generation_service.py`)
- Provider registry → Provider clients: registers clients (evidence: `backend/src/uml_generator/inference/provider_registry.py`)
- Provider clients → Model providers: calls models (evidence: `README.md`)
- Generation executor → Agentic verification tools: checks candidates (evidence: `README.md`)
- Generation executor → Inference data models: produces events
- Generation service → Stream aggregation: aggregates events (evidence: `backend/src/uml_generator/api/generation_service.py`)
- Stream aggregation → Svelte API routes: SSE stream (evidence: `README.md`)
- Generation interface → Diagram rendering route: requests rendering
- Diagram rendering route → PlantUML renderer: renders diagram
- Generation interface → Dataset store: selects dataset
- Evaluation presets → Dataset store: loads evaluation data (evidence: `backend/src/uml_generator/presets/evaluation/llm_calibration.py`)
- Evaluation presets → LLM judge: runs judge (evidence: `backend/src/uml_generator/presets/evaluation/llm_evaluator.py`)
- LLM judge → PlantUML extraction: extracts diagram (evidence: `backend/src/uml_generator/inference/llm_evaluator.py`)
- LLM judge → Prompt construction: builds judge prompt (evidence: `backend/src/uml_generator/inference/llm_evaluator.py`)
- LLM judge → Provider registry: obtains client (evidence: `backend/src/uml_generator/inference/llm_evaluator.py`)
- Evaluation models → Evaluation payloads: uses payload types (evidence: `backend/src/uml_generator/domains/evaluation_models.py`)
- PlantUML extraction → Syntax evaluation: feeds syntax checks (evidence: `README.md`)
- PlantUML extraction → CodeBLEU metric: feeds metric (evidence: `README.md`)
- PlantUML extraction → Embedding similarity: feeds similarity (evidence: `README.md`)
- PlantUML extraction → Graph similarity: feeds graph matching (evidence: `README.md`)
- Model configuration → Generation service: configures requests (evidence: `backend/src/uml_generator/api/generation_service.py`)
