Files

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