lowcode

Multi-App-Plattform mit Generator-getriebenen Apps (PIM, CRM, apartments-admin) und einem kundenorientierten Marketplace (apartments-marketplace).

📖 Entwickler-Dokumentation (Doku)

Der zentrale Einstiegspunkt ist doku/README.md. Unten findest du alle Dokumentationsdateien direkt verlinkt, sortiert nach Themengebieten inklusive einer kurzen Zusammenfassung des Inhalts.

1. ⚙️ Setup & Erste Schritte

Dokument	Inhalt & Fokus
💻 Developer Setup	Einrichten der lokalen Entwicklungsumgebung (Postgres, Node, globale Overrides, Ports, DB-Resets, Seed-Skripte und Testläufe).
➕ Neues Entity Guide	Schritt-für-Schritt-Anleitung zur Erweiterung des Datenmodells und Ausführung des Scaffolding-Generators.
🛠️ Troubleshooting	Lösungen für bekannte Entwicklungs- und Build-Probleme (z.B. UTF-8 Windows-Encoding, fehlende Fremdschlüssel-Indizes).

2. 🗺️ Konzepte & Architektur

Dokument	Inhalt & Fokus
🌐 Plattform-Übersicht	Überblick über den Technologie-Stack, die Scaffolding-Philosophie und die Multi-App-Topologie des Projekts.
👥 Admin vs. Marketplace	Der konzeptionelle Unterschied zwischen internen CRUD-Admin-Apps und kundenorientierten Marketplaces.
🔒 Security & Tenancy	Zusammenspiel von Authentifizierung, JWT-Claims, Datenbank-Rollen und Postgres Row-Level Security (RLS).
📐 Architektur-Prinzipien	Kernprinzipien wie Layer-Isolation, Inversion of Control (IoC) und die npm-Workspace-Abhängigkeitsmatrix.

3. 🤖 Generator & Scaffolding

Dokument	Inhalt & Fokus
📦 Generator Admin	Funktionsweise des Admin-Scaffolders, Form- und ListConfigs, sowie die Integration von Custom Page-Extensions.
🔌 Generator Marketplace	REST-API-Generierung für den Marketplace, Zod-DTOs, Field-Level-Permissions (Floor/Ceiling) und die @shared/marketplace-api-SQL-Bibliothek.

4. 📱 Fachliche App-Dokumentation

Dokument	Inhalt & Fokus
📦 PIM (Produktdaten)	Fachlogik, Domänenmodell und Strukturen für das Produkt-Informations-Management (PIM).
🤝 CRM (Kundenbeziehungen)	Fachlogik, Domänenmodell und Workflows für das Customer Relationship Management (CRM).
🏠 Apartments (Marktplatz & Admin)	Fachlogik des Apartment-Management-Tools und des kundenorientierten Apartments-Marketplaces.

5. 📚 Shared-Bibliotheken (npm-Workspaces)

Dokument	Inhalt & Fokus
📦 Shared Packages	Dokumentation der plattformweiten npm-Workspaces (utils, types, email, postgres, state-engine, auth).
🎨 Frontend Core	Dokumentation der UI-Bibliothek frontend-core (Layouts, Forms, Validierung) sowie der Widget-Verteilungsmatrix.

📋 Pläne & Ideen

• Pläne – Detaillierte Konzepte und Implementierungspläne (z. B. Auth-Phasen, Status).
• Ideen – Unstrukturierter Themenspeicher für zukünftige Features.