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

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

## 阶段记录

### 阶段 1：需求定义 (2026-01-28)
- 状态：已完成
- 产物：[需求文档](../requirements/sub/2026-01-28-003-08-描述和列出元数据.md)
- 关键摘要：
  - 定义了 DescribeMetadata 和 ListMetadata 的核心功能。
  - 明确了入参（apiVersion, queries）和出参（DescribeMetadataResult, ListMetadataResult）。
  - 规定了使用 `datai_metadata_describe` 表记录查询历史。

### 阶段 2：方案设计 (2026-02-03)
- 状态：已完成
- 产物：[设计文档](../design/2026-02-03-003-08-描述和列出元数据-设计.md)
- 关键摘要：
  - 架构设计：采用 Controller-Service-Repository 分层架构。
  - 数据模型：设计了 `datai_metadata_describe` 审计表。
  - 接口设计：定义了 RESTful API `/salesforce/metadata/describe` 和 `/salesforce/metadata/list`。
  - 技术方案：集成 Salesforce Metadata API，使用 MyBatis Plus 进行数据持久化。

### 阶段 3：方案决策 (2026-02-03)
- 状态：已完成
- 产物：[决策记录](../decisions/2026-02-03-003-08-ADR-描述和列出元数据技术选型.md)
- 关键决策：
    - API 交互：直接使用 WSC (`metadata.jar`)。
    - 批处理：Service 层自动分批处理 `listMetadata` 限制（>3 queries）。
    - 审计：同步写入 `datai_metadata_describe` 表。

### 阶段 4：数据库结构生成 (2026-02-03)
- 状态：已完成
- 产物：[SQL 脚本](../sql/2026-02-03-003-08-describe-metadata.sql)
- 变更：创建 `datai_metadata_describe` 表。

### 阶段 5：提示词生成 (2026-02-03)
- 状态：已完成
- 产物：[提示词文档](../prompts/2026-02-03-003-08-prompt-描述和列出元数据.md)
- 关键内容：
  - 引用真源：需求、设计、ADR、SQL。
  - 核心逻辑：定义了 Service 层自动分批处理 `listMetadata` 的要求。
  - 输出规范：明确了 Controller/Service/Mapper/Entity 的文件路径和结构。