feat: initialize V2 contract web shell

2026-06-22 18:45:39 +08:00
parent a6157fcaf8
commit dfb514e0cf
31 changed files with 2686 additions and 2 deletions
@@ -0,0 +1,118 @@
+# 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
+
+目录：`packages/design-system`
+
+已建立：
+
+- 品牌颜色、布局、圆角、阴影 tokens。
+- 企业主流程 `mainFlow` 元数据。
+- package export 边界。
+
+### Contract Web
+
+目录：`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。