Checkpoint: v4.0 media service, compose deploy, and verified docs

docs/deploy.md

@@ -0,0 +1,60 @@
+# Deployment Guide
+
+## Topology
+
+- 宿主机 nginx：负责 `te.hao.work` 的 TLS、反向代理与大文件上传入口
+- `app` 容器：Node 应用，端口 `3000`
+- `media` 容器：Go 媒体服务，端口 `8081`
+- `worker` 容器：Go 媒体归档 worker，共享媒体卷
+- `media-data` 卷：录制片段、会话状态、归档成片
+
+## Required files
+
+- `.env`
+- `docker-compose.yml`
+- `deploy/nginx.te.hao.work.conf`
+
+## Startup
+
+```bash
+cp .env.example .env
+docker compose up -d --build
+```
+
+## nginx
+
+将 `deploy/nginx.te.hao.work.conf` 放到宿主机 nginx 站点目录，确认：
+
+- `ssl_certificate`
+- `ssl_certificate_key`
+- `proxy_pass http://127.0.0.1:3000` 对应前端与业务 API
+- `proxy_pass http://127.0.0.1:8081` 对应媒体服务
+
+启用后重载 nginx：
+
+```bash
+nginx -t
+systemctl reload nginx
+```
+
+## Health checks
+
+- `curl http://127.0.0.1:3000/api/trpc/auth.me`
+- `curl http://127.0.0.1:8081/media/health`
+
+## Persistent data
+
+媒体数据默认位于 Docker volume `media-data` 下，目录结构：
+
+- `sessions/<session_id>/session.json`
+- `sessions/<session_id>/segments/*.webm`
+- `public/sessions/<session_id>/recording.webm`
+- `public/sessions/<session_id>/recording.mp4`
+
+## Rollback
+
+1. 保留 `.env` 和 `media-data`
+2. 回退 Git 版本
+3. 重新执行 `docker compose up -d --build`
+
+如果只需停止录制链路，可单独关闭 `media` 与 `worker`，主站业务仍可继续运行。