46 lines
2.0 KiB
Markdown
46 lines
2.0 KiB
Markdown
# .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)
|
|
1. **ticket-docs/<ID>.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.
|