# figuejojo/qualitygatehub architecture

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

- Interactive diagram: https://gitdiagram.com/figuejojo/qualitygatehub
- Repository: https://github.com/figuejojo/qualitygatehub

## Overview

Quality Gate Dashboard accepts CI workflow results over HTTP, validates and queues them, persists runs and check metadata in SQLite, computes trend verdicts, and streams updates to the browser over SSE. The graph separates HTTP/presentation, application use cases, domain rules, and runtime adapters. Relationships are grounded in the excerpts and README; frontend internals and several adapter details were not sampled, so those links are limited to documented behavior.

Main entry points: [`src/backend/interfaces/http_server.py`](https://github.com/figuejojo/qualitygatehub/blob/Develop/src/backend/interfaces/http_server.py) (HTTP API), [`src/backend/bootstrap.py`](https://github.com/figuejojo/qualitygatehub/blob/Develop/src/backend/bootstrap.py) (Application assembly), [`src/backend/infrastructure/sqlite_store.py`](https://github.com/figuejojo/qualitygatehub/blob/Develop/src/backend/infrastructure/sqlite_store.py) (SQLite repositories), [`src/backend/application/simulation_service.py`](https://github.com/figuejojo/qualitygatehub/blob/Develop/src/backend/application/simulation_service.py) (Demo simulation)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interfaces["HTTP and browser"]
  node_http["HTTP API<br/>[http_server.py]"]
  node_presenters["Response presenters<br/>[presenters.py]"]
  node_frontend["Dashboard page<br/>[index.html]"]
end

subgraph group_application["Application services"]
  node_ingest["Ingest service<br/>[ingest_service.py]"]
  node_simulation["Demo simulation"]
  node_check_service["Check management<br/>[check_service.py]"]
  node_dashboard_service["Dashboard queries"]
  node_worker["Run worker<br/>[worker.py]"]
end

subgraph group_domain["Domain rules"]
  node_models["Run and check models<br/>[models.py]"]
  node_validator["Payload validation<br/>[validators.py]"]
  node_policies["Status and trend rules<br/>[policies.py]"]
end

subgraph group_runtime["Runtime adapters"]
  node_bootstrap["Application assembly<br/>[bootstrap.py]"]
  node_queue["Run queue<br/>[memory_queue.py]"]
  node_events["SSE event hub<br/>[event_hub.py]"]
  node_store[("SQLite repositories<br/>[sqlite_store.py]")]
end

node_ci(("CI pipeline"))
node_browser(("Browser"))

node_ci -->|"posts results"| node_http
node_http -->|"routes ingest"| node_ingest
node_http -->|"routes simulation"| node_simulation
node_http -->|"updates checks"| node_check_service
node_http -->|"queries dashboard"| node_dashboard_service
node_http -->|"serves page"| node_frontend
node_http -->|"formats responses"| node_presenters
node_http -->|"streams events"| node_events
node_ingest -->|"validates payload"| node_validator
node_ingest -->|"reads check kinds"| node_store
node_ingest -->|"enqueues command"| node_queue
node_simulation -->|"reads prior values"| node_store
node_simulation -->|"reads check kinds"| node_store
node_simulation -->|"validates payload"| node_validator
node_simulation -->|"enqueues command"| node_queue
node_check_service -->|"persists definitions"| node_store
node_dashboard_service -->|"reads dashboard"| node_store
node_worker -->|"consumes commands"| node_queue
node_worker -->|"persists runs"| node_store
node_worker -->|"publishes updates"| node_events
node_validator -->|"creates command"| node_models
node_validator -->|"normalizes status"| node_policies
node_store -->|"judges trends"| node_policies
node_bootstrap -->|"assembles"| node_ingest
node_bootstrap -->|"assembles"| node_simulation
node_bootstrap -->|"assembles"| node_check_service
node_bootstrap -->|"assembles"| node_dashboard_service
node_bootstrap -->|"starts worker"| node_worker
node_bootstrap -->|"configures store"| node_store
node_bootstrap -->|"configures queue"| node_queue
node_bootstrap -->|"configures events"| node_events
node_browser -->|"requests dashboard"| node_http
node_events -->|"pushes SSE updates"| node_browser

click node_http "https://github.com/figuejojo/qualitygatehub/blob/Develop/src/backend/interfaces/http_server.py"
click node_presenters "https://github.com/figuejojo/qualitygatehub/blob/Develop/src/backend/interfaces/presenters.py"
click node_frontend "https://github.com/figuejojo/qualitygatehub/blob/Develop/src/frontend/index.html"
click node_ingest "https://github.com/figuejojo/qualitygatehub/blob/Develop/src/backend/application/ingest_service.py"
click node_simulation "https://github.com/figuejojo/qualitygatehub/blob/Develop/src/backend/application/simulation_service.py"
click node_check_service "https://github.com/figuejojo/qualitygatehub/blob/Develop/src/backend/application/check_service.py"
click node_dashboard_service "https://github.com/figuejojo/qualitygatehub/blob/Develop/src/backend/application/dashboard_service.py"
click node_worker "https://github.com/figuejojo/qualitygatehub/blob/Develop/src/backend/application/worker.py"
click node_models "https://github.com/figuejojo/qualitygatehub/blob/Develop/src/backend/domain/models.py"
click node_validator "https://github.com/figuejojo/qualitygatehub/blob/Develop/src/backend/domain/validators.py"
click node_policies "https://github.com/figuejojo/qualitygatehub/blob/Develop/src/backend/domain/policies.py"
click node_bootstrap "https://github.com/figuejojo/qualitygatehub/blob/Develop/src/backend/bootstrap.py"
click node_queue "https://github.com/figuejojo/qualitygatehub/blob/Develop/src/backend/infrastructure/memory_queue.py"
click node_events "https://github.com/figuejojo/qualitygatehub/blob/Develop/src/backend/infrastructure/event_hub.py"
click node_store "https://github.com/figuejojo/qualitygatehub/blob/Develop/src/backend/infrastructure/sqlite_store.py"

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_http,node_presenters,node_frontend,node_browser toneBlue
class node_ingest,node_simulation,node_check_service,node_dashboard_service,node_worker toneAmber
class node_models,node_validator,node_policies toneMint
class node_bootstrap,node_queue,node_events,node_store toneRose
class node_ci toneIndigo
```

## Components

### HTTP and browser

- [HTTP API](https://github.com/figuejojo/qualitygatehub/blob/Develop/src/backend/interfaces/http_server.py): `src/backend/interfaces/http_server.py`
- [Response presenters](https://github.com/figuejojo/qualitygatehub/blob/Develop/src/backend/interfaces/presenters.py): `src/backend/interfaces/presenters.py`
- [Dashboard page](https://github.com/figuejojo/qualitygatehub/blob/Develop/src/frontend/index.html): `src/frontend/index.html`

### Application services

- [Ingest service](https://github.com/figuejojo/qualitygatehub/blob/Develop/src/backend/application/ingest_service.py): `src/backend/application/ingest_service.py`
- [Demo simulation](https://github.com/figuejojo/qualitygatehub/blob/Develop/src/backend/application/simulation_service.py): `src/backend/application/simulation_service.py`
- [Check management](https://github.com/figuejojo/qualitygatehub/blob/Develop/src/backend/application/check_service.py): `src/backend/application/check_service.py`
- [Dashboard queries](https://github.com/figuejojo/qualitygatehub/blob/Develop/src/backend/application/dashboard_service.py): `src/backend/application/dashboard_service.py`
- [Run worker](https://github.com/figuejojo/qualitygatehub/blob/Develop/src/backend/application/worker.py): `src/backend/application/worker.py`

### Domain rules

- [Run and check models](https://github.com/figuejojo/qualitygatehub/blob/Develop/src/backend/domain/models.py): `src/backend/domain/models.py`
- [Payload validation](https://github.com/figuejojo/qualitygatehub/blob/Develop/src/backend/domain/validators.py): `src/backend/domain/validators.py`
- [Status and trend rules](https://github.com/figuejojo/qualitygatehub/blob/Develop/src/backend/domain/policies.py): `src/backend/domain/policies.py`

### Runtime adapters

- [Application assembly](https://github.com/figuejojo/qualitygatehub/blob/Develop/src/backend/bootstrap.py): `src/backend/bootstrap.py`
- [Run queue](https://github.com/figuejojo/qualitygatehub/blob/Develop/src/backend/infrastructure/memory_queue.py): `src/backend/infrastructure/memory_queue.py`
- [SSE event hub](https://github.com/figuejojo/qualitygatehub/blob/Develop/src/backend/infrastructure/event_hub.py): `src/backend/infrastructure/event_hub.py`
- [SQLite repositories](https://github.com/figuejojo/qualitygatehub/blob/Develop/src/backend/infrastructure/sqlite_store.py): `src/backend/infrastructure/sqlite_store.py`

### Other components

- **CI pipeline**
- **Browser**

## Connections

- CI pipeline → HTTP API: posts results (evidence: `README.md`)
- HTTP API → Ingest service: routes ingest (evidence: `src/backend/interfaces/http_server.py`)
- HTTP API → Demo simulation: routes simulation (evidence: `src/backend/interfaces/http_server.py`)
- HTTP API → Check management: updates checks (evidence: `src/backend/interfaces/http_server.py`)
- HTTP API → Dashboard queries: queries dashboard (evidence: `src/backend/interfaces/http_server.py`)
- HTTP API → Dashboard page: serves page (evidence: `src/backend/interfaces/http_server.py`)
- HTTP API → Response presenters: formats responses (evidence: `src/backend/interfaces/http_server.py`)
- HTTP API → SSE event hub: streams events (evidence: `src/backend/interfaces/http_server.py`)
- Ingest service → Payload validation: validates payload (evidence: `src/backend/application/ingest_service.py`)
- Ingest service → SQLite repositories: reads check kinds (evidence: `src/backend/application/ingest_service.py`)
- Ingest service → Run queue: enqueues command (evidence: `src/backend/application/ingest_service.py`)
- Demo simulation → SQLite repositories: reads prior values (evidence: `src/backend/application/simulation_service.py`)
- Demo simulation → SQLite repositories: reads check kinds (evidence: `src/backend/application/simulation_service.py`)
- Demo simulation → Payload validation: validates payload (evidence: `src/backend/application/simulation_service.py`)
- Demo simulation → Run queue: enqueues command (evidence: `src/backend/application/simulation_service.py`)
- Check management → SQLite repositories: persists definitions (evidence: `src/backend/application/check_service.py`)
- Dashboard queries → SQLite repositories: reads dashboard (evidence: `src/backend/application/dashboard_service.py`)
- Run worker → Run queue: consumes commands (evidence: `src/backend/application/worker.py`)
- Run worker → SQLite repositories: persists runs (evidence: `src/backend/application/worker.py`)
- Run worker → SSE event hub: publishes updates (evidence: `src/backend/application/worker.py`)
- Payload validation → Run and check models: creates command (evidence: `src/backend/domain/validators.py`)
- Payload validation → Status and trend rules: normalizes status (evidence: `src/backend/domain/validators.py`)
- SQLite repositories → Status and trend rules: judges trends (evidence: `src/backend/infrastructure/sqlite_store.py`)
- Application assembly → Ingest service: assembles (evidence: `src/backend/bootstrap.py`)
- Application assembly → Demo simulation: assembles (evidence: `src/backend/bootstrap.py`)
- Application assembly → Check management: assembles (evidence: `src/backend/bootstrap.py`)
- Application assembly → Dashboard queries: assembles (evidence: `src/backend/bootstrap.py`)
- Application assembly → Run worker: starts worker (evidence: `src/backend/bootstrap.py`)
- Application assembly → SQLite repositories: configures store (evidence: `src/backend/bootstrap.py`)
- Application assembly → Run queue: configures queue (evidence: `src/backend/bootstrap.py`)
- Application assembly → SSE event hub: configures events (evidence: `src/backend/bootstrap.py`)
- Browser → HTTP API: requests dashboard (evidence: `README.md`)
- SSE event hub → Browser: pushes SSE updates (evidence: `README.md`)
