# 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`（含冒烟输出、回滚演练记录）。