Troubleshooting

Source: app_docs/guide/troubleshooting.md, app_docs/guide/faq.md.

Worker offline

Symptoms: Cases stuck IN_PROGRESS; jobs PENDING; readiness worker “attention”.

Fix (self-host / local):

bun run worker

Confirm DATABASE_URL matches the app. Check logs for worker_started.

Check	Action
Consent published?	Publish a version
Key valid?	Develop → publishable key not revoked
SDK origin?	Must be Erasure origin (`apiBaseUrl` / origin only)
Network	POST `/api/sdk/v1/consent` → 201?
Rate limit	429 → back off

Check	Action
Credentials	Rotate secrets (Owner)
TLS	Production SQL needs `sslmode=require` / `ssl=true`
Network from worker	Egress / firewall
Demo Acme MySQL	Intentionally DEGRADED for training in demo seed

Check	Action
`RESEND_API_KEY` + `EMAIL_FROM`	Required in production
Spam folder	Subject line from org name
Rate limits	Wait; outstanding challenges capped
`RIGHTS_INTAKE_DEMO_OTP`	Must not be true in prod
Logs	`rights_intake_otp_delivered` vs `…_failed`

Cause	Fix
Non-SQL connector	Discovery only Postgres/MySQL
Auth/network	Fix connection string
Permissions	GRANT on information_schema + tables
Huge catalog	Discovery is capped; prioritize schemas

Graph emphasizes mapped delete paths + sample unmapped.
Ignored tables appear sparsely. Re-discover after mapping.

Cause	Fix
SKIP action	Intentional retention
Identifier mismatch	Subject email vs column values
Wrong table	Remap entity
Preview COUNT was 0	Expected empty

Direct SQL in a browser is unsafe and un-audited. Rights + worker + maps give verification gates, retries, timelines, and Evidence.