43 lines
4.1 KiB
Markdown
43 lines
4.1 KiB
Markdown
# 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).
|