# .planning/ — Planungsunterlagen HiveGrid 2.0 Operativer Status, Ownership und Dependencies liegen in Plane. Gebaut wird ausschließlich nach `.planning/ticket-docs/.md`; die übrigen Dateien liefern fachliche und architektonische Referenz. **Stand:** 2026-08-02 ## Zuerst lesen (in dieser Reihenfolge) 1. **ticket-docs/.md** — ausführbare Bau-Spec und DoD des Tickets. 2. **ENTITY-MODEL.md** — verbindliches Datenmodell. 3. **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 - `*.pdf` neben 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.