feat: 实现配置校验与运维命令及优雅停机

docs/DEVIATIONS.md

@@ -152,7 +152,35 @@
 
 ## 平台 P
 
-暂无。
+### P1 2026-09-30
+
+1. **admin set-password 传参方式**  
+   - 原条款：DEVELOPMENT 11.2 仅列命令名，未规定密码如何传入。  
+   - 实际做法：支持 `--password <pwd>`、位置参数，或从 stdin 读一行；最短 12 位。  
+   - 原因：自动化测试与 Docker 非交互环境需要非交互传参。  
+   - 备选方案：仅交互式 prompt。  
+   - 影响：运维文档需写明推荐用 `--password` 或管道，勿把密码写进 shell 历史时可改用 stdin。
+
+2. **admin init 密码字符集**  
+   - 原条款：生成 20 位密码，未规定字符集。  
+   - 实际做法：从去掉易混字符（0/O/1/I/l）的字母数字中均匀抽样 20 位。  
+   - 原因：终端抄写友好。  
+   - 备选方案：全 ASCII 可打印字符。  
+   - 影响：熵略低于全字符集，对 20 位仍足够。
+
+3. **PHC 哈希辅助先放在 auth，池在 P3**  
+   - 原条款：argon2 并发池属 P3；admin init 需落库哈希属 P1。  
+   - 实际做法：P1 在 `internal/auth` 提供 `HashPassword`/`VerifyPassword`（PHC），admin 命令直接调用；P3 再用同参数实现带并发上限的 `HashPool`。  
+   - 原因：避免 P1 在 cmd 内复制算法，又不等到 P3 才做 init。  
+   - 备选方案：P1 cmd 内联 argon2；或 P1/P3 合并提交。  
+   - 影响：P3 合入后 admin 可改为走 HashPool（非必须，单次 init 无并发压力）。
+
+4. **优雅停机顺序**  
+   - 原条款：停接受 → 写队列最多 10 秒 → 断开连接退出。  
+   - 实际做法：`http.Server.Shutdown`（先停接受并等待进行中的 HTTP）后，再 `Queue.Drain` 最多 10 秒；本期尚无长连接表，断开连接由 Shutdown 覆盖。  
+   - 原因：当前 main 仅有 HTTP 健康检查；N 线接入后应在 Drain 前后显式踢连接。  
+   - 备选方案：先关 listener、Drain、再 Shutdown。  
+   - 影响：有 MQTT 长连接后需 N/P 联调停机路径。
 
 ## 连接 N