Technische Architektur¶

Next.js 14 App Router mit 140 Prisma Models in 21 Domains und 226 API Routes.

Status: done | Phase: vor-go-live | Aktualisiert: 2026-03-23

Aktueller Stand¶

Die Architektur basiert auf Next.js 14 (App Router), TypeScript strict, Prisma ORM mit PostgreSQL 16 und JWT-Auth in httpOnly Cookies. Das Schema umfasst 4.990 Zeilen mit null TypeScript-Fehlern im eigenen Code.

Datenmodell (21 Domains)¶

Das Soll-Schema v1.6 definiert 21 Domains mit insgesamt 140 Models und 65 Enums. Die groessten Domains sind WEG (15 Models), Property & Unit (10 Models), KI & Agent (8 Models) und Tenant & Auth (7 Models). Jedes Model folgt 14 Prinzipien: tenantId mit Row-Level Security, Enums statt Strings, containsPII-Flag wo noetig, maximal 30 Felder.

API-Architektur (226 Routes)¶

Die Routes verteilen sich auf ca. 20 Gruppen unter src/app/api/v1/. Die groessten Gruppen: WEG (17), Portal Mieter (14), Properties (12), Agents/KI (12), Gewerbe (11), Calendar (10). Alle Routes verwenden Zod-Validierung und standardisierte Fehler-Responses.

Schema-Phasen (alle DONE)¶

Die Datenarchitektur wurde in 10 aufeinander aufbauenden Phasen entwickelt: - A: ChangeLog mit Middleware fuer 20 Endpoints - B/B+: Property/Unit Split mit 6 Enums und H3 Spatial Index - C/C+: Cross-Tenant Intelligence und OpenImmo-Import - D/D+: DSGVO-Sicherheit (AES-256-GCM, Differential Privacy) und Webhook-Ecosystem - E: User Split (UserProfile mit PII-Trennung) - F/F+: Extended Intelligence und ExternalData Layer

Naechste Schritte¶

EU Data Act Self-Service-Export implementieren (seit 12.09.2025 Pflicht)
Alte Unit-Felder entfernen (currentRent, nkVorschuss, currentTenantId)
Nummern pro Mandant auf @@unique([tenantId, number]) umstellen

Historie¶

Datum	Aenderung
2026-03-23	Migriert ins Knowledge System

Quelldateien¶

Abhaengigkeiten¶

Keine (Grundlagen-Thema)