datai/datai-scenes/datai-scene-salesforce/docs/prompts/009-metadata-retrieve-deploy.md
Kris 469c78cf29 feat: REQ-010-1 完成数据库表结构设计和创建,REQ-010-2 完成基础实体类和Mapper创建需求定义和架构决策
REQ-010-1 完成内容:
- 创建 6 个数据库表设计(datai_meta_org_config、datai_meta_task、datai_meta_job_execution、datai_meta_component、datai_meta_deploy_history、datai_meta_job_log)
- 设计了合理的索引策略
- 对敏感字段进行了加密存储设计
- 表名前缀统一为 datai_meta_
- 所有表包含标准基础字段

REQ-010-2 完成内容:
- 补充用户故事和细化验收标准
- 创建架构决策记录(MyBatis Plus 注解 + XML 映射文件混合方案)
- 对比了 3 种备选方案
- 分析了决策对系统架构、开发流程、运维管理的影响
- 识别了技术风险、业务风险和实施风险
- 定义了回滚策略和验收标准

文档更新:
- 创建 0010-database-table-design.md 架构决策记录
- 创建 0011-entity-mapper-create.md 架构决策记录
- 创建 0020-database-table-design-create.md 变更记录
- 创建 20260117-database-table-design-create.md 会话记录
- 创建 20260117-database-table-design-create-retro.md 复盘报告
- 创建 011-database-table-design-create.md 提示词文档
- 更新 REQ-010-2.md 需求文档
- 更新 docs/index.md 和 CHANGELOG.md
2026-01-18 19:44:13 +08:00

2.6 KiB
Raw Blame History

Prompt First 模板

输入引用

引用相关的 docs 文档链接:

Context Maps

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

目标

明确描述此提示词的目标和预期效果:

  1. 实现 Salesforce 元数据拉取功能,支持根据 package.xml 拉取指定元数据
  2. 实现 Salesforce 元数据部署功能,支持全量/增量部署、验证、单元测试和破坏性变更
  3. 实现异步处理机制,不阻塞请求线程
  4. 实现详细的部署结果解析和错误信息记录
  5. 支持使用验证 ID 进行快速部署

输出格式

指定期望的输出格式:

  • 代码示例语言Java
  • 文档结构Markdown

约束

列出使用此提示词时的约束条件:

  • 技术栈限制Java 17/21, Spring Boot 3.x, Salesforce Metadata API, OAuth 2.0
  • 必须遵循分层架构Controller 层 -> Service 层 -> Salesforce API 层
  • 必须实现异步处理机制
  • 必须实现详细的错误处理和日志记录
  • 必须支持 Salesforce API 调用限制处理

Rule Set

"请严格参考元数据拉取和部署的架构决策文档,不要自行发挥。"

具体规则

  • 必须使用架构决策中定义的数据库表结构
  • 必须遵循架构决策中定义的异步处理模式
  • 必须实现架构决策中定义的核心功能
  • 必须遵循项目的代码风格和命名规范

验收标准

定义验证输出质量的具体标准:

  1. 功能完整性:实现所有需求文档中定义的功能
  2. 代码正确性:代码能够正常编译和运行,无语法错误
  3. 性能指标:异步处理不阻塞请求线程,支持并发处理
  4. 安全性要求:所有 Salesforce 认证信息必须加密存储
  5. 可靠性要求:系统能够处理 API 调用失败和重试

风险

识别使用此提示词可能带来的风险:

  • 输出质量风险:代码可能存在逻辑错误或性能问题
  • 技术实现风险Salesforce API 调用可能遇到限制或兼容性问题
  • 时间成本风险:实现复杂功能可能需要较长时间
  • 测试风险:需要大量测试用例验证功能正确性

使用记录

日期 使用场景 输入参数 输出结果 反馈 改进措施
2026-01-17 元数据拉取和部署功能实现 需求文档、架构决策 Java 代码和相关文档 待反馈 待改进