# necervo-cpu/service-apps-hvac-r architecture

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

- Interactive diagram: https://gitdiagram.com/necervo-cpu/service-apps-hvac-r
- Repository: https://github.com/necervo-cpu/service-apps-hvac-r

## Overview

This repository contains a suite of browser-based German HVAC field-service tools: service and maintenance protocols, heating-system logs, service estimates, and a Daikin split-system sizing tool. A technician enters data through a wizard, with the app updating and rendering the current view; the apps also persist records and attempt synchronization. The excerpts show these startup and event-handling relationships, but most domain modules and storage implementations were not sampled, so their internal links are not inferred.

Main entry points: [`service-waermepumpe/app.js`](https://github.com/necervo-cpu/service-apps-hvac-r/blob/main/service-waermepumpe/app.js) (Heat pump app entry), [`service-waermepumpe/app-ansichten.js`](https://github.com/necervo-cpu/service-apps-hvac-r/blob/main/service-waermepumpe/app-ansichten.js) (Heat pump service views), [`service-waermepumpe/app-aktionen.js`](https://github.com/necervo-cpu/service-apps-hvac-r/blob/main/service-waermepumpe/app-aktionen.js) (Heat pump actions), [`service-waermepumpe/app-kern.js`](https://github.com/necervo-cpu/service-apps-hvac-r/blob/main/service-waermepumpe/app-kern.js) (Heat pump persistence)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_field["Field service"]
  node_logbook_actions["Logbook actions<br/>[app-aktionen.js]"]
  node_logbook_views["Logbook views<br/>[app-ansichten.js]"]
  node_heating_views["Heating maintenance views<br/>[app-ansichten.js]"]
  node_split_commission_views["Split commissioning views<br/>[app-ansichten.js]"]
  node_commission_template["Commissioning template<br/>[daten-vorlage.js]"]
  node_ac_maintenance_views["AC maintenance views<br/>[app-ansichten.js]"]
  node_ac_maintenance_core["AC maintenance core<br/>[app-kern.js]"]
  node_rlt_views["RLT maintenance views<br/>[app-ansichten.js]"]
  node_heatpump_views["Heat pump service views<br/>[app-ansichten.js]"]
  node_heatpump_template["Heat pump template<br/>[daten-vorlage.js]"]
  node_heatpump_entry["Heat pump app entry<br/>[app.js]"]
  node_heatpump_actions["Heat pump actions<br/>[app-aktionen.js]"]
  node_heatpump_storage["Heat pump persistence<br/>[app-kern.js]"]
end

subgraph group_estimation["Service estimates"]
  node_ac_estimate_views["AC estimate views<br/>[app-ansichten.js]"]
  node_heatpump_estimate_views["Heat pump estimate views<br/>[app-ansichten.js]"]
end

subgraph group_sizing["Sizing tool"]
  node_daikin_views["Daikin sizing views<br/>[app-ansichten.js]"]
  node_daikin_engine["Daikin calculation engine<br/>[engine.js]"]
end

subgraph group_shared["Reports"]
  node_logbook_pdf["Logbook PDF parts<br/>[pdf-bausteine.js]"]
  node_heating_pdf["Heating PDF parts<br/>[pdf-bausteine.js]"]
  node_ac_estimate_pdf["AC estimate PDF parts<br/>[pdf-bausteine.js]"]
  node_heatpump_estimate_pdf["Heat pump estimate PDF parts<br/>[pdf-bausteine.js]"]
  node_daikin_pdf["Daikin PDF parts<br/>[pdf-bausteine.js]"]
end

node_technician(("Technician"))

node_technician -->|"uses"| node_heatpump_entry
node_heatpump_entry -->|"dispatches actions"| node_heatpump_actions
node_heatpump_entry -->|"renders view"| node_heatpump_views
node_heatpump_entry -->|"synchronizes records"| node_heatpump_storage

click node_logbook_actions "https://github.com/necervo-cpu/service-apps-hvac-r/blob/main/anlagenlogbuch/app-aktionen.js"
click node_logbook_views "https://github.com/necervo-cpu/service-apps-hvac-r/blob/main/anlagenlogbuch/app-ansichten.js"
click node_logbook_pdf "https://github.com/necervo-cpu/service-apps-hvac-r/blob/main/anlagenlogbuch/shared/pdf-bausteine.js"
click node_heating_views "https://github.com/necervo-cpu/service-apps-hvac-r/blob/main/gas-oel-heizungswartung/app-ansichten.js"
click node_heating_pdf "https://github.com/necervo-cpu/service-apps-hvac-r/blob/main/gas-oel-heizungswartung/shared/pdf-bausteine.js"
click node_split_commission_views "https://github.com/necervo-cpu/service-apps-hvac-r/blob/main/service-inbetriebnahme-split-klimaanlage/app-ansichten.js"
click node_commission_template "https://github.com/necervo-cpu/service-apps-hvac-r/blob/main/service-inbetriebnahme-split-klimaanlage/daten-vorlage.js"
click node_ac_maintenance_views "https://github.com/necervo-cpu/service-apps-hvac-r/blob/main/service-klimaanlagenwartung/app-ansichten.js"
click node_ac_maintenance_core "https://github.com/necervo-cpu/service-apps-hvac-r/blob/main/service-klimaanlagenwartung/app-kern.js"
click node_rlt_views "https://github.com/necervo-cpu/service-apps-hvac-r/blob/main/service-rlt-kwl-anlagen/app-ansichten.js"
click node_heatpump_views "https://github.com/necervo-cpu/service-apps-hvac-r/blob/main/service-waermepumpe/app-ansichten.js"
click node_heatpump_template "https://github.com/necervo-cpu/service-apps-hvac-r/blob/main/service-waermepumpe/daten-vorlage.js"
click node_heatpump_entry "https://github.com/necervo-cpu/service-apps-hvac-r/blob/main/service-waermepumpe/app.js"
click node_heatpump_actions "https://github.com/necervo-cpu/service-apps-hvac-r/blob/main/service-waermepumpe/app-aktionen.js"
click node_heatpump_storage "https://github.com/necervo-cpu/service-apps-hvac-r/blob/main/service-waermepumpe/app-kern.js"
click node_ac_estimate_views "https://github.com/necervo-cpu/service-apps-hvac-r/blob/main/kalkulation-service-klimaanlage/app-ansichten.js"
click node_ac_estimate_pdf "https://github.com/necervo-cpu/service-apps-hvac-r/blob/main/kalkulation-service-klimaanlage/shared/pdf-bausteine.js"
click node_heatpump_estimate_views "https://github.com/necervo-cpu/service-apps-hvac-r/blob/main/kalkulation-service-waermepumpe/app-ansichten.js"
click node_heatpump_estimate_pdf "https://github.com/necervo-cpu/service-apps-hvac-r/blob/main/kalkulation-service-waermepumpe/shared/pdf-bausteine.js"
click node_daikin_views "https://github.com/necervo-cpu/service-apps-hvac-r/blob/main/auslegungstool-daikin-split-klimaanlage/app-ansichten.js"
click node_daikin_engine "https://github.com/necervo-cpu/service-apps-hvac-r/blob/main/auslegungstool-daikin-split-klimaanlage/engine.js"
click node_daikin_pdf "https://github.com/necervo-cpu/service-apps-hvac-r/blob/main/auslegungstool-daikin-split-klimaanlage/shared/pdf-bausteine.js"

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_logbook_actions,node_logbook_views,node_heating_views,node_split_commission_views,node_commission_template,node_ac_maintenance_views,node_ac_maintenance_core,node_rlt_views,node_heatpump_views,node_heatpump_template,node_heatpump_entry,node_heatpump_actions,node_heatpump_storage toneBlue
class node_ac_estimate_views,node_heatpump_estimate_views toneAmber
class node_daikin_views,node_daikin_engine toneMint
class node_logbook_pdf,node_heating_pdf,node_ac_estimate_pdf,node_heatpump_estimate_pdf,node_daikin_pdf toneRose
class node_technician toneIndigo
```

## Components

### Field service

- [Logbook actions](https://github.com/necervo-cpu/service-apps-hvac-r/blob/main/anlagenlogbuch/app-aktionen.js): `anlagenlogbuch/app-aktionen.js`
- [Logbook views](https://github.com/necervo-cpu/service-apps-hvac-r/blob/main/anlagenlogbuch/app-ansichten.js): `anlagenlogbuch/app-ansichten.js`
- [Heating maintenance views](https://github.com/necervo-cpu/service-apps-hvac-r/blob/main/gas-oel-heizungswartung/app-ansichten.js): `gas-oel-heizungswartung/app-ansichten.js`
- [Split commissioning views](https://github.com/necervo-cpu/service-apps-hvac-r/blob/main/service-inbetriebnahme-split-klimaanlage/app-ansichten.js): `service-inbetriebnahme-split-klimaanlage/app-ansichten.js`
- [Commissioning template](https://github.com/necervo-cpu/service-apps-hvac-r/blob/main/service-inbetriebnahme-split-klimaanlage/daten-vorlage.js): `service-inbetriebnahme-split-klimaanlage/daten-vorlage.js`
- [AC maintenance views](https://github.com/necervo-cpu/service-apps-hvac-r/blob/main/service-klimaanlagenwartung/app-ansichten.js): `service-klimaanlagenwartung/app-ansichten.js`
- [AC maintenance core](https://github.com/necervo-cpu/service-apps-hvac-r/blob/main/service-klimaanlagenwartung/app-kern.js): `service-klimaanlagenwartung/app-kern.js`
- [RLT maintenance views](https://github.com/necervo-cpu/service-apps-hvac-r/blob/main/service-rlt-kwl-anlagen/app-ansichten.js): `service-rlt-kwl-anlagen/app-ansichten.js`
- [Heat pump service views](https://github.com/necervo-cpu/service-apps-hvac-r/blob/main/service-waermepumpe/app-ansichten.js): `service-waermepumpe/app-ansichten.js`
- [Heat pump template](https://github.com/necervo-cpu/service-apps-hvac-r/blob/main/service-waermepumpe/daten-vorlage.js): `service-waermepumpe/daten-vorlage.js`
- [Heat pump app entry](https://github.com/necervo-cpu/service-apps-hvac-r/blob/main/service-waermepumpe/app.js): `service-waermepumpe/app.js`
- [Heat pump actions](https://github.com/necervo-cpu/service-apps-hvac-r/blob/main/service-waermepumpe/app-aktionen.js): `service-waermepumpe/app-aktionen.js`
- [Heat pump persistence](https://github.com/necervo-cpu/service-apps-hvac-r/blob/main/service-waermepumpe/app-kern.js): `service-waermepumpe/app-kern.js`

### Service estimates

- [AC estimate views](https://github.com/necervo-cpu/service-apps-hvac-r/blob/main/kalkulation-service-klimaanlage/app-ansichten.js): `kalkulation-service-klimaanlage/app-ansichten.js`
- [Heat pump estimate views](https://github.com/necervo-cpu/service-apps-hvac-r/blob/main/kalkulation-service-waermepumpe/app-ansichten.js): `kalkulation-service-waermepumpe/app-ansichten.js`

### Sizing tool

- [Daikin sizing views](https://github.com/necervo-cpu/service-apps-hvac-r/blob/main/auslegungstool-daikin-split-klimaanlage/app-ansichten.js): `auslegungstool-daikin-split-klimaanlage/app-ansichten.js`
- [Daikin calculation engine](https://github.com/necervo-cpu/service-apps-hvac-r/blob/main/auslegungstool-daikin-split-klimaanlage/engine.js): `auslegungstool-daikin-split-klimaanlage/engine.js`

### Reports

- [Logbook PDF parts](https://github.com/necervo-cpu/service-apps-hvac-r/blob/main/anlagenlogbuch/shared/pdf-bausteine.js): `anlagenlogbuch/shared/pdf-bausteine.js`
- [Heating PDF parts](https://github.com/necervo-cpu/service-apps-hvac-r/blob/main/gas-oel-heizungswartung/shared/pdf-bausteine.js): `gas-oel-heizungswartung/shared/pdf-bausteine.js`
- [AC estimate PDF parts](https://github.com/necervo-cpu/service-apps-hvac-r/blob/main/kalkulation-service-klimaanlage/shared/pdf-bausteine.js): `kalkulation-service-klimaanlage/shared/pdf-bausteine.js`
- [Heat pump estimate PDF parts](https://github.com/necervo-cpu/service-apps-hvac-r/blob/main/kalkulation-service-waermepumpe/shared/pdf-bausteine.js): `kalkulation-service-waermepumpe/shared/pdf-bausteine.js`
- [Daikin PDF parts](https://github.com/necervo-cpu/service-apps-hvac-r/blob/main/auslegungstool-daikin-split-klimaanlage/shared/pdf-bausteine.js): `auslegungstool-daikin-split-klimaanlage/shared/pdf-bausteine.js`

### Other components

- **Technician**

## Connections

- Technician → Heat pump app entry: uses (evidence: `service-waermepumpe/app.js`)
- Heat pump app entry → Heat pump actions: dispatches actions (evidence: `service-waermepumpe/app.js`)
- Heat pump app entry → Heat pump service views: renders view (evidence: `service-waermepumpe/app.js`)
- Heat pump app entry → Heat pump persistence: synchronizes records (evidence: `service-waermepumpe/app.js`)
