ai-contract-platform/project-docs/V2-contract-file-review-entry-closure-2026-06-24.md

V2 合同文件上传与发起审查入口闭环记录

日期：2026-06-24

对齐原则

本轮继续遵循《AI 合同平台 V2 重构版开发方案》：

• 合同系统只承接合同业务，不把模型、Prompt、RAG 细节塞回合同系统。
• 主流程保持简单：工作台快速发起、文件上传、关联合同、发起审查、回到合同详情看下一步。
• 附件、审查任务、审批、审计能力保留，但在详情页以折叠区承载，不压迫普通用户。

本轮完成

1. 后端 Contract API

   • 新增合同文件模型 contract_files。
   • 新增审查任务模型 review_tasks。
   • 新增文件上传接口 POST /api/v1/files。
   • 新增文件列表接口筛选参数 contract_id。
   • 新增发起审查接口 POST /api/v1/contracts/{contract_id}/review。
   • 新增合同审查任务列表接口 GET /api/v1/contracts/{contract_id}/review-tasks。
   • 合同详情返回 files 和 review_tasks。
   • 发起审查后合同状态进入 reviewing，下一步动作变为等待法律审查结果。

2. 前端 Contract Web

   • /files 从 mock 文件列表切换为 Contract API 真实数据。
   • /files 增加轻量上传表单，可选择关联合同。
   • 合同详情新增默认折叠的“附件与审查”区域。
   • 合同详情可基于当前正文或附件发起审查。
   • 工作台“发起法律审查”入口改为进入合同仓库上传/审查入口。

3. 契约与迁移

   • OpenAPI 同步文件上传、审查任务、合同详情附件字段。
   • 新增 Alembic 迁移 20260624_0003_add_contract_files_and_review_tasks.py。

保持简单的取舍

• 本轮不接 MinIO、OCR、AI 审查结果生成，避免把 T1 拉成重工程。
• 文件内容先进入本地暂存目录 CONTRACT_API_FILE_STORAGE_DIR，后续可替换为对象存储。
• 审查任务先入队并改变合同业务状态，后续再由 AI 中台/worker 消费执行。

下一步建议

下一轮自然进入：把审查任务接到 AI 中台 SDK，形成“审查任务创建 -> AI 审查执行 -> 审查结果回写合同详情”的闭环。