版本：v1.0
日期：2026-11-06
目标：11 月 27 日 300 人会议演示版；原型不是一次性 Demo，而是正式版的起点
团队：3 人（A/B/C）
产品形态：PC 主端 + 小程序客户视图（小程序是配角）
状态：原型开发执行方案
0. 结论
- 主舞台是 PC 大屏：8 分钟演一个刑事案件从建档到结案；小程序只做 30 秒客户视图。
- 三个人各守一条线：A 负责 PC 主端，B 负责客户视图/视觉，C 负责平台/数据/Agent/运维。
- 原型按正式版的骨架搭：API 契约、领域模型、组件库、权限模型、审计事件从第一天就按正式版设计；演示数据放在适配层，不进组件。
- 21 天只做 5 个屏幕、3 个哇点：PC 一案七面、Agent 出文书、7 家所驾驶舱；其余全砍。
- 正式版在原型上长：保留 UI/领域模型/API 契约/权限/审计；把 PocketBase、演示登录、Mock Agent 替换为 FastAPI/PostgreSQL、企业微信 OIDC、真实 Agent 网关。
- 不碰及锋生产代码：原型独立仓库；正式版再按适配层方案并入卓安Claw。
1. 团队与角色
1.1 三人分工
| 代号 |
角色 |
主责 |
备援 |
| A |
PC 主端负责人 |
React/TS/Electron、PC 壳、工作台、案件主线、Agent 面板、驾驶舱、权限/审计、大屏模式 |
B 可改样式，C 可接数据 |
| B |
客户视图/视觉负责人 |
设计 token、组件规范、Taro H5 客户视图、动效、一页纸、展台物料、视觉 QA |
A 可接 PC 样式 |
| C |
平台/数据/Agent/运维负责人 |
仓库/CI、PocketBase schema/seed、API 契约、Demo Agent 服务、登录/重置、部署、Playwright/备份视频 |
A 可接前端联调 |
1.2 共同职责
- 产品脚本：项目负责人（你）+ 三人，11/08 冻结。
- 每日 9:30 站会 15 分钟：昨天/今天/阻塞。
- 每日 18:00 集成，18:30 可点版本；每周五 16:00 完整演示。
- Code Review：任何合并至少 1 人 review；A/B/C 交叉。
- 演示彩排：11/23 第一次，11/26 总彩排。
2. 原型定位与原则
2.1 定位
- 11/27 演示版：PC 主端 + 小程序客户视图。
- 不是正式版全功能；是可演进的原型：能演示、能继续开发、不推翻重来。
- 只做 5 个屏幕：S1 PC 工作台、S2 PC 案件主线、S3 PC Agent、S4 PC 驾驶舱、S5 小程序客户视图。
2.2 七条原则
- API-first：UI 不直接读 mock JSON；通过
packages/api-client 调 services/api。
- 领域模型共享：客户/案件/阶段/权限/审计的 TypeScript 类型和 Zod schema 放
packages/domain。
- 演示数据隔离：seed 只在
services/api 和 packages/api-client 的 demo adapter 里；组件不写死数据。
- 权限从第一天就有：角色切换、数据范围、字段遮条；演示版也要走同一套策略。
- 审计从第一天就有：关键动作写事件；演示版也要能展示“谁看了什么”。
- Feature Flag：
demo、agent、portal、cockpit 可开关；正式版按环境替换。
- 不碰及锋生产代码：独立仓库；正式版再按适配层并入。
3. 技术栈与仓库结构
3.1 技术栈
| 层 |
选型 |
| PC 前端 |
Vite + React + TypeScript + Tailwind + shadcn/ui |
| 状态/表单 |
Zustand + React Hook Form + Zod |
| 表格/图表/时间线 |
TanStack Table + Recharts/ECharts + React Chrono |
| 动效 |
Framer Motion |
| PC 外壳 |
Electron（时间够）/ 浏览器全屏（兜底） |
| 小程序客户视图 |
Taro（React）编译 H5；正式版再提审微信小程序 |
| 演示后端 |
PocketBase（单文件、SQLite、Auth、Realtime） |
| 正式后端 |
FastAPI + PostgreSQL（沿用原型 API 契约） |
| Agent |
自定义面板 + 预生成响应 + 流式动画；正式版接 Agent 网关 |
| 测试/备份 |
Playwright + MSW |
| 设计 |
Penpot（只画 5 屏关键界面） |
3.2 仓库结构
zhuoan-claw/
├─ apps/
│ ├─ pc/ # Vite + React PC 主端
│ └─ mini/ # Taro H5 客户视图
├─ packages/
│ ├─ ui/ # shadcn 基础组件 + 业务组件
│ ├─ domain/ # TS 类型 + Zod schema + 状态机
│ ├─ api-client/ # API 客户端（OpenAPI 生成/手写）
│ └─ demo-data/ # 合成数据 seed
├─ services/
│ ├─ api/ # PocketBase 适配层（正式版换 FastAPI）
│ └─ agent/ # Demo Agent 服务（预生成 + 兜底）
├─ infra/
│ ├─ docker-compose.yml
│ ├─ scripts/ # 启动/重置/备份
│ └─ ci/ # lint/typecheck/build/test
├─ docs/
│ ├─ adr/ # 架构决策
│ ├─ demo-script.md # 8 分钟脚本
│ └─ runbook.md # 演示运行手册
└─ README.md
3.3 分支与发布
main：演示稳定版；只接受 PR。develop：日常集成。feature/*：每人功能分支。- 标签：
demo-2026-11-27。
- CI：lint + typecheck + build + Playwright smoke。
- 演示构建：
pnpm build:demo，产物在 dist/demo。
4. 工作分解（WBS）
| 编号 |
工作包 |
主责 |
支持 |
交付物 |
依赖 |
| W1 |
基础设施与规范 |
C |
A/B |
仓库、CI、TS strict、lint、Docker、README |
— |
| W2 |
设计系统与大屏规范 |
B |
A |
tokens、字体、配色、间距、组件规范、大屏模式 |
W1 |
| W3 |
PC 壳/导航/角色切换 |
A |
B |
布局、侧栏、顶栏、标签页、角色切换、Demo Mode |
W1/W2 |
| W4 |
PC 工作台 |
A |
C |
指标卡、待办、预警 |
W3 |
| W5 |
PC 案件诊疗主线 |
A |
C |
案件详情、阶段时间线、清单、标签页 |
W3 |
| W6 |
PC Agent 面板 |
A |
C |
3 个动作、流式动画、引用、草稿确认 |
W5 |
| W7 |
PC 驾驶舱 |
A |
B/C |
7 家所、负荷、超期、风险、图表 |
W3 |
| W8 |
PC 权限/审计 |
A |
C |
角色对比、审计抽屉、水印 |
W4–W7 |
| W9 |
小程序客户视图 |
B |
C |
Taro H5 3 页、公开动态、共享文书 |
W2/W10 |
| W10 |
数据与 Agent 服务 |
C |
A/B |
PocketBase schema/seed、API、Demo Agent、重置 |
W1 |
| W11 |
测试/部署/备份 |
C |
全员 |
Playwright、备份视频、runbook、本地部署 |
W6/W9 |
| W12 |
演示物料 |
B |
A |
一页纸、二维码、展台物料、视觉 QA |
W2 |
5. 21 天排期
11/07–11/08 为冲刺周末；按团队实际调休。每天 18:30 必须有一个可点版本。
| 日期 |
A（PC） |
B（客户视图/视觉） |
C（平台/数据/Agent） |
里程碑 |
| 11/06 五 |
脚本评审、页面清单 |
视觉参考、Penpot 5 屏 |
仓库/CI/技术栈、API 契约初稿 |
启动 |
| 11/07 六 |
PC 壳、路由、角色切换 |
设计 token、组件规范 |
PocketBase schema、seed 数据 |
— |
| 11/08 日 |
工作台骨架 |
客户视图 3 页线框 |
Demo Agent 骨架、重置脚本 |
M0 脚本冻结 |
| 11/09 一 |
工作台指标/待办 |
客户视图页面 |
API 联调、seed 完整 |
— |
| 11/10 二 |
案件主线/时间线 |
动效规范 |
Agent 3 动作预生成 |
— |
| 11/11 三 |
案件详情/清单 |
客户视图样式 |
权限/审计事件 |
— |
| 11/12 四 |
Agent 面板 |
客户视图联调 |
性能/错误处理 |
— |
| 11/13 五 |
S1–S3 可点 |
S5 可点 |
联调通过 |
M1 PC 核心 |
| 11/14 六 |
驾驶舱 |
一页纸初稿 |
Playwright 冒烟 |
— |
| 11/15 日 |
驾驶舱图表 |
展台物料 |
备份视频脚本 |
— |
| 11/16 一 |
权限对比 |
视觉 QA |
部署脚本 |
— |
| 11/17 二 |
审计抽屉 |
视觉 QA |
联调/修复 |
M2 PC 管理端 |
| 11/18 三 |
大屏模式/动效 |
小程序客户视图 |
全链路测试 |
— |
| 11/19 四 |
修 bug |
小程序客户视图 |
断网/重置测试 |
— |
| 11/20 五 |
功能冻结 |
功能冻结 |
演示构建 |
M3 功能完成 |
| 11/21 六 |
集成/修 bug |
集成/修 bug |
集成/修 bug |
— |
| 11/22 日 |
彩排 1 |
彩排 1 |
彩排 1 |
— |
| 11/23 一 |
修彩排问题 |
修彩排问题 |
修彩排问题 |
M4 第一次彩排 |
| 11/24 二 |
打磨 |
一页纸/二维码 |
备份视频 |
— |
| 11/25 三 |
打磨 |
展台物料 |
runbook/部署复核 |
— |
| 11/26 四 |
总彩排 |
总彩排 |
总彩排 |
M5 总彩排 |
| 11/27 五 |
舞台演示 |
展台客户视图 |
技术保障 |
演示 |
6. 协作节奏
6.1 每日
- 09:30 站会 15 分钟：昨天完成/今天计划/阻塞。
- 12:30 快速联调：接口/数据/样式问题当天清。
- 18:00 集成到
develop；18:30 出可点版本。
- 20:00 前把第二天要用的 seed/接口准备好。
6.2 每周
- 周五 16:00 完整演示一次，按 8 分钟脚本走。
- 周五 17:00 复盘：本周完成/未完成/下周砍什么。
- 每周更新
docs/adr/：记录架构决策，避免正式版推翻。
6.3 Code Review
- 任何合并至少 1 人 review；A/B/C 交叉。
- 禁止直接 push
main；develop 通过 PR。
- Review 重点：权限、数据隔离、硬编码、演示数据泄漏、性能。
7. Definition of Done
每个页面/功能完成必须满足：
- 用演示数据可走通；无 console error。
- 1920×1080 全屏下字号 ≥ 24px；大屏可读。
- 角色切换后权限正确；越权不可见。
- 不出现真实客户/案件/身份证/电话。
- 有 loading/empty/error 状态。
- 有 Demo Mode/Feature Flag；可一键重置。
- 通过 lint + typecheck + build。
- 至少 1 人 review。
- 有备份路径（录屏/静态图/降级）。
- README/runbook 更新。
8. 原型 → 正式版衔接
8.1 保留
packages/domain：领域模型、状态机、Zod schema。packages/api-client：API 契约、错误码、分页/幂等。packages/ui：设计 token、组件、无障碍。- 权限矩阵、审计事件、数据分级。
- 仓库结构、ADR、CI。
- 演示脚本/页面信息架构。
8.2 替换
| 原型 |
正式版 |
| PocketBase |
FastAPI + PostgreSQL |
| 演示登录 |
企业微信 OIDC + Keycloak |
| Mock Agent |
真实 Agent 网关（Context/Tool/Event/Knowledge） |
| Taro H5 |
Taro 微信小程序（同代码提审） |
| seed 数据 |
真实数据库 + 迁移 |
| Demo Feature Flag |
环境配置/租户配置 |
| 本地部署 |
阿里云专属 VPC |
| 前端 Mock |
真实 API + 权限策略 |
8.3 四个阶段
| 阶段 |
时间 |
内容 |
| P0 原型 |
11/06–11/27 |
5 屏、3 哇点、演示 |
| P1 正式骨架 |
12 月 |
FastAPI/PostgreSQL、OIDC、权限、审计、真实 Agent 网关 |
| P2 业务补齐 |
1–2 月 |
客户/案件/诊疗/合同/回款/知识/OA 迁移 |
| P3 试点 |
2–3 月 |
1 个分所试点、UAT、性能/安全/等保 |
8.4 不能做的事
- 组件里写死演示数据。
- UI 直接读数据库/ PocketBase SDK；必须走
api-client。
- 为演示加“一次性 hack”不留 TODO/ADR。
- 改及锋核心代码。
- 把小程序当主端。
9. 风险与砍需求顺序
9.1 风险
| 风险 |
应对 |
| 3 人太薄 |
只做 P0；P1 全砍；A/C 关键路径互相备份 |
| 范围膨胀 |
11/08 脚本冻结；新增需求进“V1.1 清单” |
| 现场网络/模型故障 |
本地 PocketBase、预生成 Agent、备份视频 |
| 小程序审核 |
27 号用 H5；正式版再提审 |
| 视觉不够“哇” |
B 专注 5 屏；动效只做 3 个哇点 |
| 数据太假 |
合成但自洽；全场“演示数据” |
| 正式版推翻 |
API-first、领域模型、组件库、ADR |
9.2 砍需求顺序
- P1：知识检索、电子签模拟、录音转写、费用摘要。
- 驾驶舱图表 → 静态图/录屏。
- 小程序 → 录屏 + 展台。
- 动效 → 静态。
- 绝不砍：PC 角色切换、案件时间线、Agent 出文书、驾驶舱基础、审计。
10. 交付物清单
- 原型仓库（含 README、runbook、ADR）。
- 演示构建
dist/demo。
- 合成数据 seed 与重置脚本。
- 8 分钟脚本 + 备份视频。
- 一页纸、二维码、展台物料。
- Playwright 冒烟用例。
- 11/26 总彩排记录。
- 正式版迁移说明（本文件第 8 节）。
11. 彩排与验收
| 时间 |
内容 |
通过标准 |
| 11/22 |
彩排 1 |
8 分钟走通；3 个哇点可单独演示 |
| 11/23 |
彩排 2 |
断网可用；备份视频可播 |
| 11/26 |
总彩排 |
场地/大屏/网络/计时；两次完整走通 |
| 11/27 |
演示 |
舞台 + 展台 |
验收清单：
- PC 全屏 1920×1080，字号 ≥ 24px。
- 角色切换 ≤ 2 秒。
- Agent 3 个动作 ≤ 10 秒出结果。
- 断网时 P0 全部可用。
- 一键重置数据。
- 备份视频可播。
- 二维码可扫，客户视图正常。
12. 第一周每日任务（可直接执行）
11/06 周五
- A：评审 8 分钟脚本；列 5 屏清单；确认 PC 页面结构。
- B：收集视觉参考；Penpot 建 5 屏画板；定字体/配色。
- C：建仓库；pnpm workspace；Vite/React/TS/Tailwind/shadcn；PocketBase；CI 骨架。
- 全员：确认三人分工与每日节奏。
11/07 周六
- A：PC 壳、侧栏、顶栏、标签页、角色切换。
- B：设计 token、基础组件规范、大屏字号规范。
- C：PocketBase schema（客户/案件/阶段/动态/文书）、seed 数据、API 契约初稿。
11/08 周日
- A：工作台骨架 + 指标卡。
- B：客户视图 3 页线框；一页纸初稿。
- C：Demo Agent 骨架（3 个动作预生成）、重置脚本。
- 全员：脚本冻结；第一次内部可点演示。
11/09–11/13
- A：工作台 → 案件主线 → Agent 面板。
- B：客户视图页面 + 动效规范。
- C：API 联调、seed 完整、权限/审计事件。
- 11/13：M1 PC 核心可点。
13. 默认假设（不阻塞开发）
| 项 |
默认 |
| PC 外壳 |
时间够用 Electron；不够用浏览器全屏 |
| 小程序 |
27 号用 Taro H5；正式版提审 |
| 演示后端 |
PocketBase；正式版 FastAPI |
| 登录 |
演示账号切换；正式版企业微信 OIDC |
| 部署 |
本地笔记本 + 热点；正式版阿里云 |
| 数据 |
合成数据；无真实客户 |
| 团队投入 |
3 人全职；如非全职，按第 9 节砍需求 |
14. GitHub 参考
| 用途 |
仓库 |
| UI 组件 |
shadcn-ui/ui |
| 全栈模板 |
fastapi/full-stack-fastapi-template |
| 本地后端 |
pocketbase/pocketbase |
| 时间线 |
prabhuignoto/react-chrono |
| 图表 |
apache/echarts / recharts/recharts |
| 动画 |
motiondivision/motion |
| 表格 |
TanStack/table |
| 表单/校验 |
react-hook-form/react-hook-form / colinhacks/zod |
| 状态 |
pmndrs/zustand |
| 构建 |
vitejs/vite |
| CSS |
tailwindlabs/tailwindcss |
| 小程序/H5 |
NervJS/taro |
| 设计 |
penpot/penpot |
| 测试/录屏 |
microsoft/playwright |
| API mock |
mswjs/msw |
| AI SDK |
vercel/ai |
本文为原型开发执行方案；11/08 脚本冻结后，新增需求进入 V1.1 清单，不插入 11/27 演示。