90 lines
8.2 KiB
Markdown
90 lines
8.2 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** | Done |
|
||
|
||
## Abhängigkeiten & Parallelität
|
||
- **Blocked by:** — (allererstes Dev-Ticket)
|
||
- **Blocks:** `R-P1b` + gesamtes Fundament (alle Folge-Phasen sitzen auf den Contracts), konkret `VA-P26a`/`VA-P26c` für den nachgezogenen Portal-Host-Vertrag
|
||
- **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; HiveGrid-Naming-Contracts ohne Alt-Aliase (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)
|
||
- Historische Milestone-Zuordnung: Phase 1, Milestone `M012-workspace-topologie`
|
||
- `REQUIREMENTS.md` → `REQ-integration-routes`
|
||
- `docs/INTEGRATION-CONTRACTS.md` (URL-Schemata — Ziel-Dokument)
|
||
- `AGENTS.md` → Bespoke-HiveGrid und EU-Stack
|
||
- `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/ROADMAP nachgezogen
|
||
- [x] 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. VA-P26a hat den unreferenzierten Legacy-Persistenzpfad `portals.db.server.ts` entfernt; eine spätere Portal-Settings-Integration muss das Feld über den bespoke Customer-Portal-Pfad anbinden.
|
||
|
||
**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:** `@hivegrid/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**.
|
||
|
||
## Abschluss-Notiz (2026-07-09, Raffael)
|
||
|
||
**DoD-Stand:** 5/5 DoD = 100 % done.
|
||
|
||
**Proof:** Die Umsetzung ist auf `main` enthalten und laut vorheriger Umsetzungsnotiz auf Staging mit Revision `fe428e1b` live verifiziert. Dieses Ticket ist screen-frei; die optionalen David-Delta-Nachzüge sind kein Done-Blocker.
|
||
|
||
**Plane:** Ticket `HIVEGRID-16` auf `Done` verschoben.
|
||
|
||
## Dependency-Impact-Nachzug (2026-07-15, AD-30/CR-001)
|
||
|
||
Der öffentliche Customer-Portal-Vertrag wurde von `app.hivegrid.de/portal/<tenant>/...` auf den dedizierten
|
||
Host `portal.hivegrid.de/<tenant>/...` geändert; verifizierte Custom-Hosts kommen über `VA-P26c` hinzu. App,
|
||
Admin, API und die übrigen P1-Hostverträge bleiben unverändert. `docs/INTEGRATION-CONTRACTS.md`,
|
||
`REQUIREMENTS.md` sowie die abhängigen P26-Tickets wurden synchron nachgezogen.
|
||
|
||
**Auswirkung auf diesen Done-Stand:** Keine Wiederöffnung. Das Ticket bleibt **5/5 DoD = 100 % done**, weil der
|
||
verbindliche Contract weiterhin zentral dokumentiert ist und noch keine produktive Portal-Route umgebaut werden
|
||
muss. Die Runtime-Implementierung des neuen Hosts liegt in `VA-P26a`: separater `hivegrid-portal`-Container aus
|
||
demselben immutable Web-Image, fail-closed vor Static-Asset-Serving und React Router und mit eigenem minimal berechtigtem DB-Login.
|
||
Paket-/Custom-Domain-Provisioning liegt in `VA-P26c` und routet nur auf diesen Portal-Service.
|