119 lines
2.5 KiB
Markdown
119 lines
2.5 KiB
Markdown
# 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。
|