yuqei
a3bb78e06b
Security Quality Gate / npm audit, Bandit, pip-audit, detect-secrets (pull_request) Failing after 16m35s
45 lines
2.1 KiB
Markdown
45 lines
2.1 KiB
Markdown
# 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 审查执行 -> 审查结果回写合同详情”的闭环。
|