Files
HiveGrid-Wireframes/03 Quellen und Referenzen/hivegrid-cloud/.planning/intel/context.md
T
2026-07-08 16:15:37 +02:00

145 lines
5.4 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.
# HiveGrid Intel — Context Notes
Supporting notes from DOC-type sources and cross-cutting SPEC metadata.
extracted: 2026-06-07
---
## Topic: Projekt-Überblick und Ziel
source: docs/ARCHITECTURE-DECISIONS.md
HiveGrid 2.0 ist eine SaaS-Plattform für SHK-Handwerksbetriebe (Sanitär, Heizung, Klima). Erstkunde: Geerkens GmbH. Das Produkt löst ab: HubSpot (CRM + Sales-Pipeline), Quiply (Team-Chat), Zapier/n8n (Automation), sowie mehrere Excel-Prozesse.
Die Codebase wird als bespoke HiveGrid-Anwendung weitergeführt. Historisches Fundament wird genutzt, produktfremde Altlasten werden entfernt.
USP-Säulen (Day-1-Launch): Automation-Engine (visuell, KI-gestützt) + KI-Layer (EU-only) + KWP-Integration (Kern-ERP Geerkens).
---
## Topic: Phase-0-Pflichten (vor Fachmodul-Bau)
source: docs/ARCHITECTURE-DECISIONS.md
Die folgenden Voraussetzungen sind vor dem ersten Fachmodul-Bau abzuarbeiten:
1. Codebase lauffähig halten
2. Naming-Drift in Code und Docs beheben (AD-10)
3. EU-Sterilisation: GitHub/Google-OAuth-Reste entfernen
4. M00 aktivieren + 4 Querschnitts-Neubauten (logActivity, Search-Registry, Subframe-Adapter, Mass-Action-Schutz)
5. Fehlende Dependencies eintragen (PLAN.md teils falsch)
---
## Topic: Delivery-Sequenzierung (AD-11)
source: docs/ARCHITECTURE-DECISIONS.md
Reihenfolge:
1. Phase 0 (Voraussetzungen, oben)
2. Fundament-Kern: M27 (Auth) → M33a (Apps-Engine) → M01 (CRM-Datenmodell)
3. Geerkens-Kernpfad: M02 (Lead-Inbox) → M03 (Sales) → M04 (Auftrag) → M19 (KWP)
4. Breite: HR-Hub (M14), Customer-Portal (M15), Marketing (M10), Mobile (M36), Billing-Feinheiten (M28)
Go-Live: Big-Bang (AD-19) — kein phasiertes Produktiv-Schalten. Gegenmaßnahme: Noah/Geerkens-Validierung per PROGRESS-TRACKER-Klick-Pfad.
---
## Topic: SHK-Branchen-Kontext
source: _bmad-output/specs/M01-crm-kern.md, M03-sales-pipeline.md, M04-auftragspipeline.md
Geerkens ist SHK-Betrieb (Heizungsanlagen, Wartung, Reparatur). Typische Entitäten:
- Kunden (B2C + B2B) mit Anlagen-Zustand (Custom-Felder)
- Vertriebsfälle: Anlagen-Verkauf (mehrstufig), Wartungsverträge (kürzer), Reparatur-Aufträge (direkt zu M4)
- KWP: Windows-basiertes ERP mit MSSQL; HiveGrid synchronisiert bidirektional
- Monteure: arbeiten auf Baustellen, brauchen Offline-Zugriff (AD-17)
- Noah = Geerkens-Kontakt für Validierung der SHK-Defaults
SHK-Seeds (beim Tenant-Anlegen): 6 Standard-Rollen, 2 Sales-Pipelines, Custom-Felder für Heizungsanlagen, Projekt-Pipelines, Automation-Templates, Onboarding-Branchen-Zweig.
---
## Topic: HiveGrid-Workspace-Struktur
source: docs/ARCHITECTURE-DECISIONS.md (AD-10), docs/INTEGRATION-CONTRACTS.md
Workspace-Pakete im `@hivegrid/*`-Scope:
- packages/ui-app (UI-Shell)
- packages/ui-subframe (Subframe-Adapter)
- packages/ui-mock (Mock-UI für Hot-Swap-Tests)
- @hivegrid/search (Meilisearch-Paket)
- @hivegrid/foundation (Basis-Utilities)
HiveGrid-Querschnittsdienste:
- @hivegrid/activity (logActivity-Service + zentrale Activity-Tabelle)
- @hivegrid/audit (auditEvent-Service)
- @hivegrid/notifications (notify-Service)
- packages/entitlements (Permission-Keys-Registry)
- packages/search (indexed-entities.ts für suchbare Entitäten)
- packages/i18n (Locale-Files)
---
## Topic: KWP-Recut-Entscheidung
source: docs/ARCHITECTURE-DECISIONS.md (KWP-Abschnitt), memory/project_kwp_api_anbindung.md
KWP bietet inzwischen eine offizielle API an. Das hat Konsequenzen:
- M089 (Windows-Sync-Programm kwpsync.exe) entfällt
- M090/M091/M092/M094/M095 vereinfachen sich erheblich
- M093 (Schema-Drift-Sentinel) bleibt relevant
- KWP wird als DataConnection type='rest-api' (statt 'windows_client') in M33a geführt
M089–M095 müssen VOR Umsetzung neu geschnitten werden. Die aktuelle M19-Spec beschreibt noch die Windows-Client-Variante.
---
## Topic: Spec-Stil-Vorgabe
source: memory/feedback_spec_style_no_ui.md
Alle Specs verwenden "requirements-pur"-Stil:
- UI-Elemente als Liste beschrieben (benötigte Komponenten), keine ASCII-Layouts
- Designer hat freie Hand für konkrete Anordnung/Layout
- Spezifiziert: was angezeigt werden muss + welche Operationen, NICHT wie es aussieht
---
## Topic: Offene Entscheidungen (noch nicht getroffen)
source: docs/ARCHITECTURE-DECISIONS.md (AD-6, AD-7)
AD-6 — EU-Email-Provider (Backlog):
- Tendenz Mailjet (EU/FR)
- MailerSend (BP-Default) vertretbar aber US-Entität (LP-13-Risiko)
- Alternativen: Brevo, Scaleway TEM
- Betrifft: M09, M10, M22
AD-7 — Captcha/Bot-Schutz (Backlog):
- Tendenz Friendly Captcha (DE) oder self-hosted mCaptcha
- Turnstile (BP) und hCaptcha sind US-Firmen
- Betrifft: Login, Public-Forms (M05), Booking (M06)
---
## Topic: Spec-Status
source: alle _bmad-output/specs/M*.md
Alle 36 Modul-Specs haben status: detail-spec-draft. Vor Bau jedes Moduls:
- Verifizierung mit Noah (Geerkens-Repräsentant)
- Konkrete Index-Definitionen + Migrations-SQL ergänzen
- SHK-Default-Werte finalisieren
- Subframe-UI-Designs (separat, nicht in Spec)
---
## Topic: Cross-Ref-Graph (Zusammenfassung)
source: alle .json Klassifizierungs-Dateien
Keine Zyklen im 38-Dokument-Graph (Cycle Detection: DFS three-color marking — alle Refs einseitig). Externe Refs auf nicht-klassifizierte Dokumente (AGENTS.md, brainstorming-session-2026-05-07-2206.md, Milestone-PLAN-Dateien, M11-whatsapp.md) — diese sind nicht im Ingest-Set, stellen aber keine Zyklen dar.
M13 referenziert M11-whatsapp.md (nicht im Set — Phase 2 Modul, nicht klassifiziert). Kein Blocker.
M18-ki-layer.md referenziert M11-whatsapp.md (nicht im Set). Kein Blocker.