docs(shadow): record v1 deployment on 2026-08-28

docs/runbooks/ft546-shadow-deployment-record-20260828.md

@@ -0,0 +1,84 @@
+# FT546 影子版本 v1 现场部署记录
+
+## 1. 部署信息
+
+| 项目 | 记录 |
+| --- | --- |
+| 部署日期 | 2026-08-28 |
+| 版本 | 影子版本 v1 |
+| 源码分支 | `optimize/wcs` |
+| 源码提交 | `f82fabd9794997f921dd8994f5b66fc033e8299a` |
+| 现场源码目录 | `C:\project\FT546-WCS-SHANDOW` |
+| 启动类 | `com.ruoyi.shadow.Ft546ShadowApplication` |
+| Active profile | `shadow` |
+| 状态地址 | `127.0.0.1:18091` |
+| 影子进程 PID | `9460` |
+| source 数据库 | `FT546-wcs` |
+| evidence 数据库 | `FT546-shadow` |
+| evidence 目录 | `C:\project\FT546-WCS-SHANDOW\shadow-evidence` |
+
+## 2. 初始启动核验
+
+状态接口返回时间：`2026-08-28T02:49:27.839Z`（北京时间 `2026-08-28 10:49:27.839`）。
+
+| 检查项 | 结果 |
+| --- | --- |
+| 影子状态 | `READY` |
+| 最近完成周期 | `2026-08-28T02:49:27.839Z` |
+| source lag | `0 ms` |
+| evidence backlog | `0` |
+| reason code | `null` |
+| 启动检查 | 全部 `PASS` |
+| 端口监听 | `127.0.0.1:18091`，PID `9460` |
+
+启动检查明细：
+
+```text
+SHADOW_ENABLED=PASS
+SHADOW_PROFILE_ACTIVE=PASS
+SOURCE_JDBC_CONFIGURED=PASS
+EVIDENCE_JDBC_CONFIGURED=PASS
+DATABASE_USERNAMES_CONFIGURED=PASS
+STATUS_ADDRESS_LOOPBACK=PASS
+SIDE_EFFECT_BEANS_ABSENT=PASS
+FORBIDDEN_BEAN_PACKAGES_ABSENT=PASS
+DATABASE_IDENTITIES_DISTINCT=PASS
+DATABASE_LOGINS_DISTINCT=PASS
+CROSS_DATABASE_ACCESS_BLOCKED=PASS
+SOURCE_PERMISSIONS_VERIFIED=PASS
+EVIDENCE_DATABASE_VERIFIED=PASS
+```
+
+## 3. 本次修复说明
+
+生产地图表中存在空白 `site_id` 记录。影子读取 SQL 已增加只读过滤，仅将有效 `site_id` 的地图点交给影子算法；没有删除、更新或修改正式数据库数据。
+
+本次修复提交前已执行：
+
+```text
+mvn -pl ruoyi-wcs-shadow -am test -DskipTests=false
+```
+
+结果：5 个模块构建成功，影子模块 114 个测试全部通过，失败数为 0。
+
+## 4. 部署边界和后续观察
+
+- 本记录表示影子测试 v1 已启动，不表示正式调度算法上线。
+- 正式 WCS 仍保持原有调度、PLC 写入和 WMS 回调职责。
+- 影子程序只读取批准的 `shadow_ro` 视图，并将证据写入独立 evidence 数据库和目录。
+- 本记录创建时已完成初始 `READY` 核验；15 分钟观察窗口及后续测试结果需要另行补充。
+- 影子状态出现 `DEGRADED`、新的 source 读取错误、evidence 写入失败或正式 WCS 指标异常时，立即停止影子进程并保留日志和证据。
+
+## 5. 测试结果回填
+
+| 项目 | 记录 |
+| --- | --- |
+| 15 分钟观察结论 | 待补充 |
+| 影子停止时间 | 待补充 |
+| 影子停止原因 | 待补充 |
+| `shadow_run` / `shadow_cycle` 导出目录 | 待补充 |
+| 差异统计和算法结论 | 待补充 |
+| 操作员 | 待补充 |
+| 复核人 | 待补充 |
+
+> 本记录不包含数据库密码、密钥或其他生产凭据。