datai/datai-scenes/datai-scene-salesforce/docs/requirements/sub/index.md

# 子需求索引

## 概述
本文档索引了所有 API 实现的子需求文档，按照开发优先级排序。

---

## PartnerAPI 源 org 实现（需求编号：001）

### 1. 认证和会话管理（001-01）
- **文件**: [2026-01-28-001-01-认证和会话管理.md](./2026-01-28-001-01-认证和会话管理.md)
- **优先级**: 高
- **状态**: 待开始
- **核心功能**: Login、Logout、ChangeOwnPassword、SessionHeader
- **依赖项**: datai-salesforce-auth 模块的 SessionManager、datai-salesforce-common 模块的异常类

### 2. CRUD 操作（001-02）
- **文件**: [2026-01-28-001-02-CRUD操作.md](./2026-01-28-001-02-CRUD操作.md)
- **优先级**: 高
- **状态**: 待开始
- **核心功能**: Create、Retrieve、Update、Delete、Upsert、Merge
- **依赖项**: 子需求 001-01、datai-salesforce-auth 模块的 SessionManager、datai-salesforce-common 模块的异常类

### 3. 批量操作（001-03）
- **文件**: [2026-01-28-001-03-批量操作.md](./2026-01-28-001-03-批量操作.md)
- **优先级**: 高
- **状态**: 待开始
- **核心功能**: Create 批量、Update 批量、Delete 批量、Upsert 批量
- **依赖项**: 子需求 001-01、子需求 001-02、datai-salesforce-auth 模块的 SessionManager、datai-salesforce-common 模块的异常类

### 4. 查询功能（001-04）
- **文件**: [2026-01-28-001-04-查询功能.md](./2026-01-28-001-04-查询功能.md)
- **优先级**: 高
- **状态**: 待开始
- **核心功能**: Query、QueryAll、QueryMore、Search
- **依赖项**: 子需求 001-01、datai-salesforce-auth 模块的 SessionManager、datai-salesforce-common 模块的异常类

### 5. 描述功能（001-05）
- **文件**: [2026-01-28-001-05-描述功能.md](./2026-01-28-001-05-描述功能.md)
- **优先级**: 中
- **状态**: 待开始
- **核心功能**: DescribeGlobal、DescribeSObject、DescribeSObjects、DescribeLayout、DescribeTabs、DescribeQuickActions
- **依赖项**: 子需求 001-01、datai-salesforce-auth 模块的 SessionManager、datai-salesforce-common 模块的异常类

### 6. 高级功能（001-06）
- **文件**: [2026-01-28-001-06-高级功能.md](./2026-01-28-001-06-高级功能.md)
- **优先级**: 中
- **状态**: 待开始
- **核心功能**: ConvertLead、EmptyRecycleBin、ProcessSubmitRequest、GetUserInfo、GetServerTimestamp
- **依赖项**: 子需求 001-01、子需求 001-02、datai-salesforce-auth 模块的 SessionManager、datai-salesforce-common 模块的异常类

---

## ApexAPI 源 org 实现（需求编号：002）

### 1. 连接管理（002-01）
- **文件**: [2026-01-28-002-01-连接管理.md](./2026-01-28-002-01-连接管理.md)
- **优先级**: 高
- **状态**: 待开始
- **核心功能**: Connector、SoapConnection、SessionHeader、CallOptions、DebuggingHeader
- **依赖项**: datai-salesforce-auth 模块的 SessionManager、datai-salesforce-common 模块的异常类

### 2. Apex 代码编译和执行（002-02）
- **文件**: [2026-01-28-002-02-Apex代码编译和执行.md](./2026-01-28-002-02-Apex代码编译和执行.md)
- **优先级**: 高
- **状态**: 待开始
- **核心功能**: CompileClasses、CompileTriggers、CompileAndTest、ExecuteAnonymous、CompileClassResult、CompileTriggerResult、CompileIssue
- **依赖项**: 子需求 002-01、datai-salesforce-auth 模块的 SessionManager、datai-salesforce-common 模块的异常类

