08-影响范围矩阵.md 4.5 KB
08 · 影响范围矩阵（全子系统）
父文档：
../00-需求总览.md· 风险 R1-R10 目的：一处改动波及哪些子系统/页面/接口/表/下位机，一表看清，避免漏改。
1. 按"改造动作 → 影响"矩阵
| 改造动作 | operate | control | autofocus | data-transmission | tl-control | business | ai-middleware | front-mgmt | 下位机/DB |
|---|---|---|---|---|---|---|---|---|---|
| 合并单进程托管 | ★主体 | ★并入/去UI | — | — | — | — | — | — | — |
| 统一硬件访问层 | 调试页改借用 | 采集改借用 | 对焦借用 | — | — | — | — | — | 串口/相机独占 |
| 本地自动对焦 | 调试页/对焦UI | 拍照流程接入 | ★算法源 | ★删打分 | ★calPhotoPosition | — | 回归确认 | 对焦预览(D10) | EEPROM回写? |
| 删选层打分链 | — | 对焦位置来源改 | — | ★删focusPointUpdate/pictureScore/Feign | ★对焦事件链 | ★★改2处选层判据(消NPE) | 不依赖(回归) | 对焦预览经business-manage(D10) | t_picture.image_score停写 |
| 保留抠图链 | 看图 | 上传 | — | ★保留cutCCD/视频 | — | — | 按CCD clearest选图 | 展示 | video*表 |
| 不可退出 | ★拦截/自愈 | 后台稳定 | — | — | — | — | — | — | — |
| UI自适应/触控/圆形/键盘 | ★全页改造 | — | — | — | — | — | — | 不改界面 | — |
| 服务监控页 | ★新增只读页 | 暴露状态 | — | — | — | — | — | — | — |
| 实时通讯稳定 | ★就近取数/链路健康 | 恢复心跳/上报 | — | — | MQTT编排 | — | — | 口径一致 | — |
| 配置统一管理 | ★新增配置页 | 配置读取改 | calibration.json | — | TLSetting | — | — | — | EEPROM/数据库 |
| 既有业务功能改造 | ★全业务页 | — | — | — | — | 业务接口 | — | 回归 | — |
★ = 主要改动；— = 不涉及或仅间接。
2. front-management 专项（不重做界面，保业务严谨性）
front-management 是独立中央管理端，本轮不重做界面，但合并+对焦本地化经数据/业务波及它：
- 选层来源变 → 临床数据可信链：它显示/分析的清晰层口径要与本地新算法一致，否则"机旁按新、管理端按旧"。
- 业务闭环别断在它这环：放皿→对焦→拍照→上传→front 看图分析→冷冻移植决策。
- 状态语义一致：新对焦的失败/中间态，front 不能显示成"正常"。
- 对焦预览（D10）：
AutoFocusWindow依赖 imageScore/highestScore，经 business-manage/getAutofocusPictures取数（不是直连 data-transmission）。打分删除后 business-manage 两处会 NPE 崩溃（见 04 §6.2），必须改判据；front-management 端字段读取需同步确认。
2b. ⚠️ 最易漏的崩溃点：business-manage
删 data-transmission 的打分后，t_picture.image_score 停写变 null。business-manage 有两处直接拿它比较/取最大值：
ResourceServiceImpl.getAutofocusPictures:476（max(imageScore)）PictureDAOServiceImpl.getFocusBestPicture:179（compareTo(imageScore)）
不改 → 一打开患者详情/对焦预览就 NPE 崩溃，是"改一半导致系统不能用"的典型。详见 04 §6.2。
3. 下位机/数据库影响
- 下位机：串口协议统一、EEPROM 回写（D9，写地址真机验证）、电机/拍照位置来源改本地。
- 数据库：
t_picture.image_score（AUTOFOCUS 停写）、t_house_photograph_setting（写入源改）；video*/业务表不受影响。
4. 用法
改任一项前，查本表对应行 → 列出所有 ★ 和需回归项 → 纳入该项的验收清单（09）。
5. 全量操作日志改造影响范围（见 14）
| 子系统 | 影响 |
|---|---|
ivf_tl_operate_2.0（C#） |
★ 全埋操作日志（命令/串口/相机/对焦/HTTP/DB）；引用 Aivfo.OperationLog 组件 |
aivfo-front-manament-2.0（C#） |
★ 全埋；引用同一组件 |
ivf_tl_control_2.0 / autofocustool（C#） |
不埋（将并入 operate、以后删） |
| 各 Java 微服务 | 关键方法加 @OperateLog；网关透传 traceId |
新增 aivfo-oplog 微服务 |
消费 Kafka 入 operation_log、保留期清理 |
log 库 |
新增 operation_log 表（与 system_log 并列） |
| Kafka | 新增 topic tl-oplog |
| 下位机 | 不影响 |