# tri0nic/hackathon-09-26 architecture

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

- Interactive diagram: https://gitdiagram.com/tri0nic/hackathon-09-26
- Repository: https://github.com/tri0nic/hackathon-09-26

## Overview

This is a fire-risk monitoring and response MVP for dispatchers: users inspect forecast alerts and sensor context, review explanations and SMS status, record decisions, and create or execute preventive-maintenance requests. The React interface calls an ASP.NET API, which owns the business workflow and PostgreSQL persistence and delegates predictions to the FastAPI ML service. The ML package also contains a substantial data-preparation and model-training workflow. Unsampled routes and storage behavior are represented at subsystem level; edges are limited to relationships visible in excerpts, the source index, or README.

Main entry points: [`services/web/src/App.tsx`](https://github.com/tri0nic/hackathon-09-26/blob/main/services/web/src/App.tsx) (Risk dashboard), [`services/api/FireRisk.Api/Program.cs`](https://github.com/tri0nic/hackathon-09-26/blob/main/services/api/FireRisk.Api/Program.cs) (HTTP workflow routes), [`services/api/FireRisk.Api/ModelDemoService.cs`](https://github.com/tri0nic/hackathon-09-26/blob/main/services/api/FireRisk.Api/ModelDemoService.cs) (Demo workflow), [`services/ml/src/fire_risk/data/pipeline.py`](https://github.com/tri0nic/hackathon-09-26/blob/main/services/ml/src/fire_risk/data/pipeline.py) (Data preparation)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Dispatcher interface"]
  node_webapp["Risk dashboard<br/>[App.tsx]"]
  node_demopage["Model demo<br/>[ModelDemoPage.tsx]"]
  node_webapi["Web API client<br/>[api.ts]"]
  node_domain["Risk domain logic<br/>[domain.ts]"]
  node_components["Shared UI<br/>[components.tsx]"]
end

subgraph group_api["Workflow API"]
  node_apiapp["HTTP workflow routes<br/>[Program.cs]"]
  node_rules["Business rules<br/>[BusinessRules.cs]"]
  node_modeldemo["Demo workflow"]
  node_scenarios["Scenario catalog"]
  node_calccache["Calculation cache"]
  node_mlclient["ML gateway client<br/>[MlClient.cs]"]
end

subgraph group_mlserve["Prediction service"]
  node_mlapi["FastAPI endpoints<br/>[ml_api.py]"]
  node_inference["Artifact inference<br/>[inference.py]"]
end

subgraph group_mlbuild["ML data and training"]
  node_datapipeline["Data preparation<br/>[pipeline.py]"]
  node_features["Feature engineering<br/>[features.py]"]
  node_quality["Data quality checks<br/>[quality.py]"]
  node_contracts["ML data contracts<br/>[contracts.py]"]
  node_training["Model training<br/>[training.py]"]
end

subgraph group_persist["Operational state"]
  node_pgstore[("PostgreSQL store<br/>[PgStore.cs]")]
  node_postgres[("PostgreSQL")]
end

node_dispatcher(("Dispatcher"))

node_dispatcher -->|"uses"| node_webapp
node_webapp -->|"requests data"| node_webapi
node_webapp -->|"renders"| node_components
node_webapp -->|"uses"| node_domain
node_webapp -->|"renders"| node_demopage
node_demopage -->|"requests demo"| node_webapi
node_webapi -->|"calls HTTP API"| node_apiapp
node_apiapp -->|"reads and writes"| node_pgstore
node_apiapp -->|"invokes"| node_mlclient
node_apiapp -->|"routes demo"| node_modeldemo
node_apiapp -.->|"applies"| node_rules
node_modeldemo -->|"loads scenario"| node_scenarios
node_modeldemo -->|"stores calculation"| node_calccache
node_modeldemo -->|"requests prediction"| node_mlclient
node_mlclient -->|"sends prediction request"| node_mlapi
node_mlapi -->|"runs predictor"| node_inference
node_pgstore -->|"persists workflow state"| node_postgres
node_datapipeline -->|"builds features"| node_features
node_datapipeline -->|"checks quality"| node_quality
node_datapipeline -->|"uses records"| node_contracts
node_training -.->|"trains from prepared data"| node_features
node_training -->|"produces model artifacts"| node_inference

click node_webapp "https://github.com/tri0nic/hackathon-09-26/blob/main/services/web/src/App.tsx"
click node_demopage "https://github.com/tri0nic/hackathon-09-26/blob/main/services/web/src/ModelDemoPage.tsx"
click node_webapi "https://github.com/tri0nic/hackathon-09-26/blob/main/services/web/src/api.ts"
click node_domain "https://github.com/tri0nic/hackathon-09-26/blob/main/services/web/src/domain.ts"
click node_components "https://github.com/tri0nic/hackathon-09-26/blob/main/services/web/src/components.tsx"
click node_apiapp "https://github.com/tri0nic/hackathon-09-26/blob/main/services/api/FireRisk.Api/Program.cs"
click node_rules "https://github.com/tri0nic/hackathon-09-26/blob/main/services/api/FireRisk.Api/Domain/BusinessRules.cs"
click node_modeldemo "https://github.com/tri0nic/hackathon-09-26/blob/main/services/api/FireRisk.Api/ModelDemoService.cs"
click node_scenarios "https://github.com/tri0nic/hackathon-09-26/blob/main/services/api/FireRisk.Api/ModelDemoScenarioCatalog.cs"
click node_calccache "https://github.com/tri0nic/hackathon-09-26/blob/main/services/api/FireRisk.Api/ModelDemoCalculationCache.cs"
click node_mlclient "https://github.com/tri0nic/hackathon-09-26/blob/main/services/api/FireRisk.Api/MlClient.cs"
click node_mlapi "https://github.com/tri0nic/hackathon-09-26/blob/main/services/ml/src/fire_risk/ml_api.py"
click node_inference "https://github.com/tri0nic/hackathon-09-26/blob/main/services/ml/src/fire_risk/ml/inference.py"
click node_datapipeline "https://github.com/tri0nic/hackathon-09-26/blob/main/services/ml/src/fire_risk/data/pipeline.py"
click node_features "https://github.com/tri0nic/hackathon-09-26/blob/main/services/ml/src/fire_risk/data/features.py"
click node_quality "https://github.com/tri0nic/hackathon-09-26/blob/main/services/ml/src/fire_risk/data/quality.py"
click node_contracts "https://github.com/tri0nic/hackathon-09-26/blob/main/services/ml/src/fire_risk/contracts.py"
click node_training "https://github.com/tri0nic/hackathon-09-26/blob/main/services/ml/src/fire_risk/ml/training.py"
click node_pgstore "https://github.com/tri0nic/hackathon-09-26/blob/main/services/api/FireRisk.Api/PgStore.cs"

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_webapp,node_demopage,node_webapi,node_domain,node_components toneBlue
class node_apiapp,node_rules,node_modeldemo,node_scenarios,node_calccache,node_mlclient toneAmber
class node_mlapi,node_inference toneMint
class node_datapipeline,node_features,node_quality,node_contracts,node_training toneRose
class node_pgstore,node_postgres,node_dispatcher toneIndigo
```

## Components

### Dispatcher interface

- [Risk dashboard](https://github.com/tri0nic/hackathon-09-26/blob/main/services/web/src/App.tsx): `services/web/src/App.tsx`
- [Model demo](https://github.com/tri0nic/hackathon-09-26/blob/main/services/web/src/ModelDemoPage.tsx): `services/web/src/ModelDemoPage.tsx`
- [Web API client](https://github.com/tri0nic/hackathon-09-26/blob/main/services/web/src/api.ts): `services/web/src/api.ts`
- [Risk domain logic](https://github.com/tri0nic/hackathon-09-26/blob/main/services/web/src/domain.ts): `services/web/src/domain.ts`
- [Shared UI](https://github.com/tri0nic/hackathon-09-26/blob/main/services/web/src/components.tsx): `services/web/src/components.tsx`

### Workflow API

- [HTTP workflow routes](https://github.com/tri0nic/hackathon-09-26/blob/main/services/api/FireRisk.Api/Program.cs): `services/api/FireRisk.Api/Program.cs`
- [Business rules](https://github.com/tri0nic/hackathon-09-26/blob/main/services/api/FireRisk.Api/Domain/BusinessRules.cs): `services/api/FireRisk.Api/Domain/BusinessRules.cs`
- [Demo workflow](https://github.com/tri0nic/hackathon-09-26/blob/main/services/api/FireRisk.Api/ModelDemoService.cs): `services/api/FireRisk.Api/ModelDemoService.cs`
- [Scenario catalog](https://github.com/tri0nic/hackathon-09-26/blob/main/services/api/FireRisk.Api/ModelDemoScenarioCatalog.cs): `services/api/FireRisk.Api/ModelDemoScenarioCatalog.cs`
- [Calculation cache](https://github.com/tri0nic/hackathon-09-26/blob/main/services/api/FireRisk.Api/ModelDemoCalculationCache.cs): `services/api/FireRisk.Api/ModelDemoCalculationCache.cs`
- [ML gateway client](https://github.com/tri0nic/hackathon-09-26/blob/main/services/api/FireRisk.Api/MlClient.cs): `services/api/FireRisk.Api/MlClient.cs`

### Prediction service

- [FastAPI endpoints](https://github.com/tri0nic/hackathon-09-26/blob/main/services/ml/src/fire_risk/ml_api.py): `services/ml/src/fire_risk/ml_api.py`
- [Artifact inference](https://github.com/tri0nic/hackathon-09-26/blob/main/services/ml/src/fire_risk/ml/inference.py): `services/ml/src/fire_risk/ml/inference.py`

### ML data and training

- [Data preparation](https://github.com/tri0nic/hackathon-09-26/blob/main/services/ml/src/fire_risk/data/pipeline.py): `services/ml/src/fire_risk/data/pipeline.py`
- [Feature engineering](https://github.com/tri0nic/hackathon-09-26/blob/main/services/ml/src/fire_risk/data/features.py): `services/ml/src/fire_risk/data/features.py`
- [Data quality checks](https://github.com/tri0nic/hackathon-09-26/blob/main/services/ml/src/fire_risk/data/quality.py): `services/ml/src/fire_risk/data/quality.py`
- [ML data contracts](https://github.com/tri0nic/hackathon-09-26/blob/main/services/ml/src/fire_risk/contracts.py): `services/ml/src/fire_risk/contracts.py`
- [Model training](https://github.com/tri0nic/hackathon-09-26/blob/main/services/ml/src/fire_risk/ml/training.py): `services/ml/src/fire_risk/ml/training.py`

### Operational state

- [PostgreSQL store](https://github.com/tri0nic/hackathon-09-26/blob/main/services/api/FireRisk.Api/PgStore.cs): `services/api/FireRisk.Api/PgStore.cs`
- **PostgreSQL**

### Other components

- **Dispatcher**

## Connections

- Dispatcher → Risk dashboard: uses (evidence: `README.md`)
- Risk dashboard → Web API client: requests data (evidence: `services/web/src/App.tsx`)
- Risk dashboard → Shared UI: renders (evidence: `services/web/src/App.tsx`)
- Risk dashboard → Risk domain logic: uses (evidence: `services/web/src/App.tsx`)
- Risk dashboard → Model demo: renders (evidence: `services/web/src/App.tsx`)
- Model demo → Web API client: requests demo (evidence: `services/web/src/ModelDemoPage.tsx`)
- Web API client → HTTP workflow routes: calls HTTP API (evidence: `README.md`)
- HTTP workflow routes → PostgreSQL store: reads and writes (evidence: `services/api/FireRisk.Api/Program.cs`)
- HTTP workflow routes → ML gateway client: invokes (evidence: `services/api/FireRisk.Api/Program.cs`)
- HTTP workflow routes → Demo workflow: routes demo (evidence: `services/api/FireRisk.Api/Program.cs`)
- HTTP workflow routes → Business rules: applies
- Demo workflow → Scenario catalog: loads scenario (evidence: `services/api/FireRisk.Api/ModelDemoService.cs`)
- Demo workflow → Calculation cache: stores calculation (evidence: `services/api/FireRisk.Api/ModelDemoService.cs`)
- Demo workflow → ML gateway client: requests prediction (evidence: `services/api/FireRisk.Api/ModelDemoService.cs`)
- ML gateway client → FastAPI endpoints: sends prediction request (evidence: `README.md`)
- FastAPI endpoints → Artifact inference: runs predictor (evidence: `services/ml/src/fire_risk/ml_api.py`)
- PostgreSQL store → PostgreSQL: persists workflow state (evidence: `README.md`)
- Data preparation → Feature engineering: builds features (evidence: `services/ml/src/fire_risk/data/pipeline.py`)
- Data preparation → Data quality checks: checks quality (evidence: `services/ml/src/fire_risk/data/pipeline.py`)
- Data preparation → ML data contracts: uses records (evidence: `services/ml/src/fire_risk/data/pipeline.py`)
- Model training → Feature engineering: trains from prepared data
- Model training → Artifact inference: produces model artifacts (evidence: `services/ml/src/fire_risk/ml/inference.py`)
