Track HiveGrid Cloud planning reference

This commit is contained in:
david committed 2026-06-26 20:48:01 +02:00
1 parent b3d5ea6764
commit e341c5938a
5784 files changed
+1104929 -3

No files matched your search

@@ -0,0 +1,93 @@
---
pdf_options:
format: A4
margin: 16mm
css: |-
body { font-size: 10.5px; font-family: -apple-system, "Segoe UI", Helvetica, Arial, sans-serif; }
h1 { font-size: 19px; }
h2 { font-size: 14px; border-bottom: 2px solid #f5a623; padding-bottom: 3px; margin-top: 20px; break-after: avoid; page-break-after: avoid; }
table { font-size: 9.5px; border-collapse: separate; border-spacing: 0; width: 100%; border-top: 1px solid #ccc; border-left: 1px solid #ccc; }
thead { display: table-header-group; }
tr { break-inside: avoid !important; page-break-inside: avoid !important; }
td, th { break-inside: avoid !important; border-right: 1px solid #ccc; border-bottom: 1px solid #ccc; padding: 3px 5px; vertical-align: top; }
th { background: #fff7e8; }
li { break-inside: avoid; }
p { orphans: 3; widows: 3; }
code { background: #f4f4f4; padding: 1px 3px; font-size: 9px; }
---
# PROJEKT-BRIEFING: HiveGrid 2.0 (zuerst lesen!)
**Dieses Blatt liegt in jedem Ordner.** Es erklärt, was wir bauen, wer wer ist und was die Begriffe in deinem persönlichen HANDOUT bedeuten. Danach: dein HANDOUT lesen, das ist dein persönlicher Plan.
## Was ist HiveGrid?
**HiveGrid 2.0 ist eine All-in-One-Software für SHK-Handwerksbetriebe** (Sanitär, Heizung, Klima): Kundenverwaltung (CRM), Anfragen-Eingang (Lead-Inbox), Verkaufs-Pipeline, Auftragsabwicklung mit Einsatzplanung (Plantafel) und digitaler Abnahme, dazu Automatisierung, E-Mail-Marketing, Team-Chat, Telefonie und HR. Alles DSGVO-konform auf EU-Servern. Das Alleinstellungsmerkmal: die **Anbindung an KWP** (das Branchen-ERP, das viele SHK-Betriebe nutzen).
Es ist ein **Produkt für viele Kunden** (Abo-Modell). Die **Geerkens GmbH** ist unser erster Kunde und Investor: dort validieren wir alles am echten Betrieb. Ansprechpartner: **Noah**.
## Das Team
| Wer | Rolle | Bei Fragen zu... |
|---|---|---|
| **Raffael** | Lead-Entwickler + Projektleitung | allem; Gesamtplan, Produkt, Technik, Preise |
| **Akeshan** | Co-Entwickler + Infrastruktur | Plattform, Server, Deployment |
| **David** | Designer | Screens, Design-System, Website-Design |
| **Dejan** | Website-Projekt | Website, Webinar-Technik, Help-Inhalte |
| **Haris** | Vertrieb + Texte | Leads, Calls, Angebote, Website-Texte |
| **Noah** | Geerkens: Validierung + Abnahme | Praxis-Feedback; nimmt alle Außen-Texte ab |
## Der Plan in 5 Zeilen
1. **v1 bauen: 12.06. bis 10.07.** (Launch). v1 ist die Demo- und Verkaufs-Basis: die komplette Kette Anfrage → Verkauf → Auftrag plus Automation, Marketing, Chat.
2. **Website live: 17./18.06.** Ab dann sammeln wir Interessenten.
3. **Verkauf startet vor dem Launch:** erste Calls 23.06., erste Abschlüsse (Founding-Deals) ab 30.06., Webinar 14./15.07.
4. **v2 bauen: 13.07. bis 31.07.** Hier passieren die wichtigsten Features: KWP-Anbindung, Self-Service-Abos, E-Mail-Postfach, Mobile-PWA-Ausbau, Kunden-Portal.
5. **Ziel: erste Gelder bis Ende Juli** und Software inkl. KWP nutzbar am 31.07.
**Arbeitsrhythmus Kern-Team: Montag bis Sonntag, mindestens 8 h täglich.** Devs syncen täglich 9:00.
## Gemeinsame Fixtermine
| Datum | Was |
|---|---|
| Fr 19.06. | Gate Woche 1: Technik-Fundament bewiesen |
| Fr 26.06. | Gate Woche 2 + **Demo 1 für Noah** (CRM klickbar) |
| Fr 03.07. | Gate Woche 3 + **Demo 2 für Noah** (komplette Kette läuft) |
| Do 09.07. | Feature-Freeze (ab da nur noch Fehler fixen) |
| **Fr 10.07.** | **Voll-Walkthrough mit Noah → Go/No-Go → LAUNCH** |
| Di/Mi 14./15.07. | Webinar Nr. 1 |
| Fr 31.07. | v2 komplett live (inkl. KWP) |
## Glossar: die Begriffe aus deinem Handout
| Begriff | Bedeutung |
|---|---|
| **v1 / v2** | v1 = was bis zum Launch (10.07.) gebaut wird. v2 = die zweite Welle direkt danach (bis 31.07.). v2 ist fest zugesagt, nur später |
| **Phase (P1 bis P21)** | Die 21 Bau-Abschnitte des Produkts, z. B. P6 = CRM, P9 = Plantafel. Nummern stehen für Reihenfolge, nicht Wichtigkeit |
| **Milestone (M001 bis M176)** | Die 176 Detail-Bausteine innerhalb der Phasen. In den Dev-Handouts je als 1-Zeilen-Erklärung |
| **Arbeitspaket (AP)** | Ein Block aus deinem Handout: Zeitfenster + Inhalt + „Fertig heißt" (= woran man Fertig erkennt) |
| **Gate** | Freitags-Prüfpunkt: erst wenn der Beweis erbracht ist, gilt die Woche als geschafft |
| **Noah-Demo** | Produkt-Vorführung für Noah an den Gate-Freitagen: seine Praxis-Brille entscheidet |
| **Freeze** | Ab 09.07. werden keine neuen Funktionen mehr eingebaut, nur noch Fehler behoben |
| **CRM / Lead / Deal** | Kundenverwaltung / eingehende Anfrage / Verkaufschance in der Pipeline |
| **Plantafel** | Einsatzplan-Tafel: welcher Monteur ist wann auf welcher Baustelle |
| **Abnahme** | Digitales Abnahme-Protokoll auf der Baustelle (Mängel, Fotos, Unterschrift auf dem Handy) |
| **KWP** | Das ERP-/Kalkulationsprogramm vieler SHK-Betriebe. Unsere Anbindung daran = Haupt-Verkaufsargument, kommt in v2 (deren API-Zugang gibt es erst ~19.07.) |
| **PWA** | „Progressive Web App": die Browser-Version installierbar aufs Handy (Add-to-Homescreen, Service-Worker, Offline): so arbeiten Monteure in v1, in v2 weiter ausgebaut. PWA-only — keine native Store-App in v1/v2 (Expo/Capacitor verworfen, AD-17); native App + App-Store frühestens v3 |
| **Hot-Swap / ui-mock** | Unsere Bau-Technik: Entwickler bauen mit Platzhalter-Oberfläche, Davids Designs werden später angedockt: deshalb blockt kein Design je die Entwicklung |
| **View-Model (VM)** | Das Datenpaket, das ein Screen anzeigt. Trennt Design von Logik |
| **Archetyp (A1 bis A7)** | Wiederverwendbare Design-Bausteine (Listen-Ansicht, Detail-Ansicht, Formular-Kit ...). Einmal designt, überall zusammengesteckt |
| **Bespoke** | Sonder-Screen, der NICHT aus Archetypen zusammensteckbar ist (z. B. Plantafel, Flow-Editor): braucht Tage statt Stunden |
| **Subframe** | Das Design-Werkzeug, in dem David die Screens baut |
| **Konnektor** | Jedes Modul ist einzeln an-/abschaltbar je nach gebuchtem Abo (so verkaufen wir Module einzeln) |
| **Founding-Deal** | Früh-Käufer-Angebot mit Sonderkonditionen, verkaufbar schon VOR dem Launch |
| **Staging** | Test-Umgebung (staging-app.hivegrid.de): hier wird geprüft, bevor etwas live geht. Nur Testdaten! |
| **Gate-Beweis „RLS"** | Technischer Nachweis, dass Kundendaten strikt getrennt sind (kein Kunde sieht je Daten eines anderen) |
## Regeln, die für alle gelten
1. **Alles, was nach außen geht** (Website, Mails, Angebote, Folien), schreibt Haris und **nimmt Noah ab**.
2. **Deadlines im eigenen Handout sind verbindlich**; wer früher fertig ist, meldet sich bei Raffael (es gibt einen vorab beschlossenen Plan für gewonnene Zeit).
3. **Blocker sofort melden**, nicht erst am Gate-Freitag: bei Raffael oder im 9:00-Sync.
4. Keine echten Kundendaten auf Test-Systemen, keine Screenshots mit echten Daten nach außen.
@@ -0,0 +1,309 @@
---
pdf_options:
format: A4
margin: 16mm
css: |-
body { font-size: 10.5px; font-family: -apple-system, "Segoe UI", Helvetica, Arial, sans-serif; }
h1 { font-size: 19px; }
h2 { font-size: 14px; border-bottom: 2px solid #f5a623; padding-bottom: 3px; margin-top: 20px; break-after: avoid; page-break-after: avoid; }
h3 { font-size: 12px; break-after: avoid; page-break-after: avoid; }
table { font-size: 9.5px; border-collapse: separate; border-spacing: 0; width: 100%; border-top: 1px solid #ccc; border-left: 1px solid #ccc; }
thead { display: table-header-group; }
tr { break-inside: avoid !important; page-break-inside: avoid !important; }
td, th { break-inside: avoid !important; border-right: 1px solid #ccc; border-bottom: 1px solid #ccc; padding: 3px 5px; vertical-align: top; }
th { background: #fff7e8; }
li { break-inside: avoid; }
p { orphans: 3; widows: 3; }
code { background: #f4f4f4; padding: 1px 3px; font-size: 9px; }
.pagebreak { page-break-after: always; }
---
# HANDOUT AKESHAN: Co-Dev
**Mission:** Plattform-Flächen (Files, Admin, HR, Marketing, Chat, Forms/Booking, Billing) + Infra/Ops. v1 bis 10.07., dein v2-Anteil (26 MS: Portal, Mobile, Help u. a.) bis 31.07.
**Arbeitsrhythmus:** Mo bis So, täglich mind. 8 h · 9:00 Dev-Sync mit Raffael · Integration auf `main` täglich.
**Wichtigste Verträge (aus P1, halten dich frei):** View-Models ohne React (ESLint erzwingt es) · jeder Screen dockt via Subframe-Adapter an · `tenantHasModule()`-Konnektor je Modul ist Merge-Pflicht · jede Mutation auditet + benachrichtigt über die P1-Kerne.
## Timeline auf einen Blick
| Datum | Paket |
|---|---|
| Fr bis So 12. bis 14.06. | AP-1: P1 Strang C (Hot-Swap-Maschine) |
| Mo bis Mi 15. bis 17.06. | AP-2: Infra LIVE (Staging, DBs, DNS, zentrale Dienste) |
| Mi bis Fr 17. bis 19.06. | AP-3: P4 Files & Tasks |
| Sa/So 20./21.06. | AP-4: P3 Querschnitts-Oberflächen |
| Mo bis Mi 22. bis 24.06. | AP-5: P19 Plattform-Admin |
| Do/Fr 25./26.06. | AP-6: P17 HR-Hub + Demo-Daten für Noah-Demo 1 |
| Sa bis Mo 27. bis 29.06. | AP-7: P14 Email & Marketing |
| Di bis Do 30.06. bis 02.07. | AP-8: P15 Telefonie & Chat |
| Fr 03. bis Di 07.07. | AP-9: P16 Kalender/Booking/Forms/Signatur (größte Phase!) |
| Mi/Do 08./09.07. | AP-10: P20 Billing + AP-11: P21 DSGVO, dann FREEZE |
| Fr 10.07. | [LAUNCH] Launch-Support (Deploy, Monitoring) |
| Mo 13. bis Fr 17.07. | AP-12: Self-Service-Abo-UI + Postfach-Sync |
| Sa/So 18./19.07. | AP-13: Wizard-UI |
| Mo 20. bis Mi 22.07. | AP-14: Customer-Portal |
| Do 23. bis Mo 27.07. | AP-15: Mobile-PWA-Ausbau (PWA-only, AD-17) |
| Di 28. bis Do 30.07. | AP-16: Help-Center + Help-Desk |
| Mi 29. bis Fr 31.07. | AP-17: Dashboard-Deluxe + Querschnitt-Nachzügler |
## Schnittstellen: was du bekommst, was andere von dir brauchen
**Du bekommst:**
| Von | Was | Wann |
|---|---|---|
| Raffael | Service-Kerne aus P1 (Audit, notify, Flags, i18n): Pflicht-Unterbau für alles, was du baust | Di 16.06. |
| Raffael | Hetzner-Projekt `HiveGrid` + Keys (er legt es Mo an) | Mo 15.06. |
| Raffael | Apps-Engine-Vertrag (P5): deine AirCall/PandaDoc/Google-Anbindungen laufen darüber | So 21.06. |
| Raffael | CRM-Entitäten (P6): Marketing-Segmente, Chat-Links, Booking→Lead brauchen Contacts | Mi 24.06. |
| David | Screen-Pakete: HR + Form-Builder + Kampagnen-Editor 26.06. · Chat 01.07. · Booking + Kalender 03.07. · Abo-UI 16.07. · Portal 19.07. · Mobile-Shell 22.07. | je Deadline |
| Dejan | Subframe-Lizenz | Fr 12.06. |
**Andere brauchen von dir:**
| Wer | Was | Wann |
|---|---|---|
| Raffael | Hot-Swap-Maschine + Skeleton (P1 Strang C): sein P2 baut dagegen | Di 16.06. |
| alle | Staging-Umgebung + CI (Gates laufen darauf!) | Mi 17.06. |
| Raffael | EntityLink-Tabelle (P4): sein P6 verdrahtet Task-CRM-Links damit | Fr 19.06. |
| Raffael | HR-Abwesenheits-Daten (P17): seine Plantafel zeigt Urlaub/krank als Konflikt | Fr 26.06. |
| Noah/Demo | Demo-Tenant mit CRM-Daten via Admin eingerichtet (für Demo 1) | Fr 26.06. früh |
| Haris | Funktionierender Demo-Tenant auf Staging für seine Klick-Demos | ab Mo 30.06. |
| Dejan | Help-Center-System (er pflegt die Inhalte ein) | Di 28.07. |
## AP-1: P1 Strang C, die Hot-Swap-Maschine (Fr bis So 12. bis 14.06.)
**Was:** Die Maschine, die Designer-Screens jederzeit andocken/tauschen lässt. Raffael baut parallel Stränge A+B.
**Fertig heißt:** Hot-Swap-Drill grün (CI tauscht echtes UI gegen ui-mock, App läuft weiter) · eine Beispiel-Route lädt VM gegen Mock · Visual-Reg-Gate inkl. Mobile-Viewport aktiv.
| Milestone | Inhalt |
|---|---|
| M012 workspace-topologie | Monorepo-Schnitt: packages (ui-app/ui-subframe/ui-mock/foundation), Naming-Drift fixen (AD-10) |
| M013 view-model-konvention | VM = reines Datenobjekt aus dem Loader; ESLint verbietet React-Import im VM-Paket |
| M014 action-callback-contract | UI bekommt nur VM + typisierte Callbacks; keine Fetches aus Komponenten |
| M015 subframe-adapter-layer | Dünne Mapping-Schicht Subframe-Screen ↔ VM-Slots; Designer-Output bleibt unangetastet |
| M016 visual-regression-gate | Playwright-Baselines, Diff > Threshold bricht Build mit Klartext-Liste; Mobile-Viewport Pflicht |
| M017 hot-swap-drill | CI-Job: ui-mock-Tausch muss grün bleiben (beweist die Trennung) + PWA-Manifest + Walking-Skeleton-Route mit `tenantHasModule()`-Demo |
## AP-2: Infra LIVE (Mo bis Mi 15. bis 17.06.)
**Was:** Die komplette Laufzeit-Umgebung. **Alles nach Infra-Repo-Muster (`~/Documents/GitHub/infra`), nichts neu erfinden.**
**Fertig heißt:** CI deployt auf Staging, Gates können laufen.
| Aufgabe | Inhalt |
|---|---|
| Coolify-Apps | Auf `staging-1` anlegen (Muster: die 8 Boilerplate-Apps dort); Registry = Gitea, build-once/promote |
| Staging öffentlich + gehärtet | `staging-app.` + `staging-api.hivegrid.de` · NUR synthetische Daten · eigene Secrets je Umgebung · noindex · Webhooks HMAC + Rate-Limit |
| Datenbanken | Coolify-managed Postgres + Redis; PgBouncer liegt auf staging-1 |
| DNS + TLS | Cloudflare (`hivegrid.de`-Zone existiert!), ein `*.hivegrid.de`-Wildcard (CT-Log-Leak vermeiden) |
| Zentrale Dienste anbinden | mCaptcha (`captcha.saas-ctrl.com`) · ClamAV (zentral) · Meilisearch: scoped Key auf node1 minten (`hivegrid-*`, `MEILI_API_KEY`) · Sentry/Loki. **Läuft alles, nur ENV!** |
| Prod-Vorbereitung | Hetzner-Projekt `HiveGrid` (Raffael legt an): `hivegrid-db/-app/-worker/-lb` + S3-Bucket |
## AP-3: P4 Files & Tasks (Mi bis Fr 17. bis 19.06.)
**Was:** Die nutzerseitigen Primitive, die jedes Modul wiederverwendet.
**Fertig heißt:** Upload chunked mit RLS-Pfaden auf Hetzner-S3 · **HEIC→JPG-Konvertierung läuft** (iPhone-Monteur-Fotos!) · Task-Listen-Pattern als wiederverwendbare Komponente · polymorphe EntityLink-Tabelle (Extension-Point für CRM & Portal).
| Milestone | Inhalt |
|---|---|
| M052 datei-upload | Chunked Upload (TUS), Multi-Datei-Queue, Fehler+Retry, ClamAV-Scan (zentral) |
| M053 speicher-backend | Hetzner-S3 (Name sagt Scaleway, gilt nicht mehr!), `tenants/{id}/`-Pfade, Signed-URLs |
| M054 permissions-sharing | Datei-Rechte + Sharing + Bild/PDF-Preview + HEIC→JPG; Versionierung/Office-Video ruht (v2) |
| M055 suche-tagging-archiv | Tags + Dateiname-Suche via Meilisearch + Archiv-Flag; OCR ruht (v2) |
| M071 aufgaben-crud | Task-Entity: Status, Priorität, Fälligkeit, Assignee (Person/Gruppe), Watcher |
| M072 aufgaben-listen | Task-Listen-Komponente wiederverwendbar (P12/P14/P16 betten sie später selbst ein) |
| M073 erinnerungen | Reminder über notify() (In-App + Email), Anti-Spam, Auto-Archiv-Cron 30 Tage |
## AP-4: P3 Querschnitts-Oberflächen (Sa/So 20./21.06.)
**Was:** Die Bedien-Oberflächen zu Raffaels P1-Kernen. DE-only.
**Fertig heißt:** Audit-Viewer mit Export läuft · Notification-Center + Kategorie-Toggles · `verify:i18n` grün mit vollständiger de-Locale.
| Milestone | Inhalt |
|---|---|
| M028 sprach-settings | DE-Defaults (Auflösungskette/Timezone ruht, v2); Profil zeigt Sprache fest DE |
| M115 notifications-center | Topbar-Bell + Drawer/Seite: Einträge, Tabs, mark-read, Deeplinks |
| M116 user-settings | Pro Event-Typ In-App/Email-Toggle, Master-Toggle; kanal-erweiterbar gebaut (Push-Sektion kommt v2) |
| M151 audit-anzeige | Audit-Viewer: Filter, deutscher Summary-Text, Detail-Drawer mit Diff |
| M152 export-aufbewahrung | CSV/NDJSON-Export (Zweck-Pflichtfeld) + fixe Default-Retention (Konfigurierbarkeit v2) |
## AP-5: P19 Plattform-Admin (Mo bis Mi 22. bis 24.06.)
**Was:** Die Betriebs-Konsole auf `admin.hivegrid.de`. **Harte Auflagen (Scope-Schnitt 12.06.):** Admin-User bekommen KEINEN Tenant-Workspace · Host-Routing admin.hivegrid.de (Code routet bisher `/admin`-Pfad!) · Cookie-Domain-Trennung zu app.* · TOTP-Pflicht + MFA-Step-up (Boilerplate-Modell, keine getrennte Identität bis v2).
**Fertig heißt:** Tenant anlegen/verwalten + **Abo-Zusammenstellung** (Konnektoren je Tenant schalten + Stripe-Positionen) + Impersonation mit Begründungs-Pflicht + Queue-Monitoring.
| Milestone | Inhalt |
|---|---|
| M031 flag-schalter-lifecycle | Flag-Admin-UI: Schalter, Lifecycle (beta/rollout/ga), Tenant-Override mit Ablauf |
| M032 flag-filter-editor | Targeting-Editor (plan-tier, Branche, Größe) mit Live-Vorschau |
| M034 admin-auth | admin.hivegrid.de-Login (Host-Routing + Cookie-Trennung + TOTP-Pflicht + Auflagen oben) |
| M035 admin-dashboard | Basis-KPIs: Tenants, aktive User, MRR, Health-Ampel (Churn/ARPU v2) |
| M036 mandanten-verwaltung | Tenant-Liste/Detail, Status-Wechsler, manuelle Anlage mit Begründung, Notizen, **Abo-Baukasten-Schalter** |
| M037 stellvertreter-anmeldung | Impersonation mit Reason-Pflicht + Banner + Audit (Boilerplate liefert den Kern) |
| M041 system-health-support | Health-Ampeln, BullMQ-Queue-Monitor (Retry/Pause), Support-Inbox (generische Quelle, Feedback-Widget speist ein) |
## AP-6: P17 HR-Hub (Do/Fr 25./26.06.)
**Was:** Personalprozesse, verschlüsselt. Voll (inkl. Surveys), ohne Memberspot (v2).
**Fertig heißt:** Urlaub/Krankmeldung E2E mit Genehmigung · AU-Upload verschlüsselt (AES-256-GCM, app-seitige Envelope-Encryption, Master-Key in Coolify-Secrets) · Abwesenheiten erscheinen in der Plantafel (Extension-Point liegt in P9).
| Milestone | Inhalt |
|---|---|
| M133 mitarbeiter-stammdaten | HR-Profile (verschlüsselte Felder), MA-Verzeichnis, Standorte |
| M134 dokumente | Lohnabrechnungen (Einzel-/Bulk-Upload mit Auto-Match), Upload-Erinnerungen, Passwort-Safe (Reveal audit-geloggt) |
| M135 urlaub | Antrag → Genehmigung → Plantafel-Konflikt-Anzeige; Resturlaubs-Logik |
| M136 krankmeldungen | Krankmeldung + AU-Bescheinigung (verschlüsselt) + Büro-Benachrichtigung |
| M137 mitarbeiter-kommunikation | Announcements mit Bestätigungs-Pflicht + Read-Receipts, Reaktionen, Kommentare |
| M139 berichte-lohn-export | Lohn-Export für Steuerberater + Mitarbeiter-Surveys (Rating/NPS, Auswertungs-Charts) |
| M140 selbstbedienung | MA-Self-Service: eigene Daten, eigene Anträge, eigene Payslips (Web/PWA, Push v2) |
**Außerdem Fr 26.: CRM-Demo-Daten für Noah-Demo 1 via Admin einrichten.**
## AP-7: P14 Email & Marketing (Sa bis Mo 27. bis 29.06.)
**Was:** Marketing VOLL (löst HubSpot-Marketing ab); Postfach-Sync kommt erst v2, es bleibt: Sende-Domain + BCC-Brücke.
**Fertig heißt:** Kampagne an Test-Segment versendet (echter Versand Gate W3!) · Domain-Verifikation grün · BCC-Mail erscheint am Kontakt · Unsubscribe rechtssicher.
| Milestone | Inhalt |
|---|---|
| M099 tracking-bounces | Open/Click-Tracking, Bounce-Handling, Suppression-Liste (Mailjet-Webhooks) |
| M100 editor | Kampagnen-Editor (Davids Screen): Personalisierungs-Tokens, Pflicht-Footer, Templates selbst seeden |
| M101 segmente | Dynamische/statische Segmente mit Live-Anzahl + Ausschluss-Aufschlüsselung |
| M102 versand-engine | BullMQ-Versand mit Rate-Limit über Mailjet; Checkliste blockiert bei roter Domain |
| M103 ab-tests-reporting | A/B-Varianten + Stats (Zugestellt/Geöffnet/Geklickt/Klick-Map) |
| M104 unsubscribe-bounces | Öffentliche Unsubscribe-Page (Token), Gründe, Suppression-Pflege |
| + BCC-Brücke | `crm@tenant…`-BCC-Adresse: eingehende Kopie wird am Kontakt-Activity-Stream geloggt (Inbound-Infra, kein OAuth) |
## AP-8: P15 Telefonie & Chat (Di bis Do 30.06. bis 02.07.)
**Was:** AirCall + Team-Chat VOLL („ultra wichtig": Threads/Reactions/Pins bleiben).
**Fertig heißt:** Click-to-Call aus Kontakt · eingehender Anruf zeigt Notification mit Kontakt-Match · Chat realtime (WebSocket, AD-9) mit Projekt-Channels.
| Milestone | Inhalt |
|---|---|
| M106 aircall | AirCall-Connect über Apps-Engine + User-Binding (Auto-Match per Email) |
| M107 anruf-eingang | Inbound-Webhook → Kontakt-Match (E.164) → Notification + Activity |
| M108 anruf-ausgang | Click-to-Call + Anruf-Session + Nach-Anruf-Notiz-Prompt |
| M109 voicemail-notizen | Voicemail-Handling + Notiz-Editor (Markdown) + Aufnahme-Links |
| M110 channel-permissions | Channels (Gruppe/DM/Projekt-Auto-Channel) mit Rechten + Auto-Archiv bei Projekt-Ende |
| M111 direkt-nachrichten | DMs mit Reuse-Logik, Read-Receipts |
| M112 anhaenge | Datei-Anhänge im Chat (über P4-Files), Channel-Datei-Übersicht |
| M113 modul-verknuepfungen | Entity-Links im Chat (Deal/Projekt referenzieren), System-Messages (z. B. Anruf verpasst) |
| M114 mentions-push | @-Mentions + Mentions-Aggregat + Notification (In-App/Email; Push v2) |
## AP-9: P16 Kalender, Booking, Forms, Signatur (Fr 03. bis Di 07.07., größte Phase!)
**Was:** 15 MS in 4,5 Tagen. **Davids Screens (Form-Builder ist seit 26.06. fertig designt) liegen bereit.** Kalender NUR Google.
**Fertig heißt:** Öffentliche Booking-Page bucht E2E (Slot → Lead + Bestätigung + .ics) · Form-Builder mit Conditional Logic published Formulare · Signatur-Flow über PandaDoc trackt Status.
| Milestone | Inhalt |
|---|---|
| M118 google-adapter | Google-Calendar-OAuth (Verifizierung läuft seit 15.06.; Testmodus-Fallback) |
| M119 termin-sync | Bidirektionaler Termin-Sync + Plantafel-Anbindung (Retro in P9-Slots) |
| M120 display-verknuepfung | Kalender-Ansicht (Monat/Woche) + Termine an Entitäten |
| M121 form-editor | Form-Builder-Canvas: 12 Feldtypen, Drag&Drop, SHK-Templates (selbst seeden), Live-Vorschau |
| M122 veroeffentlichung | Öffentliche URL `/f/{tenant}/{slug}` + QR + iFrame (personalisierte Links/JS-Snippet v2) |
| M123 submission-eingang | Submissions-Tabelle + Post-Submit-Actions (Lead/Deal/Task, Email, Webhook, Automation-Trigger) |
| M124 conditional-display | Conditional Logic („zeige X wenn Y=Z") im Builder UND im Public-Rendering |
| M125 rate-limit-captcha-dsgvo | mCaptcha auf Public-Forms, Rate-Limits, DSGVO-Checkbox-Pflicht |
| M126 time-slot | Slot-Berechnung timezone-aware aus Verfügbarkeitsregeln + Puffer |
| M127 verfuegbarkeit | Wochenregeln + Ausnahme-Tage je Mitarbeiter; eine Zuteilungs-Strategie („erster freie") |
| M128 bestaetigung | Buchung → Lead + Activity + Bestätigungs-Mail + .ics |
| M129 stornierung | Storno mit Begründung + Auto-Mail, Verschieben mit Slot-Picker, Re-Assignment, No-Show (VOLL, deine Ansage) |
| M130 angebot-erstellung | Angebots-PDF am Deal vorbereiten |
| M131 pandadoc-docusign | PandaDoc-Anbindung über Apps-Engine (DocuSign optional später) |
| M132 status-tracking | Signatur-Status je Unterzeichner + Reminder + Widerruf + Deal-Activity |
## AP-10: P20 Billing & Onboarding (Mi 08. bis Do 09.07.)
**Was:** Stripe mit dem **Abo-Baukasten-Recut**: Basis-Preis pro Nutzer + Feature-Module als Stripe-Positionen. KEINE Seat-Typen! Vorlage: `archive/hivegrid-cloud/app/config/pricing-plans.ts` (Core/Swarm/Colony, 14 Gates). Boilerplate-Billing ist HIGH-Coverage (14 Modelle, ~40 Stripe-Funktionen, `packages/entitlements`).
**Fertig heißt:** Admin stellt Tenant-Abo zusammen → Konnektoren schalten frei → Stripe rechnet ab · Trial → Frozen-Modus funktioniert · Demo-Daten-Knopf liefert 25 Datensätze.
| Milestone | Inhalt |
|---|---|
| M030 hell-dunkel | Nur Hell/Dunkel-Toggle, flash-frei (next-themes aus Boilerplate; KEIN System-Modus) |
| M153 stripe | Stripe-Anbindung: Checkout, Webhooks, Portal-Embed; ersetzt den Subscription-Stub aus P2 |
| M154 abo-baukasten | Recut: Basis-Preis/Nutzer + Module als Positionen via Entitlements × Flag-Engine (Preise aus Kostenmatrix 25.06.) |
| M155 trial-readonly | 14-Tage-Trial ohne Karte, Dunning-Sequenz, Frozen = Read-Only-Middleware |
| M156 metering | Verbrauchs-Zähler (Automation-Läufe, AI-Tokens, Speicher) + Fair-Use-Drossel (Abrechnung v2) |
| M158 shk-provisionierung | Signup-Auto-Seed orchestriert die Self-Seeds aller Module (AD-12; ohne Wizard) |
| M159 branchen-templates | Template-Framework, v1 nur SHK befüllt |
| M160 demo-daten | Settings-Knopf: 25 Demo-Datensätze mit is_demo_data-Flag + Lösch-Funktion (KI-Walkthrough v2) |
## AP-11: P21 DSGVO & Launch (Do 09.07., dann FREEZE)
| Milestone | Inhalt |
|---|---|
| M164 daten-export | Tenant-Voll-Export als ZIP via Worker, 72h-Signed-URL (Hetzner-S3) |
| M165 loesch-workflow | Tenant-Löschung: Multi-Step mit Slug-Confirm, 30-Tage-Grace, Crypto-Shredding |
| + Feedback-Widget | Schwebender Button → Mini-Form → Admin-Support-Inbox (P19) |
<div class="pagebreak"></div>
## v2-Pakete (13. bis 31.07.)
### AP-12: Self-Service-Abo-UI + Postfach-Sync (Mo 13. bis Fr 17.07.)
**Fertig heißt:** Kunde toggelt Module mit Preis-Vorschau selbst (Revenue ohne Admin-Handgriff) · Outlook-Postfach synct (Gmail im Testmodus bis Google-Verifizierung durch ist).
| Milestone | Inhalt |
|---|---|
| Abo-UI (M154-Teil) | Self-Service-Baukasten: Module togglen, Preis-Vorschau, Stripe-Update live |
| M096 sync-strategie | OAuth-Postfach-Anbindung (Entra/Outlook zuerst; Gmail-Scopes laufen bei Google) |
| M097 inbox-view | Inbox mit Threading, Auto-Verknüpfung an Kontakt/Deal (Match-Confidence + Override) |
| M098 provider-versand | Mail-Versand aus HiveGrid über das verbundene Postfach (Compose, Reply, Vorlagen) |
### AP-13: Wizard-UI (Sa/So 18./19.07.)
| Milestone | Inhalt |
|---|---|
| M157 wizard | 10-Schritte-Setup-Wizard (Firmendaten, Logo, Smart-Setup-Vorschau, Demo-Daten, Einladungen) + KI-Walkthrough-Rückläufer |
### AP-14: Customer-Portal (Mo 20. bis Mi 22.07.)
**Andockpunkte liegen seit v1:** FileEntityLink, Portal-URL-Pfad, Magic-Link-Auth (AD-3).
| Milestone | Inhalt |
|---|---|
| M141 datenmodell | Portal-User + Tenant-Mapping + Sichtbarkeits-Regeln |
| M142 auth-magic-link | Magic-Link-Login für Endkunden (keine Passwörter) |
| M143 projekt-sicht | Endkunde sieht seine Projekte: Status, Termine, freigegebene Dokumente |
| M144 upload | Endkunden-Upload (Fotos/Dokumente) über FileEntityLink |
| M145 skalierung | Benachrichtigungen an Endkunden, Service-Team-Rolle, Mehr-Projekt-Fälle |
| M146 dsgvo | Portal-Konto-Löschung + Datenauskunft für Endkunden |
### AP-15: Mobile-PWA-Ausbau (Do 23. bis Mo 27.07.)
**Mobile ist PWA-only in v1 und v2 (AD-17) — Expo/Capacitor verworfen, keine native App, kein App-Store (frühestens v3).** OfflineSyncQueue aus P9 ist PWA-ready (Storage-Interface), Push-Stub liegt in notify().
| Milestone | Inhalt |
|---|---|
| M167 pwa-shell | Installierbare PWA: App-Shell, Tab-Bar, Auth, Tenant-Kontext, Add-to-Homescreen (Davids Mobile-Shell-Screens) |
| M168 web-push | Web-Push (VAPID) über den ruhenden notify()-Push-Kanal + Geräte-/Subscription-Verwaltung |
| M169 monteur-flows | Meine Termine / Projekt-Detail / Abnahme / Foto-Upload mobil-optimiert |
| M170 offline-sync | IndexedDB-Storage hinter der OfflineSyncQueue, Service-Worker, Offline-Härtung, Konflikt-Strategie |
| M171 pwa-haertung | PWA-Härtung: Standalone-Modus, iOS-Safari ≥16.4 für Web-Push, Installierbarkeit/Manifest, Offline-Fallbacks (App-Store-Einreichung entfällt → v3) |
### AP-16: Help-Center + Help-Desk (Di 28. bis Do 30.07.)
| Milestone | Inhalt |
|---|---|
| M172 help-center | Öffentliche Markdown-Help-Site mit Suche + Deep-Links aus der App |
| M173 artikel-pipeline | Content-Verwaltung (Dejan pflegt Inhalte ein) |
| M174 help-desk | Ticket-System: das Feedback-Widget + Support-Inbox aus v1 wird zum vollen Desk |
| M175 kb-integration | Hilfe-Vorschläge kontextuell in der App |
### AP-17: Dashboard-Deluxe + Querschnitt (Mi 29. bis Fr 31.07.)
| Milestone | Inhalt |
|---|---|
| M149 custom-widgets | Eigene Widgets konfigurieren (Datenquelle, Filter, Darstellung) |
| M150 export-report | Dashboard-Export / Report-Generator |
| M117 buendelung-quiet-hours | Notification-Bündelung (5-Min-Fenster), Quiet-Hours, Push-Limits |
| M029 sprach-wechsler | Sprach-Wechsler + EN-Locale + Auflösungskette (alles ist i18n-ready aus v1) |
| M033 flag-statistik | Flag-Massen-Statistik im Admin |
| M040 plattform-lead-pipeline | Eigene Sales-Pipeline für HiveGrid-Interessenten im Admin |
| M138 drittanbieter-onboarding | Memberspot/Boobora-Anbindung im HR-Onboarding |
---
*Quellen für Tiefe: `docs/milestones/M0xx-*/PLAN.md` je Milestone · `SCREEN-MAP.md` (UI-Inhalte präzise) · `PHASE-SOURCES.md` (Retro-Integrationen + Auflagen) · Infra-Repo `~/Documents/GitHub/infra` (README + runbooks). Bei Phasen-Start: `/gsd-plan-phase N`.*
@@ -0,0 +1,86 @@
---
pdf_options:
format: A4
margin: 16mm
css: |-
body { font-size: 10.5px; font-family: -apple-system, "Segoe UI", Helvetica, Arial, sans-serif; }
h1 { font-size: 19px; }
h2 { font-size: 14px; border-bottom: 2px solid #f5a623; padding-bottom: 3px; margin-top: 20px; break-after: avoid; page-break-after: avoid; }
h3 { font-size: 12px; break-after: avoid; page-break-after: avoid; }
table { font-size: 9.5px; border-collapse: separate; border-spacing: 0; width: 100%; border-top: 1px solid #ccc; border-left: 1px solid #ccc; }
thead { display: table-header-group; }
tr { break-inside: avoid !important; page-break-inside: avoid !important; }
td, th { break-inside: avoid !important; border-right: 1px solid #ccc; border-bottom: 1px solid #ccc; padding: 3px 5px; vertical-align: top; }
th { background: #fff7e8; }
li { break-inside: avoid; }
p { orphans: 3; widows: 3; }
code { background: #f4f4f4; padding: 1px 3px; font-size: 9px; }
.pagebreak { page-break-after: always; }
---
# HANDOUT DAVID: Designer (App-Screens + Website-Screens)
**Mission:** ~95 v1-Screens (12 Bespoke + ~83 aus Archetypen) + Website-Screens + v2-Screens (Portal, Mobile, Help). Präzise Inhalte je Screen: **SCREEN-MAP.pdf, liegt in diesem Ordner: das ist deine Arbeitsliste.** Dazu DESIGNER-FIRST-PLAYBOOK.pdf (Archetypen-Logik + Übergabe-Checkliste) und 00-PROJEKT-BRIEFING.pdf (zuerst lesen).
**Das Wichtigste zuerst:** Kein Screen blockt je einen Entwickler (Hot-Swap: Devs bauen gegen ui-mock, dein Screen dockt nachträglich an). Deine Deadlines sind Demo-/Politur-Termine. ABER: D0 ist der Hebel, der 70 % aller Screens zu Stunden-Arbeit macht: D0 zuerst, ohne Kompromiss.
**Werkzeug:** Subframe (Lizenz kommt von Dejan am 12.06.).
## Die 3 Regeln (aus dem Playbook in diesem Ordner)
1. **Designe aus der Element-Liste der SCREEN-MAP, nicht frei.** Jedes angezeigte Feld braucht eine Datenquelle, jeder Button eine Aktion. Sonst entstehen „unmögliche Daten".
2. **Pro Screen vor Übergabe die Checkliste:** alle Felder haben Datenquellen ✓ alle Aktionen mappen auf Operationen ✓ **4 Zustände designt: leer / laden / Fehler / keine Berechtigung** (Pflicht, sind VM-Zustände!) ✓
3. **Die Bespoke-Langläufer (Flow-Editor, Form-Builder) sofort parallel anskizzieren**, auch wenn ihr Bau erst spät kommt. Sie sind dein kritischer Pfad.
## Timeline
| Deadline | Paket | Inhalt (Details: SCREEN-MAP §) |
|---|---|---|
| **Sa 13.06.** | Website-Screens an Dejan | Landing, Features, Pricing-Teaser, Demo-Formular, Webinar-Warteliste · Brand-Tokens (Farben/Typo/Spacing) dienen Website UND App |
| Mo/Di 15./16.06. | Website-Support + D0-Start | Feinschliff für Dejan · App-Shell beginnen |
| **So 21.06.** | **D0 KOMPLETT** (§0) | App-Shell (Sidebar mit Konnektor-Gating, Topbar, Banner-System) + Archetypen A2 bis A7 (List/Detail/Form/Modal/Settings/Zustands-Kit) + Primitives + Auth-Screens (§1) |
| ab Mo 22.06. | täglich 1 h Flow-Editor | Schwierigste UI der App, braucht Iterationszeit |
| **Mi 24.06.** | CRM-Cluster (§2) | Kontakt/Firma/Lead-Listen + Detail mit Activity-Stream + **Lead-Promotion-Modal** + P3/P4-Composes → **Noah-Demo 1 am Fr zeigt deine Screens!** |
| **Fr 26.06.** | Bespoke-Welle 1 (§3) | **Sales-Kanban** · **Form-Builder-Canvas** (+Conditional-Logic-Editor) · **Kampagnen-Editor** · HR-Composes · Admin-Composes |
| **Mi 01.07.** | Bespoke-Welle 2 (§4) | **Plantafel** (Monteur mobile-first, Offline-Zustände!) · **Abnahme-Flow** (Touch-Unterschriften!) · **Chat** |
| **Fr 03.07.** | Bespoke-Welle 3 (§5) | **Flow-/Node-Editor final** · **Dashboard** (3 feste Rollen-Layouts + Cmd+K) · **Booking-Page (öffentlich, höchster Polish!)** · Kalender |
| Mo 06.07. | Rest-Composes (§6) | KI-Settings, AirCall, Sende-Domain, Abo-Übersicht, Privacy-Hub, Feedback-Widget |
| Mo bis Do 06. bis 09.07. | Politur + Baselines | Extern sichtbare Flächen (Booking, Form-Pages, Marketing-Mails) · Visual-Reg-Baselines final (Do, vor Freeze) |
| Fr 10.07. | [LAUNCH] | Standby für Hotfixes |
## v2-Screens (13. bis 31.07.)
| Deadline | Paket |
|---|---|
| Do 16.07. | Self-Service-Abo-UI (Akeshan baut ab 13.07. dagegen!) · Onboarding-Wizard (10 Schritte) · Postfach-Inbox (Liste, Thread, Compose) |
| So 19.07. | **Portal-Shell**: extern sichtbar, eigene Design-Sprache, höchster Polish (Endkunden-Projekt-Sicht, Magic-Link-Login, Upload) |
| Mi 22.07. | **Mobile-PWA-Shell**: eigenes Touch-Paradigma, Tab-Bar, Monteur-Flows, Offline-Zustände, Add-to-Homescreen/Standalone-Modus (Expo/Capacitor verworfen — PWA-only, AD-17) |
| Mo 27.07. | Help-Center (Public-Content-Site) — App-Store-Screenshots/Assets entfallen (PWA-only, → v3) |
| Fr 31.07. | Politur Portal + Mobile-PWA |
## Schnittstellen: was du bekommst, was andere von dir brauchen
**Du bekommst:**
| Von | Was | Wann |
|---|---|---|
| Dejan | Subframe-Workspace + Lizenz | Fr 12.06. |
| Raffael/Akeshan | Feedback je Screen (Reconciliation: hat jedes Feld eine Datenquelle?) | < 24 h nach Übergabe |
| Haris | Website-Texte (du designst die Screens, er liefert die Worte) | parallel 13. bis 15.06. |
| (Ordner) | SCREEN-MAP.pdf = präziser Inhalt jedes Screens · Playbook = Methodik | liegt bei |
**Andere brauchen von dir:**
| Wer | Was | Wann |
|---|---|---|
| Dejan | Website-Screen-Designs (Landing, Features, Formulare) + Brand-Tokens | **Sa 13.06.** |
| Raffael | CRM-Screens (Demo 1!) 24.06. · Kanban 26.06. · Plantafel 01.07. · Flow-Editor + Dashboard + Cmd+K 03.07. · KI-Panel 06.07. | je Deadline |
| Akeshan | HR + Form-Builder + Kampagnen-Editor 26.06. · Chat 01.07. · Booking + Kalender 03.07. · Abo-UI 16.07. · Portal-Shell 19.07. · Mobile-Shell 22.07. · Help 27.07. | je Deadline |
| Haris | Screens fürs Pitch-Deck (D0/Auth reicht) | Fr 19.06. |
| — | App-Store-Screenshots/Assets entfallen (PWA-only, → v3) | — |
| CI/alle | Visual-Reg-Baselines final (vor dem Freeze!) | Do 09.07. |
## Prioritäts-Merkzettel
1. **D0 schlägt alles.** Jeder Tag D0-Verzug verzögert 70 % der Screens.
2. **Öffentliche Flächen** (Booking-Page, Form-Pages, Marketing-Mails, später Portal) bekommen den Polish, interne Admin-Screens bewusst nicht (Anti-Regel der Beschleunigungs-Leiter).
3. **Mobile-first gilt für Monteur-Flächen** (Plantafel „Meine Termine heute", Projekt-Detail, Abnahme, Foto-Upload): die laufen in v1 als PWA auf dem iPhone.
4. Bei Fragen, ob ein Feld/Button existiert: SCREEN-MAP, dann Raffael fragen, NIE einfach dazuerfinden.
@@ -0,0 +1,88 @@
---
pdf_options:
format: A4
margin: 16mm
css: |-
body { font-size: 10.5px; font-family: -apple-system, "Segoe UI", Helvetica, Arial, sans-serif; }
h1 { font-size: 19px; }
h2 { font-size: 14px; border-bottom: 2px solid #f5a623; padding-bottom: 3px; margin-top: 20px; break-after: avoid; page-break-after: avoid; }
table { font-size: 9.5px; border-collapse: separate; border-spacing: 0; width: 100%; border-top: 1px solid #ccc; border-left: 1px solid #ccc; }
thead { display: table-header-group; }
tr { break-inside: avoid !important; page-break-inside: avoid !important; }
td, th { break-inside: avoid !important; border-right: 1px solid #ccc; border-bottom: 1px solid #ccc; padding: 3px 5px; vertical-align: top; }
th { background: #fff7e8; }
li { break-inside: avoid; }
p { orphans: 3; widows: 3; }
code { background: #f4f4f4; padding: 1px 3px; font-size: 9px; }
---
# HANDOUT DEJAN: Website-Projekt + Launch-Support
**Mission:** Website **LIVE am Mi 17.06. (Puffer Do 18.06.)**, danach Pflege, Webinar-Landing, Help-Inhalte. Die Website ist ab 18.06. der Inbound-Lead-Kanal für Haris und ab Launch das Schaufenster.
**Zulieferungen an dich:** Screens von David (Sa 13.06.) · Texte von Haris, abgenommen von Noah (Mo 15.06. früh) · Rechtstexte aus dem Anwalt-Paket (Raffael beauftragt 12.06.) · Preise erst ab 25.06. (Pricing-Seite vorbereiten, live später).
## Arbeitspakete
### AP-1: Website bis LIVE (Fr 12. bis Do 18.06.)
**Fertig heißt:** Seite live auf eigener Domain, responsive, DSGVO-sauber, Formular routet Leads an Haris (< 24 h Antwortzeit ist sein Versprechen), EU-konformes Analytics läuft.
| Datum | Schritt |
|---|---|
| Fr 12.06. | **Scope fixieren:** Landing · Features · Pricing-Teaser (ohne Zahlen) · **Demo-Anfrage-Formular** · **Webinar-Warteliste** · Impressum/Datenschutz · Stack + Hosting + Domain klären · **Subframe-Lizenzen kaufen** (David + beide Devs, blockt sonst alle!) |
| Sa/So 13./14.06. | Setup + Seitenstruktur · Davids Screens einbauen |
| Mo 15.06. | **Texte von Haris einpflegen** (Noah-Abnahme liegt vor) · Webinar-Plattform wählen (EU-konform: Livestorm/Zoom) |
| Di 16.06. | Build fertig · QA: responsive, Formular → Lead-Benachrichtigung an Haris, Rechtstexte drin |
| **Mi 17.06.** | **[WEB] LIVE** + Analytics (EU!) + Search Console. Puffer: Do 18. |
| Do 18.06. | Lead-Routing mit Haris testen (Formular → er bekommt sofort Bescheid) |
### AP-2: Pflege + Conversion (19. bis 28.06.)
SEO-Basics · Conversion-Feinschliff · Pricing-Seite vorbereiten (Zahlen kommen am 25.06. aus dem Partner-Gespräch) · Founding-Member-Sektion mit Haris (ab 30.06. live, mit Stripe Payment Link).
### AP-3: Webinar-Funnel (Mo 29.06. bis Fr 03.07.)
**Fertig heißt:** Webinar-Landing mit Anmelde-Flow steht, bevor Haris am Mo 06.07. die Einladungen schickt.
Landing-Page (Datum 14./15.07., Agenda, Anmeldeformular) · Bestätigungs-Mail · Erinnerungs-Logik mit Haris abstimmen.
### AP-4: Launch-Update (Mo 06. bis Fr 10.07.)
Finale Feature-Seiten (Screens aus dem echten Produkt) · Pricing live · Launch-Ankündigung · [LAUNCH] Fr 10.07.
### AP-5: Webinar-Technik (Di/Mi 14./15.07.)
Plattform-Setup, Generalprobe mit Haris + Raffael, Aufzeichnung, Follow-up-Seite (Replay + CTA).
### AP-6: Help-Inhalte (Mo 20. bis Fr 31.07.)
**Fertig heißt:** Help-Center befüllt + Website-Feature-Update live am Fr 31.07.
**Help-Center-Inhalte einpflegen** (Akeshan baut das System 28. bis 30.07.) · Fr 31.07.: Website-Update mit Portal/Mobile-PWA/KWP als Features. (App-Store-Metadaten / Store-Listings / Store-Badges entfallen — Mobile ist PWA-only in v1/v2, AD-17; native App + App-Store frühestens v3.)
## Schnittstellen: was du bekommst, was andere von dir brauchen
**Du bekommst:**
| Von | Was | Wann |
|---|---|---|
| David | Website-Screen-Designs + Brand-Tokens | Sa 13.06. |
| Haris | Website-Texte (von Noah abgenommen) | Mo 15.06. früh |
| Raffael | Rechtstexte vom Anwalt (Impressum/Datenschutz) · Preise für die Pricing-Seite | sobald da / 25.06. |
| — | App-Store-Screenshots entfallen (PWA-only, → v3) | — |
| Akeshan | Help-Center-System zum Befüllen | Di 28.07. |
**Andere brauchen von dir:**
| Wer | Was | Wann |
|---|---|---|
| David + beide Devs | Subframe-Lizenzen (blockt sonst ALLE Screens!) | **Fr 12.06.** |
| Haris | Website LIVE + Lead-Routing (Formular → er wird sofort benachrichtigt) | Mi/Do 17./18.06. |
| Haris | Webinar-Landing + Anmelde-Flow (seine Einladungen gehen Mo 06.07. raus) | Fr 03.07. |
| Raffael/Akeshan | Webinar-Generalprobe + Technik am Webinar-Tag | 14./15.07. |
| alle | Help-Center befüllt + Website-Feature-Update (Portal/Mobile-PWA/KWP) live | Fr 31.07. (Store-Listings entfallen — PWA-only, AD-17) |
## Merkzettel
1. **17./18.06. ist hart.** Alles, was die Deadline gefährdet, sofort im 9:00-Sync melden.
2. Formular-Leads sind ab Tag 1 echtes Geld wert: Routing an Haris hat Vorrang vor Hübschheit.
3. Keine US-Tracker (DSGVO/EU-Stack-Prinzip): Analytics EU-konform wählen.
4. Texte kommen IMMER von Haris, Abnahme IMMER Noah. Du baust, du textest nicht.
@@ -0,0 +1,98 @@
---
pdf_options:
format: A4
margin: 16mm
css: |-
body { font-size: 10.5px; font-family: -apple-system, "Segoe UI", Helvetica, Arial, sans-serif; }
h1 { font-size: 19px; }
h2 { font-size: 14px; border-bottom: 2px solid #f5a623; padding-bottom: 3px; margin-top: 20px; break-after: avoid; page-break-after: avoid; }
table { font-size: 9.5px; border-collapse: separate; border-spacing: 0; width: 100%; border-top: 1px solid #ccc; border-left: 1px solid #ccc; }
thead { display: table-header-group; }
tr { break-inside: avoid !important; page-break-inside: avoid !important; }
td, th { break-inside: avoid !important; border-right: 1px solid #ccc; border-bottom: 1px solid #ccc; padding: 3px 5px; vertical-align: top; }
th { background: #fff7e8; }
li { break-inside: avoid; }
p { orphans: 3; widows: 3; }
---
# HANDOUT HARIS: Vertrieb + Website-Texte
**Mission:** [€] **Erste Gelder bis Ende Juli, gerne früher.** Du schreibst die Website-Texte und das gesamte Vertriebsmaterial. **Abnahme für Texte und Vertrieb ist immer Noah.**
**Dein Produkt-Verständnis:** v1 (Launch 10.07.) ist die Demo- und Verkaufs-Basis: CRM, Lead-Inbox, Sales-Kanban, Plantafel, Automation, Marketing, Chat. Der USP **KWP-Sync kommt Ende Juli** (v2): verkaufe ihn als „ab August live", an KWP-Nutzer ist er DAS Argument.
## Arbeitspakete
### AP-1: Painpoints + Texte (Fr 12. bis Mo 15.06.)
**Fertig heißt:** Website-Texte liegen Mo 15.06. früh bei Dejan, von Noah abgenommen.
| Datum | Schritt |
|---|---|
| Fr 12.06. | **Zielkunden-Liste SHK starten** (Fokus: KWP-Nutzer!) · Painpoint-Gespräch mit Noah terminieren |
| Sa/So 13./14.06. | [CALL] **Exklusiv-Gespräch mit Noah:** SHK-Alltags-Painpoints (Zettelwirtschaft, HubSpot-Frust, Doppelerfassung, Monteur-Kommunikation). Daraus: **Website-Texte** (Landing-Headline, Nutzenversprechen, Feature-Beschreibungen) |
| **Mo 15.06. früh** | Texte an Dejan (Noah-Abnahme eingeholt) · danach: Pitch + Gesprächsskript (auch Noah-Abnahme) |
### AP-2: Inbound-Maschine (Do 18. bis Mo 22.06.)
**Fertig heißt:** Jede Website-Anfrage bekommt in < 24 h eine Antwort.
Website geht Mi/Do 17./18. live → Lead-Sheet aufsetzen (bis die HiveGrid-Lead-Inbox steht, dann Dogfooding!) · Benachrichtigungs-Routing mit Dejan testen · Fr 19.: Pitch-Deck mit Davids Screens bestücken.
### AP-3: Erste Calls (ab Di 23.06.)
**Fertig heißt:** Mindestens Discovery-Gespräche laufen täglich.
[CALL] Discovery/Qualifizierung: Painpoints abfragen, KWP-Nutzung (ja/nein/Version), Team-Größe, aktuelle Tools. **Noch keine Live-Demo** (Produkt ist mitten im Bau): Screens + Pitch reichen. Notizen strukturiert ins Lead-Sheet.
### AP-4: Founding-Member-Verkauf (ab Do 25.06.)
**Fertig heißt:** Ab Mo 30.06. kann jemand BEZAHLEN.
| Datum | Schritt |
|---|---|
| Do 25.06. | Preise kommen aus Raffaels Partner-Gespräch → **Founding-Member-Angebot strukturieren** (Early-Bird-Jahresdeal, begrenzte Plätze) → Noah-Abnahme |
| Fr 26.06. | Stripe Payment Link von Raffael |
| **Mo 30.06.** | [€] **Founding-Deal live**: Klick-Demos (CRM-Stand der Noah-Demo) + Abschluss via Payment Link. **Geld kann VOR dem Launch fließen** |
| ab Fr 03.07. | Echte Produkt-Demos (Kette Lead → Sales → Auftrag läuft E2E) |
### AP-5: Webinar-Funnel (Mo 06. bis Mi 15.07.)
| Datum | Schritt |
|---|---|
| Mo 06.07. | **Webinar-Einladungen** (mit Dejan; KLEINE Liste: die Mail-Domain ist erst 3 Wochen gewärmt, Spam-Risiko bei Masse!) |
| Fr 10.07. | [LAUNCH] → zahlende Onboardings (Raffael stellt Abos im Admin zusammen) |
| Di/Mi 14./15.07. | [WEBINAR] **Webinar Nr. 1 moderieren** (Raffael macht die Live-Demo) → Trial-/Kauf-Conversions |
### AP-6: Conversion-Endspurt (bis Fr 31.07.)
Fr 24.07.: Trial-Follow-ups (14 Tage nach Launch-Onboardings) · ab ~20.07. neues Verkaufsargument: **KWP-Sync ist live bei Geerkens** (Referenz!) · Fr 31.07.: [€] Bilanz: Founding-Deals + Onboardings + Trial-Konversionen.
## Schnittstellen: was du bekommst, was andere von dir brauchen
**Du bekommst:**
| Von | Was | Wann |
|---|---|---|
| Noah | Painpoint-Gespräch (dein Rohstoff für Texte + Pitch) · danach laufend Abnahmen | Sa/So 13./14.06. |
| Dejan | Website LIVE + Lead-Routing (jede Anfrage landet sofort bei dir) | Mi/Do 17./18.06. |
| David | Screens fürs Pitch-Deck | Fr 19.06. |
| Raffael | **Preise** (25.06.) · **Stripe Payment Link** für den Founding-Deal (26.06.) | siehe Daten |
| Akeshan | Demo-Tenant auf Staging für deine Klick-Demos | ab Mo 30.06. |
| Dejan | Webinar-Landing für deine Einladungen | Fr 03.07. |
| Raffael | Live-Demo im Webinar (du moderierst, er zeigt) | 14./15.07. |
**Andere brauchen von dir:**
| Wer | Was | Wann |
|---|---|---|
| Dejan | **Website-Texte, von Noah abgenommen** (er baut sie Mo ein, live Mi!) | **Mo 15.06. früh** |
| Noah | Jeden Außen-Text zur Abnahme BEVOR er rausgeht (Website, Pitch, Angebot, Folien) | laufend |
| Raffael | Markt-Feedback: Einwände, fehlende Features, Preis-Reaktionen aus den Calls | laufend ab 23.06. |
| Raffael | Onboarding-Liste: wer hat gekauft und braucht ein Abo im Admin | ab Fr 10.07. |
| Dejan | Webinar-Inhalt (Agenda, Folien) für die Landing-Page | bis Do 02.07. |
## Merkzettel
1. **Ohne Preise kein Abschluss:** Der 25.06. (Raffaels Partner-Gespräch) ist dein härtester Abhängigkeits-Termin. Vorher: qualifizieren, Pipeline füllen.
2. **Noah ist deine Abnahme-Instanz** für jede Text-Zeile, die nach außen geht: Website, Pitch, Angebot, Webinar-Folien.
3. **KWP-Nutzer sind A-Leads:** Die bekommen ab Ende Juli das, was kein Wettbewerber hat.
4. Versprich nichts, was nicht in v1 ist: Mobile-PWA-Ausbau, Portal, Postfach-Sync sind „kommt im August": ehrlich verkaufen. (Mobile = installierbare PWA, KEINE App-Store-App versprechen.)
5. Demo-Termine immer NACH den Gate-Freitagen ansetzen (dann ist sichtbar mehr da).
@@ -0,0 +1,67 @@
---
pdf_options:
format: A4
margin: 16mm
css: |-
body { font-size: 10.5px; font-family: -apple-system, "Segoe UI", Helvetica, Arial, sans-serif; }
h1 { font-size: 19px; }
h2 { font-size: 14px; border-bottom: 2px solid #f5a623; padding-bottom: 3px; margin-top: 20px; break-after: avoid; page-break-after: avoid; }
table { font-size: 9.5px; border-collapse: separate; border-spacing: 0; width: 100%; border-top: 1px solid #ccc; border-left: 1px solid #ccc; }
thead { display: table-header-group; }
tr { break-inside: avoid !important; page-break-inside: avoid !important; }
td, th { break-inside: avoid !important; border-right: 1px solid #ccc; border-bottom: 1px solid #ccc; padding: 3px 5px; vertical-align: top; }
th { background: #fff7e8; }
li { break-inside: avoid; }
p { orphans: 3; widows: 3; }
---
# HANDOUT NOAH: Validierung & Abnahme (Geerkens)
**Deine Rolle:** Erster Kunde + Investor = unsere Realitäts-Instanz. Du validierst das Produkt an vier Freitagen, nimmst alle Außen-Texte ab und bist die Brücke zu KWP/Geerkens-IT. **Zeitaufwand: ca. 1 bis 2 h pro Woche + 4 Demo-Termine.**
## Deine Termine & Zulieferungen
| Datum | Was wir von dir brauchen | Aufwand |
|---|---|---|
| **Fr 12.06.** | KWP-Mail: unsere Antwort (Callback-URLs) freigeben/weiterleiten · **bnWin.net-Update auf 8.1 N3** bei eurer IT anstoßen (KWP braucht das für die API!) | 15 min + IT-Auftrag |
| **Sa/So 13./14.06.** | [CALL] **Exklusiv-Gespräch mit Haris:** Eure SHK-Alltags-Painpoints (was nervt an HubSpot, Zetteln, Doppelerfassung?) + **Abnahme der Website-Texte** | 1 bis 2 h |
| Mo 15.06. | Die 4 Freitags-Slots bestätigen (19.06. · 26.06. · 03.07. · 10.07.) | 5 min |
| laufend | **Abnahme von Vertriebsmaterial** (Pitch, Founding-Angebot ~25.06., Webinar-Folien ~10.07.): alles, was nach außen geht, siehst du vorher | je 15 bis 30 min |
| **bis Fr 26.06.** | **Echte SHK-Beispieldaten**: eure Pipelines (Verkauf + Auftrag), Custom-Felder, Rollen-Struktur: damit die Seeds der Realität entsprechen | 1 h |
| **bis Fr 26.06.** | **Lagerist-Frage:** Braucht ihr den Lager-Arbeitsplatz (Lagerist sieht Material-Ausgang) schon zum Start, oder reicht die Material-Liste am Auftrag bis August? | Antwort genügt |
| **Fr 19.06.** | (Optional) Gate W1: Technik-Beweis, kannst du auslassen | : |
| **Fr 26.06.** | **Demo 1: CRM klickbar.** Kontakte, Firmen, Leads, Custom-Felder: ist das euer Alltag? | 45 min |
| **Fr 03.07.** | **Demo 2: Die Kette.** Lead kommt rein → wird Deal → wird Auftrag → steht auf der Plantafel. Der Kern des Produkts | 1 h |
| **Fr 10.07.** | **Voll-Walkthrough + Go/No-Go:** komplettes Produkt, deine Stimme entscheidet mit über den Launch | 2 h |
| Di/Mi 14./15.07. | (Optional) Webinar Nr. 1: als Referenz-Stimme dabei sein | 1 h |
| **ab Mo 20.07.** | **KWP-Verprobung:** Test-Instanz/Testdaten eurer KWP für den Sync (E2E am Fr 24.07.). Ende Juli: ihr seid der erste Betrieb mit laufendem HiveGrid-KWP-Sync | nach Absprache |
## Schnittstellen: wer dir was liefert, wer auf dich wartet
**Du bekommst:**
| Von | Was | Wann |
|---|---|---|
| Raffael | KWP-Antwort-Entwurf (Callback-URLs) zum Weiterleiten | Fr 12.06. |
| Haris | Website-Texte, Pitch, Founding-Angebot, Webinar-Folien: jeweils zur Abnahme | 14.06. / laufend |
| Raffael + Team | Die Demos an den Gate-Freitagen (klickbares Produkt, kein Foliensatz) | 26.06. / 03.07. / 10.07. |
**Auf dich warten:**
| Wer | Was | Wann |
|---|---|---|
| Raffael | bnWin.net-8.1-N3-Update durch eure IT (ohne das keine KWP-API!) | so früh wie möglich |
| Haris | Painpoint-Gespräch + Text-Abnahmen (seine Texte gehen Mo 15.06. an die Website) | Sa/So 13./14.06. |
| Raffael | SHK-Beispieldaten (Pipelines, Felder, Rollen) + Lagerist-Antwort | bis Fr 26.06. |
| das ganze Team | Dein Go/No-Go beim Walkthrough | Fr 10.07. |
| Raffael | KWP-Test-Instanz/Testdaten für den Sync-Test | ab Mo 20.07. |
## Woran du bei den Demos messen solltest
1. **Demo 1 (CRM):** Würde euer Büro damit ab morgen arbeiten wollen? Fehlen Felder, die ihr täglich braucht?
2. **Demo 2 (Kette):** Bildet der Fluss Lead → Angebot → Auftrag → Plantafel euren echten Ablauf ab? Wo klemmt es?
3. **Walkthrough (10.07.):** Reicht das, um es eurem Team hinzustellen? Was MUSS vor dem ersten echten Einsatz noch rein? (Achtung: KWP-Sync kommt 2 Wochen später, bis dahin Doppelerfassung: ist das für euch tragbar?)
## Was nach dem Launch kommt (damit du es einordnen kannst)
**v2 bis 31.07., alles schon durchgeplant:** KWP-Sync (20. bis 26.07., euer Live-Test 24.07.) · Self-Service-Abos · Email-Postfach im System · Endkunden-Portal · Mobile-PWA-Ausbau (installierbar aufs Handy, offline — keine eigene Store-App, das kommt frühestens viel später) · Help-Center.
@@ -0,0 +1,283 @@
---
pdf_options:
format: A4
margin: 16mm
css: |-
body { font-size: 10.5px; font-family: -apple-system, "Segoe UI", Helvetica, Arial, sans-serif; }
h1 { font-size: 19px; }
h2 { font-size: 14px; border-bottom: 2px solid #f5a623; padding-bottom: 3px; margin-top: 20px; break-after: avoid; page-break-after: avoid; }
h3 { font-size: 12px; break-after: avoid; page-break-after: avoid; }
table { font-size: 9.5px; border-collapse: separate; border-spacing: 0; width: 100%; border-top: 1px solid #ccc; border-left: 1px solid #ccc; }
thead { display: table-header-group; }
tr { break-inside: avoid !important; page-break-inside: avoid !important; }
td, th { break-inside: avoid !important; border-right: 1px solid #ccc; border-bottom: 1px solid #ccc; padding: 3px 5px; vertical-align: top; }
th { background: #fff7e8; }
li { break-inside: avoid; }
p { orphans: 3; widows: 3; }
code { background: #f4f4f4; padding: 1px 3px; font-size: 9px; }
.pagebreak { page-break-after: always; }
---
# HANDOUT RAFFAEL: Lead-Dev
**Mission:** Kern-Kette (Lead → Sales → Auftrag) + beide USP-Säulen (Automation, KI) + technische Externals. v1 bis 10.07., dein v2-Anteil (17 MS, inkl. KWP) bis 31.07.
**Arbeitsrhythmus:** Mo bis So, täglich mind. 8 h · 9:00 Dev-Sync mit Akeshan · Integration auf `main` täglich.
**Deine Gates:** Fr 19.06. (W1, du führst) · Fr 26.06. (Noah-Demo 1, du präsentierst) · Fr 03.07. (Kette E2E) · Fr 10.07. (Go/No-Go).
## Timeline auf einen Blick
| Datum | Paket |
|---|---|
| Fr 12. bis Di 16.06. | AP-1: P1 Fundament (Stränge A+B) + Externals |
| Mi 17. bis Fr 19.06. | AP-2: P2 Identität & Mandanten |
| Sa/So 20./21.06. | AP-3: P5 Apps-Engine |
| Mo 22. bis Mi 24.06. | AP-4: P6 CRM-Kern |
| Do/Fr 25./26.06. | AP-5: P7 Lead-Inbox + [€] Preise fix (25.) + Noah-Demo 1 |
| Sa bis Mo 27. bis 29.06. | AP-6: P8 Sales-Pipeline + v2-Vorlauf-Externals (29.) |
| Di bis Do 30.06. bis 02.07. | AP-7: P9 Projekte & Plantafel |
| Sa/So 04./05.07. | AP-8: P11 Suche & Dashboard |
| Mo bis Mi 06. bis 08.07. | AP-9: P12 Automation (USP) |
| Do 09.07. | AP-10: P13 KI-Layer + FREEZE |
| Fr 10.07. | [LAUNCH] Go/No-Go mit Noah |
| Mo 13. bis Fr 17.07. | AP-11: KWP-Recut + Public-API + API-Keys |
| Sa/So 18./19.07. | AP-12: HiveMind/RAG Start |
| Mo 20. bis So 26.07. | AP-13: KWP gegen echte API |
| Mo 27. bis Fr 31.07. | AP-14/15: AdminUser-Welt · HalloPetra · DSGVO-Auskunft |
## Schnittstellen: was du bekommst, was andere von dir brauchen
**Du bekommst:**
| Von | Was | Wann |
|---|---|---|
| Akeshan | Hot-Swap-Maschine + Walking-Skeleton (P1 Strang C) | Di 16.06. |
| Akeshan | Staging/CI läuft (Gates brauchen das) | Mi 17.06. |
| Akeshan | EntityLink-Tabelle aus P4 (brauchst du in P6 für Task-CRM-Links) | Fr 19.06. |
| David | Screen-Pakete: CRM 24.06. · Kanban 26.06. · Plantafel 01.07. · Flow-Editor + Dashboard 03.07. · KI-Panel 06.07. | je Deadline |
| Noah | KWP-Mail-Freigabe (12.06.) · SHK-Beispieldaten + Lagerist-Antwort (26.06.) · Demo-Teilnahme an den Gate-Freitagen | siehe Daten |
| Partner | Kostenmatrix-Input fürs Preis-Gespräch | Do 25.06. |
| Haris | Markt-Feedback aus den Calls (Einwände, fehlende Argumente) | laufend ab 23.06. |
**Andere brauchen von dir:**
| Wer | Was | Wann |
|---|---|---|
| Akeshan | Service-Kerne aus P1 (Audit, notify, Flags, i18n): er baut ab Mi alles darauf | Di 16.06. |
| Akeshan | Apps-Engine-Vertrag (P5): seine P14/P15/P16-Anbindungen laufen darüber | So 21.06. |
| Akeshan | CRM-Entitäten (P6): Marketing-Segmente + Chat-Verknüpfungen brauchen Contacts | Mi 24.06. |
| Haris | Preise (25.06.) · Stripe Payment Link (26.06.) · Live-Demo im Webinar (14./15.07.) | siehe Daten |
| Dejan | Rechtstexte vom Anwalt durchreichen · Preise für die Pricing-Seite | sobald da / 25.06. |
| David | Reconciliation-Feedback je Screen (passt jedes Feld zu einer Datenquelle?) | < 24 h je Screen |
| Noah | Demo-Führung an den Gate-Freitagen + KWP-E2E-Termin (24.07.) | Gate-Freitage |
## Externals (nur du)
| Wann | Was |
|---|---|
| Fr 12.06. | KWP-Antwortmail (Callback-URLs) · bnWin 8.1 N3 an Noah · AVV + Rechtstexte an Anwalt |
| Mo 15.06. | Mailjet-DNS + Warm-up · Google-Calendar-OAuth · Stripe-Live · AirCall/PandaDoc-Sandbox · Hetzner-Projekt `HiveGrid` + Mistral-Key · Noah-Slots blocken |
| Do 25.06. | [€] Kostenmatrix/Preise mit Partner FIX (Blocker für Haris!) |
| Mo 29.06. | Web-Push-VAPID-Keys · Gmail-Restricted-Scope-Antrag · Microsoft-Entra-App (Google Play Console / FCM/APNs entfallen — PWA-only, AD-17) |
| Mo 13.07. | HalloPetra-Konto · Memberspot-Zugänge |
<div class="pagebreak"></div>
## AP-1: P1 Fundament, Stränge A+B (Fr 12. bis Di 16.06.)
**Was:** Die Service-Kerne und Verträge, auf denen alles andere steht. Akeshan baut parallel Strang C (Hot-Swap-Maschine).
**Fertig heißt:** Boilerplate-Ist-Stand dokumentiert (ADR-Text veraltet, Code ist seit 04.06. real!) · EU-Sterilisation durch (GitHub/Google-OAuth-Reste + GA/ConvertKit raus) · alle Service-Kerne als aufrufbare Dienste mit Smoke-Test · `tenantHasModule()`-Gate am Skeleton demonstrierbar · URL-Schemata dokumentiert.
| Milestone | Inhalt (1 Zeile) |
|---|---|
| M001 audit-log-default | Jede Mutation erzeugt automatisch einen AuditEvent (Prisma-Middleware, SHA-256-Hash-Kette), default-on |
| M002 klartext-diagnostik | Fehler-Katalog: jeder Fehler hat deutschen Klartext + Lösungs-Knopf; ESLint verbietet nacktes `throw` |
| M003 i18n-pflicht-wiring | Jeder String läuft durch `t()`, `verify:i18n`-CI-Gate, v1 nur DE-Locale (vollständig) |
| M004 tenant-scope-owner-check | `withTenantScope`/`withOwnerCheck` als Pflicht-Wrapper für jeden Datenzugriff |
| M005 url-tampering-schutz | IDs in URLs werden server-seitig gegen Tenant geprüft; Mass-Action-Schutz (Limit + Bestätigung) |
| M006 feature-flag-engine | `tenantHasFlag()` + Redis-Cache + plan-tier-Targeting; Grundlage der Konnektor-Pflicht |
| M007 idempotenz-wrapper | Doppelt gefeuerte Jobs/Webhooks führen nicht zu Doppel-Daten (Idempotency-Keys) |
| M011 notification-service | `notify({channel, recipient, template})` als Pflicht-Interface; Kanäle In-App + Email, Push ruht |
| M176 anti-liste-doku | Die Anti-Liste (was wir bewusst NICHT bauen) als Change-Request-Doku im Repo |
## AP-2: P2 Identität & Mandanten (Mi 17. bis Fr 19.06.)
**Was:** Signup, Login, echte Mandanten-Trennung. **Boilerplate HIGH-Coverage** (Login/Magic-Link/TOTP fertig); dein Eigenbau-Kern ist **RLS**.
**Fertig heißt (= Gate W1):** Self-Service-Signup → Tenant mit Auto-SHK-Seed · Login + TOTP + Server-Sessions · **RLS-Cross-Tenant-Beweis** (nachweisbar kein Fremd-Zugriff, AD-1) · 6 SHK-Rollen geseedet.
| Milestone | Inhalt |
|---|---|
| M018 mandanten-anlage | Signup mit Auto-Slug (Reserved-Words geblockt), Tenant-Provisionierung |
| M019 trennung-hardening | Postgres-RLS: USING/WITH CHECK, `SET LOCAL app.tenant_id`, App-Rolle ohne BYPASSRLS + Beweis-Test |
| M020 email-passwort-auth | NIST-Regeln, HaveIBeenPwned-Breach-Check, mCaptcha ab 3. Fehlversuch (zentral, nur ENV) |
| M021 magic-link-sessions | Magic-Link + Server-Sessions in Postgres (Geräte-Liste, Revoke, „überall abmelden") + Redis-Cache |
| M022 totp-2fa | TOTP (RFC 6238) mit QR-Setup, Trust-Device 30 Tage (Boilerplate liefert fast alles) |
| M023 rollen-engine | Role/Permission-System + 6 SHK-Standard-Rollen + Gruppen |
| M024 einladung-deaktivierung | Einladung (48h-Token), Soft-Deaktivierung mit Reassign-Workflow für offene Verknüpfungen |
| M025 konto-loeschung | DSGVO-Löschung via PII-Anonymisierung ohne Audit-Trail-Verlust (Boilerplate-Muster) |
| M026 mandanten-lebenszyklus | Tenant-Status-Maschine (trial/active/past_due/frozen/…) + Status-Banner; liest Subscription-Stub |
*(M027 API-Keys ist v2, wandert mit der Public-API.)*
## AP-3: P5 Apps-Engine (Sa/So 20./21.06.)
**Was:** DER Integrations-Vertrag. Alles Externe (AirCall, PandaDoc, Stripe, Google, später KWP) läuft über dieses eine Framework.
**Fertig heißt:** Eine DataConnection lässt sich per OAuth ODER API-Key herstellen, Status-Ampel + Klartext, Health-Check, Tokens verschlüsselt (DEK aus Coolify-Secret).
| Milestone | Inhalt |
|---|---|
| M008 adapter-state-machine | DataConnection-Modell + Status-Maschine (pending/active/degraded/broken/revoked) + Adapter-Registry (typsicher erweiterbar) |
| M009 setup-wizard-sync-log | Connect-Wizard (Voraussetzungen → Credentials → Health-Check) + AppSyncRun-Log mit Klartext |
| M010 probe-scheduler-webhook-schutz | Periodische Health-Probes + HMAC-Signaturprüfung für eingehende Webhooks |
## AP-4: P6 CRM-Kern (Mo 22. bis Mi 24.06.)
**Was:** Das Datenfundament des Produkts. **Mi Abend fertig = Davids CRM-Screens docken an, Noah-Demo 1 am Fr.**
**Fertig heißt:** Kontakt/Firma anlegen, finden, verknüpfen; Custom-Felder mit SHK-Defaults; Activity-Stream läuft; Task↔CRM-Links verdrahtet (Retro-Integration aus P4).
| Milestone | Inhalt |
|---|---|
| M042 kontakt-stammdaten | Contact als First-Class-Tabelle (AD-2: kein Entity-Builder!), Listen/Detail, Inline-Edit |
| M043 firma-stammdaten | Company + M:N zu Kontakten mit Rollen + Primär-Markierung |
| M044 schlagwoerter-custom-felder | Tags (farbig, entity-übergreifend) + CustomFieldDefinition/Value je Tenant + SHK-Template-Seeds |
| M045 aktivitaets-stream | Append-only Activity-Tabelle (Event-Sourcing), chronologische Stream-View, `logActivity()` überall |
| M046 listen-segmente-dsgvo | Server-seitige Filter/Sortierung/Pagination, Bulk-Actions, CSV-Export, Duplikat-Merge-Tool |
## AP-5: P7 Lead-Inbox (Do/Fr 25./26.06.)
**Was:** Der Eingangs-Trichter. Jede Anfrage (Formular, Inbound-Mail, Anruf, Fremd-Website via Quellen-Token) landet hier.
**Fertig heißt:** Lead kommt aus mind. 2 Quellen automatisch rein, Spam wird markiert, Promotion-Modal erzeugt Kontakt (+optional Deal-Event für P8). **Extension-Point: `lead.qualified`-Event.**
| Milestone | Inhalt |
|---|---|
| M047 quellen-adapter | Multi-Quellen-Framework: Form, Inbound-Mail-Adresse, Webhook-URL mit Token je Quelle |
| M048 routing-pro-quelle | Auto-Zuweisung je Quelle (wer bekommt Website-Leads?) |
| M050 spam-duplikat-erkennung | Spam-Score mit Begründung, Honeypot, Limits je IP/Quelle, Duplikat-Hinweise |
| M051 status-pipeline-gruende | Lead-Status (new/qualified/converted/lost/spam) + Verlust-Gründe (Range-Hinweis: braucht nur M047/M048/M050) |
**Außerdem Do 25.: [€] Partner-Gespräch Preise. Fr 26.: Noah-Demo 1 + Lagerist-Frage + Payment-Link an Haris.**
## AP-6: P8 Sales-Pipeline (Sa bis Mo 27. bis 29.06.)
**Was:** Deals im Kanban bis zum Won-Handoff ans Projekt.
**Fertig heißt:** Lead-Qualifizierung erzeugt Deal (M049, Retro aus P7) · Kanban mit Drag&Drop · Won → Projekt-Anlage-Option · `deal.won`-Event + Aggregat-APIs (Extension-Points für P9/P11). **SHK-Pipelines + Gründe selbst seeden (AD-12).**
| Milestone | Inhalt |
|---|---|
| M049 auto-verkaufsfall | Bei Lead-Status `qualified`: Deal automatisch anlegen (konsumiert P7-Event) |
| M059 pipeline-konfiguration | Multi-Pipeline + Stage-Editor (Art offen/won/lost, Win-%, Farbe) + SHK-Seed |
| M060 verkaufsfall-crud | Deal-Entity mit Nummer, Volumen (permission-gegated!), Custom-Feldern, Stage-Historie |
| M061 kanban-ui | Kanban-Board (Davids Screen): Drag&Drop, Aggregate je Spalte, Stuck-Marker |
| M062 verlust-gewinn-gruende | Lost-Reason-Pflicht bei Lost-Drop, Gründe-Verwaltung + Seed |
| M063 auto-auftragsprojekt | Won-Handoff: Deal → Projekt mit Übernahme (Setter/Closer-Logik); liefert deal.won-Event |
| M064 pipeline-reporting | Basis-KPIs + Aggregat-APIs (Forecast einfach: Volumen × Win-%); KWP-Sync-Anteil ruht bis v2 |
**Mo 29.: v2-Vorlauf-Externals (30 min, siehe Externals-Tabelle).**
## AP-7: P9 Projekte & Plantafel (Di bis Do 30.06. bis 02.07.)
**Was:** Auftragsabwicklung + das Monteur-Herzstück. **Plantafel + Abnahme sind mobile-first und offline (PWA-only statt nativer App, AD-17 — gilt für v1 und v2).**
**Fertig heißt (= Gate W3 am Fr):** Kette Lead → Deal → Projekt E2E klickbar · Plantafel mit Konflikt-Anzeige (inkl. HR-Abwesenheiten) · Abnahme offline mit Unterschrift + PDF. **OfflineSyncQueue als pures TS mit Storage-Interface (PWA-ready!).**
| Milestone | Inhalt |
|---|---|
| M065 auftragspipeline-konfiguration | Projekt-Pipelines analog Sales + SHK-Seed + Abnahme-Pflicht-Flag je Stage |
| M066 auftrag-crud | Projekt-Entity, Mitglieder mit Rollen (PL!), Sales-Verlauf-Tab; KWP-Archiv-Anteil ruht (Extension-Point) |
| M067 plantafel | Scheduling-Board MA × Zeit, Drag&Drop, Konflikte (Doppelbelegung/Urlaub); VM-Slots für Termine/Abwesenheiten |
| M068 mitglieder-mgmt | Mitglieder-Verwaltung + Benachrichtigungen über notify() |
| M069 abnahme-workflow | SHK-Abnahme-Formular (fix in v1) → Mängel-Klassifizierung → Touch-Unterschriften → PDF + Auto-Mail, offline |
| M070 material-listen | Material-Liste am Auftrag (Position/Menge/Status); Lagerist-Sicht ruht bis v2 (Noah-Antwort abwarten) |
## AP-8: P11 Suche & Dashboard (Sa/So 04./05.07.)
**Was:** Alles wiederfinden + Kennzahlen sehen. **Retro-Integrationen einplanen:** Suche in Audit-Viewer/Datei-Browser/CRM-Segmente/Kanban-Filter nachrüsten, Sales-Widgets aus P8-Aggregaten, Dashboard-Defaults selbst seeden.
**Fertig heißt:** Cmd+K findet jede Entität permission-aware (Meilisearch, scoped Key auf node1) · 3 feste Rollen-Dashboards (GF/Büro/Monteur) live via SSE.
| Milestone | Inhalt |
|---|---|
| M056 such-index | SearchIndexEntry + Outbox-Pattern: jede Mutation aktualisiert den Index (Registry aus P1) |
| M057 permission-aware-search | Treffer respektieren Permissions server-seitig (kein Leak über Suche!) |
| M058 such-ui | Cmd+K-Modal (300ms debounce, Gruppierung, Highlight) + Vollbild-Suche mit Filtern |
| M147 layout-widget-engine | Widget-Registry + 3 feste Rollen-Layouts (kein Drag&Drop; Registry bleibt voll für Inversionen) |
| M148 standard-widgets | Die Standard-Widgets: Sales-KPIs, Projekt-KPIs, meine Tasks, Termine heute, Auslastung, Mängel |
## AP-9: P12 Automation-Engine, USP-Säule 1 (Mo bis Mi 06. bis 08.07.)
**Was:** Der visuelle Flow-Editor über alle Module. VOLL, ohne Dünnung (deine Ansage: „dringend").
**Fertig heißt:** Flow aus Trigger + Bedingungen + Aktionen läuft produktiv · Dry-Run zeigt Klartext-Vorschau · 24h-Undo funktioniert · Loop-Guard erkennt Schleifen · jede Execution hat deutsche Step-Logs.
| Milestone | Inhalt |
|---|---|
| M075 schema-ausloeser | Trigger-Library: CRM/Sales/Projekte/Email/Forms/Kalender/Zeit/Webhooks (Events aus allen v1-Modulen) |
| M076 aktion-registry | Action-Library typsicher erweiterbar (KI-Actions docken in P13 an, KWP-Push in v2) |
| M077 bedingungen | If/Else, Filter-Bedingungen auf Entity-Feldern, UND/ODER-Gruppen |
| M078 visueller-editor | Graph-Canvas (Davids Screen): Knoten-Katalog, Konfig-Panel, Mini-Map, Undo/Redo |
| M079 test-lauf-vorschau | Dry-Run: „trifft X Datensätze, würde an [Liste] senden" + Bestätigungs-Pflicht |
| M080 undo-fenster | 24h-Reverse: ausgeführte Automation rückgängig machen (kompensierende Aktionen) |
| M081 schleifen-webhook-anomalie | Loop-Guard (A→B→A erkannt → Modal mit Graph), Webhook-Sturm-Schutz, Anomalie-Pause |
| M082 klartext-logs-metering | Deutsche Step-by-Step-Logs je Execution + Verbrauchs-Zähler (Quota-Basis) |
## AP-10: P13 KI-Layer, USP-Säule 2 (Do 09.07., dann FREEZE)
**Was:** EU-LLM-Unterbau + Sprach-zu-Automation (exklusiv im Flow-Editor, KEIN HiveMind-Koppeln!).
**Fertig heißt:** „Wenn ein Lead 3 Tage offen ist, erinnere den Verantwortlichen" als gesprochener/getippter Satz erzeugt einen Flow-Entwurf, der NIE ohne User-OK aktiv wird · Promptfoo-Suite grün · Limits + Drossel greifen.
| Milestone | Inhalt |
|---|---|
| M083 eu-provider-layer | LLM-Gateway: Mistral La Plateforme (EU), RetrievalProvider-Interface als HiveMind-Andockpunkt |
| M084 multi-provider-fallback | Provider-Abstraktion mit Fallback-Kette (zweiter EU-Provider folgt v2) |
| M085 promptfoo-eval-suite | Eval-Suite gegen Prompt-Regressionen (CI-Gate für KI-Änderungen) |
| M086 sprach-zu-automation | NL → Flow-Entwurf mit direkten DB-Prüfungen (kein RAG), Rückfragen bei Mehrdeutigkeit, Bestätigungs-Grenze |
| M088 token-limits | Lokales AiCredits-Konto, Soft-Limit-Banner 80 %, Hard-Limit + Drossel (Kauf kommt aus P20) |
<div class="pagebreak"></div>
## v2-Pakete (13. bis 31.07.)
### AP-11: KWP-Recut + Public-API + API-Keys (Mo 13. bis Fr 17.07.)
**Fertig heißt:** M089 bis M095 sind gegen die echte API-Doku neu geschnitten (kwpsync.exe ist tot) · Read-REST-API läuft mit Key-Auth gegen Staging.
| Milestone | Inhalt |
|---|---|
| M161 api-spec-read | Read-Only-REST für Contacts/Deals/Leads/Projects/Tasks/Companies + OpenAPI-Spec auto-generiert |
| M162 key-auth-rate-limit | API-Key-Auth + Rate-Limit + Scopes |
| M163 webhooks | Eingehende Lead-Webhooks + ausgehende HMAC-signierte Subscriptions mit Retry |
| M027 api-keys-ui | Tenant-Settings: Keys erstellen/widerrufen, Scopes, SHA-256-Speicherung (Boilerplate-Modell aktivieren) |
### AP-12: HiveMind/RAG + Whisper + pgvector (Sa/So 18./19.07. Start, fertig parallel zu KWP)
| Milestone | Inhalt |
|---|---|
| M087 hivemind-rag | KI-Assistent mit Retrieval über RetrievalProvider (Adapter liegt seit v1); pgvector-Spalte + Hybrid-RRF rüsten Suche nach (AD-5 Teil 2); Whisper-Diktat (Notiz/Abnahme); Bestätigungs-Grenze geerbt aus M086 |
### AP-13: KWP-Integration, der USP (Mo 20. bis So 26.07.)
**Fertig heißt:** Fr 24.07. Sync-E2E mit Geerkens-Testdaten · „KWP gewinnt"-Konfliktregel beweisbar · Drift-Sentinel meldet Schema-Änderungen.
| Milestone | Inhalt (Recut-Stand) |
|---|---|
| M089 (recut) | KWP als `DataConnection type='rest-api'` über die Apps-Engine, OAuth/PKCE (Callback-URL ist registriert) |
| M090 heartbeat-recovery | Verbindungs-Überwachung + Auto-Recovery (vereinfacht durch API) |
| M091 warteschlange-replay | Sync-Queue mit Replay bei Fehlern (Idempotenz aus M007) |
| M092 schema-drift-sentinel | API-Versions-/Schema-Snapshot + Drift-Erkennung + Admin-Notification |
| M093 konflikt-aufloesung | Bidirektionaler Sync mit Regel „KWP gewinnt" (AD-14) |
| M094 plantafel-sync | KWP-Termine ↔ Plantafel (Retro-Integration in P9-Slots) |
| M095 dokumenten-archiv-sync | Auftrags-Dokumente ↔ KWP-Archiv (Retro in M066/M070-Extension-Points) |
| M074 aufgaben-sync-erp | Task-Sync mit KWP (Teil des Recut-Scopes) |
### AP-14: AdminUser-Welt (Mo 27. bis Mi 29.07.)
| Milestone | Inhalt |
|---|---|
| M038 admin-mitarbeiter | Getrennte AdminUser-Identität (eigene Credentials/Sessions, 8h-Cap, IP-Bindung); löst v1-Auflagen-Brücke ab |
| M039 admin-konten-rollen | AdminRBAC (super_admin/support/sales/engineering) |
### AP-15: HalloPetra + DSGVO-Auskunft (Mi 29. bis Fr 31.07.)
| Milestone | Inhalt |
|---|---|
| M105 hallopetra | Zweiter Telefonie-Adapter (KI-Telefonist) über das TelephonyProviderInterface aus P15 |
| M166 dsgvo-auskunft | Auskunfts-Tooling (Art. 15): Betroffenen-Suche → Report; ersetzt das manuelle v1-Playbook |
---
*Quellen für Tiefe: `docs/milestones/M0xx-*/PLAN.md` je Milestone · `SCREEN-MAP.md` (UI-Inhalte) · `PHASE-SOURCES.md` (Retro-Integrations-Register: beim Planen jeder Phase MIT einplanen!) · `TIMELINE.md` (Gesamtbild). Bei Phasen-Start: `/gsd-plan-phase N` lesen lassen.*