datai/datai-scenes/datai-scene-salesforce/docs/sessions/2026-02-03-003-08-session.md

会话记录：描述和列出元数据

元数据

• 需求编号：003-08
• 需求名称：描述和列出元数据
• 创建时间：2026-02-03
• 状态：进行中
• 当前阶段：阶段 2：方案设计

阶段记录

阶段 1：需求定义 (2026-01-28)

• 状态：已完成
• 产物：需求文档
• 关键摘要：
  • 定义了 DescribeMetadata 和 ListMetadata 的核心功能。
  • 明确了入参（apiVersion, queries）和出参（DescribeMetadataResult, ListMetadataResult）。
  • 规定了使用 datai_metadata_describe 表记录查询历史。

阶段 2：方案设计 (2026-02-03)

• 状态：已完成
• 产物：设计文档
• 关键摘要：
  • 架构设计：采用 Controller-Service-Repository 分层架构。
  • 数据模型：设计了 datai_metadata_describe 审计表。
  • 接口设计：定义了 RESTful API /salesforce/metadata/describe 和 /salesforce/metadata/list。
  • 技术方案：集成 Salesforce Metadata API，使用 MyBatis Plus 进行数据持久化。

阶段 3：方案决策 (2026-02-03)

• 状态：已完成
• 产物：决策记录
• 关键决策：
  • API 交互：直接使用 WSC (metadata.jar)。
  • 批处理：Service 层自动分批处理 listMetadata 限制（>3 queries）。
  • 审计：同步写入 datai_metadata_describe 表。

阶段 4：数据库结构生成 (2026-02-03)

• 状态：已完成
• 产物：SQL 脚本
• 变更：创建 datai_metadata_describe 表。

阶段 5：提示词生成 (2026-02-03)

• 状态：已完成
• 产物：提示词文档
• 关键内容：
  • 引用真源：需求、设计、ADR、SQL。
  • 核心逻辑：定义了 Service 层自动分批处理 listMetadata 的要求。
  • 输出规范：明确了 Controller/Service/Mapper/Entity 的文件路径和结构。