# 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` 导出目录 | 待补充 |
| 差异统计和算法结论 | 待补充 |
| 操作员 | 待补充 |
| 复核人 | 待补充 |

> 本记录不包含数据库密码、密钥或其他生产凭据。