Files
HiveGrid-Wireframes/hivegrid-cloud/.planning/ticket-docs/R-P1a.md
T

69 lines
6.6 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.
# 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**.