aivfo-tl-3.0/sql/migrations/2026-06-25-autofocus-range.sql

-- =============================================================================
-- 自动对焦 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 '对焦曝光二分上限(沿用引擎现值)';