Refresh HiveGrid Cloud reference snapshot
This commit is contained in:
1 parent
5e99e14772
commit
7f88026f79
5955 files changed
+1177325
-188362
No files matched your search
@@ -0,0 +1,83 @@
|
||||
# Lokaler Demo-Seed (HiveGrid SHK)
|
||||
|
||||
Befüllt einen reichhaltigen, realistischen SHK/Handwerk-Demo-Tenant zum lokalen
|
||||
Erkunden der App. Nach dem Seed ist der Workspace voll bestückt (Kontakte,
|
||||
Pipelines, Projekte, Leads, Forms, Bookings, Kalender, Automationen, Tasks,
|
||||
Rechnungen, Activities, Benachrichtigungen, API-Key, eingehender Webhook) statt
|
||||
leer.
|
||||
|
||||
Quelle: `scripts/seed-hivegrid-demo.ts` (Muster: `scripts/seed-e2e-readiness.ts`).
|
||||
|
||||
## Ausführen
|
||||
|
||||
```bash
|
||||
pnpm seed:demo
|
||||
```
|
||||
|
||||
Das Skript setzt das Guard-Flag `HIVEGRID_DEMO_SEED=1` selbst. Es läuft **nie in
|
||||
Produktion** (`NODE_ENV=production` → Abbruch) und braucht ein erreichbares
|
||||
`DATABASE_URL`. Der Seed ist **idempotent**: mehrfaches Ausführen aktualisiert die
|
||||
Daten in-place, es entstehen keine Duplikate (deterministische `demo-*`-IDs bzw.
|
||||
`@@unique`-Upserts). Alle Fachdaten tragen `isDemoData = true`, sofern die jeweilige Tabelle dieses Feld unterstützt.
|
||||
|
||||
## Login-Daten
|
||||
|
||||
Alle Nutzer haben das Passwort `password`.
|
||||
|
||||
| E-Mail | Rolle im Betrieb | Tenant-Rolle | App-Rolle(n) |
|
||||
|---|---|---|---|
|
||||
| `demo@hivegrid.de` | Geschäftsführer | Owner | SuperUser (voll berechtigt) |
|
||||
| `buero@hivegrid.de` | Büro/Verwaltung | Admin | Admin, Billing Admin |
|
||||
| `monteur@hivegrid.de` | Monteur | Member | User |
|
||||
| `vertrieb@hivegrid.de` | Vertrieb | Member | User |
|
||||
|
||||
Login-URL: `http://localhost:3000/hivegrid-demo/dashboard`
|
||||
|
||||
Tenant: Slug `hivegrid-demo`, Name `HiveGrid Demo SHK`, Blueprint `crm-saas`,
|
||||
aktive Business-Subscription, die wichtigsten v1-Feature-Gates freigeschaltet
|
||||
(`dashboard`, CRM, Leads, Projekte, Tasks, Files, HR, Integrationen, Bookings,
|
||||
Forms, Automationen, E-Mail-Inbox, API, Suche).
|
||||
|
||||
## Was wird geseedet
|
||||
|
||||
- **14 Kontakte:** 6 Firmen (mit Adresse) + 8 Privatpersonen (mit E-Mail + Telefon)
|
||||
- **3 Pipelines** mit Stages (Vertriebs- und Auftrags-Pipeline)
|
||||
- **8 Projekte** über mehrere Stages verteilt (inkl. gewonnen/verloren)
|
||||
- **6 Leads** (verschiedene Quellen + Status) mit 3 Lead-Sources
|
||||
- **5 Forms** (u.a. `SHK Angebotsanfrage`, `SHK Abnahmeprotokoll`) mit
|
||||
**9 Submissions** und Action-Logs
|
||||
- **2 Booking-Pages** mit **3 Terminen**, Provider-Zuordnung, Verfügbarkeits-Regeln
|
||||
(Mo–Fr für 3 Nutzer) plus **4 Datums-Ausnahmen** (Urlaub + Custom-Window, für den
|
||||
`/availability`-Editor); die Seite `Beratung vor Ort` ist mit dem Intake-Form
|
||||
`SHK Angebotsanfrage` verknüpft (AK-P16b/AK-P16c)
|
||||
- **6 Kalender-Events** inkl. Booking-Spiegelung, externem Privat-Termin und einer
|
||||
zweitägigen ganztägigen Messe (Quell-Marker fürs Kalender-Grid) + 1 Konflikt-Log-Eintrag
|
||||
- **2 Automationen** mit **4 Executions** inkl. Erfolg, Dry-Run und Fehlerfall
|
||||
- **6 Tasks** (an Projekte/Kontakte verknüpft)
|
||||
- **2 Rechnungen**, **4 Benachrichtigungen**, **5 Activity-Einträge**
|
||||
- **1 API-Key** (`Website Lead Intake`) + **1 eingehender Webhook**
|
||||
(`website-kontaktformular`)
|
||||
|
||||
## Sichtbarkeit von Demo-Daten
|
||||
|
||||
Einige Listen filtern `isDemoData = true` standardmäßig aus, damit echte
|
||||
Tenant-Daten nicht mit Demo-Füllstand vermischt werden. Für Review-Screens ggf.
|
||||
`?demo=show` anhängen oder den UI-Toggle „Demo-Daten anzeigen“ nutzen:
|
||||
|
||||
- `http://localhost:3000/hivegrid-demo/contacts?demo=show`
|
||||
- `http://localhost:3000/hivegrid-demo/projects?demo=show`
|
||||
- `http://localhost:3000/hivegrid-demo/tasks?demo=show`
|
||||
|
||||
## Hinweis: lokale DB-Erreichbarkeit
|
||||
|
||||
Das Runtime-`DATABASE_URL` zeigt auf PgBouncer (`localhost:6432`). Läuft PgBouncer
|
||||
lokal nicht, ist der direkte Postgres-Backend-Port erreichbar (Container
|
||||
`hivegrid-local-pg`). Zum einmaligen Seeden gegen den direkten Port ohne `.env`
|
||||
zu ändern:
|
||||
|
||||
```bash
|
||||
DATABASE_URL="postgres://<user>:<pass>@localhost:5434/boilerplate" pnpm seed:demo
|
||||
```
|
||||
|
||||
Es ist dieselbe Datenbank, die die App über PgBouncer liest — Seeding über den
|
||||
direkten Port schreibt in denselben `boilerplate`-Datenbestand.
|
||||
Reference in new issue
Block a user