Bruce/DEMO-AGENT
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs(file-summary): 对齐文档路径和附件模型命名

Browse Source
This commit is contained in:
bruce
2026-06-06 00:56:41 +08:00
parent ce574048a4
commit b96ab1303a
4 changed files with 16 additions and 16 deletions
Download Patch File Download Diff File Expand all files Collapse all files

10
docs/2.功能设计/1.自动汇总.md
View File

@@ -4,7 +4,7 @@
| 项目 | 内容 | | 项目 | 内容 |
| --- | --- | | --- | --- |
| 需求分析文档 | docs/需求分析/1.自动汇总.md | | 需求分析文档 | docs/1.需求分析/1.自动汇总.md |
| 功能名称 | 自动汇总文件夹文件目录与页数 | | 功能名称 | 自动汇总文件夹文件目录与页数 |
| 所属模块 | 审核智能体 review_agent | | 所属模块 | 审核智能体 review_agent |
| 设计日期 | 2026-06-05 | | 设计日期 | 2026-06-05 |
@@ -137,7 +137,7 @@ WorkflowExecutor
| 职责 | 接收对话页上传的压缩包或多个文件，保存原始文件，创建上传批次 | | 职责 | 接收对话页上传的压缩包或多个文件，保存原始文件，创建上传批次 |
| 输入 | conversation_id、user_id、uploaded_files | | 输入 | conversation_id、user_id、uploaded_files |
| 输出 | batch_id、upload_file_ids、upload_type、original_storage_paths | | 输出 | batch_id、upload_file_ids、upload_type、original_storage_paths |
| 数据写入 | FileSummaryBatch、UploadedSourceFile | | 数据写入 | FileSummaryBatch、FileAttachment、FileSummaryBatchAttachment |
| 关键规则 | 文件必须绑定当前 Conversation；同一对话只使用本对话上传的文件 | | 关键规则 | 文件必须绑定当前 Conversation；同一对话只使用本对话上传的文件 |
### 4.3 压缩包解压 Skill ### 4.3 压缩包解压 Skill
@@ -252,9 +252,9 @@ WorkflowExecutor
| started_at | DateTimeField | 开始时间 | | started_at | DateTimeField | 开始时间 |
| finished_at | DateTimeField | 完成时间 | | finished_at | DateTimeField | 完成时间 |
### 5.2 UploadedSourceFile ### 5.2 FileAttachment
上传原始文件记录。 上传原始文件记录。用户上传即存储为 `FileAttachment`，批次启动时再通过 `FileSummaryBatchAttachment` 固化本次使用的附件版本。
| 字段 | 类型 | 说明 | | 字段 | 类型 | 说明 |
| --- | --- | --- | | --- | --- | --- |
@@ -552,7 +552,7 @@ export_id -> batch -> conversation -> user
| 设计点 | 说明 | | 设计点 | 说明 |
| --- | --- | | --- | --- |
| 对话隔离 | 所有批次查询和下载必须校验 conversation.user | | 对话隔离 | 所有批次查询和下载必须校验 conversation.user |
| 防串文件 | 工作流只能读取当前 batch 绑定的 UploadedSourceFile | | 防串文件 | 工作流只能读取当前 batch 通过 FileSummaryBatchAttachment 绑定的 FileAttachment |
| 解压安全 | 禁止压缩包内路径跳出批次工作目录 | | 解压安全 | 禁止压缩包内路径跳出批次工作目录 |
| 文件执行安全 | 不执行上传文件中的脚本、宏或外部链接 | | 文件执行安全 | 不执行上传文件中的脚本、宏或外部链接 |
| 下载权限 | 下载接口必须验证当前用户拥有批次所属对话 | | 下载权限 | 下载接口必须验证当前用户拥有批次所属对话 |

4
docs/3.详细设计/1.自动汇总.md
View File

@@ -4,8 +4,8 @@
| 项目 | 内容 | | 项目 | 内容 |
| --- | --- | | --- | --- |
| 需求分析文档 | docs/需求分析/1.自动汇总.md | | 需求分析文档 | docs/1.需求分析/1.自动汇总.md |
| 功能设计文档 | docs/功能设计/1.自动汇总.md | | 功能设计文档 | docs/2.功能设计/1.自动汇总.md |
| 功能名称 | 自动汇总文件夹文件目录与页数 | | 功能名称 | 自动汇总文件夹文件目录与页数 |
| 所属模块 | 审核智能体 review_agent | | 所属模块 | 审核智能体 review_agent |
| 设计日期 | 2026-06-05 | | 设计日期 | 2026-06-05 |

6
docs/4.数据库设计/1.自动汇总.md
View File

