Files
HiveGrid-Wireframes/03 Quellen und Referenzen/hivegrid-cloud/.planning/ticket-docs/README.md
T

43 lines
4.1 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Ticket-Docs — eine Bau-Doku pro Plane-Ticket
Eine self-contained Datei pro Ticket: `<TICKET-ID>.md` (Working-ID, z.B. `R-P6.md`, `D-P2.md`, `EXT-07.md`).
Jedes Plane-Ticket verlinkt **diese** Datei als ersten, granularen Doku-Link (statt auf einen langen Sammel-Brief zu zeigen).
**Quelle der Wahrheit** bleiben `.planning/ENTITY-MODEL.md` (Datenmodell, AD-20), `REQUIREMENTS.md`, `ROADMAP.md` und die `designer-briefs/PXX.md` — die Ticket-Docs *destillieren* daraus genau den für dieses Ticket relevanten Teil. Bei Widerspruch gilt für P6–P9 das **ENTITY-MODEL** (Pivot-Vorrang).
**Aktiver Recut:** Billing wurde am 2026-07-04 per `docs/ARCHITECTURE-DECISIONS.md` **AD-27** von Legacy-Provider auf
**Lago self-hosted + Mollie Payments** umgestellt. Einstieg: `BILL-README.md`, dann `BILL-00`.
## Aufbau je Doc
Header-Tabelle (Typ/Owner/Phase/Cycle/Status) · **Abhängigkeiten & Parallelität** · **Was wir bauen** · **Benötigte Screens** · **Definition of Done** · **Technische Bausteine** (Dev) bzw. **UI-Elemente** (Screen) · **Quellen** (granular) · **Davids Delta** (Screen) / **Dev-Nachzug** (Dev).
**Interim-UI-Tag (AD-28, `/planning` = Single Source of Truth):** Geht ein Dev-Ticket mit einer Interim-UI (Vorschau aus `~/ui`) auf Done, während Davids finaler `D-*`-Screen noch fehlt, bekommt die Doc **direkt unter die Header-Tabelle** den standardisierten Tag `**🎨 design-nachzug: offen** (seit YYYY-MM-DD) — …` (Format + Erledigt-Variante im Playbook). Dieser Doc-Tag ist die autoritative Quelle des offenen Nachzugs (`grep -rl "design-nachzug: offen" .planning/ticket-docs/`); das gleichnamige Plane-Label spiegelt ihn nur.
Ticket-Typen: **Dev** (R-/AK-/VR-/VA- — Code) · **Screen** (D-/VD- — Design) · **Setup** (EXT-) · **Vertrieb** (H-) · **Website** (J-) · **Noah-Zulieferung** (N-). Setup/Vertrieb/Website/Noah nutzen ein schlankeres Schema (Was zu tun · Warum · Abhängigkeiten · DoD).
---
## Einem Coding-Agent ein Ticket geben
Du nennst dem Agent nur die **Ticket-ID**. Damit er korrekt loslegt, gib ihm diesen **Standard-Einstiegs-Prompt** (Ticket-ID einsetzen):
```text
Arbeite Ticket <TICKET-ID> ab.
1. Lies .planning/ticket-docs/<TICKET-ID>.md (Spec) UND AGENTS.md (verbindliche Bau-Regeln).
2. Prüfe "Abhängigkeiten & Parallelität": Sind alle blocked-by-Tickets erledigt? Wenn ein Blocker
(z.B. R-P5/AK-P4b/R-REFIT) noch offen ist, STOP und sag mir, was fehlt.
3. Folge den granularen Quellen der Doc (ENTITY-MODEL §Domäne, REQ-Namen, Brief, Spec).
WICHTIG: Bei P6–P9 / Deal-Auftrag hat .planning/ENTITY-MODEL.md Vorrang vor den
4. Halte die Definition of Done Punkt für Punkt ein. Schema: eigene prisma/schema/<modul>.prisma
(AD-21), RLS + Konnektor tenantHasModule(), is_demo_data — wie in "Technische Bausteine".
5. Erzeuge KEINE Migration auf dem Branch (prisma db push); Migration entsteht erst beim Merge (AD-21).
```
**Benutzung:**
- **Backend-/Logik-Tickets** (P1, P2, P5, P6-Kern, Automation, KI …): Agent kann mit der Doc **sofort loslegen**, sobald die blocked-by stehen.
- **UI-/Screen-lastige Tickets:** Erst designt **David** (Screen-Ticket `D-*`/`VD-*`), trägt sein **„Davids Delta"** in die Screen-Doc ein → dann zieht der Dev nach. Solange das Delta leer ist, baut der Agent das Backend/Datenmodell **und** eine **Interim-UI** (Vorschau-Screen) aus `~/ui` (**AD-28**, `.planning/INTERIM-UI-PLAYBOOK.md`): `<XPage vm={} actions={} />` aus `~/ui`-Components + Layout, VM als Prop, **kein handgeschriebenes Tailwind**. Damit wird das Ticket Done-fähig (Dev-DoD + Interim-UI + Tests grün); die finale Subframe-Optik ist ein **getrackter Nachzug** (Plane-Label `design-nachzug`), nicht Done-blockierend. Der Interim-UI-Vermerk gehört in die **„Dev-Nachzug"**-Sektion der Ticket-Doc (Muster im Playbook).
- **Reihenfolge** = `SPRINT-DAYPLAN.md` (jedes Ticket an seinem Start-Tag) bzw. die Plane-Cycles (Sprint-Wochen).
- Das **Plane-Ticket selbst** verlinkt diese Doc als ersten Doku-Link — Ticket in Plane öffnen → Doc-Link klicken → an den Agent geben.
- Nach Davids Delta: „Dev-Nachzug"-Checkliste am Doc-Ende abarbeiten (Spec/REQUIREMENTS/Plane-Ticket aktualisieren).