Files
HiveGrid-Wireframes/03 Quellen und Referenzen/hivegrid-cloud/.planning/ticket-docs/R-P1a.md
T
2026-07-08 16:15:37 +02:00

6.6 KiB
Raw Blame History

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.googleId aus Schema raus (war bereits via Migration 20260605120000_drop_oauth_identity_fields raus)
  • 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; 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)
  • 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: @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.