aivfo-tl-3.0/项目文档/进度/进度状态.yaml

# 续接断点状态（机器可解析）。换会话/换电脑后首先读它定位。
# 状态取值: 未开始 / 进行中 / 完成 / 代码完成待验证
# 纪律：本字段只存【当前断点】，历史细节进 交接卡.md（见 CLAUDE.md 第三节）。
更新时间: 2026-06-20 G3-2 完成（tl-control/business Java 操作日志埋点）
当前任务: >
  【★G3-2 Java 埋点完成（tl-control + business 接入 M8 操作日志）★】
  · 两服务各装三件套:service+log-starter、manage+kafka-starter、lanucher+oplog-client;application-local 配 kafka(${server.ip}:9092, producer.enable=true)。
  · tl-control 15 Controller/90 方法、business 24 Controller/121 方法贴 @OperateLog(module=@Api tags、operation=@ApiOperation 中文值);两服务 Maven 编译 BUILD SUCCESS。
  · ★真入 operation_log 待起 Kafka+oplog 端到端抽查(运行期,非真机硬件门控)★。
  下一步:G3-1(operate 逐方法埋点,C# 大量 ViewModel)或 G3-3(配置下发 C4);或挑 G2/G4 纯代码任务。真机门控 G1-1/G4-3/G5 待用户在场。
  续接读:《工作计划表》+《当前开发计划》+ 本文件 + 交接卡末尾。
说明: >
  M0-M5 全部【可写源码】已完成，C#合并端 0 error + M2-02 单测 15/15。工具链就位(JDK11.0.25 + Maven3.9.9
  @ C:\TLData\tools)，Nexus 凭证(admin)已配 ~/.m2/settings.xml(401 解除)；framework install(93 个 aivfo
  模块入本地仓库 C:\TLData\tools\maven-repo) + 四微服务(tl-control/business/data-transmission/gateway)编译全绿。
  V-047(对焦下发链)/V-064(对焦上行链)Java 改动【已随四微服务编译通过】，运行/真机效果待验。
  运行期中间件【已就绪】：docker 7 容器(MySQL/Redis/Nacos/Kafka/FastDFS/MQTT-Mosquitto)，M8 端到端验证已用之；
  本机测试统一 localhost / 127.0.0.1。M1-M7 真机验证未做的真正阻塞 = 下位机/相机/operate GUI 等硬件 +
  现场网络决策(见紧前阻塞 SITE-NET)，已非中间件。
里程碑概览:
  - id: M0
    名称: 基线与脚手架
    状态: 完成
    备注: "M0-00/01/03完成;M0-02回归基线需运行系统(待环境)"
  - id: M1
    名称: 合并跑通(托管/单登录/HAL/程序集统一)
    状态: 代码完成待验证
    备注: "M1-00程序集统一编译0error;M1-01/02/03代码完成,真机验证V-017~V-029"
  - id: M2
    名称: 本地自动对焦
    状态: 代码完成待验证
    备注: "M2-02已单测15/15;余M2-01/03/04/05/06/07代码完成,真机验证V-041~V-067"
  - id: M3
    名称: 微服务改造
    状态: 代码完成待验证
    备注: "3微服务BUILD SUCCESS;真机验证V-030~V-040/V-068~V-075"
  - id: M4
    名称: UI改造(自适应/触控/圆形/键盘/零滚动)
    状态: 代码完成待验证
    备注: "编译0error;真机验证V-076~V-100"
  - id: M5
    名称: 配置/监控/通讯稳定
    状态: 代码完成待验证
    备注: "编译0error;真机验证V-101~V-120"
  - id: M6
    名称: 业务回归
    状态: 未开始
    备注: "需运行环境+真机(V-005等)"
  - id: M7
    名称: 集中测试与真机验收
    状态: 未开始
    备注: "按待验证清单风险从高到低逐条验(V-001~V-121)"
  - id: M8
    名称: 全量操作日志(插队,优先于 M6/M7——调试强依赖日志)
    状态: 代码完成待验证
    备注: "P1基础设施+P2 Java机制+P3a/P3b C#+Pjava真实接入 全完成且端到端自测;真机验证埋点效果(operate GUI)待用户"
