Files
HiveGrid-Wireframes/hivegrid-cloud/_bmad-output/pflichtenheft/99-anhang.md
T

148 lines
10 KiB
Markdown

# Anhang
## H.1 Geparkte Themen
Diese Themen sind **bewusst nicht** Teil dieses Pflichtenhefts. Sie werden in eigenen, abgegrenzten Runden geklärt, bevor die Implementierung begonnen oder abgeschlossen wird.
### H.1.1 Pricing-Modell
H.1.1.1 **Status:** unbestimmt. Konkrete Preise pro Plan, Trigger-Volumen-Limits und Setup-Fees stehen noch nicht fest.
H.1.1.2 **Worauf das Pflichtenheft schon vorbereitet ist:**
- Drei Plan-Stufen werden technisch bedacht (Cloud, Cloud+, Enterprise, siehe Modul 28).
- Seat-Modell mit Unterscheidung zwischen Büro- und Monteur-Sitzplätzen ist im Auth-Modul (M27) und Subscription-Modul (M28) verankert.
- Trigger-Volumen-Metering pro Mandant ist im Automation-Modul (M17.L) gebaut, die konkreten Limits werden später per Konfiguration eingespielt.
- Trial-Phase und Read-Only-Downgrade bei Nichtzahlung sind funktional in M28 vorgesehen.
H.1.1.3 **Was zu klären ist (separater Workflow):**
- Konkrete Preise je Plan und Seat-Typ.
- Setup-Fee ja/nein, Höhe.
- Trigger-Volumen-Limits pro Plan (1.000/h? 10.000/h?).
- Self-Service-Sales vs. Demo-Termin-Pflicht ab welchem Plan.
- Discount-Logik für Jahres-Bezahlung, Multi-Year-Verträge.
### H.1.2 Migration aus HubSpot, Quiply und KWP
H.1.2.1 **Status:** geparkt für eigene Runde nach Sign-off des Pflichtenhefts.
H.1.2.2 **Worauf das Pflichtenheft schon vorbereitet ist:**
- CSV-Import-Pfad für Kontakte, Firmen, Deals (M01, M03) ist als Phase-1-Bestandteil vorgesehen.
- Apps-Engine (M33a) kann Adapter zu HubSpot/Quiply als spätere Implementierungen aufnehmen.
H.1.2.3 **Was zu klären ist (separater Workflow):**
- Welche Daten werden aus HubSpot mitgenommen, welche bleiben dort liegen?
- Wie werden Quiply-Mitarbeiter-Daten überführt (insb. Dokumente, Lohn-Daten)?
- Welche KWP-Bestände werden initial in die HiveGrid-CRM-Welt gespiegelt?
- Migration-Termine vs. Live-Betrieb-Übergang (Cut-Over-Plan).
### H.1.3 KWP-Native-Integration nach Geschäftsführer-Termin
H.1.3.1 **Status:** offen. Termin mit KWP-Geschäftsführer geplant. Ergebnis kann **Modul 19 vereinfachen** (oder M8, Rechnungs-UI, neu evaluieren).
H.1.3.2 **Vorgehen:**
- Termin abwarten, Aussage zu offizieller API/Datenbank-Anbindung dokumentieren.
- Modul 19 ggf. nachschärfen (z. B. Wegfall des Schema-Drift-Sentinels, wenn API-Kontrakt entsteht).
- Ggf. Modul 8 (eigene Rechnungs-UI) aus Phase 2 vorziehen oder dauerhaft streichen.
### H.1.4 Sales-Flow Self-Service vs. Demo-Pflicht
H.1.4.1 **Status:** geparkt. Betrifft Marketing-Webseite und Onboarding (M29).
H.1.4.2 **Worauf das Pflichtenheft vorbereitet ist:** Onboarding-Modul kann beide Flows bedienen.
## H.2 Verifikations-Workflow für Noah
### H.2.1 Wann ist eine Sektion „verifiziert"?
H.2.1.1 **Verifiziert** = Noah hat die Sektion gelesen, alle Punkte einzeln geprüft und entweder
- **OK** vermerkt (kein Änderungsbedarf), oder
- **Korrektur-Vorschlag** als Klartext-Anmerkung am betroffenen Punkt formuliert.
H.2.1.2 **Nicht verifiziert** = Sektion noch nicht durchgegangen, oder offene Anmerkungen sind nicht aufgelöst.
### H.2.2 Empfohlene Reihenfolge
Das Pflichtenheft ist nach Implementierungs-Blöcken sortiert. Für die Verifikation empfiehlt sich aber eine **andere** Reihenfolge, die der Geerkens-Workflows folgt:
H.2.2.1 **Termin 1 (60-90 Min): Vertrieb und Auftrag**: Block 3 (Sales-Pipeline, Auftrags-Pipeline, Tasks) plus Modul 1, 2 (CRM, Lead-Inbox) aus Block 2. Hier sitzt der Kern, hier sollte Noah am intensivsten korrigieren.
H.2.2.2 **Termin 2 (60-90 Min): USP-Säulen**: Block 4 (Apps-Engine, Automation, KI, KWP-Integration). Hier prüft Noah, ob die Wenn-Dann-Vorstellungen seinem Tagesgeschäft entsprechen.
H.2.2.3 **Termin 3 (60 Min): Kommunikation und Mitarbeiter-Plattform**: Block 5 (Email, Marketing, Telefonie, Chat, Push, Kalender) plus Modul 14 (HR-Hub) aus Block 6.
H.2.2.4 **Termin 4 (60 Min): Spezialfälle und Außenseite**: Rest von Block 6 (Form-Builder, Booking, Angebot, Customer-Portal, Dashboard) plus Block 7 (Audit, Subscription, Onboarding, API, DSGVO, Mobile, Help-Center, Help-Desk).
H.2.2.5 **Termin 5 (60 Min): Plattform-Fundament und Architektur**: Block 1 (Auth, i18n, Branding, Feature-Flags, Plattform-Admin) plus Architektur-Vorschriften (Kapitel A). Hier schaut Noah, ob die Bauprinzipien zu seinem Verständnis passen, viele Punkte hier sind mehr „Vertrauen statt Detail-Korrektur".
### H.2.3 Anmerkungs-Format
Korrektur-Vorschläge bitte direkt am Punkt mit folgender Form:
```
M04.6.5 Plantafel-Drag-and-Drop muss nur Wochen, nicht Tage zeigen
→ Korrektur Noah, 12.05.2026: Tage müssen rein, sonst überschneiden
sich Mehrtages-Einsätze nicht erkennbar.
```
So bleibt nachvollziehbar, **wer wann was geändert hat**, ohne dass das Pflichtenheft umstrukturiert werden muss.
### H.2.4 Sign-off
H.2.4.1 Sign-off erfolgt **pro Modul-Block**, sobald alle Anmerkungen aufgelöst sind. Das geht parallel zur Implementierung, Block 1 (Plattform-Fundament) muss vor allen anderen sign-off-fähig sein, weil die anderen darauf aufbauen.
H.2.4.2 **Vollständiger Sign-off** = alle 7 Blöcke plus Architektur plus Anti-Liste plus Anhang von Noah freigegeben.
H.2.4.3 Nach vollständigem Sign-off: alle weiteren Änderungen über die **Change-Request-Liste** (siehe A.9).
## H.3 Change-Request-Format
Eine Change-Request hat folgende Felder, die ausgefüllt sein müssen, bevor sie Wirkung hat:
| Feld | Beispiel |
|---|---|
| **Datum** | 2026-06-12 |
| **Initiator** | Noah Geerkens |
| **Betrifft (Punkt-Adresse)** | M17.4.3 |
| **Was soll geändert werden** | Klartext, was vorher anders war und was jetzt gewünscht ist |
| **Warum (Begründung)** | Klartext, was den Bedarf ausgelöst hat |
| **Auswirkung auf Aufwand** | Geschätzt durch Entwickler (z. B. „+2 Tage", „Anti-Liste-Verstoß: nicht in Phase 1 möglich") |
| **Entscheidung** | Genehmigt / Abgelehnt / Verschoben auf Phase 2 |
| **Datum der Entscheidung** | |
Change-Request-Liste wird zentral geführt (Format: einfache Tabelle, z. B. Markdown im Repository oder Notion).
## H.4 Verweis auf Detail-Spezifikationen
Dieses Pflichtenheft ist die **konsolidierte Klartext-Form**. Für jedes Modul gibt es eine **technische Detail-Spezifikation** mit Datenmodell, exakten Feld-Namen, Permission-IDs und Routen-Pfaden. Die Detail-Specs sind die Vertragsanlage für die technische Umsetzung, nicht für Noah-Review.
H.4.1 **Speicherort der Detail-Specs:** `_bmad-output/specs/M*.md` (Markdown) und `_bmad-output/specs/pdfs/M*.pdf` (PDF).
H.4.2 **Master-Scope-Dokument** (Brainstorming-Ergebnis mit Leitplanken, Pre-mortem, Edge-Cases): `_bmad-output/brainstorming/brainstorming-session-2026-05-07-2206.md`.
H.4.3 **Schema** für die Detail-Specs: `_bmad-output/specs/_SCHEMA.md`.
H.4.4 **Wenn Noah einen Punkt in diesem Pflichtenheft tiefer verstehen will**, wird auf die zugehörige Detail-Spec verwiesen, diese liefert das technische Wie zum hier dokumentierten Was.
## H.5 Versions-Historie dieses Pflichtenhefts
| Version | Datum | Autor | Änderungen |
|---|---|---|---|
| 1.0 (Entwurf) | 2026-05-09 | Raffael Sheikh | Erst-Konsolidierung aus 35 Detail-Specs. |
| 1.1 (Noah-Review #1) | 2026-05-09 | Raffael Sheikh | 17 Anmerkungen aus Noah-Review eingearbeitet. Markiert mit Anmerkungs-Nummer im Format `[NXX, Datum]` direkt am betroffenen Punkt. Zwei Anmerkungen ausdrücklich nicht eingearbeitet: N3 (In-App-Checkout) abgelehnt wegen Apple-Compliance-Konflikt; N15 (Unified Inbox mit WhatsApp) auf Phase 2 verschoben. Zusammenfassung der eingearbeiteten Punkte siehe H.6. |
| ... | ... | ... | (zukünftige Sign-off-Stände, Change-Requests) |
## H.6 Eingearbeitete Anmerkungen aus Noah-Review #1 (2026-05-09)
| Nr. | Modul-Adresse | Inhalt | Status |
|---|---|---|---|
| N1 | M27.7 | Drei zusätzliche SHK-Standard-Rollen: Buchhaltung, Personal, Lagerist | eingearbeitet |
| N2 | M27.10 | Admin-Notification bei Selbst-Löschung; Admin kann Nutzer aktiv löschen | eingearbeitet |
| N3 | M28 / Mobile | In-App-Checkout statt Pricing-Link | **abgelehnt** wegen Apple-Compliance (Punkt 28.X.10 bleibt) |
| N4 | M02.11 + M02.12.9 | Lead-Routing pro Quelle (Pipeline-Zuweisung, Auto-Verkaufsfall, mandanten-konfigurierbar) + Marketing-Funnels Phase 2 | eingearbeitet |
| N5 | M19.2.5 + M23.9.7 | KWP-Dokumenten-Archiv-Sync mit Spiegelung der Kunden- und Projekt-Archiv-Struktur (KWP → HiveGrid einseitig) | eingearbeitet |
| N6 | M03.1.8 | Verantwortlicher Vertriebler als Pflichtfeld | eingearbeitet |
| N7 | M03.1.15 + M03.6.7 | Mandanten-konfigurierbar: Auftragsprojekt entsteht bei „Gewonnen" oder schon bei Anlage | eingearbeitet |
| N8 | M03.3 + M03.5.3 | Konfigurierbare Verlust-Gründe UND Gewinn-Gründe; pflicht/optional pro Mandant | eingearbeitet |
| N9 | M03.6.6 + Vision V.3.2.5a | Wartung und Service sind keine Projekte; eigenes Service-Modul Phase 2 | eingearbeitet |
| N10 | M04.6.14 | Bidirektionale Plantafel-Sync KWP↔HiveGrid; Konflikt-Default „KWP gewinnt" | eingearbeitet |
| N11 | M26.10 | Aufgaben-Sync mit ERP-Aufgaben-Welt (KWP-Box), modular pro ERP-Adapter | eingearbeitet |
| N12 | M17.10 | Vorlagen-Marketplace als Vertriebszweig (kommerziell), Phase-1-Vorbereitung mit Eigentümer-Modell | eingearbeitet |
| N13 | M18.8 + M28.8 | KI nicht pausieren, sondern Pay-as-you-go bei Limit-Überschreitung; Notbremse | eingearbeitet |
| N14 | M19.6 | Konflikt-Default „KWP gewinnt immer" statt Letzter-Schreibt-Gewinnt | eingearbeitet |
| N15 | Vision V.3.2.3 + M9.9.7 | Unified Inbox mit WhatsApp und weiteren Kanälen | **Phase 2** (Anti-Liste-Eintrag, kein Phase-1-Bestandteil) |
| N16 | M12 (gesamt) | HalloPetra als Phase-1-Telefonie zusätzlich zu AirCall; Telefonie generell optional | eingearbeitet |
| N17 | M03.9.5 + M25.3.5 | Setter-Closer-Termin direkt aus dem Verkaufsfall mit Auto-Datentransfer | eingearbeitet |
| N18 | M14.12 | Onboarding über Drittanbieter-Anbindung (Memberspot, Boobora) statt nativ; native Lösung Phase 2 | eingearbeitet |
| N19 | M15.13 | Customer-Portal: Pro-Kunde-Lebensdauer, Skalierungs-Sicht für große Kundenbestände, Subunternehmer-Zugang | eingearbeitet |