Files
FT546-WCS/docs/runbooks/ft546-shadow-deployment-record-20260828.md

85 lines
2.8 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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` 导出目录 | 待补充 |
| 差异统计和算法结论 | 待补充 |
| 操作员 | 待补充 |
| 复核人 | 待补充 |
> 本记录不包含数据库密码、密钥或其他生产凭据。