# 迁移计划

## 范围与目标
- 将旧工程 `/old/servicemanager/src/main/java/com/servicemanager/project/` 下剩余接口完整迁移到 `urbanops-module-garden`，保持原「路径/行为」不变。
- 统一数据表前缀为 `garden_`，对齐新模块的分层规范（controller/admin|app、service、dal/mysql、dal/dataobject、vo）。

## 当前进度（已完成且编译通过）
- 树档案与古树：`/business/tree/*`、`/treerecord/oldtrees/*`
- 养护计划与提交：`/maintain/plan/*`、`/app/plan/commit/*`
- 物料库存/入出库：`/material/inventory/*`、`/material/in/*`、`/material/out/*`
- 热线案件/文件/照片：`/business/hotlinecase/*`（含聚合详情 `/getInfoMore/{id}`）、`/business/file/*`、`/business/sysphoto/*`
- PC 问题管理/任务：`/pc/problem/manager/*`、`/pc/problem/task/*`
- 部门桥接、基础字典、道路、养护频次、摄像机接口等

## 待迁移内容
- 绩效系列
  - `/performance/index/listForPage`
  - `/performance/write/listForPage`
  - `/performance/experts/listForPage`
- 项目与子项目
  - `/project/manager/listForPage`
  - `/project/manager/selectProjectManagerForList`
  - `/subProject/manager/listForPage`
- 物料管理剩余
  - `/material/manager/*`（分页、列表、导出）
  - `/materialType/*`（大类/中类/分页、导入导出）

## 技术方案
- 控制层
  - 保持旧路径与 HTTP 方法不变；后台接口放 `controller/admin/*`，App 接口放 `controller/app/*`。
  - 权限注解对齐（`@PreAuthorize`），沿用旧权限字符串或等价替换。
- 服务层
  - 迁移旧的业务服务方法，保持参数/校验/业务流程；使用新模块工具集（分页 `PageParam/PageResult`、统一响应 `CommonResult`）。
- 数据访问层
  - Mapper 改造为 `BaseMapperX + LambdaQueryWrapperX`，SQL 条件与排序对齐旧逻辑。
  - DataObject 使用 `@TableName("garden_*")` 对齐重命名后的表。
- VO/DTO
  - 保持旧的入参/出参结构；命名与包路径迁移至新模块相应 `vo` 目录。

## 数据表映射
- 旧表 `td_*/t_*` → 新表 `garden_*`（如 `td_project_manager` → `garden_project_manager`，`td_performance_index` → `garden_performance_index`，`td_material_type` → `garden_material_type` 等）。
- 统一使用新模块审计字段（creator/updater、createTime/updateTime）与部门/公司维度（`SecurityFrameworkUtils`）。

## 验证与交付
- 每批迁移完成后：
  - 运行 `mvn -q -DskipTests -U -pl urbanops-module-garden -am compile` 验证编译。
  - 提供可访问端点清单与关键入参示例。
  - 对导出接口进行本地验证（返回 XLS）。

## 风险与处理
- 依赖缓存损坏（如 kotlin 相关）：遇到后强制更新或清理缓存后重试编译。
- 权限字符串不一致：若旧权限在新模块中无对应，按域统一到 `garden:*:*` 规范并在说明中列出调整。

## 需要确认
- 绩效/项目/物料三组是否作为本次优先批次全部迁移？
- 若有其他域需优先（例如 App 端补充查询或导入），请指出以便先行安排。