Files
HiveGrid-Wireframes/03 Quellen und Referenzen/hivegrid-cloud/.planning/ticket-docs/R-P1a.md
T

90 lines
8.2 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** | 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.