关键遗留:
  - id: V-047
    描述: >
      对焦配置下发链【2026-06-18 已补全,走"服务器下发"方向】:
      C#本地SQLite缓存链原已通(TLSettingDB↔TLSetting focus 4+2列);
      本次补全服务器下发链(共10处)——Java实体TlSetting(+5)/HouseWellSetting(+2)、
      下发VO TlSettingVO/HouseWellSettingVO、mapper saveOrUpdate;C# tlSettingDTO(+5)/
      houseWellSettingDTO(+2)+ConvertHelper两个DTO重载。完整链路:中央MySQL→
      getBySn/getByTlSn(SELECT*)→VO(BeanUtils)→init JSON→C# DTO→ConvertHelper→
      TLSetting→TLSettingDB→PhotoLayerCalculator。
      C#编译0error通过;★Java 端已随 M8 四微服务编译通过(工具链已装),运行/真机效果待验★。
      上行链(机旁手调写库 HouseWellSettingUpdate)属V-064,本次未含。
    需真机验证: true
  - id: V-064
    描述: >
      对焦配置上行链【2026-06-18 已补全】:机旁调试页手调拍摄层保存→HTTP上行(/house/well/update)
      →写中央库 house_well_setting well级覆盖。Java 4文件:HouseWellSettingUpdate 入参+3字段
      (focusLayerSpacingPulse/focusLayerCount/moveDownLayer);manage.updateHouseWellSettings
      以moveDownLayer非空判手调请求;service.updateManualLayerTune 用LambdaUpdateWrapper.set
      写focus_layer_spacing_pulse/focus_layer_count/move_down_layer(null也写=留空继承设备级§2.5)。
      C#上行body本已就绪、字段对齐,无需改。Java 已随 M8 四微服务编译通过,运行/真机待验。
    需真机验证: true
  - id: 部署前置
    描述: >
      ①跑sql/*.sql建5库 → 再跑sql/migrations/2026-06-17-autofocus-data-layer.sql(对
      aivfo_tl_setting库,不可重复执行);②改IP:local profile server.ip + C# App.config
      改本机实际IP,统一MQTT broker地址(现场网络定后,见SITE-NET);③本地SQLite tl_setting/
      house_well_setting新列无自动迁移(V-046),旧db需重建或手工ALTER。
    需真机验证: true
下一步(待环境/真机): 中间件已就绪 → 确认建库/migration → 现场网络决策(SITE-NET)+接入下位机/相机/operate GUI → 按待验证清单逐条真机验证,每验一条回写待验证清单+本文件+交接卡+进度数据.js
紧前阻塞:
  - id: NEXUS-AUTH
    描述: >
      【2026-06-18 02:52 已解除】Nexus 私服凭证(admin/Aivfo2017)已填入 ~/.m2/settings.xml
      <server id=aivfo-nexus>;401 解除。本地构建顺序:先 mvn install aivfo-framework
      (底座,提供 aivfo-notify-spring-boot-starter 等 SNAPSHOT,Nexus public 未发布),
      再编译依赖它的微服务。aivof-tl-control 已 BUILD SUCCESS。
    阻塞: []
    需用户提供: false
  - id: SITE-NET
    描述: >
      【2026-06-18 部分推进】中间件已部署到服务器测试环境 192.168.0.108(见 开发环境/服务器测试环境.md)。
      已改:8 个激活 Java 服务(7 local + service pro)连接统一 server.ip=192.168.0.108、各连接用 ${server.ip}
      (MySQL/Nacos/Kafka/FastDFS/MQTT),app/surface 库密码 Aivfo.2017→root。
      仍待用户决策:①微服务集群跑在哪——用户已定【微服务本机、中间件服务器】(交接卡 23:40);
      MQTT broker 在服务器,mqttIp 指 192.168.0.108。②C# App.config 已改(operate/front mqttIp/kfkaIP→.108,
      urlIp 指本机 gateway),随 6b8dd8a 提交;★前提坑:DEBUG 块覆盖 + outInter=1 走外网→连内网须 Release 编译 + outInter=0。
      ③整集群冒烟已做(夜跑起 7 服务+业务闭环实测过);Nacos 配置中心 dataId 是否需导入待定。
    阻塞: [起微服务集群, V-002~V-121真机类]
    需用户提供: true