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

日期：2026-06-22

## 1. 本轮目标

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

## 2. 已完成内容

### Workspace

已建立根 npm workspace：

- `package.json`
- `package-lock.json`
- `tsconfig.base.json`

根命令：

```powershell
npm run web:dev
npm run web:typecheck
npm run web:build
```

### Design System

目录：`yuqei-contract-platform/packages/design-system`

已建立：

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

### Contract Web

目录：`yuqei-contract-platform/apps/contract-web`

已建立：

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

## 3. 体验原则落地

本轮页面遵循以下原则：

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

## 4. 验证结果

已通过：

```powershell
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`

截图输出：

```text
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。