feat: add deployment smoke check

docs/DEPLOYMENT.md

@@ -80,6 +80,17 @@ database schema. If the release included an incompatible schema change, restore
 the matching PostgreSQL backup before starting the previous images. Always
 verify the API and web health checks after a rollback.
 
+Run the post-deploy smoke check against the public endpoints:
+
+```sh
+API_HEALTH_URL=http://localhost:3000/health \
+WEB_BASE_URL=http://localhost:8080 \
+./scripts/smoke-production.sh
+```
+
+The check performs read-only requests against API health, the web health path,
+and public search. It exits nonzero on the first failed request.
+
 ## Health Checks
 
 Production Compose waits for healthy PostgreSQL, Redis, and API services before