feat: PLANNING体系首版（00路线图/02任务总表/03执行协议/I-03/I-04/registry42口径）+M1止血交付

2026-09-12 14:25:25 +08:00
commit 8242e730b4
482 changed files with 37029 additions and 0 deletions
@@ -0,0 +1,47 @@
+# S-02 · DSP 部署基线（Docker + LAN）
+
+| 字段 | 值 |
+|---|---|
+| 项目 | DSP · `Desktop/dsp/dsp`（deploy + nginx + backend） |
+| 优先级 | P1 · M4 |
+| 建议模型 | deepseek-v4-flash（主）/ glm-5.3-flash（复核） |
+| 依赖 | S-01（测试基建先绿） |
+| 预估 | 1.5 天 |
+
+## 一、背景（为什么做）
+
+DSP 架构文档（`docs/architecture-dual-client.md`）定义了完整形态：Android + Web 双端、Django + Channels、PG + Redis、ffmpeg 转码、nginx 静态视频。但**没有一键部署与验收**——"最后一公里"没修。
+
+## 二、目标（交付物）
+
+1. `docker-compose.yml`：`db`(postgres:16) + `redis:7` + `api`(granian ASGI + Channels) + `web`(nginx) 四服务，含健康检查与依赖顺序。
+2. 一键脚本：`deploy.sh`（构建 → 起服务 → 迁移 → 种子数据 → 健康检查），幂等可重跑。
+3. nginx 配置：`/api` 反代、`/media` 静态视频（Range 支持）、SPA 回退。
+4. 部署文档：环境要求、命令、验证清单、**回滚步骤**。
+5. 冒烟验收脚本：健康检查 + 关键 API + 视频文件 Range 请求。
+
+## 三、验收标准
+
+- [ ] 全新环境（干净机器/清空卷）一条命令拉起全栈
+- [ ] 冒烟脚本全过：健康检查、登录、视频列表、视频 Range 播放（206 响应）
+- [ ] 重启幂等：重复执行 deploy.sh 不报错、不毁数据
+- [ ] 文档含回滚步骤并演练过一次（记录）
+- [ ] 在 LAN 192.168.5.7 部署成功（或本机等价环境 + 差异说明）
+
+## 四、验收命令（参考）
+
+```bash
+bash deploy.sh
+bash smoke.sh
+curl -s -o /dev/null -w "%{http_code}" -H "Range: bytes=0-1023" http://localhost/media/<video>.mp4   # 期望 206
+```
+
+## 五、边界（不许做）
+
+- 不上 K8s/复杂编排（单机 Compose 是明确规模假设）
+- 不引入外部 CDN/云存储
+- 不动应用代码（纯部署层；有 bug 记 PROGRESS 遗留）
+
+## 六、交接
+
+写 `PROGRESS_S-02.md`（含冒烟输出、回滚演练记录）。