Document deployment tuning phase

ai_knowledge_base_v2/development_records/2026-07-08-concurrency-optimization-plan.md

@@ -452,3 +452,25 @@
 1. 当前 Redis 缓存 TTL 仍复用进程内缓存的 5 分钟默认值。
 2. 同步旧飞书链路暂未接入 Redis 缓存，用户端 async 问答链路已接入。
 3. 后续可以在系统设置开放飞书缓存 TTL、缓存清理和单知识库刷新能力。
+
+## 阶段 5 实施计划
+
+目标：补齐生产部署时必须可调的 worker、数据库连接池和压测工具，方便后续基于数据调参。
+
+实施范围：
+
+1. 后端启动支持 `BACKEND_WORKERS` 环境变量。
+2. SQLAlchemy 连接池支持环境变量配置：
+   - `DB_POOL_SIZE`
+   - `DB_MAX_OVERFLOW`
+   - `DB_POOL_TIMEOUT`
+   - `DB_POOL_RECYCLE`
+3. `.env.example` 和 dev compose 补齐对应配置。
+4. 新增一个轻量聊天压测脚本，用于并发请求 `/chat/completions`，输出成功数、错误数、首包耗时、总耗时。
+5. 文档记录默认值和调参建议。
+
+风险控制：
+
+1. dev 环境默认仍使用 1 个 worker，避免本地调试时多 worker 日志和热更新混乱。
+2. 生产可以通过环境变量调高 worker，不需要改代码。
+3. 压测脚本只作为研发/验收工具，不进入应用启动链路。