Files
HiveGrid-Wireframes/03 Quellen und Referenzen/hivegrid-cloud/.planning/handouts/akeshan/HANDOUT-AKESHAN.md
T

310 lines
21 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
---
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`.*