架构与实现

卓安Claw 经营数据录入/导入 v1.0

约 5 分钟·卓安Claw · 2026.11

本页目录

日期：2026-11-13
状态：案件财务、渠道成本、线索事件录入与 CSV 导入已落地；审批流/凭证附件待做
关联：卓安Claw-任务链-v1.0.md、卓安Claw-预约排期-v1.0.md

0. 一句话

经营分析不能只靠演示种子。把案件财务、渠道投放成本、线索事件变成管理者可录入、可批量导入、可审计的数据入口，报表的每个数字才能追到来源。

沿用已存在的 zhuoan_* 扩展表，不改上游案管表：

字段：

财务：contract_amount / received_amount / cost_amount / refund_amount / outcome / client_rating / notes。
渠道成本：channel / period(YYYY-MM) / cost / note。
线索事件：intake_id / event_type / event_at / actor / note；事件类型 created/contacted/invited/visited/consulted/signed/lost。
线索渠道、质量分、签约金额仍在 zhuoan_lead_ops，本次未开单独表单，先通过已有种子/后续线索表单维护。

口径不变：

方法	路径	说明
GET	`/api/zhuoan/ops`	增加 `entry`：可录入案件（含当前财务）、线索、渠道、已有账期
POST	`/api/zhuoan/ops/finance`	保存案件财务；`case_id` 必填
POST	`/api/zhuoan/ops/channel-cost`	保存渠道成本；`channel/period/cost` 必填
POST	`/api/zhuoan/ops/lead-event`	追加线索事件；`intake_id/event_type` 必填
POST	`/api/zhuoan/ops/import`	CSV 导入：`{kind: finance\|channel_cost\|lead_event, text}`

校验：

case_no,contract_amount,received_amount,cost_amount,refund_amount,outcome,client_rating,notes
ZA-2026-0318,150000,80000,30000,0,在办,4.6,首付款已到账

channel,period,cost,note
抖音,2026-11,8000,信息流投放
转介绍,2026-11,10000,渠道维护

intake_id,event_type,event_at,note
<线索ID>,visited,2026-11-13 10:00,客户到所面谈

也支持中文表头别名（案件编号/合同额/已收/成本/退款/渠道/账期/事件类型/事件时间/备注）。

「经营分析 → 经营数据」：

保存/导入后自动刷新经营分析，复用原有总览/渠道/漏斗/律师/盈利/质量页签。

仅 ops:view（管理者）可录入/导入；服务端 403，不靠前端隐藏。
客服、客户经理、谈案/承办律师看不到经营分析，也不能写经营数据。
审计动作：zhuoan_ops_finance_saved、zhuoan_ops_channel_cost_saved、zhuoan_ops_lead_event_added、zhuoan_ops_csv_imported。

GET /api/zhuoan/ops：10 个可录入案件、6 条线索、4 个渠道、账期 2026-11。
财务保存：合同 88,888 / 已收 50,000 / 成本 12,000 / 退款 1,000 → 201，报表口径随刷新变化。
渠道成本：2026-10 / 1,234 → 201。
线索事件：contacted → 201。
CSV：渠道成本 2 行 → imported 2；无效案件编号 → imported 0 / skipped 1 / 错误定位到第 2 行。
Playwright 1920×1080：经营数据页签 3 个表单、10 个案件选项、6 个线索选项；渠道成本保存与 CSV 导入成功，0 console error；截图 C:\tmp\ops-entry.png。
测试写入已清理，未污染演示数据。