### 3. 测试执行（002-03）
- **文件**: [2026-01-28-002-03-测试执行.md](./2026-01-28-002-03-测试执行.md)
- **优先级**: 高
- **状态**: 待开始
- **核心功能**: RunTests、RunTestsRequest、RunTestsResult、RunTestSuccess、RunTestFailure
- **依赖项**: 子需求 002-01、datai-salesforce-auth 模块的 SessionManager、datai-salesforce-common 模块的异常类

### 4. 代码覆盖率（002-04）
- **文件**: [2026-01-28-002-04-代码覆盖率.md](./2026-01-28-002-04-代码覆盖率.md)
- **优先级**: 中
- **状态**: 待开始
- **核心功能**: CodeCoverageResult、CodeCoverageWarning、CodeLocation
- **依赖项**: 子需求 002-01、子需求 002-03、datai-salesforce-auth 模块的 SessionManager、datai-salesforce-common 模块的异常类

### 5. Flow 覆盖率（002-05）
- **文件**: [2026-01-28-002-05-Flow覆盖率.md](./2026-01-28-002-05-Flow覆盖率.md)
- **优先级**: 中
- **状态**: 待开始
- **核心功能**: FlowCoverageResult、FlowCoverageWarning
- **依赖项**: 子需求 002-01、子需求 002-03、datai-salesforce-auth 模块的 SessionManager、datai-salesforce-common 模块的异常类

### 6. 日志记录（002-06）
- **文件**: [2026-01-28-002-06-日志记录.md](./2026-01-28-002-06-日志记录.md)
- **优先级**: 中
- **状态**: 待开始
- **核心功能**: LogInfo、LogType、LogCategory、LogCategoryLevel
- **依赖项**: 子需求 002-01、datai-salesforce-auth 模块的 SessionManager、datai-salesforce-common 模块的异常类

### 7. WSDL 转换（002-07）
- **文件**: [2026-01-28-002-07-WSDL转换.md](./2026-01-28-002-07-WSDL转换.md)
- **优先级**: 低
- **状态**: 待开始
- **核心功能**: WsdlToApexInfo、WsdlToApexResult
- **依赖项**: 子需求 002-01、datai-salesforce-auth 模块的 SessionManager、datai-salesforce-common 模块的异常类

---

## MetadataAPI 源 org 实现（需求编号：003）

### 1. 连接管理（003-01）
- **文件**: [2026-01-28-003-01-连接管理.md](./2026-01-28-003-01-连接管理.md)
- **优先级**: 高
- **状态**: 待开始
- **核心功能**: Connector、MetadataConnection、SessionHeader、CallOptions
- **依赖项**: datai-salesforce-auth 模块的 SessionManager、datai-salesforce-common 模块的异常类

### 2. 元数据类型定义（003-02）
- **文件**: [2026-01-28-003-02-元数据类型定义.md](./2026-01-28-003-02-元数据类型定义.md)
- **优先级**: 高
- **状态**: 待开始
- **核心功能**: 核心组件类型、配置类型、分析类型、AI 和自动化类型、UI 和用户体验类型
- **依赖项**: 子需求 003-01、datai-salesforce-auth 模块的 SessionManager、datai-salesforce-common 模块的异常类

### 3. 部署操作（003-03）
- **文件**: [2026-01-28-003-03-部署操作.md](./2026-01-28-003-03-部署操作.md)
- **优先级**: 高
- **状态**: 待开始
- **核心功能**: DeployOptions、DeployResult、DeployMessage、DeployDetails、DeployStatus
- **依赖项**: 子需求 003-01、子需求 003-02、datai-salesforce-auth 模块的 SessionManager、datai-salesforce-common 模块的异常类

### 4. 异步操作（003-04）
- **文件**: [2026-01-28-003-04-异步操作.md](./2026-01-28-003-04-异步操作.md)
- **优先级**: 高
- **状态**: 待开始
- **核心功能**: AsyncResult、AsyncRequestState
- **依赖项**: 子需求 003-01、datai-salesforce-auth 模块的 SessionManager、datai-salesforce-common 模块的异常类

