Files
xiaoqu_mcp_service/xiaoqu-agent-service/sql
my_local_kimi_dev2 1a7a761a66 feat(mcp): 新增电池检查/故障汇总/现场维修记录三工具
- battery.inspection.list.query(m2 battery_inspection,老 /batteryInspection/pageList)
- repair.recording.list.query(m0 equipment_repair_recording,老 /equipmentRepair/recordingByPage)
- repair.handle.list.query(m0 equipment_repair_handle,老 repairRecordHandleList)
- 行权限复用 resolveRowScope 含直属下级口径(方案 B 拍板),battery 落 apply_agent_id,
  repair 三字段 OR(apply_agent_id/property_id 代管/agent_id)
- 修复点:富化与字典按页批量(修 N+1 与 accessory NPE)、chipCode 落 chip_code(修拼不存在列)、
  固定 id DESC 砍掉 sidx/sord 动态排序注入面、传 agentId 仍叠加行级 ACL
- REQ-20261106-0020,515 项测试全绿
2026-11-07 09:08:39 +08:00
..

数据库迁移规范

自有库结构由 Flyway 管理,运行时只扫描 src/main/resources/db/migration。

  1. 已合并的 V<N>__description.sql 永不修改、删除或改名;Flyway 与测试都会校验历史 checksum。
  2. 每次结构或数据变更新增下一个连续版本,并同步新增 sql/rollback/V<N>__description.down.sql。
  3. Migration 只操作当前 svc schema,禁止包含 CREATE DATABASE、USE 和环境专属数据。
  4. DDL 优先向后兼容;删除字段或表必须先经过废弃版本。大表变更必须给出锁表时间与分批方案。
  5. seed-dev.sql 仅用于开发数据,不进入 Flyway。数据库首次创建使用 bootstrap/create-database.sql。
  6. 合并前必须运行 ./mvnw clean package;部署启动时 Flyway 会再次 validate 并按版本迁移,失败则应用不会启动。

baseline-on-migrate 默认关闭,避免连错非空库时被静默接管。已有 V1 数据库首次接入时,显式设置 SVC_FLYWAY_BASELINE_ON_MIGRATE=true:Flyway 记录 V1 基线并只执行 V2 以后版本;确认生成 flyway_schema_history 后立即恢复为 false。空数据库无需开启,会正常执行全部版本。