ai-contract-platform/project-docs/V2前端基础工程与轻量化体验底座记录-2026-06-22.md

V2 前端基础工程与轻量化体验底座记录

日期：2026-06-22

1. 本轮目标

承接 T0-5，建立 V2 前端基础工程和设计系统底座，同时把企业主线的轻量化体验原则落到第一版页面结构里。

2. 已完成内容

Workspace

已建立根 npm workspace：

• package.json
• package-lock.json
• tsconfig.base.json

根命令：

npm run web:dev
npm run web:typecheck
npm run web:build

Design System

目录：packages/design-system

已建立：

• 品牌颜色、布局、圆角、阴影 tokens。
• 企业主流程 mainFlow 元数据。
• package export 边界。

Contract Web

目录：apps/contract-web

已建立：

• Next.js App Router 工程。
• 全局布局和左侧主导航。
• 工作台。
• 合同列表。
• 合同详情。
• 统一搜索。
• 合同仓库。
• 管理区。
• 系统健康页。

3. 体验原则落地

本轮页面遵循以下原则：

• 工作台只突出“待我处理”和“快速发起”。
• 主流程导航只保留：工作台、合同、统一搜索、合同仓库。
• 管理员能力集中到“管理区”。
• 合同详情首屏突出“下一步操作”。
• 审批、版本、履约、审计在合同详情侧栏折叠呈现。
• 统一搜索结果标题就是主入口，减少重复“打开”按钮。
• 合同仓库保留文件预览、关联合同和批量下载入口。

4. 验证结果

已通过：

npm audit --audit-level=moderate
npm run web:typecheck
npm run web:build
python -m pytest

结果：

• npm audit：0 vulnerabilities。
• TypeScript：通过。
• Next.js production build：通过。
• 后端 pytest：6 passed。

页面验收：

• /
• /workspace
• /contracts
• /contracts/contract-001
• /search
• /files
• /admin
• /health

截图输出：

output/playwright/v2-front-foundation/

5. 当前边界

本轮仍使用 mock 数据，不包含：

• 登录认证。
• 真实合同 API 对接。
• 真实文件上传/下载。
• 真实搜索查询。
• 真实审批提交。
• AI 问答和审查调用。

6. 下一步建议

继续进入 S2/S3 的最小闭环：

1. 建立 AI Platform MVP 的数据模型和 /api/v1/legal/qa 假实现。
2. 建立 Python SDK MVP，使 contract-api 只能通过 SDK 调用 ai-platform-api。
3. 建立 Contract API 的工作台和合同列表真实接口。
4. 前端从 mock 数据切换到 Contract API。