### 5. 删除操作（003-05）
- **文件**: [2026-01-28-003-05-删除操作.md](./2026-01-28-003-05-删除操作.md)
- **优先级**: 中
- **状态**: 待开始
- **核心功能**: DeleteResult
- **依赖项**: 子需求 003-01、datai-salesforce-auth 模块的 SessionManager、datai-salesforce-common 模块的异常类

### 6. 检索操作（003-06）
- **文件**: [2026-01-28-003-06-检索操作.md](./2026-01-28-003-06-检索操作.md)
- **优先级**: 中
- **状态**: 待开始
- **核心功能**: RetrieveRequest、RetrieveResult、RetrieveMessage
- **依赖项**: 子需求 003-01、datai-salesforce-auth 模块的 SessionManager、datai-salesforce-common 模块的异常类

### 7. 检查部署和检索状态（003-07）
- **文件**: [2026-01-28-003-07-检查部署和检索状态.md](./2026-01-28-003-07-检查部署和检索状态.md)
- **优先级**: 中
- **状态**: 待开始
- **核心功能**: CheckDeployStatus、CheckRetrieveStatus
- **依赖项**: 子需求 003-01、子需求 003-03、子需求 003-06、datai-salesforce-auth 模块的 SessionManager、datai-salesforce-common 模块的异常类

### 8. 描述和列出元数据（003-08）
- **文件**: [2026-01-28-003-08-描述和列出元数据.md](./2026-01-28-003-08-描述和列出元数据.md)
- **优先级**: 中
- **状态**: 待开始
- **核心功能**: DescribeMetadataResult、DescribeValueType、ListMetadataQuery、ListMetadataResult、ListMetadata
- **依赖项**: 子需求 003-01、datai-salesforce-auth 模块的 SessionManager、datai-salesforce-common 模块的异常类

---

## ToolingAPI 源 org 实现（需求编号：004）

### 1. 连接管理（004-01）
- **文件**: [2026-01-28-004-01-连接管理.md](./2026-01-28-004-01-连接管理.md)
- **优先级**: 高
- **状态**: 待开始
- **核心功能**: Connector、ToolingConnection、SessionHeader、CallOptions、DebuggingHeader
- **依赖项**: datai-salesforce-auth 模块的 SessionManager、datai-salesforce-common 模块的异常类

### 2. 元数据操作（004-02）
- **文件**: [2026-01-28-004-02-元数据操作.md](./2026-01-28-004-02-元数据操作.md)
- **优先级**: 高
- **状态**: 待开始
- **核心功能**: 自定义对象和字段、Apex 组件、Flow 和自动化
- **依赖项**: 子需求 004-01、datai-salesforce-auth 模块的 SessionManager、datai-salesforce-common 模块的异常类

### 3. 开发工具功能（004-03）
- **文件**: [2026-01-28-004-03-开发工具功能.md](./2026-01-28-004-03-开发工具功能.md)
- **优先级**: 高
- **状态**: 待开始
- **核心功能**: 诊断和调试、查询和搜索
- **依赖项**: 子需求 004-01、datai-salesforce-auth 模块的 SessionManager、datai-salesforce-common 模块的异常类

### 4. AI 和智能功能（004-04）
- **文件**: [2026-01-28-004-04-AI和智能功能.md](./2026-01-28-004-04-AI和智能功能.md)
- **优先级**: 中
- **状态**: 待开始
- **核心功能**: AI 应用、AI 评估、AI 创作
- **依赖项**: 子需求 004-01、datai-salesforce-auth 模块的 SessionManager、datai-salesforce-common 模块的异常类

### 5. 动作和自动化（004-05）
- **文件**: [2026-01-28-004-05-动作和自动化.md](./2026-01-28-004-05-动作和自动化.md)
- **优先级**: 中
- **状态**: 待开始
- **核心功能**: 动作定义、可操作列表、动作任务
- **依赖项**: 子需求 004-01、datai-salesforce-auth 模块的 SessionManager、datai-salesforce-common 模块的异常类

### 6. 访问和安全（004-06）
- **文件**: [2026-01-28-004-06-访问和安全.md](./2026-01-28-004-06-访问和安全.md)
- **优先级**: 中
- **状态**: 待开始
- **核心功能**: 访问控制、连接器
- **依赖项**: 子需求 004-01、datai-salesforce-auth 模块的 SessionManager、datai-salesforce-common 模块的异常类

