10 KiB
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 |