Lokales Setup
Für interne Prüfungen muss die API mit einer gepflegten apps/api/.env.local laufen.
Relevante Variablen sind insbesondere SUPABASE_URL, SUPABASE_SERVICE_ROLE_KEY, API_KEY_PEPPER und SUPABASE_DEV_TEST_API_KEY.
set -a
source apps/api/.env.local
set +a
pnpm --filter @namenschild/api bootstrap:dev
pnpm dev:localhostVerifikation gegen die Dev-Umgebung
Der Verifikationslauf prüft Credits, die Exportliste, einen vorhandenen Export-Download und den vollständigen POST /v1/generate Happy Path mit slot_mapping.
Die API-Verifikation nutzt standardmäßig http://api.localhost:3000, solange PUBLIC_API_BASE_URL nicht überschrieben wird.
set -a
source apps/api/.env.local
set +a
pnpm --filter @namenschild/api verify:devWichtige Prüfobjekte
Bei Exportproblemen zuerst exports, csv_imports, credit_transactions, slot_mapping in request_metadata und die Storage-Pfade prüfen.
Für Idempotency-Fragen zusätzlich den zugehörigen Eintrag in private.idempotency_requests und die Request-Logs auswerten.
- X-Request-Id für Log- und Sentry-Korrelation
- X-Export-Id für Export- und Storage-Suche
- output_storage_path für den Download-Pfad im exports-Bucket
- next_cursor für Cursor-Pagination in GET /v1/exports
- csv_imports.status = mapped nach erfolgreicher Slot-Zuordnung