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

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):

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).