ai-contract-platform/project-docs/V2-lifecycle-filter-2026-06-25.md

AI 合同平台 V2 - 生命周期筛选闭环记录

日期：2026-06-25

背景

对照《AI 合同平台 V2 重构版开发方案》Phase 6 合同仓库与生命周期，本轮实现生命周期筛选功能。

已完成内容

后端

新增：

• ContractListItem.lifecycle_stage 字段
• LifecycleStage 类型：draft / in_approval / approved / signed / in_obligation / archived
• compute_lifecycle_stage() 函数：根据合同状态计算生命周期阶段
• list_contracts() 增加 lifecycle 查询参数

生命周期映射：

• draft → draft
• reviewing → draft
• approval_pending → in_approval
• rejected → draft
• approved → approved
• signed → in_obligation
• archived → archived

前端

• 合同列表页增加生命周期筛选下拉框
• 筛选标签同步展示
• 支持独立和联合筛选（status + lifecycle + keyword）

验证结果

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 的履约提醒和签署/归档证据功能。