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

AI 合同平台 V2 - 合同台账仪表盘闭环记录

日期：2026-06-25

背景

对照《AI 合同平台 V2 重构版开发方案》Phase 6 合同仓库与生命周期，本轮实现合同台账仪表盘，提供合同状态汇总视图。

已完成内容

后端 API

新增模型：

• DashboardStatusCount: status, status_label, count
• DashboardTypeCount: contract_type, count
• ContractDashboard: total, status_counts, type_counts, new_last_7_days, pending_approval

新增接口：

• GET /api/v1/contracts/dashboard: 返回统计数据

前端

新增路由：

• /dashboard: 合同台账仪表盘页面

功能：

• 指标卡片：合同总数、近7天新增、待审批数量
• 状态分布：按合同状态分组展示（含进度条）
• 类型分布：按合同类型分组展示（含进度条）
• 点击状态行直接跳转到对应筛选的合同列表

验证结果

npm --prefix yuqei-contract-platform/apps/contract-web run typecheck
npm --prefix yuqei-contract-platform/apps/contract-web run build

构建通过，新增 /dashboard 路由。

后续建议

1. 合同列表生命周期筛选（signed/archived/obligation）
2. 履约提醒真实数据
3. 签署证据
4. 归档证据