计划与路线
卓安Claw P1:任务链、分诊、经营数据、文件补齐(2026-11-13)
本页目录
定位:11/27 之后的 P1;如果提前启动,必须隔离开发,不改演示主线。
四项来源:任务对象/任务链/DRI/任务级归因;分诊承办律师分配+预约排期;经营数据录入/导入;文件 V1 补齐。
关联:卓安Claw-下一步工作计划-2026-11-13.md、卓安Claw-AI原生办案系统-设计需求-v1.0.md、ADR-004-数据先存后处理.md
0. 结论
四项不是并列的四个功能,而是一条依赖链:
A 任务对象/任务链/DRI/归因 是地基;
B 分诊分配/预约 产生任务和责任人;
C 经营数据录入/导入 把收入/成本/退费归到任务/案件;
D 文件 V1 补齐 为任务和归因提供证据与引用。
推荐顺序:A → B → C → D;其中 C、D 可以在 A 的 schema 稳定后并行。
11/27 前不建议动 A 的写路径和现有 12 节点/结案门禁;如果现在启动,先做隔离分支 + 只读任务链 + 新表,不改演示数据。
1. A:任务对象、任务链、DRI、任务级归因(约 2 周)
1.1 为什么先做
- 现在的 12 节点和清单是“合规检查”,不是“任务”:没有明确谁做、谁复核、AI 参与多少、贡献怎么算。
- 没有任务对象,分诊只能分案件,不能分任务;经营归因只能到案件,不能到人/AI/环节。
- DRI 和分配制度需要“任务级证据”,否则会变成拍脑袋。
1.2 最小数据模型
zhuoan_task (
id, case_id, chain_key, stage_key, checklist_item_id,
title, task_type, status, priority,
owner_user_id, reviewer_user_id, created_by,
due_at, started_at, submitted_at, completed_at,
ai_role, ai_tools, ai_contribution,
attribution_json, attribution_status,
created_at, updated_at
)
zhuoan_task_event (
id, task_id, event_type, actor, note, created_at
)
chain_key:引流/邀约/转化/交付/维护/复购,或 12 节点 key。status:待认领/进行中/待复核/已完成/已取消。ai_role:无/辅助/起草/自动执行;ai_contribution只记录事实,不自动算钱。attribution_json:案源/主办/协办/复核/AI 辅助的贡献草稿;必须人工确认。checklist_item_id:可关联现有清单项,避免“任务”和“清单”两套状态打架。
1.3 最小闭环
- 从清单生成任务,或手建临时任务。
- 律师认领/管理员指派;一个任务一个 DRI。
- 进行中→提交复核→复核通过→完成;每次状态写
task_event。 - 任务详情显示:谁做、何时、AI 参与、谁复核、证据链接。
- 结案时生成归因草稿;管理者确认后才进入分配参考,不直接发钱。
1.4 验收
- 一个案件能拆出 6–10 个任务,责任人和复核人清楚。
- 任务状态变化全部有事件和审计。
- 任务能关联案件节点、清单项、文书/证据。
- 归因草稿可解释、可修改、可申诉;不自动分配。
- Agent 能读任务链,但写操作仍只提议。
2. B:分诊承办律师分配 + 预约排期(约 1 周)
2.1 分诊分配
候选律师评分:
- 城市/分所匹配
- 罪名/案由专长匹配
- 当前负荷(在办任务/案件数)
- 利益冲突预筛
- 质量分/客户评分
- 是否可承接(状态、排期)
动作:推荐 → 管理员/谈案确认 → 生成承办任务 → 通知 → 审计。
不做“黑箱自动分配”;推荐分可解释、可覆盖。
2.2 预约排期
- 预约登记:客户、时间、地点/线上、案由、来源。
- 律师时段:可用/已占用;避免重复。
- 提醒:24 小时/1 小时;企微/短信后置。
- 到店/线上签到 → 接诊记录 → 转案件。
2.3 验收
- 分诊页能看到候选律师和推荐理由。
- 分配后生成任务,责任人收到待办。
- 预约不重叠;取消/改期留痕。
- 冲突命中时不能直接分配,需平台/管理员裁决。
3. C:经营数据录入/导入(约 1 周,可与 D 并行)
3.1 要补的不是报表,是数据来源
当前经营分析 V2 是种子数据;管理者会问“数据从哪来”。最小闭环:
- 线索事件:创建/联系/邀约/上门/接诊/签约/流失(表单或 CSV)。
- 渠道成本:渠道 × 周期 × 金额。
- 财务:合同额/到账/退费/成本/结果/客户评分。
- 月份/周期筛选:总览、渠道、漏斗、律师、财务、质量联动。
3.2 导入规则
- CSV 模板 + 字段校验 + 错误行回显。
- 幂等键:渠道+周期、案件+财务类型、线索+事件时间。
- 导入写审计;不覆盖已审核财务,只新增版本/更正记录。
- 演示数据标记
demo=true,不与真实数据混算。
3.3 验收
- 一条线索从创建到签约的事件可录入/导入。
- 渠道成本导入后 CAC/ROI 变化可解释。
- 财务退费/复购口径与门店报表一致。
- 切换月份数字变化;空数据不报错。
4. D:文件 V1 补齐(约 1 周,可与 C 并行)
4.1 旧文书回填
- 对现有
document.file_path计算 SHA-256,复制到内容寻址 blob 层,保留原文件不动。 - 建
zhuoan_doc_version映射;入解析队列;失败不阻断。 - 回填报告:成功/跳过/缺失/哈希不符。
4.2 删除清理
- 删除审批 + 墓碑 + 保留期;派生层(FTS/artifact)先删,原件最后删。
- 引用计数:同一 blob 多案件引用时,只删引用,不删 blob。
- legal hold 禁止删除。
- 审计:谁删、为什么、何时、删了什么。
4.3 页级 OCR
- 仅对扫描页/图片页按需 OCR;文字页保留原结构。
- OCR 输出标记
[OCR],引用前必须核对原件页图;不得直接当MATCH_BODY。 - OCR 失败保留
[NO EXTRACTABLE TEXT]和安装提示。 - C 类默认本地 OCR,不送外部模型。
4.4 验收
- 旧案件文书可检索,原件哈希可验证。
- 删除后 FTS/artifact/引用清理干净,审计完整。
- 扫描 PDF 可按页 OCR,引用带
[OCR]标记。 - 删除/回填都不破坏上游
document表兼容。
5. 排期建议
| 周 | 工作 | 产出 |
|---|---|---|
| 11/28–12/5 | A 任务对象 + 任务链 + DRI + 事件 | 表/API/任务链页面/验收 |
| 12/6–12/12 | A 归因草稿 + B 分诊分配/预约 | 归因确认、候选律师、预约时段 |
| 12/8–12/15 | C 经营录入/导入(并行) | 表单/CSV/月份筛选 |
| 12/8–12/15 | D 文件补齐(并行) | 回填/删除/页级 OCR |
| 12/16–12/20 | 联调 + 回归 + 文档 | P1 验收报告 |
6. 11/27 前的边界
- 不在演示分支做 A 的写路径/数据库迁移;如需启动,用独立分支或 feature flag。
- 不改现有 12 节点、清单、结案/归档门禁的默认行为。
- 不把任务系统半成品放进 11/27 演示,避免“功能讲了但点不通”。
- 11/27 前仍以彩排/录屏/演示数据为主。
7. 第一刀建议
先做 A 的只读骨架:
zhuoan_task/zhuoan_task_event建表。- 从现有清单生成任务(幂等,不双写状态)。
- 案件页增加“任务链”只读视图:任务、DRI、状态、AI 参与、复核人。
- 不改清单/节点写路径;先让任务可见,再开认领/复核。
这样既能开始 P1,又不会把 11/27 演示搞崩。