49 lines
2.1 KiB
Markdown
49 lines
2.1 KiB
Markdown
# 会话记录：描述和列出元数据
|
||
|
||
## 元数据
|
||
- 需求编号：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 的文件路径和结构。
|