Files
nick-doc/Issues/ISSUE-105-backend-no-startup-validation-of-required-env-vars.md
Siavash Sameni dceaf82934 audit: 2026-05-30 full-codebase audit — report, issues, docs, runbooks
Full-codebase-audit 2026-05-30 outputs:
- Audit report: 09 - Audits/Full Codebase Audit - 2026-05-30.md
- 81 issue files ISSUE-055..135 (decisions + 1 skipped no-brainer).
- Scanner docs from scratch (was zero): architecture, data model, API ref, payment
  flow, operations runbook + repo README.
- Doc-sync updates across API reference, data models, flows, design system.
- Secret Rotation Runbook (08 - Operations) for the exposed credentials.
- Reusable workflow guide (07 - Development) + .claude/workflows/full-codebase-audit.js.

Issues remain status:open intentionally — the code fixes are uncommitted-then-committed
working-tree changes per repo and aren't "resolved" until merged/deployed.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-05-30 18:48:04 +04:00

1.3 KiB

issue, title, severity, domain, labels, status, created, source
issue title severity domain labels status created source
105 Backend: no startup validation of required env vars — silent misconfiguration medium Configuration
backend
reliability
configuration
open 2026-05-30 Full Codebase Audit 2026-05-30

Backend: no startup validation of required env vars — silent misconfiguration

Severity: medium Domain: Configuration Labels: backend, reliability, configuration

Description

backend/src/shared/config/index.ts:32 reads env vars without validating they are present or have correct types. A misconfigured deployment (missing JWT_SECRET, MONGODB_URI, or SMTP_PORT) starts silently and fails only at runtime when those vars are first used, making misconfiguration hard to diagnose.

Options

  1. Validate required vars with a schema (zod/envalid) and exit on missing/NaN.
  2. Manual assertions for the critical few (PORT, JWT_SECRET, MONGODB_URI, SMTP_PORT).
  3. Log-and-continue warnings only.

Recommendation

Add schema-based validation that fails fast on missing/invalid required vars. Changes startup behavior.

Affected Files

  • backend/src/shared/config/index.ts:32

References