kris/datai

- 新增 SyncProgress 实体类、ISyncProgressService 接口和 SyncProgressServiceImpl 实现类
- 在 DataiIntegrationObjectController 中添加 6 个进度查询接口：
  - 查询指定对象的同步进度
  - 查询所有正在同步的对象进度
  - 查询指定对象的插入进度
  - 查询所有正在插入的对象进度
  - 查询指定对象的更新进度
  - 查询所有正在更新的对象进度
- 在 DataiIntegrationObjectServiceImpl 中集成进度跟踪功能：
  - syncFullData 方法集成同步进度跟踪
  - syncIncrementalData 方法集成同步进度跟踪
  - insertObjectDataToTarget 方法集成插入进度跟踪
  - updateObjectDataToTarget 方法集成更新进度跟踪
- 进度信息存储在内存中（ConcurrentHashMap），任务完成后立即清除
- 新增 3 个需求文档（REQ-002、REQ-003、REQ-004）
- 新增 3 个架构决策记录（0002、0003、0004）
- 新增 3 个提示词文件（002、003、004）
- 新增 3 个会话记录
- 新增 3 个变更记录（0012、0013、0014）
- 新增 3 个复盘报告
- 新增 6 个 API 文档
- 更新 CHANGELOG.md 和 docs/index.md

2026-01-16 13:02:09 +08:00

5.8 KiB

Raw Blame History

insertObjectDataToTarget 插入数据进度跟踪实现提示词

输入引用

引用相关的 docs 文档链接：

REQ-003.md - insertObjectDataToTarget 插入数据进度跟踪需求文档
0003-insert-progress-tracking.md - insertObjectDataToTarget 插入数据进度跟踪架构决策
DataiIntegrationObjectController - 对象同步控制接口
DataiIntegrationObjectServiceImpl - 对象同步服务实现
SyncProgress - 进度信息实体类（复用）
ISyncProgressService - 进度跟踪服务接口（复用）
SyncProgressServiceImpl - 进度跟踪服务实现类（复用）

Context Maps

强制列出本次 Prompt 依赖的 Canvas 文件：

Authentication.canvas - 项目架构视觉化展示
相关节点: DataiIntegrationObjectController - 对象同步控制接口
相关节点: DataiIntegrationObjectServiceImpl - 对象同步服务实现

目标

实现 insertObjectDataToTarget 插入数据进度跟踪功能，包括：

在 Controller 中添加插入进度查询接口
在 Service 中集成进度跟踪功能
插入任务完成后立即清除该插入进度信息，不保留历史记录

输出格式

输出以下 Java 代码文件：

DataiIntegrationObjectController.java - 添加插入进度查询接口
- 在现有 Controller 中添加以下接口：
  - GET /integration/object/insertProgress/{objectId} - 查询指定对象的插入进度
  - GET /integration/object/insertProgress - 查询所有正在插入的对象进度
- 使用 @RestController 和 @RequestMapping 注解
- 返回统一响应格式（AjaxResult）
- 添加日志记录
DataiIntegrationObjectServiceImpl.java - 集成进度跟踪
- 注入 ISyncProgressService（如果尚未注入）
- 在 insertObjectDataToTarget 方法开始时调用 startProgressTracking（syncType 参数设置为 "INSERT"）
- 在插入过程中调用 updateProgress 更新进度（遍历批次时，每处理完一个批次调用一次）
- 在插入完成时调用 completeProgress（该方法会立即清除进度信息）
- 在插入失败时调用 failProgress（该方法会立即清除进度信息）

约束

列出使用此提示词时的约束条件，例如：

技术栈限制：
- 使用 Spring Boot 框架
- 使用 Lombok 简化代码
- 使用 SLF4J 进行日志记录
- 复用现有的 ConcurrentHashMap 存储进度信息
性能要求：
- 插入进度查询接口响应时间 < 100ms
- 进度更新操作对插入性能影响 < 5%
- 支持 10 个对象同时插入并跟踪进度
安全性要求：
- 插入进度查询接口需要登录认证
- 避免内存泄漏，确保过期数据被正确清理
兼容性要求：
- 不影响现有的插入逻辑
- 与现有的 ADR-0001（Salesforce CDC 同步方案）不冲突
- 与现有的 ADR-0002（syncObjectData 同步进度跟踪）保持一致
- 保持代码风格一致性

Rule Set

"请严格参考 @Authentication.canvas 中的状态机转移逻辑，不要自行发挥。"

具体规则：

必须使用 Canvas 中定义的类名和方法名
必须遵循 Canvas 中定义的调用关系
必须参考 Canvas 中的流程图逻辑
必须遵循项目现有的代码风格和命名规范
必须使用项目现有的工具类和依赖（如 AjaxResult、SecurityUtils 等）
必须复用现有的 SyncProgress 实体类、ISyncProgressService 接口和 SyncProgressServiceImpl 实现类
必须参考 syncObjectData 同步进度跟踪的实现方式，保持一致性

验收标准

定义验证输出质量的具体标准，例如：

功能完整性：
- 所有接口方法正确实现
- 进度信息能够正确初始化、更新、完成和失败
- 插入进度查询接口能够返回准确的进度信息
代码正确性：
- 代码编译通过，无语法错误
- 遵循 Java 编码规范
- 使用正确的注解和依赖注入
性能指标：
- 插入进度查询接口响应时间 < 100ms
- 进度更新操作轻量级，对插入性能影响 < 5%
文档准确性：
- 代码注释清晰，说明关键逻辑
- 方法命名准确，符合业务含义

风险

识别使用此提示词可能带来的风险，例如：

输出质量风险：
- 生成的代码可能存在 bug
- 代码风格可能与现有代码不一致
技术实现风险：
- 修改现有的 insertObjectDataToTarget 方法可能引入 bug
- 进度跟踪逻辑与插入逻辑耦合，可能影响代码可维护性
时间成本风险：
- 实现和测试工作量可能超出预期

使用记录

日期	使用场景	输入参数	输出结果	反馈	改进措施
2026-01-16	实现 insertObjectDataToTarget 插入数据进度跟踪功能	REQ-003、ADR-0003	生成 2 个 Java 文件更新	待验证	待定

5.8 KiB Raw Blame History Unescape Escape