# peregrinadiego-byte/openapu architecture

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

- Interactive diagram: https://gitdiagram.com/peregrinadiego-byte/openapu
- Repository: https://github.com/peregrinadiego-byte/openapu

## Overview

OpenAPU is a construction-cost management application: users work through a web interface and HTTP API to maintain resources, build unit-price analyses (APUs), apply them to concepts, and assemble budgets. Application handlers coordinate domain rules through repository abstractions; SQLite repositories persist the resulting data. The README also documents CSV exchange, HTML reports, database backup, readiness checks, diagnostics, and optional administrative access. Some feature wiring is documented or indexed but not excerpted, so those links cite the README or the indexed API entry point rather than implying source inspection.

Main entry points: [`src/OpenAPU.Api/Program.cs`](https://github.com/peregrinadiego-byte/openapu/blob/master/src/OpenAPU.Api/Program.cs) (HTTP API), [`src/OpenAPU.Application/Abstractions`](https://github.com/peregrinadiego-byte/openapu/tree/master/src/OpenAPU.Application/Abstractions) (Repository abstractions), [`src/OpenAPU.Application/Apus`](https://github.com/peregrinadiego-byte/openapu/tree/master/src/OpenAPU.Application/Apus) (APU management), [`src/OpenAPU.Application/Concepts`](https://github.com/peregrinadiego-byte/openapu/tree/master/src/OpenAPU.Application/Concepts) (Concept management)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API and operations"]
  node_webui["Web interface<br/>[app.js]"]
  node_httpapi["HTTP API<br/>[Program.cs]"]
  node_startup["Startup validation"]
  node_observability["Request observability"]
  node_admin["Admin access"]
  node_diagnostics["Diagnostics"]
end

subgraph group_application["Cost workflows"]
  node_resources["Resource management<br/>[Resources]"]
  node_apus["APU management<br/>[Apus]"]
  node_concepts["Concept management<br/>[Concepts]"]
  node_budgets["Budget management<br/>[Budgets]"]
  node_repoports["Repository abstractions<br/>[Abstractions]"]
end

subgraph group_domain["Cost domain"]
  node_domain["Cost domain model<br/>[OpenAPU.Domain]"]
end

subgraph group_storage["Persistence and backup"]
  node_sqlite[("SQLite database")]
  node_sqlrepos["SQLite repositories<br/>[Repositories]"]
  node_backup["Database transfer"]
end

subgraph group_outputs["Exchange and reports"]
  node_csvimport["CSV resource import"]
  node_csvexport["CSV export"]
  node_htmlreport["HTML reports"]
end

node_user(("OpenAPU user"))

node_user -->|"uses"| node_webui
node_webui -.->|"calls HTTP"| node_httpapi
node_httpapi -->|"routes requests"| node_resources
node_httpapi -->|"routes requests"| node_apus
node_httpapi -->|"routes requests"| node_concepts
node_httpapi -->|"routes requests"| node_budgets
node_resources -.->|"uses"| node_repoports
node_apus -->|"uses"| node_repoports
node_concepts -->|"uses"| node_repoports
node_budgets -->|"uses"| node_repoports
node_apus -->|"updates"| node_domain
node_concepts -->|"calculates with"| node_domain
node_budgets -->|"updates"| node_domain
node_httpapi -->|"registers repositories"| node_sqlrepos
node_sqlrepos -->|"reads and writes"| node_sqlite
node_httpapi -->|"validates startup"| node_startup
node_httpapi -.->|"configures middleware"| node_observability
node_httpapi -.->|"configures access"| node_admin
node_httpapi -->|"uses diagnostics"| node_diagnostics
node_httpapi -->|"exposes backup"| node_backup
node_httpapi -->|"exposes import"| node_csvimport
node_httpapi -.->|"offers export"| node_csvexport
node_httpapi -.->|"offers reports"| node_htmlreport

click node_webui "https://github.com/peregrinadiego-byte/openapu/blob/master/src/OpenAPU.Api/wwwroot/app.js"
click node_httpapi "https://github.com/peregrinadiego-byte/openapu/blob/master/src/OpenAPU.Api/Program.cs"
click node_startup "https://github.com/peregrinadiego-byte/openapu/blob/master/src/OpenAPU.Api/Configuration/DatabaseStartupValidator.cs"
click node_observability "https://github.com/peregrinadiego-byte/openapu/blob/master/src/OpenAPU.Api/Observability/RequestObservabilityMiddleware.cs"
click node_admin "https://github.com/peregrinadiego-byte/openapu/blob/master/src/OpenAPU.Api/Security/AdminAccessMiddleware.cs"
click node_diagnostics "https://github.com/peregrinadiego-byte/openapu/blob/master/src/OpenAPU.Api/Support/DiagnosticsService.cs"
click node_resources "https://github.com/peregrinadiego-byte/openapu/tree/master/src/OpenAPU.Application/Resources"
click node_apus "https://github.com/peregrinadiego-byte/openapu/tree/master/src/OpenAPU.Application/Apus"
click node_concepts "https://github.com/peregrinadiego-byte/openapu/tree/master/src/OpenAPU.Application/Concepts"
click node_budgets "https://github.com/peregrinadiego-byte/openapu/tree/master/src/OpenAPU.Application/Budgets"
click node_repoports "https://github.com/peregrinadiego-byte/openapu/tree/master/src/OpenAPU.Application/Abstractions"
click node_domain "https://github.com/peregrinadiego-byte/openapu/tree/master/src/OpenAPU.Domain"
click node_sqlite "https://github.com/peregrinadiego-byte/openapu/blob/master/src/OpenAPU.Infrastructure/Persistence/OpenApuDbContext.cs"
click node_sqlrepos "https://github.com/peregrinadiego-byte/openapu/tree/master/src/OpenAPU.Infrastructure/Repositories"
click node_backup "https://github.com/peregrinadiego-byte/openapu/blob/master/src/OpenAPU.Infrastructure/Backup/SqliteDatabaseTransferService.cs"
click node_csvimport "https://github.com/peregrinadiego-byte/openapu/blob/master/src/OpenAPU.Application/Imports/CsvResourceImportService.cs"
click node_csvexport "https://github.com/peregrinadiego-byte/openapu/blob/master/src/OpenAPU.Application/Exports/CsvExportService.cs"
click node_htmlreport "https://github.com/peregrinadiego-byte/openapu/blob/master/src/OpenAPU.Application/Reports/HtmlReportService.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_webui,node_httpapi,node_startup,node_observability,node_admin,node_diagnostics,node_user toneBlue
class node_resources,node_apus,node_concepts,node_budgets,node_repoports toneAmber
class node_domain toneMint
class node_sqlite,node_sqlrepos,node_backup toneRose
class node_csvimport,node_csvexport,node_htmlreport toneIndigo
```

## Components

### API and operations

- [Web interface](https://github.com/peregrinadiego-byte/openapu/blob/master/src/OpenAPU.Api/wwwroot/app.js): `src/OpenAPU.Api/wwwroot/app.js`
- [HTTP API](https://github.com/peregrinadiego-byte/openapu/blob/master/src/OpenAPU.Api/Program.cs): `src/OpenAPU.Api/Program.cs`
- [Startup validation](https://github.com/peregrinadiego-byte/openapu/blob/master/src/OpenAPU.Api/Configuration/DatabaseStartupValidator.cs): `src/OpenAPU.Api/Configuration/DatabaseStartupValidator.cs`
- [Request observability](https://github.com/peregrinadiego-byte/openapu/blob/master/src/OpenAPU.Api/Observability/RequestObservabilityMiddleware.cs): `src/OpenAPU.Api/Observability/RequestObservabilityMiddleware.cs`
- [Admin access](https://github.com/peregrinadiego-byte/openapu/blob/master/src/OpenAPU.Api/Security/AdminAccessMiddleware.cs): `src/OpenAPU.Api/Security/AdminAccessMiddleware.cs`
- [Diagnostics](https://github.com/peregrinadiego-byte/openapu/blob/master/src/OpenAPU.Api/Support/DiagnosticsService.cs): `src/OpenAPU.Api/Support/DiagnosticsService.cs`

### Cost workflows

- [Resource management](https://github.com/peregrinadiego-byte/openapu/tree/master/src/OpenAPU.Application/Resources): `src/OpenAPU.Application/Resources`
- [APU management](https://github.com/peregrinadiego-byte/openapu/tree/master/src/OpenAPU.Application/Apus): `src/OpenAPU.Application/Apus`
- [Concept management](https://github.com/peregrinadiego-byte/openapu/tree/master/src/OpenAPU.Application/Concepts): `src/OpenAPU.Application/Concepts`
- [Budget management](https://github.com/peregrinadiego-byte/openapu/tree/master/src/OpenAPU.Application/Budgets): `src/OpenAPU.Application/Budgets`
- [Repository abstractions](https://github.com/peregrinadiego-byte/openapu/tree/master/src/OpenAPU.Application/Abstractions): `src/OpenAPU.Application/Abstractions`

### Cost domain

- [Cost domain model](https://github.com/peregrinadiego-byte/openapu/tree/master/src/OpenAPU.Domain): `src/OpenAPU.Domain`

### Persistence and backup

- [SQLite database](https://github.com/peregrinadiego-byte/openapu/blob/master/src/OpenAPU.Infrastructure/Persistence/OpenApuDbContext.cs): `src/OpenAPU.Infrastructure/Persistence/OpenApuDbContext.cs`
- [SQLite repositories](https://github.com/peregrinadiego-byte/openapu/tree/master/src/OpenAPU.Infrastructure/Repositories): `src/OpenAPU.Infrastructure/Repositories`
- [Database transfer](https://github.com/peregrinadiego-byte/openapu/blob/master/src/OpenAPU.Infrastructure/Backup/SqliteDatabaseTransferService.cs): `src/OpenAPU.Infrastructure/Backup/SqliteDatabaseTransferService.cs`

### Exchange and reports

- [CSV resource import](https://github.com/peregrinadiego-byte/openapu/blob/master/src/OpenAPU.Application/Imports/CsvResourceImportService.cs): `src/OpenAPU.Application/Imports/CsvResourceImportService.cs`
- [CSV export](https://github.com/peregrinadiego-byte/openapu/blob/master/src/OpenAPU.Application/Exports/CsvExportService.cs): `src/OpenAPU.Application/Exports/CsvExportService.cs`
- [HTML reports](https://github.com/peregrinadiego-byte/openapu/blob/master/src/OpenAPU.Application/Reports/HtmlReportService.cs): `src/OpenAPU.Application/Reports/HtmlReportService.cs`

### Other components

- **OpenAPU user**

## Connections

- OpenAPU user → Web interface: uses
- Web interface → HTTP API: calls HTTP
- HTTP API → Resource management: routes requests (evidence: `src/OpenAPU.Api/Program.cs`)
- HTTP API → APU management: routes requests (evidence: `src/OpenAPU.Api/Program.cs`)
- HTTP API → Concept management: routes requests (evidence: `src/OpenAPU.Api/Program.cs`)
- HTTP API → Budget management: routes requests (evidence: `src/OpenAPU.Api/Program.cs`)
- Resource management → Repository abstractions: uses (evidence: `src/OpenAPU.Application/Resources/CreateResourceHandler.cs`)
- APU management → Repository abstractions: uses (evidence: `src/OpenAPU.Application/Apus/RefreshApuPricesHandler.cs`)
- Concept management → Repository abstractions: uses (evidence: `src/OpenAPU.Application/Concepts/CreateConceptHandler.cs`)
- Budget management → Repository abstractions: uses (evidence: `src/OpenAPU.Application/Budgets/AddBudgetItemHandler.cs`)
- APU management → Cost domain model: updates (evidence: `src/OpenAPU.Domain/Apu.cs`)
- Concept management → Cost domain model: calculates with (evidence: `src/OpenAPU.Domain/Concept.cs`)
- Budget management → Cost domain model: updates (evidence: `src/OpenAPU.Domain/Budget.cs`)
- HTTP API → SQLite repositories: registers repositories (evidence: `src/OpenAPU.Api/Program.cs`)
- SQLite repositories → SQLite database: reads and writes (evidence: `src/OpenAPU.Infrastructure/Repositories/SqliteApuRepository.cs`)
- HTTP API → Startup validation: validates startup (evidence: `src/OpenAPU.Api/Program.cs`)
- HTTP API → Request observability: configures middleware (evidence: `src/OpenAPU.Api/Program.cs`)
- HTTP API → Admin access: configures access (evidence: `src/OpenAPU.Api/Program.cs`)
- HTTP API → Diagnostics: uses diagnostics (evidence: `src/OpenAPU.Api/Program.cs`)
- HTTP API → Database transfer: exposes backup (evidence: `src/OpenAPU.Api/Program.cs`)
- HTTP API → CSV resource import: exposes import (evidence: `src/OpenAPU.Api/Program.cs`)
- HTTP API → CSV export: offers export
- HTTP API → HTML reports: offers reports
