6.6 KiB
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
- GitHub/Google-OAuth-Reste entfernt;
User.githubId/User.googleIdaus Schema raus (war bereits via Migration20260605120000_drop_oauth_identity_fieldsraus) - GA + ConvertKit-Einbindungen entfernt (Externals D3) (inkl. Drop der verwaisten GA-Spalte, s.u.)
- Kein US-Kern im Auth-Pfad (EU-Sterilität nachweisbar)
- URL-Schemata dokumentiert in
docs/INTEGRATION-CONTRACTS.md: App, Admin (admin.hivegrid.de), Portal, Forms, Booking, Help, API - Repo baut lokal durch; upstream-Remote bleibt mergebar (AD-10)
Technische Bausteine
- Keine neuen Entities — nur Felder entfernen (
User.githubId/googleIdausaccounts.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, MilestoneM012-workspace-topologieREQUIREMENTS.md→REQ-integration-routesdocs/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-P1aaktualisiert
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.tsxgtag.js-Block,AnalyticsHelper.tswindow.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_IDaus 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.tswar aufmainrot (Regression aus EXT-12:IpAddressServicedelegiert Env-Config angeoip.server.ts). Boundary-Test auf die tatsächlich config-lesende Datei nachgezogen.
Spalten-Drop (nachgezogen 2026-06-17):
AppConfiguration.analyticsGoogleAnalyticsTrackingIdgedroppt — Migration20260617121403_drop_app_config_ga_tracking_id(forward-only DROP COLUMN + Inverse-SQL-Kommentar, DoD 28). Generiert + validiert gegen eine lokale Wegwerf-Postgres (alle 154 Migrationenmigrate deploygrün,migrate status„up to date",validateok), Prisma-Client neu generiert. Commitfe428e1b, nachmaingemerged, 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 vonportals.db.server.ts/PortalDto/Portal-Settings gelesen/geschrieben.
Staging-Deploy & Gegencheck (Deploy-Run 8343, fe428e1b):
staging-web.hivegrid.de/healthz→ revisionfe428e1b;/healthcheck→ 200 (DB erreichbar, DROP COLUMN hat nichts gebrochen);/→ 302 (rootData lädtAppConfigurationohne die Spalte fehlerfrei → Schema/Code konsistent).- Infra-Lernpunkt: Der erste Deploy-Versuch von
fe428e1bschlug fehl — nicht wegen Code/Migration, sondern transientes429 Too Many Requestsder Gitea-Docker-Registry beim Layer-Push (Build-Cache). Migration lief dabei gar nicht erst (Build brach davor ab), Staging blieb stabil aufc2a31a2b. Ein Rerun löste es. Gleiches Muster traf zuvor2f740f2a. 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.