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,68 @@
# R-P1a · P1 EU-Sterilisation + Contracts + URL-Schemata
| | |
|---|---|
| **Typ** | Dev (Code) |
| **Owner** | Raffael |
| **Phase** | P1 — Fundament & Walking-Skeleton |
| **Cycle/Fenster** | W1 — Fundament & Identität · fällig 2026-06-17 · Gate W1 |
| **Status** | geplant |
## Abhängigkeiten & Parallelität
- **Blocked by:** — (allererstes Dev-Ticket)
- **Blocks:** `R-P1b` + gesamtes Fundament (alle Folge-Phasen sitzen auf den Contracts)
- **Läuft parallel zu:** `AK-INFRA1`/`AK-INFRA2` (Akeshan, reines Ops — kein Code-Konflikt). **P1 läuft Raffael SOLO** (R-P1a→R-P1b→R-P1c), Akeshan parallel auf der Infra-Schiene.
- **Konflikt-Risiko:** keines — diese Phase ist Repo-Säuberung + Contract-Dokumente, kein Schema-Konflikt. (AD-21: jedes Modul später eigene `prisma/schema/<modul>.prisma`.)
## Was wir bauen
Macht das Repo zu einer **lauffähigen, EU-sterilen Codebasis**: alle US-/OAuth-Altlasten aus der Boilerplate raus (GitHub/Google-OAuth-Reste, `User.githubId/googleId`, kein US-Kern im Auth-Pfad), GA + ConvertKit entfernt (Externals D3). Dazu die **verbindlichen URL-Schemata** als Bau-Vertrag, gegen den alle Folge-Phasen ihre Routen registrieren (App / Admin / Portal / Forms / Booking / Help / API).
## Benötigte Screens (Backend bedient — Design liefert `D-D0a`/`D-D0b`)
Kein fachlicher Screen. P1 ist Plattform-Fundament; der UI-Anteil liegt komplett in `D-D0a` (App-Shell A1) + `D-D0b` (Archetypen A2–A7 + Primitives) und wird über R-P1c (Walking-Skeleton) erstmals angedockt. Dieses Ticket liefert die **URL-Schemata**, gegen die David seine Routen-Hierarchie ausrichtet.
## Definition of Done
- [x] GitHub/Google-OAuth-Reste entfernt; `User.githubId`/`User.googleId` aus Schema raus *(war bereits via Migration `20260605120000_drop_oauth_identity_fields` raus)*
- [x] GA + ConvertKit-Einbindungen entfernt (Externals D3) *(inkl. Drop der verwaisten GA-Spalte, s.u.)*
- [x] Kein US-Kern im Auth-Pfad (EU-Sterilität nachweisbar)
- [x] URL-Schemata dokumentiert in `docs/INTEGRATION-CONTRACTS.md`: App, Admin (`admin.hivegrid.de`), Portal, Forms, Booking, Help, API
- [x] Repo baut lokal durch; upstream-Remote bleibt mergebar (AD-10)
## Technische Bausteine
- **Keine neuen Entities** — nur Felder entfernen (`User.githubId/googleId` aus `accounts.prisma`/`core.prisma`). Schema-Eingriffe minimal; **db push auf Branch, Migration erst beim Merge** (AD-21).
- EU-Sterilisation berührt Auth-Service-Pfad (`apps/web/app/services/auth/`) — OAuth-Provider-Reste deaktivieren/entfernen, nicht App-Logik umbauen.
- URL-Schemata als verbindlicher **Integration-Contract** (Multi-Host: App/Admin/Portal getrennte Subdomains).
- `is_demo_data`-Konvention: hier nur als Vorgabe dokumentiert (greift ab Seed-Tickets).
## Quellen (granular)
- `ROADMAP.md` → Phase 1 (Goal: EU-sterile lauffähige Codebasis)
- `PHASE-SOURCES.md` → Phase 1, Milestone `M012-workspace-topologie`
- `REQUIREMENTS.md` → `REQ-integration-routes`
- `docs/INTEGRATION-CONTRACTS.md` (URL-Schemata — Ziel-Dokument)
- `EXTERNALS-CHECKLISTE.md` → D3 (GA/ConvertKit raus)
- `designer-briefs/P01-fundament-walking-skeleton.md` (§EU-Sterilisation + URL-Schemata)
## Dev-Nachzug (nach Davids `D-D0a`/`D-D0b`-Delta)
- [ ] URL-Schemata an Davids Routen-Hierarchie-Entscheidungen angepasst
- [ ] REQUIREMENTS/PHASE-SOURCES nachgezogen
- [ ] Plane-Ticket `R-P1a` aktualisiert
## Umsetzungsstand (Claude, 2026-06-17 — noch nicht final abgenommen)
> Branch `p1-fundament-rp1abc`. Diese Notiz dokumentiert den Stand; den finalen DoD-Abhaken/Done macht Raffael.
**Ausgangslage:** Repo war bereits ~95% EU-steril. OAuth (GitHub/Google) + `User.githubId/googleId` waren schon raus (Migration `20260605120000_drop_oauth_identity_fields`); die URL-Schemata standen bereits vollständig in `docs/INTEGRATION-CONTRACTS.md` (App/Admin/Portal/Forms/Booking/Help/API §3). Verifiziert per Grep: keine OAuth-Reste, keine US-AI-Imports.
**Tatsächliche Arbeit = GA + ConvertKit-Einbindung entfernen (Externals D3):**
- **Google Analytics (App-Ebene):** `ScriptAnalytics.tsx` gtag.js-Block, `AnalyticsHelper.ts` `window.gtag`-Calls, `appConfiguration.db.server.ts`-Plumbing, Admin-Settings-Feld (`admin/settings/analytics.tsx` + Validierung), `packages/config` (`web.ts`/`types.ts`/`catalog.ts` + `ANALYTICS_GA_TRACKING_ID` aus allen `.env.*`-Beispielen). **SimpleAnalytics + Plausible (EU, datenschutzfreundlich) bleiben** erhalten.
- **ConvertKit (US-Newsletter):** Provider-Integration aus `CrmService.ts` (subscribe-Branch + Subscriber-Fetch/Sync), `packages/config` + `CONVERTKIT_*` aus `.env.*`, Admin-CRM-Sync-Badge (`admin/crm/sync.tsx`). **CRM-Kern (Contacts/Companies/Opportunities/Submissions) bleibt**; Newsletter läuft nur noch über das eigene CRM.
- **Baseline-Fix:** `runtime-node-env-boundary.test.ts` war auf `main` rot (Regression aus EXT-12: `IpAddressService` delegiert Env-Config an `geoip.server.ts`). Boundary-Test auf die tatsächlich config-lesende Datei nachgezogen.
**Spalten-Drop (nachgezogen 2026-06-17):**
- `AppConfiguration.analyticsGoogleAnalyticsTrackingId` **gedroppt** — Migration `20260617121403_drop_app_config_ga_tracking_id` (forward-only DROP COLUMN + Inverse-SQL-Kommentar, DoD 28). Generiert + validiert gegen eine lokale Wegwerf-Postgres (alle 154 Migrationen `migrate deploy` grün, `migrate status` „up to date", `validate` ok), Prisma-Client neu generiert. Commit `fe428e1b`, nach `main` gemerged, **auf Staging deployt + live** (Migration sauber gelaufen).
- **Portal-Ebene per-Tenant-GA** (`Portal.analyticsGoogleAnalyticsTrackingId`) bleibt bewusst erhalten: mandanten-konfigurierbares Portal-Feature (Portals-Modul-Scope), nicht P1 — wird weiterhin von `portals.db.server.ts`/`PortalDto`/Portal-Settings gelesen/geschrieben.
**Staging-Deploy & Gegencheck (Deploy-Run 8343, fe428e1b):**
- `staging-web.hivegrid.de/healthz` → revision `fe428e1b`; `/healthcheck` → 200 (DB erreichbar, DROP COLUMN hat nichts gebrochen); `/` → 302 (rootData lädt `AppConfiguration` ohne die Spalte fehlerfrei → Schema/Code konsistent).
- **Infra-Lernpunkt:** Der erste Deploy-Versuch von `fe428e1b` schlug fehl — **nicht** wegen Code/Migration, sondern transientes `429 Too Many Requests` der Gitea-Docker-Registry beim Layer-Push (Build-Cache). Migration lief dabei gar nicht erst (Build brach davor ab), Staging blieb stabil auf `c2a31a2b`. Ein **Rerun** löste es. Gleiches Muster traf zuvor `2f740f2a`. Wiederkehrend → Registry-Rate-Limit/Build-Cache ist ein Infra-Thema (Akeshan), kein App-/P1-Code-Problem.
**Proof:** `@toolctrl/config` 101/101 grün · Web-Typecheck grün · ESLint `--max-warnings=0` grün · alle betroffenen Tests grün · volle Suite 3698 grün · **Staging live auf `fe428e1b`, healthcheck 200**.