BIZ-46 Phase3: 7项 follow-up 开发完成

1. 架构解耦 — SidecarContext + FastAPI Depends 注入
   - 新增 context.py: SidecarContext dataclass 收敛全部全局状态
   - server.py: 移除模块级全局变量，lifespan 创建 ctx → app.state.sidecar
   - webui.py: 移除反向导入 server，改用 Depends(get_context)

2. Prometheus 标签基数治理 — model_id → provider
   - upstream_latency_seconds / upstream_errors_total label 收敛为 provider
   - 模型级信息保留在 structlog JSON 日志

3. SSE 快照共享缓存
   - 1s TTL 共享 snapshot cache + double-check locking
   - 多客户端不重复构建快照

4. 部署支撑
   - Dockerfile (python:3.12-slim, 非 root 用户, HEALTHCHECK)
   - systemd service (安全加固, 资源限制)
   - .env.example (完整环境变量清单)

5. Readiness HTTP Client 复用
   - check_upstream() 注入主 http_client，不再每次创建新 client

6. Retreat 并发回归测试
   - 5 个测试用例全部通过（死锁检测 + 状态转换 + 并发安全）

7. Dashboard UX 优化
   - 队列柱状图 300ms 平滑动画
   - SSE 断连 5s 半透明遮罩
   - 队列图标题显示总排队数
   - 页面加载同步配置

验证: mypy strict 通过 (0 errors), pytest 5/5 通过, server 导入正常 (13 routes)

Co-authored-by: multica-agent <github@multica.ai>

services/nvidia_sidecar/README.md

@@ -2,6 +2,8 @@
 
 为 NVIDIA API 提供**优先级排队 + 令牌桶限流**的透明代理层。
 
+> BIZ-46 Phase3: 架构解耦、Prometheus 标签治理、SSE 共享缓存、部署支撑、测试完善、Dashboard UX 优化。
+
 ## 快速启动
 
 ```bash
@@ -48,8 +50,61 @@ nvidia-sidecar --config /etc/nvidia-sidecar.yaml
 | `/v1/completions` | POST | OpenAI Completions 代理（legacy） |
 | `/v1/embeddings` | POST | OpenAI Embeddings 代理 |
 | `/v1/models` | GET | 模型列表代理 |
-| `/health` | GET | 健康检查 |
-| `/metrics` | GET | 指标查询 |
+| `/health` | GET | 存活检查 (liveness) |
+| `/health/ready` | GET | 就绪检查 (readiness，含上游连通性) |
+| `/status` | GET | 调试用完整状态（限流器 + 队列 + 避退） |
+| `/api/dashboard/stream` | GET | SSE 仪表盘实时推送 |
+| `/api/dashboard` | GET | 仪表盘 HTML 页面 |
+| `/api/admin/config` | GET/POST | 配置查询/热重载（需 Admin Token） |
+| `/metrics` | :9191 | Prometheus 指标端点（独立端口） |
+
+## 部署方式
+
+### Docker（推荐）
+
+```bash
+# 构建
+docker build -t nvidia-sidecar:latest .
+
+# 运行
+docker run -d --name nvidia-sidecar \
+  -p 127.0.0.1:9190:9190 \
+  -p 127.0.0.1:9191:9191 \
+  -e SIDECAR_API_KEY="nvapi-xxx" \
+  nvidia-sidecar:latest
+```
+
+### systemd
+
+```bash
+# 安装
+sudo cp deploy/nvidia-sidecar.service /etc/systemd/system/
+sudo systemctl daemon-reload
+sudo systemctl enable nvidia-sidecar
+
+# 配置环境变量
+sudo cp deploy/.env.example /opt/nvidia-sidecar/.env
+sudo vim /opt/nvidia-sidecar/.env  # 填入实际值
+
+# 启动
+sudo systemctl start nvidia-sidecar
+sudo journalctl -u nvidia-sidecar -f  # 查看日志
+```
+
+### 环境变量清单
+
+详见 `deploy/.env.example`。
+
+### 防火墙建议
+
+```bash
+# 仅允许内网访问代理端口
+sudo ufw allow from 192.168.1.0/24 to any port 9190
+sudo ufw allow from 192.168.1.0/24 to any port 9191
+# 禁止外网访问
+sudo ufw deny 9190
+sudo ufw deny 9191
+```
 
 ## 架构