历史问题与迁移任务
EasyPro 项目现状问题梳理与待执行迁移清单
历史问题
迁移任务
待执行
本页归档项目演进中的历史问题与处置记录，供追溯背景时查阅；日常开发以各规范文档为准。
1
现状问题梳理
1.1 现状问题（截至 2026-07-29 实际数据）
| # | 问题 | 实际表现 |
|---|---|---|
| ① | 分支堆积未清理 | 本地 + 远程共 90+ 个分支，大量 dev-fanhx-page、dev-jqynew2、dev-hzyf-bak 等已合并分支长期残留 |
| ② | 命名前缀不统一 | 版本分支 2.1.1（无前缀） vs 现场分支 v2.1.0-现场问题（带 v） vs 个人分支 dev-fanhx（下划线后跟人名）并存 |
| ③ | 定制污染主版本 | 客户定制分支 dev-huzhou、dev-hzyf 与版本分支同处一层，存在被误合并到新版本 2.1.1/2.2.0 的风险 |
| ④ | SQL 散落无登记 | data/sql/ 为空占位；真正的 SQL 散落在 doc/智问/、doc/驱动设计文档/，无版本号、无执行顺序、无现场登记 |
| ⑤ | 仓库卫生差 | doc/ 与 docs/ 两目录并存；根目录 hs_err_pid*.log、replay_pid*.log、spy.log、.DS_Store 被误提交 |
| ⑥ | 子产品分支裸名 | 节能（reduceEnergy）、轻量版（ems-lite）、碳排（carbon）等独立子产品分支无前缀，与版本分支 2.1.0/release/2.1.1 同处一层，归属与合并去向不可辨 |
1.2 规范目标
- 分支可追溯：任何分支能从命名直接判断类型、所属版本、合并去向。
- 定制可隔离：客户定制永不进入通用版本线，交付边界清晰。
- SQL 可回溯：每个版本对应的库结构变更可按序执行、可登记、可回查。
- 命名前后端一致：后端 Java 仓与前端工程共用同一套分支/提交/API 命名约定。
- 子产品可独立演进：独立子产品（EOS 等）基于主产品版本分叉后，长期独立演进、不污染主版本，且有清晰的产品线分支与回流规则。
2
分支命名迁移映射
以下为旧命名到新规范的迁移对照表，需逐步完成重命名或清理：
进展（截至 2026-08-24）：新式命名已在新分支中落地（release/2.1.1、feature/2.1.1/物联缓存一致性、hotfix/2.1.0/knx隧道假死优化 等）；旧命名分支（裸版本名、dev-人名、裸名产品分支）仍大量残留，迁移需负责人确认后另行执行。
| 旧命名（当前） | 新命名（规范） | 说明 |
|---|---|---|
2.1.1 | release/2.1.1 | 版本分支补 release/ 前缀 |
2.1.1-bacnet | feature/2.1.1/bacnet-ip | 补 feature/ 前缀，版本号保留 |
2.1.1-智问 | feature/2.1.1/zw 或 feature/2.1.1/智问 | 补前缀与版本段（语义中文/英文均可） |
v2.1.0-现场问题 | hotfix/2.1.0/<问题描述> | 现场分支改 hotfix/，去 v 前缀 |
v2.1.0-现场问题-knx临时修改 | hotfix/2.1.0/knx-fix | 同上，语义改英文/简明中文 |
dev-fanhx | dev/2.1.1/fanhx-xxx 或清理 | 个人分支换分隔符 + 补版本号；已合并的删除 |
dev-huzhou | custom/2.1.0/huzhou-xxx | 定制分支必须改 custom/ + 版本号（按其基线 tag 补） |
dev-hzyf | custom/2.1.0/hzyf-xxx | 同上 |
reduceEnergy | line/eos/<基线版本> | 子产品裸名分支改 line/ + 产品代号 + 版本号（按基线 tag 补，产品线分支规则见 01·产品线分支） |
ems-lite | line/lite/<基线版本> | 同上 |
carbon | line/carbon/<基线版本> | 同上 |
定制分支迁移时，版本号取其实际基线 tag（如湖州定制基于 v2.1.0，则为 custom/2.1.0/huzhou-xxx）；若无法确认基线，取最近合入的 release 版本。
子产品裸名分支迁移同理，基线 tag 用 git merge-base <分支> <主产品tag> 确认。
3
定制分支整改
当前定制分支命名均不符合规范，需负责人逐个确认基线并整改：
| 现分支 | 整改后 | 操作 |
|---|---|---|
dev-huzhou | custom/2.x.x/huzhou-<功能> | 确认基线 tag → 重命名 → 补文档 |
dev-hzyf | custom/2.x.x/hzyf-<功能> | 同上 |
dev-hzyf-bak | 清理或归并 | 多余备份分支删除 |
dev-hzyf-ndy-gateway | custom/2.x.x/hzyf-ndy-gateway | 确认基线 → 重命名 → 补文档 |
dev-hzyf-ndy-ztxm | custom/2.x.x/hzyf-ndy-ztxm | 同上 |
dev-hzyf-ztxm | custom/2.x.x/hzyf-ztxm | 同上 |
dev-reduceEnergy-huzhou | custom/2.x.x/huzhou-reduceEnergy | 同上 |
每整改一个分支，必须同步创建对应的 doc/定制/<客户>/<功能>.md，做到「无文档不分定制」。
4
SQL 脚本迁移清单
本节迁移已完成（2026-08-21 / 08-24 分批汇总），下表为归档记录。现存 data/sql/ 仅余空占位文件，可废弃；所有 SQL 唯一入口为 sql/（目录规则见 06·SQL 版本化）。
| 来源 | 目标 | 状态 |
|---|---|---|
data/sql/ibms-*.sql（多数为空占位） | sql/release/2.1.0/ibms-*.sql（9 个库全量建库） | 已迁移（2026-08-21） |
doc/智问/智问模型配置_初始化SQL.sql | sql/release/2.1.1/5_zhiwen.sql | 已汇总 |
doc/驱动设计文档/Modbus/modbus写功能码切换_属性升级SQL.sql | sql/release/2.1.1/3_modbus.sql | 已汇总 |
doc/驱动设计文档/BACnet/BACnet IP驱动_初始化SQL.sql | sql/release/2.1.1/4_bacnet.sql | 已汇总 |
doc/驱动设计文档/KNX/knx只写点优化_属性升级SQL.sql | sql/release/2.1.1/6_knx.sql | 已汇总 |
doc/驱动设计文档/RCP驱动/工程同步机制/RCP驱动_属性升级SQL.sql | sql/release/2.1.1/7_rcp.sql | 已汇总（2026-08-24，随 feature 回流归档） |
| 直提的 enable_edit 加列 / 月结算日配置脚本 | sql/release/2.1.1/0_common.sql | 已并入（2026-08-21 补汇，补幂等保护） |