fix(docs): document evidence file upload issue and VPS setup

Files not displaying after upload due to missing EVIDENCE_DIR and
EVIDENCE_URL_SECRET environment variables. Uploads fail silently when
env vars unset, files never inserted into database.

Add bug fix documentation with root cause analysis and VPS deployment
instructions. Update .env.local.example to emphasize these vars are
required for file uploads to work.

See docs/BUG_FIX_evidence_display.md for details.
This commit is contained in:
2026-08-15 11:01:49 +08:00
parent acc1f58a29
commit d7ba6a5265
2 changed files with 57 additions and 1 deletions
+2 -1
View File
@@ -10,7 +10,8 @@ APP_URL=http://localhost:3000
NEXT_PUBLIC_SITE_URL=http://localhost:3000
CRON_SECRET=<generate with: openssl rand -hex 32>
# Evidence storage (local filesystem)
# Evidence storage (local filesystem) — REQUIRED for file uploads
# Without these, file uploads fail silently and no files appear in incidents
EVIDENCE_DIR=/tmp/ims-evidence
EVIDENCE_URL_SECRET=<generate with: openssl rand -hex 32>