Skip to content

add-on: Customer engagement (brief, domains, milestones) checklist #16

Description

@Fluory

Checklist from the control center (Entwicklungsplan/templates/addons/saas-auftrag.md, fluory-system 2.1), activated in project-profile.yml. Tick items as they are implemented; each item is proven in the PR that implements it. The checklist text is copied verbatim (German).


Add-on: SaaS / Kundenauftrag (bei Projekttyp saas oder externem Auftraggeber)

Vor dem ersten großen Code – siehe SYSTEM.md §14. Diese Projekte starten mit
aufgefächerter Doku (docs/product/, docs/technical/, docs/decisions/).

Phase 1: Project Brief (docs/product/project-brief.md)

# Project Brief

## Problem
Welches konkrete Problem löst das Produkt für wen?

## Nutzer und Rollen
- …

## Erfolg (messbar)
- Nutzer kann X in unter Y Minuten erledigen.
- …

## Nicht-Ziele
Was bauen wir ausdrücklich (noch) nicht?

## Risiken
Datenschutz · externe Abhängigkeiten · unklare fachliche Regeln · KI-Kosten

## Offene Entscheidungen
- …

Bei Kundenaufträgen zusätzlich klären:

  • Wer entscheidet fachlich? Wer darf Anforderungen ändern?
  • Was ist im Vertrag/Scope – und was ausdrücklich nicht?
  • Abnahmebedingungen
  • Welche Daten darf die KI sehen, welche nicht?
  • Wo findet die Kundenkommunikation statt?
  • Regel: Neue/unklare Anforderungen werden nie still als Code interpretiert → decision-needed-Issue an den Menschen

Phase 2: Fachliche Zerlegung

  • Domänen benennen (Identity, Kerndaten, Workflow, Notifications, …) – als modularer Monolith
  • Microservices nur bei nachweislich eigenen Skalierungs-/Sicherheits-/Release-Anforderungen eines Moduls
  • Bei Monorepo: apps/ + packages/; jedes Package mit Owner, Zweck, Tests, öffentlicher API (Drei-Verwendungen-Regel, SYSTEM.md §13)

Phase 3: Vertical Slice & Meilensteine

  • Epic „Vertical Slice": ein echter End-to-End-Ablauf (UI → API → Datenmodell → Berechtigung → Tests → Betrieb) als 3–6 Issues
  • Meilensteine mit überprüfbarer Abnahme, nie „80 % fertig":
    M0 Problem bestätigt → M1 sicherer Kern → M2 interne Beta (5–10 reale Testnutzer)
    → M3 abnahmefähig → M4 Produktion (Monitoring, Backup, Rollback) → M5 Ausbau
  • docs/product/roadmap.md mit den Meilensteinen anlegen
  • Erfolgsmessung ab Beta (docs/product/metrics.md): 3–5 messbare Signale aus dem
    Brief ableiten (z. B. „70 % der Testfragen brauchbar beantwortet", „p95 < 8 s",
    „max. 5 € Modellkosten/Nutzer/Monat") – sonst baut ihr technisch Gutes, das niemand braucht

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    add-onAdd-on checklist from the Entwicklungsplan

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions