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