feat(d2-02-t3): 加自动对焦per-well范围列(迁移+base同步:house_well_setting 2半幅/tl_setting 4范围曝光)

sql/aivfo_tl_setting.sql

@@ -495,6 +495,8 @@ CREATE TABLE `house_well_setting` (
   `eeprom_clear_position` int NOT NULL COMMENT 'E方清晰位置',
   `focus_layer_spacing_pulse` int DEFAULT NULL COMMENT 'well级层间距覆盖(空=继承设备级) — 自动对焦数据层(migrations/2026-06-17 已并入)',
   `focus_layer_count` int DEFAULT NULL COMMENT 'well级层数覆盖(空=继承设备级)',
+  `horizontal_focus_range` int DEFAULT NULL COMMENT 'well级水平搜索半幅(围绕horizontal_motor_position;空=继承tl_setting.focus_h_range_default)',
+  `vertical_focus_range` int DEFAULT NULL COMMENT 'well级垂直搜索半幅(围绕eeprom_clear_position;空=继承tl_setting.focus_v_range_default)',
   `create_by` varchar(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci NOT NULL COMMENT '创建人',
   `create_time` datetime NOT NULL COMMENT '创建时间',
   `update_by` varchar(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci NOT NULL COMMENT '修改人',
@@ -700,6 +702,10 @@ CREATE TABLE `tl_setting` (
   `focus_layer_down` int NOT NULL DEFAULT '2' COMMENT '对焦起点下移层数(清晰层在第几层之上)',
   `focus_peak_ratio_threshold` decimal(10,3) NOT NULL DEFAULT '1.200' COMMENT '标定合格峰比阈值(不同客户可松紧)',
   `local_autofocus_enabled` int NOT NULL DEFAULT '0' COMMENT '场景B本地自动对焦安全门:0关闭(降级按基准/既有位置拍照,默认安全) 1启用;三上线前置有结论后再开',
+  `focus_h_range_default` int DEFAULT NULL COMMENT '水平半幅设备级默认(well级留空时用)',
+  `focus_v_range_default` int DEFAULT NULL COMMENT '垂直半幅设备级默认',
+  `focus_exposure_min` int NOT NULL DEFAULT '10' COMMENT '对焦曝光二分下限(沿用引擎现值)',
+  `focus_exposure_max` int NOT NULL DEFAULT '800' COMMENT '对焦曝光二分上限(沿用引擎现值)',
   PRIMARY KEY (`id`) USING BTREE,
   UNIQUE KEY `one` (`tl_sn`,`deleted`) USING BTREE COMMENT '唯一索引'
 ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci ROW_FORMAT=DYNAMIC COMMENT='tl设备设置表';

sql/migrations/2026-06-25-autofocus-range.sql

@@ -0,0 +1,18 @@
+-- =============================================================================
+-- 自动对焦 per-well 运动范围迁移（依据 需求文档 2026-06-25 §七）
+-- 库：aivfo_tl_setting（MySQL 8，InnoDB/utf8mb4）
+-- 范围 = 中心 ± 半幅：中心复用现有 horizontal_motor_position / eeprom_clear_position，
+--        本次仅加"半幅"列 + 设备级默认/曝光范围。
+-- ⚠ MySQL 8 ADD COLUMN 不支持 IF NOT EXISTS：旧库重跑前先 DESC 判断列是否已存在。
+-- 全新部署不需要本文件（base 脚本 sql/aivfo_tl_setting.sql 已含，见 Task 1.2）。
+-- =============================================================================
+
+ALTER TABLE `house_well_setting`
+  ADD COLUMN `horizontal_focus_range` int NULL DEFAULT NULL COMMENT 'well级水平搜索半幅(围绕horizontal_motor_position;空=继承tl_setting.focus_h_range_default)',
+  ADD COLUMN `vertical_focus_range` int NULL DEFAULT NULL COMMENT 'well级垂直搜索半幅(围绕eeprom_clear_position;空=继承tl_setting.focus_v_range_default)';
+
+ALTER TABLE `tl_setting`
+  ADD COLUMN `focus_h_range_default` int NULL DEFAULT NULL COMMENT '水平半幅设备级默认(well级留空时用)',
+  ADD COLUMN `focus_v_range_default` int NULL DEFAULT NULL COMMENT '垂直半幅设备级默认',
+  ADD COLUMN `focus_exposure_min` int NOT NULL DEFAULT 10 COMMENT '对焦曝光二分下限(沿用引擎现值)',
+  ADD COLUMN `focus_exposure_max` int NOT NULL DEFAULT 800 COMMENT '对焦曝光二分上限(沿用引擎现值)';