8. Troubleshooting & Support

This troubleshooting guide groups structural anomalies by observable symptoms.

Symptom 1: Authentication Loop

Root Cause: Local browser has a stale JWT cookie conflicting with the API's updated HMAC secrets. Resolution Path A: Clear cache/cookies, specifically authjs.session-token. Resolution Path B: Hit the generic application /login manual portal which triggers an automatic purge of orphaned keys.

Symptom 2: Assets Table is Empty upon Bootstrap

Root Cause: The underlying PostgreSQL service hasn't synchronized or seed data failed. Resolution Path A: Check environment variable .env against the PostgreSQL configuration. Resolution Path B: Inspect server logs for TypeORM query execution errors during startup.