13 KiB
Handoff — Stand 2026-05-21
Historical snapshot only (2026-05-25 cleanup). This file is preserved for audit/history. Do not treat its "start", "push", "deploy" or operator instructions as current work. Use
PROGRESS.md,OPERATOR-CHECKLIST.mdand the latest session notes for live status.
Vorgänger-Agent: Claude Opus 4.7 (1M context) Letzte aktive Session: #72 i18n-Extraction (2 Batches) + Worker-Crash-Fix + Lighthouse-CI-Rebuild — 5 Commits gepusht, Staging grün Ziel des Handoffs: Nachfolge-Agent weiß in 5 Minuten wo wir stehen und kann einen der großen Tracks fokussiert aufnehmen.
0. Start hier (5-Minuten-Onboarding)
Lies in dieser Reihenfolge:
- Dieses Dokument komplett.
HANDOFF-2026-05-20b.md+HANDOFF-2026-05-20.md— archivierter Bucket-A / Operator-Pending-Kontext..claude/CLAUDE.md— React-Router-v7-Konventionen, strikt enforced.AGENTS.mdim Repo-Root — Workflow + Branch-Strategie.
Sofort-Sanity-Check (Repo-Root):
git log --oneline -6 # HEAD sollte d1b2183a sein (oder neuer)
git status -s # nur packages/db/generated/** churn erwartet
git pull --rebase --autostash # andere Agenten arbeiten ggf. parallel
Dann: EINEN großen Track aus Section 3 wählen, fokussiert aufnehmen. Nicht mehrere parallel. Bei #38 zwingend eigene saubere Session (siehe Risiko-Hinweis).
1. Was diese Session bewegt hat (5 Commits auf main, gepusht)
origin/main = d1b2183a. Push-Range dieser Session: c8b37a89..d1b2183a.
| Commit | Was |
|---|---|
35b7483a |
#72 i18n Batch 1 — 65 hartcodierte JSX-Text-Strings über 42 apps/web/app-Dateien auf ui.autogenerated.*-Translation-Keys umgestellt (sha1-Suffix, Konvention der bestehenden 1335 Keys). EN-Werte + idiomatische deutsche Übersetzungen in beide translations.json. verify-hardcoded-strings.mjs-Baselines runter: jsx-text 85→18, user-facing-prop-literal 73→46, Lock-Test angepasst. |
7c36c00c |
#72 i18n Batch 2 — 20 weitere gate-gezählte Strings über 7 Admin-/Route-Dateien (Tabellen-Header, Card/Breakdown-Props, 3 interpolierte aria-labels mit {{value0}}). Baselines: jsx-text 18→9, user-facing-prop-literal 46→35. |
a06c41ff |
Worker-Crash-Fix — ioredis in apps/worker/package.json deklariert. Der Worker bündelt @toolctrl/shared-store (importiert ioredis direkt) ins dist/index.js; ioredis war nur transitive Dep → unter pnpms isoliertem Linker nicht im Worker-Image → ERR_MODULE_NOT_FOUND, Crash-Loop. |
cff48bc4 |
Lighthouse-CI-Rebuild — Workflow lief auf dem Gitea-Runner nie (kein Browser, kein Server, keine DB). Neu: auditet das deployte Staging (boiler.saas-ctrl.com), Gitea-Job installiert Chromium, Trigger = schedule (nächtlich) + workflow_dispatch. Neue .lighthouserc.staging.json. |
d1b2183a |
Lighthouse: nur Performance gegatet — Produkt-Entscheidung des Operators: B2B-SaaS, SEO irrelevant. categories:performance bleibt error ≥0.95; seo nicht mehr asserted; accessibility/best-practices → warn. Gilt für .lighthouserc.staging.json + .lighthouserc.json. |
Verifiziert: Worker healthy auf Staging, deploy.yml grün, lighthouse.yml grün (Run 7000). Web/API/Worker laufen alle auf d1b2183a.
2. Wichtige Erkenntnisse / Gotchas dieser Session
- E-Mail-i18n ist eine Sackgasse, NICHT aufnehmen. Untersucht: Transaktionsmails (
packages/mail/src/templates-react/transactional/) sind bewusst englisch —EmailTemplates.ts:20-36dokumentiertt/localeals akzeptiert-aber-ignorierte No-ops; volle i18n wurde von der Phase-10-#75-React-Email-Migration explizit als „coordinated cross-cutting rewrite" verschoben.mail.jsonist verwaistes Legacy. Sequenz-Mails (packages/email-templates/src/sequences/*) sind totes Gerüst — der Worker-renderTemplateist einthrow-Stub (email-sequence-runtime.ts:92),sendMailfällt geschlossen. → Kein sauberer i18n-Task hier. - #73 a11y-Tooling ist inkonsistent.
.eslintrc.a11y-baseline.jsonverweist aufscripts/verify-a11y-baseline.mjs— existiert nicht. Scope (apps/web/app/**) vs. Rationale (packages/uistorybook) widersprüchlich.anchor-is-valid(3) /no-noninteractive-tabindex(1) reproduzieren sich nicht sauber. Vor #73-P2-Arbeit das Tooling klären/reparieren. no-autofocus(88) ist KEIN mechanischer Sweep.autoFocus→useEffect-Fokus umgeht nur die Lint-Regel, behebt das a11y-Problem nicht. Echte Lösung = 88 Einzelfall-Urteile (eslint-disablemit Begründung vs. entfernen).- i18n-Audit zählt auskommentierten Code.
scripts/i18n-audit.mjsscannt rohen Source inkl.{/* */}-Blöcke. Bei Batch 1 waren 16 von 111 „Treffer" in totem Code — bewusst NICHT migriert. Der enforced Gate (verify-hardcoded-strings.mjs) überspringt Kommentarzeilen korrekt. Audit-Floor steht bei 46 (30 gate-excluded Seed/Codegen/Legal-Pages + 16 auskommentiert).
3. Offener Track-Bestand + Empfehlung
Die sauberen Quick-Wins sind erschöpft. Alles Folgende ist substanziell — ein Track pro fokussierter Session.
| # | Track | Aufwand | Hinweis |
|---|---|---|---|
| #38 | Shared-Store: Session-Store sync→async | 2-3 Tage | HÖCHSTES RISIKO. Eigene saubere Session zwingend. apiSessionStore hat synchrone API (createSession/getActiveSession/rotateSession/revokeSession), konsumiert von vielen sync Route-Handlern + JWT-signing-flow. Falsch gemacht = Logout-Storm auf Prod. Nur 1/6 Store offen (rate-limits ×2, idempotency, subscription-cache erledigt). |
| #42 | Outbox completion | ~1 Woche | call-site migrations, admin UI, CLI re-queue, e2e tests. Admin-UI-Teil braucht Browser-Verifikation. |
| #73 | WCAG P2 | 3-4 Tage | Erst Tooling reparieren (Section 2). Dann no-autofocus (88) per Einzelfall-Urteil. media-has-caption (2 in AudioOrVideoPlayer.tsx) = generische Komponente, vermutlich justified eslint-disable. |
| #53/#55 | Feature-Flag-Builder / AI-Cost-UIs | je 3-5 Tage | UI-Tracks — brauchen Dev-Server/Browser-Verifikation. |
| #76 | Test-Coverage ratchet | 5-10 Tage | Per-Modul-Gates hochziehen. |
| #21/#22 | Plugin Phase 1+2 | 2-3 Wochen | Hot-reload, marketplace, sandboxed iframe, 13 hook-points. |
| F-002 | WASM per-instruction fuel | mehrere Wochen | Wasmtime-Swap oder worker-thread + wall-clock kill. |
#72 i18n ist abgeschlossen (darum nicht mehr im Track-Bestand oben): mechanische Extraction, Namespace-Split (billing/crm/auth/emailMarketing) und E2E-Locale-Switch sind erledigt — Commits a3885ed5 + fa8b0e70 (Stand 2026-05-22 noch lokal, nicht gepusht). Korrektur zum früheren Stand dieses Dokuments: „Arabisch" war nie ein geplanter Track. Es taucht in 10-compliance-polish/i18n-foundation.md ausschließlich als Beispiel auf — für Plural-Komplexität (6 Plural-Formen) und als RTL-Begründung. supportedLngs ist DE/EN; RTL existiert nur als Foundation mit 2 Storybook-Smoke-Tests (dir="rtl"-Toggle), siehe 10-compliance-polish/VERIFICATION.md. Keine ar-Locale vorschlagen oder bauen.
Empfehlung: Als Nächstes #38 in einer dedizierten, frischen Session. Sorgfältig: erst alle Call-Sites von apiSessionStore kartieren, dann async-Migration mit Tests pro Call-Site, kein Big-Bang.
Offene Lighthouse-Restpunkte (klein, optional)
- Authentifizierte Routen (
/app/*,/admin/*) werden noch nicht auditiert — braucht einen rotierten Staging-Session-Cookie als CI-Secret. Doku-Pfad indocs/architecture/lighthouse.mdbeschrieben. - Der
Upload Lighthouse artifacts-Step meldetNo files found .lighthouseci/(kosmetisch — Reports liegen auftemporary-public-storage, Links im Job-Log).
4. Bucket-A / Operator-Pending (unverändert)
Historical note only: this 2026-05-21 operator-pending snapshot was superseded by OPERATOR-CHECKLIST.md and PROGRESS.md. In particular, A7/B2/#51 CDN rollout is now parked in backlog rather than active operator work.
Bekannte pre-existing Test-Brüche (nicht von dieser Session): packages/config/src/env-examples.test.ts (9 uncataloged PLUGIN_* keys), apps/api-typecheck (3 pre-existing Errors, nicht push-blocking).
5. Konventionen (unverändert)
- Alle Commits direkt auf
main.git pull --rebase --autostashvor Workflow-Start (Worktree hat permanentenpackages/db/generated/**-Churn). - Lefthook pre-commit (test-density / eslint-baseline / secrets / lint-staged) und pre-push (full
pnpm typecheck, ~50s) sind hart. - React Router v7: Route-Type-Imports IMMER
./+types/<name>, nie relativ. - Niemals
git add -A— explizite Paths. Achtung:packages/db/generated/**niemals mitcommitten. pnpm, nicht npm. Tests vianpx vitest run <path>.- Co-Author-Trailer:
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com> - Push deployt auto via Coolify auf Staging. CI-Status prüfbar via Gitea-DB-Query (siehe
docs/improvement-plan/archive/STAGING-ACCESS.mdSection "CI / Gitea-Actions Runner"). lighthouse.ymltriggert NICHT mehr auf Push — bei Bedarf viaworkflow_dispatchauslösen (curl-Command indocs/improvement-plan/archive/STAGING-ACCESS.md).
6. Operator-Profil-Notiz
Operator hat klargestellt: SEO ist für dieses Produkt irrelevant (B2B-SaaS, keine Search-Discoverability nötig). Keine Meta-Description-/Sitemap-/Structured-Data-Arbeit vorschlagen. Quality-Gates fokussieren auf Performance.
Ende des Handoffs. Bei Unklarheit fragen, nicht raten.