9.6 KiB
会话记录
元数据
- 需求编号：005
- 开始时间：2026-02-03
- 结束时间：进行中
- 当前阶段：阶段 1：需求定义与入库
需求澄清记录
原始需求
调整 Apex 模块，将代码提取出来使用 file 模块进行存储。
第一轮澄清
AI 提问：
- 这个重构涉及 Apex 模块的哪些具体功能？
- 代码提取后需要存储到 file 模块的哪种存储方式？
- 数据库中已存在的代码如何处理？
- 这个重构对现有功能的影响范围是什么？
用户回答：
- 涉及所有需要的子需求
- 多种存储方式，可以自定义
- 不处理数据库中的
- 对现有功能为向后兼容
第二轮澄清
AI 提问：
- 具体涉及的子需求有哪些？
- file 模块支持 local、minio、oss 三种存储方式，用户如何选择？
- 数据库表结构是否需要调整？
- "向后兼容"是指 API 接口保持不变吗？
- file 模块存储后，代码下载的响应时间要求是多少？
- 是否需要对存储的代码文件进行加密？
- 是否需要记录代码文件的访问日志？
用户回答：
- 所有有可能需要的模块，都提取
- 存储默认 local，可以切换其它
- 需要调整数据库表结构
- （未回答 API 接口、响应时间、加密、日志等问题）
第三轮澄清
AI 提问：
- 数据库表结构调整的具体方式是什么？
- 向后兼容性的实现方式是什么？
- 存储切换机制是什么？
- 代码文件命名规则是什么？
- 文件删除策略是什么？
用户回答：
- 改为 file_path 字段
- API 接口是否保持不变
- 数据库配置切换存储方式
- /apex/wsdl/{conversionId}/{className}.cls
- 文件同步删除
- 建议所有 apex 代码文件的唯一索引，所有文件的增删都需要更新该唯一索引
澄清总结
- 功能范围：所有可能需要存储代码的 Apex 模块子需求（002-01 到 002-07）
- 业务流程：代码生成 → 存储到 file 模块 → 数据库存储 file_path → 下载时从 file 模块读取
- 数据交互：
- 数据库表结构调整：将代码字段改为 file_path 字段
- 集成 datai-scene-file 模块进行文件存储
- 数据库配置存储方式（local/minio/oss）
- 性能要求：响应时间保持现有水平
- 安全要求：文件同步删除，建立唯一索引防止重复
- 兼容性要求：API 接口保持不变，向后兼容
需求描述
调整 Apex 模块，将代码提取出来使用 file 模块进行存储。涉及所有需要的子需求，多种存储方式，可以自定义。不处理数据库中的，对现有功能为向后兼容。改为 file_path 字段，API 接口保持不变，数据库配置切换存储方式，/apex/wsdl/{conversionId}/{className}.cls，文件同步删除。建议所有 apex 代码文件的唯一索引，所有文件的增删都需要更新该唯一索引。
执行阶段
阶段 1：需求定义与入库
- 状态：已完成
- 生成文档：需求文档
- 关键决策：
- 需求编号：005
- 优先级：高
- 涉及所有 Apex 模块子需求（002-01 到 002-07）
- 数据库表结构调整：将代码字段改为 file_path 字段
- 集成 datai-scene-file 模块
- 支持多种存储方式（local、minio、oss），默认 local
- API 接口保持不变，向后兼容
- 文件同步删除机制
- 建立 Apex 代码文件的唯一索引
阶段 2：方案设计
- 状态：未开始
阶段 3：方案决策
- 状态：未开始
阶段 4：数据库结构
- 状态：未开始
阶段 5：提示词生成
- 状态：未开始
阶段 6：代码生成
- 状态：未开始
阶段 7：会话记录
- 状态：未开始
阶段 8：变更日志
- 状态：未开始
对话记录
用户：调整 Apex 模块，将代码提取出来使用 file 模块进行存储。
AI：好的，我理解了您的需求。在创建需求文档前，我需要先进行需求澄清，以确保需求的完整性和准确性。
需求澄清
原始需求
调整 Apex 模块，将代码提取出来使用 file 模块进行存储。
第一轮澄清
让我先了解一些关键信息：
-
功能范围：这个重构涉及 Apex 模块的哪些具体功能？
- 是否只涉及 002-07 WSDL 转换功能？
- 还是涉及所有子需求（002-01 到 002-07）？
- 是否包括编译历史、测试结果等存储的代码？
-
存储目标：代码提取后需要存储到 file 模块的哪种存储方式？
- 本地存储（local）
- MinIO 分布式存储
- 阿里云 OSS 对象存储
- 还是支持多种存储方式？
-
数据迁移：数据库中已存在的代码如何处理？
- 是否需要将数据库中的历史代码迁移到 file 模块？
- 还是只处理新产生的代码？
- 如果需要迁移，是否需要保留数据库中的代码副本？
-
业务影响：这个重构对现有功能的影响范围是什么？
- 是否需要修改现有的 API 接口？
- 前端是否需要相应调整？
- 是否需要保持向后兼容？
请您回答以上问题，我将根据您的回答进行更深入的分析和澄清。
用户：涉及到所有需要的子需求 多种存储方式，可以自定义 不处理数据库中的 对现有功能为向后兼容，
AI：感谢您的回答。让我继续了解更多细节：
第二轮澄清
基于您的回答，我需要进一步了解以下内容：
-
具体涉及的子需求：
- 根据之前的分析，Apex 模块中涉及代码存储的主要是 002-07 WSDL 转换功能（生成的 Apex 类代码）
- 其他子需求（002-02 编译、002-03 测试、002-04 覆盖率等）是否也需要将代码提取到 file 模块？
- 请明确列出需要重构的所有子需求编号
-
存储策略：
- file 模块支持 local、minio、oss 三种存储方式，用户如何选择？
- 是否需要配置化（如在 application.yml 中配置默认存储方式）？
- 是否需要支持运行时动态切换存储方式？
-
数据库字段变更：
- 不处理数据库中的历史代码，那么数据库表结构是否需要调整？
- 是否需要在数据库中保留 file 模块返回的文件路径（file_path）？
- 还是完全删除
class_code等代码字段？
-
向后兼容性：
- "向后兼容"是指 API 接口保持不变吗？
- 还是说需要同时支持数据库存储和 file 模块存储两种方式？
- 如果是同时支持，如何判断使用哪种方式？
-
性能和安全：
- file 模块存储后，代码下载的响应时间要求是多少？
- 是否需要对存储的代码文件进行加密？
- 是否需要记录代码文件的访问日志？
请您回答以上问题，我将进行总结并创建需求文档。
用户：所有有可能需要的模块，都提取 存储默认local，可以切换其它。。需要调整数据库表结构
AI：感谢您的回答。让我继续了解关键细节：
第三轮澄清
基于您的回答，我需要明确以下关键问题：
-
数据库表结构调整：
- 是否将
class_code等代码字段改为file_path字段？ - 还是保留
class_code字段，新增file_path字段？ - 如果保留两个字段，如何判断优先使用哪个？
- 是否将
-
向后兼容性的实现方式：
- API 接口是否保持不变（前端无需修改）？
- 下载接口的响应内容是否保持一致（仍然是代码内容或 ZIP 文件）？
- 如果数据库中既有代码又有文件路径，优先读取哪个？
-
存储切换机制：
- 如何配置存储方式（application.yml？数据库配置？）？
- 是否需要支持不同租户使用不同的存储方式？
- 存储方式切换后，已存储的文件是否需要迁移？
-
代码文件命名规则：
- 存储到 file 模块时，文件路径如何命名？
- 例如：
/apex/wsdl/{conversionId}/{className}.cls？ - 是否需要按日期、用户、租户等维度组织目录结构？
-
文件删除策略：
- 当删除数据库记录时，file 模块中的文件是否同步删除？
- 是否需要提供文件清理机制（定期清理孤立的文件）？
请您回答以上问题，我将进行最终总结并创建需求文档。
用户：改为 file_path 字段
API 接口是否保持不变 数据库配置切换存储方式 /apex/wsdl/{conversionId}/{className}.cls 文件同步删除 建议所有apex代码文件的唯一索引，所有文件的增删都需要更新该唯一索引
AI：感谢您的详细回答。让我总结一下需求并创建需求文档。
澄清总结
- 功能范围：所有可能需要存储代码的 Apex 模块子需求（002-01 到 002-07）
- 业务流程：代码生成 → 存储到 file 模块 → 数据库存储 file_path → 下载时从 file 模块读取
- 数据交互：
- 数据库表结构调整：将代码字段改为 file_path 字段
- 集成 datai-scene-file 模块进行文件存储
- 数据库配置存储方式（local/minio/oss）
- 性能要求：响应时间保持现有水平
- 安全要求：文件同步删除，建立唯一索引防止重复
- 兼容性要求：API 接口保持不变，向后兼容
现在让我查找现有需求编号，确定新需求的编号。
（执行查找需求编号和创建需求文档的操作）
生成的文档
回退记录
无