Referenz

API

• OpenAPI-Spezifikation: wird vom laufenden Backend live unter /docs/api.json serviert (Scramble, generiert aus den Controllern)
• App-Kommunikation (REST + WebSocket-Events, Payloads, Client-Flow): App Communication Guide

MQTT

• Kanonischer Protokollvertrag (AsyncAPI + JSON-Schemas): docs/asyncapi/
• Topic-Struktur und Message-/Transaction-IDs: ADR-0002
• Typisierte Outbound-Publisher im Backend: ADR-0008
• Broker-Authentifizierung: mosquitto-go-auth gegen /api/mosq/*

Hardware

• Stückliste (BOM): siehe Hardware
• Das Modbus-Relais-Board muss das dort gelistete Waveshare-Board sein (verifiziertes Flash- und Digital-Input-Verhalten, siehe ADR-0004)
• KiCad-Designs: hardware/

Architecture Decision Records

Alle Architektur-Entscheidungen sind als ADRs dokumentiert: docs/adr/

Interne Dokumente

Weitere interne Dokumentation (Integrationspläne, Detailanalysen) liegt im Repository unter docs/.