feat: 测试交付 Q1 混沌压测骨架与 Q4 镜像骨架

docs/DEVIATIONS.md

@@ -401,4 +401,60 @@
 
 ## 测试交付 Q
 
-暂无。
+### Q1 / Q4 骨架 2026-09-30
+
+1. **压测客户端未做到 1000 连接 / 10 分钟**  
+   - 原条款：TASKS Q1「1000 连接的压测客户端」；验证「能保持 1000 个连接」。  
+   - 实际做法：`test/load` 提供 MQTT 3.1.1 CONNECT/CONNACK 骨架与 `mqttbench` 命令，单元测试用进程内假 broker 验证多连接与连接数打印；未对真实 broker 压到 1000，也未跑 10 分钟吞吐。  
+   - 原因：本波只做 Q1 基础设施骨架；完整弱网/压测属 Q3，且当前 main 尚无完整 MQTT broker 业务。  
+   - 备选方案：立刻接 mochi 假 broker 或外部 mosquitto 压到 1000。  
+   - 影响：Q3 需补真实压测与报告数字。
+
+2. **未做弱网压测与验收用例**  
+   - 原条款：TASKS Q2/Q3；本波总控指示「不要做弱网压测和验收用例」。  
+   - 实际做法：只交付 toxiproxy/netem 辅助、报告生成器与空结果样例；F01–F23 全部为未测。  
+   - 原因：波次范围。  
+   - 备选方案：无。  
+   - 影响：交付标准第 2、4 条待后续波次。
+
+3. **为 Docker 健康检查在 `cmd/nixmsg` 增加 `healthcheck`**  
+   - 原条款：DEVELOPMENT 11.2/11.4；TASKS 第 5 节 `cmd/nixmsg` 属平台 P。  
+   - 实际做法：Q 线最小实现 `nixmsg healthcheck`（读 `listen.addr` 或配置 `listen`，请求本机 `/healthz`），否则 compose 健康检查无法按文档工作。  
+   - 原因：Q4 镜像骨架硬依赖该子命令；改动面小。  
+   - 备选方案：等 P 实现后再写 compose；或健康检查改用外部 curl（与 distroless 无 shell/curl 冲突）。  
+   - 影响：P 线后续可替换或扩展实现；注意勿重复注册同名命令。
+
+4. **Docker 镜像仅当前架构骨架，不推送**  
+   - 原条款：DEVELOPMENT 11.4 多架构 `buildx` 推送；TASKS Q4 验证两个架构。  
+   - 实际做法：完善多阶段 Dockerfile + `deploy/docker-compose.yml`（镜像名 `git.asio.asia/nixevol/nixmsg`，健康检查 `/nixmsg healthcheck`）；本机只 `docker build` 当前架构并冒烟 `/healthz`；不做 `docker push`、不做 arm64。  
+   - 原因：总控本波只要骨架；推送在 Z3。  
+   - 备选方案：本波强制 buildx 双架构（耗时长、非阻塞目标）。  
+   - 影响：多架构与仓库推送留到 Q4 定稿 / 阶段 3。
+
+5. **compose 示例端口仍写 7443**  
+   - 原条款：测试隔离「不要写死 7443」；DEVELOPMENT 11.4 示例为 `7443:7443`。  
+   - 实际做法：`deploy/docker-compose.yml` 与文档示例一致使用 7443；混沌辅助与压测工具通过参数传入上游地址，不写死；本地冒烟可用其它宿主机端口映射。  
+   - 原因：部署示例需与 DEVELOPMENT 对齐；隔离约束针对并行测试而非产品默认端口。  
+   - 备选方案：compose 用变量 `${NIXMSG_HOST_PORT:-7443}`。  
+   - 影响：多 Agent 同时起官方 compose 会端口冲突，应改映射或错开项目名。
+
+6. **toxiproxy 镜像与 netem 旁路镜像选型**  
+   - 原条款：用 toxiproxy 官方镜像；Linux 丢包用 netem。  
+   - 实际做法：`ghcr.io/shopify/toxiproxy:2.12.0`；netem 说明用 `nicolaka/netshoot` 挂脚本（需 `NET_ADMIN`）。  
+   - 原因：官方镜像无 tc；本机 Windows 不能本机 netem。  
+   - 备选方案：自建含 iproute2 的旁路镜像。  
+   - 影响：首次拉取 netshoot 需网络；脚本不进业务镜像。
+
+7. **增加根目录 `.dockerignore`**  
+   - 原条款：未要求；Dockerfile 原为 `COPY web/` 在 `pnpm install` 之后。  
+   - 实际做法：忽略 `**/node_modules`、`web/dist`、`bin` 等，避免本机 Windows 的 `node_modules` 覆盖 Linux 安装结果导致 `vue-tsc` 找不到。  
+   - 原因：本机 `task check` 会生成 `web/node_modules`，直接进构建上下文会破坏前端阶段。  
+   - 备选方案：Dockerfile 在 `COPY web/` 后再跑一次 `pnpm install`。  
+   - 影响：镜像构建依赖 dockerignore；与任务目录无关的本地产物不再进上下文。
+
+8. **命名卷首次需 chown 给 nonroot**  
+   - 原条款：DEVELOPMENT 11.4「挂载的数据目录要可写」，uid 65532。  
+   - 实际做法：冒烟前对命名卷执行 `chown -R 65532:65532 /data`；compose 未内置 init 容器。  
+   - 原因：空命名卷属主为 root 时，distroless nonroot 无法建库（`unable to open database file`）。  
+   - 备选方案：compose 增加一次性 init 服务；或文档要求宿主机目录预授权。  
+   - 影响：按示例首次 `up` 前需处理权限，否则 serve 立即退出。