Architecture Decision Records (ADRs)¶
Stand: 09.08.2026 15:22 Branch: main Status: Verbindliches Register
| Datum, Uhrzeit | Version | Änderung | Autor |
|---|---|---|---|
| 09.08.2026 15:22 | 2.4 | Umsetzungsstand von ADR-009, ADR-010 und ADR-012 nach statisch geprüfter UC00-Migrationsfolge aktualisiert | Codex |
| 09.08.2026 14:24 | 2.3 | ADR-012 zur providerneutralen RLS-Strategie akzeptiert und entgegenstehende ADR-001-Idee abgelehnt | Codex |
| 09.08.2026 14:10 | 2.2 | ADR-010 zu Prisma-Migrationen als führendem Deploymentverfahren akzeptiert | Codex |
| 09.08.2026 14:01 | 2.1 | ADR-009 zum Prisma-Schema als technische Wahrheit mit abgegrenzten Nachweisrollen akzeptiert | Codex |
| 09.08.2026 12:49 | 2.0 | ADR-023 zu Support-, Wartungs-, Fern- und Auslandszugriffen als akzeptiert aufgenommen | Codex |
| 09.08.2026 12:34 | 1.9 | ADR-022 zur eigenbetriebenen Malware-Prüfung von Vertrags-PDFs als akzeptiert aufgenommen | Codex |
| 09.08.2026 12:17 | 1.8 | ADR-021 zu Grafana Cloud Pro und anbieterunabhängiger Kostenkontrolle als akzeptiert aufgenommen | Codex |
| 09.08.2026 11:52 | 1.7 | ADR-020 zu Backup und Wiederherstellung als akzeptiert aufgenommen | Codex |
| 09.08.2026 11:33 | 1.6 | ADR-019 zu Hetzner Object Storage und AWS KMS als akzeptiert aufgenommen | Codex |
| 08.08.2026 14:48 | 1.5 | ADR-018 zur revisionsfähigen Auditierung als akzeptiert aufgenommen | Codex |
| 08.08.2026 13:40 | 1.4 | ADR-017 zum V1-Tenant-Offboarding als akzeptiert aufgenommen | Codex |
| 08.08.2026 13:28 | 1.3 | ADR-016 zur bedingt produktionsfreigegebenen Providerwahl Hostpoint als akzeptiert aufgenommen | Codex |
| 07.08.2026 18:11 | 1.2 | ADR-013 zur privaten Ablage versionierter Vertragsdokumente im Objektspeicher als akzeptiert aufgenommen | Codex |
| 06.08.2026 19:08 | 1.1 | ADR-015 zum Auftragsverarbeitungsvertrag und Datenschutzrollen als akzeptiert aufgenommen | Codex |
| 06.08.2026 18:42 | 1.0 | Zentrales ADR-Register angelegt und vorhandene ADR-Fundstellen konsolidiert | Codex |
Zweck¶
Dieses Verzeichnis enthält die verbindlichen Architecture Decision Records von DiveLogix360. Ein ADR dokumentiert den Kontext, die geprüften Varianten, die Entscheidung, ihre Begründung und ihre Konsequenzen.
Diese Datei ist die massgebliche Quelle für ADR-Nummern, Titel und Status. Erwähnungen in Reviews, Spezifikationen, Projektstatus, Quellcode oder älteren Dokumenten sind nur Referenzen und reservieren keine ADR-Nummer.
Statuswerte¶
| Status | Bedeutung |
|---|---|
| Vorgeschlagen | Die Entscheidung steht noch aus oder ein älterer Entscheid muss vor der Übernahme validiert werden. |
| Akzeptiert | Die Entscheidung wurde verbindlich getroffen. Die Umsetzung kann separat noch offen sein. |
| Abgelehnt | Die vorgeschlagene Entscheidung wurde bewusst nicht übernommen. |
| Ersetzt | Ein neueres ADR hat diese Entscheidung abgelöst. |
| Veraltet | Die Entscheidung ist nicht mehr relevant, ohne durch ein bestimmtes ADR ersetzt worden zu sein. |
Verbindliches Register¶
| ADR | Thema | Status | Dokument / Hinweis |
|---|---|---|---|
| ADR-001 | PostgreSQL Schema-per-Tenant mit RLS | Abgelehnt | Für V1 durch das gemeinsame Schema mit providerneutraler RLS gemäss ADR-012 verworfen. |
| ADR-002 | CRDT-ready SyncEngine, Phase 1: Timestamp | Vorgeschlagen | Nur als Altbestand in docs/ReadMe.md erwähnt; Inhalt und Titel vor Übernahme prüfen. |
| ADR-003 | UUID-Routing, keine sequenziellen IDs in URLs | Vorgeschlagen | Nur als Altbestand in docs/ReadMe.md erwähnt; Inhalt und Titel vor Übernahme prüfen. |
| ADR-004 | Hosting: Hetzner Cloud Produktion, Hostpoint Entwicklung | Vorgeschlagen | Nur als Altbestand in docs/ReadMe.md erwähnt; Inhalt und Titel vor Übernahme prüfen. |
| ADR-005 | PWA statt nativer App | Vorgeschlagen | Nur als Altbestand in docs/ReadMe.md erwähnt; Inhalt und Titel vor Übernahme prüfen. |
| ADR-006 | Plan-Feature-Management | Akzeptiert | ADR-006-plan-feature-management.md |
| ADR-007 | API-Basis-URL und Versionierungsstrategie | Akzeptiert | ADR-007-api-basis-url.md |
| ADR-008 | Route-Reihenfolge in NestJS-Controllern | Akzeptiert | ADR-008-route-reihenfolge-nestjs.md |
| ADR-009 | Prisma-Schema als technische Wahrheit | Akzeptiert | ADR-009-prisma-schema-als-technische-wahrheit.md; UC00-Zielschema und Migrationsfolge vorhanden, Build-Reparatur und Laufzeitnachweis offen. |
| ADR-010 | Prisma-Migrationen als führendes Deploymentverfahren | Akzeptiert | ADR-010-prisma-migrationen-als-deploymentverfahren.md; Initial- und Schutzmigration statisch geprüft, Deployment-Pipeline und Laufzeitnachweise offen. |
| ADR-011 | Globale Benutzeridentität und E-Mail-Eindeutigkeit | Akzeptiert | ADR-011-globale-benutzeridentitaet.md; Umsetzung und Tests noch offen. |
| ADR-012 | Providerneutrale Row-Level-Security-Strategie | Akzeptiert | ADR-012-providerneutrale-rls-strategie.md; Rollen und Policies statisch migriert, Transaktionswrapper und Laufzeitnachweise offen. |
| ADR-013 | Vertragsdokumente im privaten Objektspeicher | Akzeptiert | ADR-013-vertragsdokumente-im-objektspeicher.md; Anbieterwahl gemäss ADR-019 entschieden, technische Umsetzung offen. |
| ADR-015 | Auftragsverarbeitungsvertrag und Datenschutzrollen | Akzeptiert | ADR-015-avv-prozess-und-datenschutzrollen.md; Umsetzung und juristische Prüfung offen. |
| ADR-016 | Hostpoint als E-Mail-Provider | Akzeptiert | ADR-016-hostpoint-als-e-mail-provider.md; Produktivnachweise und technische Umsetzung offen. |
| ADR-017 | Tenant-Offboarding und operative Datenlöschung | Akzeptiert | ADR-017-tenant-offboarding.md; technische Umsetzung und Tests offen. |
| ADR-018 | Revisionsfähige Auditierung | Akzeptiert | ADR-018-revisionsfaehige-auditierung.md; Schema-, Speicher- und Testumsetzung offen. |
| ADR-019 | Objektspeicher und Schlüsselverwaltung | Akzeptiert | ADR-019-objektspeicher-und-schluesselverwaltung.md; Produktivnachweise und technische Umsetzung offen. |
| ADR-020 | Backup und Wiederherstellung | Akzeptiert | ADR-020-backup-und-wiederherstellung.md; Produktivnachweise, Umsetzung und Restore-Tests offen. |
| ADR-021 | Monitoring und Kostenkontrolle | Akzeptiert | ADR-021-monitoring-und-kostenkontrolle.md; Produktivnachweise, Umsetzung und Alarmtests offen. |
| ADR-022 | Malware-Prüfung von Vertrags-PDFs | Akzeptiert | ADR-022-malware-pruefung-von-vertrags-pdfs.md; Härtung, Umsetzung und Wirksamkeitsnachweise offen. |
| ADR-023 | Support-, Wartungs-, Fern- und Auslandszugriffe | Akzeptiert | ADR-023-support-und-fernzugriffe.md; Providerprüfung, Umsetzung und Zugriffstests offen. |
ADR-014 ist derzeit nicht vergeben. Historische Vorschläge mit dieser oder anderen bereits belegten Nummern werden bei einer tatsächlichen Bearbeitung unter einer freien Nummer neu erfasst.
Umgang mit historischen Fundstellen¶
- Review-Dokumente bleiben als historische Arbeitsunterlagen unverändert.
- Ein dort genannter ADR-Titel oder eine Nummer gilt nicht als beschlossen oder reserviert.
- Inhaltlich gleiche Vorschläge werden vor der Aufnahme zusammengeführt.
- Nummernkollisionen werden im Register aufgelöst, nicht durch Umdeuten bereits akzeptierter ADRs.
- Eingebettete, bereits umgesetzte Entscheidungen werden in eine eigene ADR-Datei migriert; ADR-006 ist der erste so bereinigte Fall.
Ablage- und Benennungsregel¶
Jede akzeptierte Entscheidung erhält eine eigene Datei in diesem Verzeichnis:
ADR-NNN-kurzer-beschreibender-titel.md
Das Register liefert die Übersicht. Die Einzeldatei enthält mindestens Kontext, Entscheidung, Begründung, Konsequenzen, Umsetzungsstand und verwandte ADRs.
Neue Nummern werden ausschliesslich über dieses Register vergeben. Eine Nummer wird nicht wiederverwendet, auch wenn ein ADR abgelehnt, ersetzt oder veraltet ist.
Pflegeprozess¶
- Entscheidungskandidat im Register mit Status
Vorgeschlagenerfassen. - Kontext, Varianten und Auswirkungen prüfen.
- Nach dem Entscheid eine eigene ADR-Datei anlegen und den Status aktualisieren.
- Betroffene Spezifikationen, Implementierungen, Tests und Backlog-Einträge mit der ADR-Nummer verknüpfen.
- Bei einer späteren Änderung ein neues ADR anlegen und das alte als
Ersetztmarkieren.