卓卓安Claw项目方案库
展示首页/方案库/架构与实现
架构与实现

卓安Claw 任务对象 / 任务链 / DRI v1.0

约 5 分钟·卓安Claw · 2026.11
本页目录
  1. 0. 一句话
  2. 1. 数据模型
  3. zhuoan_task
  4. zhuoan_task_event
  5. zhuoan_task_contributor
  6. 2. 状态机
  7. 3. DRI 与 AI 参与
  8. 4. 任务链与 12 节点
  9. 5. API / UI
  10. 6. 权限与边界
  11. 7. V1.2 限制
  12. 8. 下一步

日期：2026-11-13
状态：V1.2 已落地（任务看板 + 认领/DRI/AI 参与 + 新建任务 + 从清单生成 + 贡献汇总 + 12 节点联动 + Agent 提议任务）
关联：卓安Claw-AI原生办案系统-设计需求-v1.0.md、卓安Claw-下一步工作计划-2026-11-13.md

0. 一句话

案件是业务容器，任务才是基本工作单元。任务链把「引流→邀约→转化→交付→维护→复购转介」串起来，每个任务有执行人、DRI、复核人、AI 参与记录和贡献记录。

1. 数据模型

zhuoan_task

字段 说明
case_id 所属案件
chain_stage 引流/邀约/转化/交付/维护/复购转介
stage_key 对应 12 节点（可选）
title/description 任务标题与说明
status 待认领/进行中/待复核/已完成/已取消
priority 高/中/低
owner_user_id/name 执行人
dri_user_id/name 最终负责人（DRI）
reviewer_user_id/name 复核人
created_by 创建人
ai_role 无/辅助/主导
ai_note AI 参与说明
due_at 截止日期
quality_score/efficiency_score/client_score 多维评价
risk_level 风险标记
completed_at 完成时间

zhuoan_task_event

只追加事件：created/claim/start/submit/complete/return/cancel，记录 actor、actor_type（human/ai/system）、detail、时间。

zhuoan_task_contributor

任务贡献：user_id/user_name/role/weight/note。默认写入执行人（执行）、DRI（DRI）、任务链阶段贡献。后续分配/评价按这张表汇总。

2. 状态机

待认领 → 进行中 → 待复核 → 已完成
             ↑        │
             └─ 退回 ─┘
任意状态 → 已取消（管理者/DRI）
  • 认领：待认领 → 进行中，写执行人。
  • 提交复核：进行中 → 待复核。
  • 完成：待复核/进行中 → 已完成（管理者/DRI/复核人）。
  • 退回：待复核 → 进行中。
  • 取消：管理者/DRI。

所有动作写 zhuoan_task_event 和案管审计。

3. DRI 与 AI 参与

  • 执行人：实际做任务的人。
  • DRI：对结果最终负责的人，可以不是执行人。
  • 复核人：结案/质量/高风险任务的复核者。
  • AI 参与：ai_role=辅助/主导 + ai_note 说明 AI 做了什么；AI 不能直接把任务标完成，必须由人提交/复核。
  • Agent 在案件上下文里能看到任务摘要；可用 propose_task 生成待确认任务，律师确认后才写库。

4. 任务链与 12 节点

  • 任务链是跨节点的业务链：引流/邀约/转化在谈案阶段，交付在办案阶段，维护在结案后，复购转介回到线索。
  • stage_key 记录任务对应的 12 节点；新建任务时必须从 12 节点里选（默认当前节点），后端校验枚举。
  • 案件图顶部 12 节点条显示每个节点的未完成任务数；案件概览新增「本案任务」卡，列出未完成任务、DRI、截止日期与状态。
  • 点任务行进入任务链看板；任务操作后节点计数和本案任务卡同步刷新。
  • 任务完成不会自动推进节点：节点推进仍需律师在「当前节点」确认，避免任务状态倒逼案件状态。

5. API / UI

  • GET /api/zhuoan/tasks?scope=all|mine&case_id=&status=：任务列表 + 状态/任务链汇总。
  • GET /api/zhuoan/tasks/members：执行人/DRI/复核人候选。
  • GET /api/zhuoan/tasks/contributions：按人/角色汇总任务数、完成率、质量分、AI 参与、按时率、权重。
  • POST /api/zhuoan/tasks：创建任务（需案件权限/客户权限）。
  • POST /api/zhuoan/tasks/from-checklist：从案件未完成清单项生成任务，按标题去重。
  • PATCH /api/zhuoan/tasks/<id>：claim/start/submit/complete/return/cancel/patch。
  • 工作台返回 myTasks + taskSummary。
  • Agent zhuoan_case 上下文增加 tasks 摘要（含 stage_key）。
  • Agent propose_task：参数 task_title / chain_stage / stage_key / due_at / reason，只写 zhuoan_agent_action(kind=task)；律师在「Agent 待确认」点确认后由 POST /api/zhuoan/actions/<id>/confirm 调 create_task 写库。
  • 前端侧栏「案件办理 → 任务链」：任务链计数条 + 四列看板 + 新建任务 + 从清单生成 + 贡献汇总 + 认领/提交/完成/退回。
  • 案件图：12 节点任务徽标 + 本案任务卡 + 新建任务默认绑定当前节点。

6. 权限与边界

  • 任务列表按当前账号数据范围过滤案件；不能看未授权案件的任务。
  • 创建/操作任务需 case:edit 或 customer:view；完成/退回/取消按管理者/DRI/复核人校验。
  • 任务只存结构化工作记录，不复制案卷全文；C 类材料引用仍受原有权限约束。
  • 任务评分用于复盘/评价，不直接发钱；分配规则要可解释、可申诉。

7. V1.2 限制

  • 只显示未完成任务数，不显示节点内任务排序/拖拽；节点卡不能直接改任务状态。
  • Agent 只能提议“新建任务”，不能提议改任务状态/改 DRI/改截止日期。
  • 任务提醒/超期通知未接。
  • 贡献汇总按“人×角色”展示，同一人多角色会多行；后续可加“按人聚合”视图。
  • 任务级财务归因未做：财务仍按案件归因，未拆到任务。
  • 评分用于复盘/评价，不直接发钱；分配规则要可解释、可申诉。

8. 下一步

  1. 任务提醒：超期/临期接入现有 reminder worker，推送站内/企微。
  2. Agent 提议改任务状态/DRI/截止日期，仍走待确认动作。
  3. 节点任务看板：节点内按状态分组、拖拽改状态（走审计）。
  4. 贡献按人聚合视图 + 任务级工时/财务归因。
  5. 任务模板：按案件类型/节点预置任务清单。