### 7. 高级功能（004-07）
- **文件**: [2026-01-28-004-07-高级功能.md](./2026-01-28-004-07-高级功能.md)
- **优先级**: 低
- **状态**: 待开始
- **核心功能**: 聚合和计算、预测和预测、激活和应用
- **依赖项**: 子需求 004-01、datai-salesforce-auth 模块的 SessionManager、datai-salesforce-common 模块的异常类

### 8. SOQL 查询功能（004-08）
- **文件**: [2026-01-28-004-08-SOQL查询功能.md](./2026-01-28-004-08-SOQL查询功能.md)
- **优先级**: 高
- **状态**: 待开始
- **核心功能**: query、queryMore、支持所有 Tooling API 对象的查询、支持复杂的查询条件、排序、分页
- **依赖项**: 子需求 004-01、datai-salesforce-auth 模块的 SessionManager、datai-salesforce-common 模块的异常类

## 开发顺序建议

### 第一阶段（高优先级）
1. **001-01：认证和会话管理** - 基础功能，其他子需求都依赖它
2. **001-02：CRUD 操作** - 核心数据操作功能
3. **001-03：批量操作** - 批量数据操作功能，依赖 CRUD 操作
4. **001-04：查询功能** - 数据查询功能

### 第二阶段（中优先级）
5. **001-05：描述功能** - 元数据描述功能
6. **001-06：高级功能** - 高级业务功能，依赖 CRUD 操作

### ApexAPI 源 org 实现（需求编号：002）

#### 第一阶段（高优先级）
1. **002-01：连接管理** - 基础功能，其他子需求都依赖它
2. **002-02：Apex 代码编译和执行** - 核心编译和执行功能
3. **002-03：测试执行** - 测试执行功能

#### 第二阶段（中优先级）
4. **002-04：代码覆盖率** - 代码覆盖率分析
5. **002-05：Flow 覆盖率** - Flow 覆盖率分析
6. **002-06：日志记录** - 日志记录功能

#### 第三阶段（低优先级）
7. **002-07：WSDL 转换** - WSDL 转换功能

### MetadataAPI 源 org 实现（需求编号：003）

#### 第一阶段（高优先级）
1. **003-01：连接管理** - 基础功能，其他子需求都依赖它
2. **003-02：元数据类型定义** - 核心元数据类型定义功能
3. **003-03：部署操作** - 核心部署功能
4. **003-04：异步操作** - 异步操作功能

#### 第二阶段（中优先级）
5. **003-05：删除操作** - 删除操作功能
6. **003-06：检索操作** - 检索操作功能
7. **003-07：检查部署和检索状态** - 状态检查功能
8. **003-08：描述和列出元数据** - 描述和列出功能

### ToolingAPI 源 org 实现（需求编号：004）

#### 第一阶段（高优先级）
1. **004-01：连接管理** - 基础功能，其他子需求都依赖它
2. **004-02：元数据操作** - 核心元数据操作功能
3. **004-03：开发工具功能** - 诊断和调试功能
4. **004-08：SOQL 查询功能** - 核心查询功能（Tooling API 的核心特性）

#### 第二阶段（中优先级）
5. **004-04：AI 和智能功能** - AI 应用、评估和创作功能
6. **004-05：动作和自动化** - 动作定义和自动化功能
7. **004-06：访问和安全** - 访问控制和安全配置

#### 第三阶段（低优先级）
8. **004-07：高级功能** - 聚合、预测和激活功能

## 技术约束
所有子需求必须遵守以下技术约束：
- 直接使用 `partner.jar` 中的现有类
- 使用 `datai-salesforce-auth` 的 SessionManager 管理会话
- 优先使用 `datai-salesforce-common` 模块中的现有异常
- 提供 Service 层和 Controller 层（REST API）
- 不进行不必要的二次封装

## 成功标准
每个子需求必须满足以下成功标准：
1. 实现所有核心功能
2. 正确处理各种异常情况，使用合适的异常类
3. 代码符合项目规范，无编译错误和警告
4. 通过单元测试