# 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 是独立中央管理端，本轮**不重做界面**，但合并+对焦本地化经数据/业务波及它：
1. **选层来源变 → 临床数据可信链**：它显示/分析的清晰层口径要与本地新算法一致，否则"机旁按新、管理端按旧"。
2. **业务闭环别断在它这环**：放皿→对焦→拍照→上传→**front 看图分析**→冷冻移植决策。
3. **状态语义一致**：新对焦的失败/中间态，front 不能显示成"正常"。
4. **对焦预览（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` |
| 下位机 | 不影响 |