.planning/ — Planungsunterlagen HiveGrid 2.0
Operativer Status, Ownership und Dependencies liegen in Plane. Gebaut wird ausschließlich nach
.planning/ticket-docs/<ID>.md; die übrigen Dateien liefern fachliche und architektonische Referenz.
Stand: 2026-08-02
Zuerst lesen (in dieser Reihenfolge)
- ticket-docs/.md — ausführbare Bau-Spec und DoD des Tickets.
- ENTITY-MODEL.md — verbindliches Datenmodell.
- PROJECT.md / ROADMAP.md / REQUIREMENTS.md* — Produkt- und Scope-Referenz.
Kern-Planung (gepflegt)
| Datei | Inhalt |
|---|---|
| PROJECT.md | Produkt-Charter und Architekturkontext |
| ROADMAP.md | 21 Phasen, Reihenfolge, Success-Criteria |
| REQUIREMENTS.md | v1-Requirements (90) je Modul |
| KWP-API-CONTRACT.md | bindender read-only KWP-Connector- und Providervertrag |
Datenmodell — ✅ APPROVED & LOCKED (Projekt-zentrisch, AD-20)
| Datei | Rolle |
|---|---|
| ENTITY-MODEL.md | autoritatives Datenmodell (voll) |
| entity-model.dbml | maschinenlesbar → in dbdiagram.io importieren |
| entity-model.svg | gerendertes ER-Diagramm |
| ENTITY-MODELL-ERKLAERUNG.md | laienverständliche Fassung (für Design/Stakeholder) |
| HiveGrid_CRM_Datenlogik_UX_Entscheidungen.md | Davids approved UX-Quelle (Grundlage des Pivots) |
UX / Design
- designer-briefs/ — phasenbezogene Screen-Briefs für David
- DESIGNER-FIRST-PLAYBOOK.md — Designer-first-Methodik + Archetypen
Externe Abhängigkeiten
Externe Abhängigkeiten werden als EXT-*-/VEXT-*-Tickets in Plane und in den zugehörigen
.planning/ticket-docs/ gepflegt. Es gibt keine zweite globale Statusliste im Repository.
Unterordner
Konventionen
*.pdfneben einer*.md= nur die gerenderte Fassung derselben Datei (zum Teilen).- Infra-Realität: Hetzner + Coolify + Cloudflare (nicht Scaleway/Fly).
- Ersetzte Produktplanungen liegen nur noch in der Git-Historie. Aktive Regeln stehen in
AGENTS.md, Scope/DoD in der Ticket-Doc und das Datenmodell im Entity Model.