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

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