@@ -4,9 +4,9 @@
| 项目 | 内容 | | 项目 | 内容 |
| --- | --- | | --- | --- |
| 需求分析文档 | docs/需求分析/1.自动汇总.md | | 需求分析文档 | docs/1.需求分析/1.自动汇总.md |
| 功能设计文档 | docs/功能设计/1.自动汇总.md | | 功能设计文档 | docs/2.功能设计/1.自动汇总.md |
| 详细设计文档 | docs/详细设计/1.自动汇总.md | | 详细设计文档 | docs/3.详细设计/1.自动汇总.md |
| 数据库类型 | SQLite / Django ORM | | 数据库类型 | SQLite / Django ORM |
| 表名前缀 | ra_ | | 表名前缀 | ra_ |
| 设计日期 | 2026-06-05 | | 设计日期 | 2026-06-05 |

12
docs/5.开发计划/1.自动汇总.md
View File

@@ -4,10 +4,10 @@
| 项目 | 内容 | | 项目 | 内容 |
| --- | --- | | --- | --- |
| 需求分析文档 | docs/需求分析/1.自动汇总.md | | 需求分析文档 | docs/1.需求分析/1.自动汇总.md |
| 功能设计文档 | docs/功能设计/1.自动汇总.md | | 功能设计文档 | docs/2.功能设计/1.自动汇总.md |
| 详细设计文档 | docs/详细设计/1.自动汇总.md | | 详细设计文档 | docs/3.详细设计/1.自动汇总.md |
| 数据库设计文档 | docs/数据库设计/1.自动汇总.md | | 数据库设计文档 | docs/4.数据库设计/1.自动汇总.md |
| 功能名称 | 自动汇总文件夹文件目录与页数 | | 功能名称 | 自动汇总文件夹文件目录与页数 |
| 所属模块 | 审核智能体 review_agent | | 所属模块 | 审核智能体 review_agent |
| 执行方式 | 单人开发 + Codex 流水线自动化执行 | | 执行方式 | 单人开发 + Codex 流水线自动化执行 |
@@ -120,7 +120,7 @@
| 开发步骤 | 1. 定义 `FileAttachment`；2. 定义 `FileSummaryBatch`；3. 定义 `FileSummaryBatchAttachment`；4. 定义 `FileSummaryItem`；5. 定义 `WorkflowNodeRun`；6. 定义 `WorkflowEvent`；7. 定义 `ExportedSummaryFile`；8. 使用 Django `TextChoices` 管理枚举 | | 开发步骤 | 1. 定义 `FileAttachment`；2. 定义 `FileSummaryBatch`；3. 定义 `FileSummaryBatchAttachment`；4. 定义 `FileSummaryItem`；5. 定义 `WorkflowNodeRun`；6. 定义 `WorkflowEvent`；7. 定义 `ExportedSummaryFile`；8. 使用 Django `TextChoices` 管理枚举 |
| 验收标准 | 模型字段、关联、默认值、`db_table`、`indexes`、`constraints` 与数据库设计一致 | | 验收标准 | 模型字段、关联、默认值、`db_table`、`indexes`、`constraints` 与数据库设计一致 |
| 验证命令 | `python manage.py check` | | 验证命令 | `python manage.py check` |
| Codex 执行提示 | 请按 `docs/数据库设计/1.自动汇总.md` 在 `review_agent/models.py` 新增 7 个 `ra_` 表模型，使用 Django ORM、TextChoices、短表名、索引和唯一约束。 | | Codex 执行提示 | 请按 `docs/4.数据库设计/1.自动汇总.md` 在 `review_agent/models.py` 新增 7 个 `ra_` 表模型，使用 Django ORM、TextChoices、短表名、索引和唯一约束。 |
### FS-P1-002 生成并验证数据库迁移 ### FS-P1-002 生成并验证数据库迁移
@@ -616,7 +616,7 @@
后续可直接对 Codex 输入： 后续可直接对 Codex 输入：
```text ```text
请按 docs/开发计划/1.自动汇总.md 执行，从 V2 创建 codex/YYYYMMDD-自动汇总文件目录页数 分支，按 P0 到 P7 顺序开发、验证和阶段提交。每个阶段完成后调用 git-commit-summary 生成提交摘要并本地提交。全部完成后合并回 V2，并重新运行总体验收。 请按 docs/5.开发计划/1.自动汇总.md 执行，从 V2 创建 codex/YYYYMMDD-自动汇总文件目录页数 分支，按 P0 到 P7 顺序开发、验证和阶段提交。每个阶段完成后调用 git-commit-summary 生成提交摘要并本地提交。全部完成后合并回 V2，并重新运行总体验收。
``` ```
--- ---