Files
ai-contract-platform/project-docs/V2-archive-export-2026-06-26.md
T
yuqei a3bb78e06b
Security Quality Gate / npm audit, Bandit, pip-audit, detect-secrets (pull_request) Failing after 16m35s
release: freeze V2 release candidate
2026-07-12 15:32:24 +08:00

2.2 KiB

AI 合同平台 V2 - 归档证据和数据导出闭环记录

日期:2026-06-26

背景

对照《AI 合同平台 V2 重构版开发方案》Phase 6 合同仓库与生命周期,本轮实现归档证据和数据导出功能。

已完成内容

归档证据后端

新增模型:

  • ArchiveEvidence: id, contract_id, archived_at, archived_by, document_hash, archive_location, retention_policy, summary
  • ArchiveRequest: archived_by, archive_location, retention_policy, summary

新增接口:

  • POST /api/v1/contracts/{id}/archive: 归档合同并创建证据
  • GET /api/v1/contracts/{id}/archive-evidence: 获取归档证据列表

归档逻辑:

  • 仅允许 approved 或 signed 状态的合同归档
  • 归档时自动计算文档哈希
  • 状态变更为 archived

数据导出后端

新增模型:

  • ContractExportRow: id, title, code, counterparty, status, status_label, amount, owner, created_at, updated_at

新增接口:

  • GET /api/v1/contracts/export: 导出合同列表,支持 status 和 lifecycle 筛选

前端

新增 API 代理:

  • /api/contract-platform/contracts/[id]/archive
  • /api/contract-platform/contracts/[id]/archive-evidence
  • /api/contract-platform/contracts/export

新增服务函数:

  • getArchiveEvidence(contractId): 获取归档证据
  • archiveContract(contractId, archivedBy, options): 归档合同
  • exportContracts(options): 导出合同列表

验证结果

python -m pytest yuqei-contract-platform/services/contract-api/tests -q  # 25 passed
npm --prefix yuqei-contract-platform/apps/contract-web run typecheck     # passed
npm --prefix yuqei-contract-platform/apps/contract-web run build         # passed

Phase 6 完成情况

功能 状态
文件仓库 MVP ✅
文件预览 ✅
关联合同 ✅
批量下载 ✅
合同台账 ✅
生命周期筛选 ✅
履约提醒 ✅
签署证据 ✅
归档证据 ✅(本轮)
数据导出 ✅(本轮)

Phase 6 合同仓库与生命周期全部完成!

下一步建议

Phase 6 已全部完成,可以进入下一阶段开发,或进行系统集成测试和文档完善。