RING 01 / 开源
让客户先来问
把官网、公众号、企微、表单、搜索、AI 问答、转介绍和内容平台接成一条可算账的获客链。
- 渠道连接器：官网 / 企微 / 表单 / 公众号
- SEO + GEO：内容矩阵、FAQ、AI 引用监测
- 线索六字段、查重、评分、A/B/C
- 分配、首触 SLA、公海与培育池
- 首次来源归因 + 渠道 ROI
主指标：有效线索数 / 24h 首触率 / 渠道 ROI
系统架构建议稿 · V1.02026-11-05内部讨论版
一条主干跑通，
五环插件赋能。
以华为增长三轮为业务主干，把 LTC 从线索、订单、交付到回款完整跑通；把开源、变现、练兵、激励、经营做成五个可开关、可配置、可扩展的插件，共用一套客户 ID 和数据底座；AI 不替代流程，只在每个关键节点当参谋。
01 / ARCHITECTURE MAP
一页主架构
上层是四种角色的工作入口，中层是增长三轮主干与五环插件总线，下层是AI 能力中台、企业系统连接器、统一数据底座。插件只增强主干，不另造流程；外部系统只经连接器接入，不直连数据库。
制图依据：增长三轮模型（MTL / LTC / 铁三角）与业绩五环顶层设计；交付、MES、ERP、回款为本次架构新增的延伸层。
图 1 / 6
P01
一条主干，五环增强
五环不另造流程，只增强主干上的节点。
P02
共用客户 ID
线索、商机、订单、回款必须能追到同一个人/企业。
P03
插件不互读表
只走标准 API 与事件，避免五个系统各自都对、合起来全错。
P04
连接器统一接入
外部系统不直连数据库；主数据归属先定，再谈同步。
P05
AI 建议，人确认
抽取、评分、预测都可解释；AI 不直接写业务库。
P06
指标实时算
从动作与交易算，不落人工填报的指标表。
02 / VALUE STREAM
LTC 主干：七段、五闸、三条线
华为 LTC 的骨架保留：分阶段、有评审、看数据、回款才算完。但中小企业不能照搬大客户流程，所以这里把交付验收单独展开，并把闸门做成两道硬闸 + 三道可配置闸。交付和回款不是本系统的自说自话，必须由 MES / ERP / 财务系统回写事实。
七段是业务主线的展开，不代表所有客户都要一次启用；SME 首版默认只硬控 G1 商机成立与 G3 报价过审。
图 2 / 6
三条铁律：一段一件证据；一单一个下一动作；钱到账才算完成。任何一条缺失，漏斗就会变成“业务员自己填进度”的装饰。
- 四路落账：客户、需求、金额、时间。少一路，商机不成立；但允许先保存后补齐，每天推一次，不一次拦死。
- 下一动作：动作 + 日期 + 负责人，三样缺一，经理屏标灰；“继续跟进”“保持联系”设为敏感词。
- 停滞预警：超过阶段平均停留 1.5 倍自动亮灯；交付与回款卡点由外部系统事件触发，不靠人记。
- 丢单归因：只能选六类 + 一句话，不填不许关单；每周把真实丢单变成练兵考题。
- 回款计划：合同生效即拆期次；提前 7 天、3 天、当天、逾期每 3 天提醒；坏账看行为变化，不只看财务数据。
4
外部系统只在四个位置介入：合同系统管用印与正文，OA 管审批，MES / ERP 管交付事实，金蝶 / 用友管应收与到账。其余过程数据由本系统承载，避免“五个系统都有一份客户”。
| 闸门 | 过闸条件 | 默认 | 过不去 |
|---|---|---|---|
| G1 商机成立 | 四路落账齐 + 明确时间窗 | 硬闸 | 退回线索池，30 天后可再提 |
| G2 方案过审 | 决策链画清 + 交付期确认 | 可配置 | 卡住，系统每日提醒 |
| G3 报价过审 | 让价在权限内或上级已批 | 硬闸 | 超权限锁死提交，自动上浮 |
| G4 合同生效 | 合同有回款计划 + 用印完成 | 可配置 | 无回款计划不许进交付 |
| G5 验收回款 | 验收单 + 到账流水 | 可配置 | 交付卡点 / 逾期预警 |
03 / FIVE RINGS
五个插件，各管一段“人”的问题
五环不是五个并列的系统，而是围绕同一条主干安装的五个能力包：开源解决信息从哪来，变现解决单子怎么成，练兵解决人不会谈，激励解决队伍没劲，经营解决目标拆不下去。每一环都可以单独开通、单独配置，但共用客户、商机、动作和目标。
RING 02 / 变现
把单子打下来
让“跟到哪一步、卡在哪、谁能批价、为什么丢”变成系统里点得出来的事实，而不是周会上的感觉。
- LTC 六段 + 五闸 + 交付回款
- 四路落账、决策链、铁三角共背
- 报价与让价权限、审批时限
- 丢单 12 类归因、健康度、下一动作
- 回款计划、逾期预警、周预测
主指标：阶段转化率 / 成单周期 / 回款率
RING 03 / 练兵
把人练出来
每天 20 分钟，用客户 Agent 对练、复盘、认证，把“会干的人”批量造出来，而不是靠师傅悟性。
- 晨读、对练、三问复盘、带教
- 客户人设库 / 话术库 / 案例库
- 能力四级认证与认证明细
- 能力等级回写派单：难单给高等级
- 录音、转写、评分与合规隔离
主指标：人均周练次数 / 认证率 / 上手周期
RING 04 / 激励
让人想打
荣誉不产生线索，但能让同一个人多跑一趟、敢开口、愿意被指出问题。它是油门，不是传动轴。
- 一年四仗：从春节回来那天算
- 三张榜：业绩 / 过程 / 进步
- 评功六步、照片留痕、战报
- 预算四层、门票名额算法
- 与变现、练兵、开源共享动作数据
主指标：参与率 / 达标率 / 榜单打开率
RING 05 / 经营
让目标落地
老板拖一根滑块定上浮，系统拆到仗、月、周、人；每周盯一次，落后的有人帮，预测有口径。
- 七项指标：三结果、四过程
- 年 → 仗 → 月 → 周 → 人四刀分解
- 军令状、周盯、帮扶台账
- 下月成交单数与金额预测
- 老板屏、经理屏、个人“我的今天”
主指标：目标拆到人比例 / 预测偏差 / 缺口关闭率
五环怎么咬合：开源把线索交给变现；变现把单与回款交给经营和激励；练兵把能力等级交给变现用于派单；经营把目标值回写给全部；激励只加油门，不单独算产出。任何一环都不能直接读另一环的表。
- 开源 → 变现：线索六字段 + 首次来源，转商机时一次性带过去。
- 变现 → 经营 / 激励：阶段、金额、回款、丢单原因，实时 / 每日同步。
- 练兵 → 变现：能力等级与对练分，每日一次，用于难单派给谁。
- 经营 → 全部：年、仗、月、周、人目标，每月一次。
| 你提的能力 | 落在哪个插件 | 关键机制 |
|---|---|---|
| a. 获得线索 / 主动咨询 | 开源 | 渠道连接器 + 内容中台 + SEO/GEO + 官网/公众号/企微/表单留资 |
| b. 识别有效线索 | 开源 | 六字段门槛 + 查重 + 规则评分 + A/B/C + 退回通道 |
| c. 分配 / 每日跟踪 / AI 军师 / 转订单 | 开源 + 变现 | 分配回收 + 首触 SLA + LTC 阶段 + 下一动作 + 销售 Agent |
| d. 各渠道线索订单转化率 | 开源 + 经营 | 首次来源归因 + 漏斗转化 + 渠道投入产出 + 老板屏下钻 |
| e. 预测下月订单 / 金额 | 经营 | 04 以上商机加权 + 历史转化 + 季节/工作日 + 三口径预测 |
04 / PLUGIN CONTRACT
插件机制：像装应用一样装五环
插件不是“五个独立数据库”。每个插件提供清单、配置、权限、扩展点、事件契约，由底座装载；插件之间只走标准 API / 事件，不互相读表。第一版建议用模块化单体实现，后续再把高负载的 AI、连接器拆成独立服务。
插件五条铁律：不直连别人的库；不私建客户 ID；不绕过权限；不静默写业务事实；不能卸载后带走核心数据。做到这五条，插件才能既独立又统一。
- Manifest：ID、版本、依赖、配置 Schema、权限点、菜单与 UI 插槽。
- Extension points：老板屏卡片、经理工作台、商机详情页签、流程节点、报表下钻。
- Event contract：发布什么、订阅什么、幂等键是什么、失败如何补偿。
- Data boundary：核心表共享；插件私有表加命名空间；分析只读数据仓。
- Lifecycle：安装 → 配置 → 试运行 → 验收 → 升级 / 停用；停用不删历史事实。
- Role assembly：同一插件对不同角色只开放不同的数据范围与动作，不复制五套页面。
# plugin.manifest.yaml id: ring.revenue name: 变现 / LTC version: 1.0.0 requires: - core.identity@1 - core.customer@1 - core.deal@1 - ai.extract@1 slots: - workbench.card.sales - deal.detail.tab - boss.widget.pipeline publishes: - deal.stage_changed - quote.approved - payment.received subscribes: - lead.qualified - training.level_changed config_schema: config/revenue.schema.json data_scope: tenant → org → team → self ai_policy: suggest_only; write_after_confirm
插件清单是安装合同；字段、流程、权限、UI 都从这里声明。代码示意
| 插件 | 发布事件 | 订阅事件 | 私有数据 | 给谁装配 |
|---|---|---|---|---|
| 开源 | lead.created lead.qualified lead.assigned | deal.won deal.lost | 渠道、内容、活动、培育池 | 市场 / 经理 / 销售 |
| 变现 | deal.stage_changed quote.approved order.confirmed payment.received | lead.qualified delivery.updated training.level_changed | 商机、报价、合同、回款计划 | 销售 / 方案 / 交付 / 内勤 |
| 练兵 | training.completed training.level_changed | deal.lost deal.stage_changed | 人设、对练、评分、认证 | 销售 / 组长 / 经理 |
| 激励 | award.granted campaign.closed | deal.won payment.received training.completed | 战役、榜单、预算、名额 | 全员 / 老板 |
| 经营 | target.published forecast.updated | deal.stage_changed payment.received lead.qualified | 指标、目标、军令状、帮扶 | 老板 / 经理 / 组长 |
事件命名是域对象 + 过去式；每个事件必须带 tenant_id、occurred_at、idempotency_key 和最小必要字段。表 1
05 / AI MIDDLE PLATFORM
AI 是参谋，不是第五个老板
AI 统一走中台，按场景分流模型：抽字段、分类、打分用便宜模型；写反馈、写方案、做解释用好模型。所有 AI 输出都要可解释、可回读、可拒绝；凡是要写业务事实的动作，必须经过人确认。
AGENT 01 / 获客
内容与 GEO 参谋
根据行业问题、搜索词、AI 问答引用情况，生成选题、FAQ、案例卡和落地页框架；发布前由市场确认。
读：内容库 / 搜索监测 · 写：草稿箱
AGENT 02 / 线索
线索鉴定官
补全企业信息、识别角色与意图、查重合并、解释评分；低置信度只提示，不自动降级或丢弃。
读：线索 / 渠道 · 写：建议分 / 建议合并
AGENT 03 / 销售
销售军师
每天从 50 条线索里挑 3 家：为什么去、见谁、对方背景、决策人是谁、第一句话、要拿回的下一步。
读：客户 / 商机 / 动作 · 写：今日建议卡
AGENT 04 / 交付
交付与回款预警官
把 MES 工单、验收单、应收台账翻译成“哪一单会晚、晚了几天、卡在谁那里、今天该找谁”。
读：MES / ERP / 应收 · 写：风险事件 / 任务
AGENT 05 / 经营
预测分析师
用确定性模型算加权预测、历史转化和三种口径；AI 只负责解释“为什么比上周少了 240 万”。
读：商机 / 历史 · 写：预测快照 / 解释
AGENT 06 / 练兵
教练与复盘官
扮演客户对练、按五个动作打分、给一句人话反馈；把丢单和录音变成下一周的训练题。
读：录音 / 话术库 · 写：训练记录 / 反馈
AI 军师每天怎么工作：先读客户卡与最近动作 → 再看阶段、金额、停滞天数 → 匹配行业案例与话术 → 给出 3 个候选动作 → 销售选一个 → 系统生成拜访前简报 → 拜访后语音落账 → 更新下一动作。建议被采纳、被拒绝、最终成单，都会回写，形成排序训练数据。
ASR / OCR信息抽取意图识别线索评分赢率预测RAG 问答方案草稿话术生成会议纪要预测解释对练评分异常检测
| 边界 | 规定 |
|---|---|
| 写库 | AI 只能写草稿、建议、任务；业务事实经人确认后由 API 写入 |
| 可解释 | 评分、预测、推荐必须给出依据字段与权重，不能只给一个分数 |
| 可拒绝 | 销售可一键忽略建议；忽略原因进入评估，不进入个人考核 |
| 数据隔离 | 租户隔离、字段级权限、PII 脱敏；客户数据不进入公共训练 |
| 模型分流 | 抽取/分类用便宜模型；生成/解释用好模型；TTS 必须缓存 |
| 评测 | 离线金标集 + 线上采纳率 / 成单率 / 预测偏差；提示词版本可回滚 |
06 / CONNECTORS
企业系统接入：客户习惯不变，数据统一进来
接入的原则是先定主数据归属，再做同步。有 CRM 的客户，CRM 继续管客户主数据；有 ERP 的客户，ERP 继续管订单与回款；本系统补的是过程、行为、判断和 AI，不抢财务的账。所有系统经连接器映射到统一模型，不点对点写死。
| 系统 / 域 | 接什么数据 | 方向 | 接入方式 | 主数据归属与注意 |
|---|---|---|---|---|
| 企业微信 / 钉钉 / 飞书 | 组织、人员、免登、消息、审批、表单、外部联系人 | 双向 | OAuth2 / 通讯录 API / 消息卡片 / Webhook / 审批回调 | 身份与组织以办公平台为准；客户行为以本系统为准；消息只推处理项，不做群发骚扰 |
| CRM | 客户、联系人、商机、跟进记录、合同 | 双向 | OpenAPI / Webhook / 中间表 / 批量导入 | 有 CRM 则 CRM 为客户主数据；本系统做 LTC 过程与 AI 建议；按外部 ID 映射，冲突写审计 |
| MES | 工单、生产进度、质量、交期、异常卡点 | 入 | REST / Webhook / 只读视图 / 定时增量 | 交付事实以 MES 为准；只取订单号、节点、预计完成日、卡点原因，不复制工艺数据 |
| 金蝶 / 用友 / ERP | 订单、库存、应收、收款、发票、客户档案 | 双向 | OpenAPI / 中间表 / 文件交换 / 财务接口 | 订单与回款以 ERP / 财务为准；本系统只读回款事实，提成与工资不进系统 |
| OA / 合同 / 电子签 | 审批流、用印、合同状态、合同附件 | 双向 | API / 回调 / 文件同步 | 合同正文留在原系统；本系统只存合同要素与状态，避免版本冲突 |
| 官网 / CMS / 表单 | 访问、留资、UTM、企微二维码、咨询记录 | 入 | JS SDK / 表单 Webhook / 开放 API | 首次来源写入不可覆盖；表单只收必要字段，附隐私同意 |
| 小红书 / 抖音 / B站 / 公众号 | 内容、评论、私信、留资、活动报名 | 双向 | 官方开放平台 / 授权 API / 导出文件 / 企微承接 | 平台接口能力有限，优先把流量承接到官网/企微/表单；不做违规爬虫 |
| 搜索 / AI 问答 | 品牌词、行业词、AI 引用、提及与排名 | 入 | 搜索 API / 监测服务 / 人工抽检 | 只做 SEO/GEO 监测与内容优化，不抓取客户个人信息 |
| Excel / 邮件 / 文档 | 历史台账、合同、报价、SOP、培训资料 | 入 | 模板导入 / 邮件解析 / OCR / 大模型抽取 | 先入暂存区，人审后入正式库；抽取结果必须回读确认 |
“双向”不等于双向随便写；每个字段只能有一个主系统。连接器负责协议、映射、重试、幂等、审计，不承载业务规则。表 2
零改造入口：销售不必离开企微/钉钉/飞书，老板不必学新系统，财务不必改 ERP。所有入口都汇到同一个事件总线，再落到统一客户 ID。
- 办公平台内嵌：免登 H5、消息卡片、审批、表单，直接办任务。
- 语音 / 拍照 / 转发：一段话或一张名片，30 秒录线索；AI 抽字段，人回读确认。
- Excel / 邮件：历史台账、订单、回款批量进；不要求客户一夜换系统。
- OpenAPI / Webhook：客户自有系统、官网、表单、MES、ERP 主动推事件。
- 文档抽取：合同、报价、SOP、案例上传后自动切分、打标、入知识库。
1
一次采集，四路落账：业务员只看到“传”一个按钮；系统同时生成客户、需求、金额、时间四路，并分发给开源、变现、经营、激励。出现第二次输入，这套系统就会被放弃。
# 合同 / SOP / 表单进入系统
上传或 API 拉取
→ OCR / 版面解析
→ 字段抽取（客户、金额、日期、条款）
→ 人工回读确认
→ 业务库（结构化）
→ 切分 / 打标 / 权限
→ 向量库 + 全文索引
→ AI 军师 / 客服 / 经营问答可检索
07 / ROLE EXPERIENCE
同一份数据，四个高度
老板和销售不是两块屏，是同一块屏的两个高度。底层数据完全一样，老板默认折叠到部门 / 战役层，经理展开到人，销售只看到自己。角色不是写死的岗位名，而是数据范围 + 功能点 + 插件开关的组合。
总经理 / 全公司 · 2026-11-05
团队层 · 可下钻
界面示意 · 示例数据
今日签约
3单 / 86万
本月累计 42 单 / 1,260 万
今日回款
318万
本月回款率 82% · 逾期 6 单
交付卡点
7单
缺料 3 · 验收未回 2 · 排产冲突 2
本月缺口
240万
加权预测完成率 91%
全员在 LTC 的哪一步人 / 单
线索
126
待首触 18
商机
48
停滞 9
方案报价
21
待审批 5
合同
9
待用印 4
交付
14
卡点 7
回款
6
逾期 2
今天必须处理按影响金额 × 紧急度
- 交付卡点 3 单：MES 缺料、验收单未回，预计影响本月回款 96 万。
- 预测缺口 240 万：S4 以上商机不足，需决定是否提前启动老客户复购。
- 重点单 2 单：报价超权限，等老板拍板；审批已停 26 小时。
老板默认看团队层；要看某个人，多点一次。排名只到团队层，成本、毛利、提成不对销售公开。
销售 / 本人 · 50 条在跟
今日建议 3 家
界面示意 · 示例数据
今日目标
2个下次约见
1 份方案 · 1 个决策人确认
本月个人
68万
达标 86 万 · 还差 18 万
AI 建议先跑这 3 家为什么是现在
A 包装厂 · 老板A · 82
“王总，上次您问的 7 天交期，我带了两个同行的做法，今天下午给您 10 分钟？”
下一步 · 今天约周五现场，带上交期对比表
B 食品厂 · 采购负责人B · 61
“李经理，您上次提到下季度要换线，我想约技术负责人一起看现场，避免方案反复。”
下一步 · 今天 16:00 前约下周技术会
C 电子 · 老板A · 76
“陈总，您看的那个交期案例，关键不是设备，是排产规则；我把三条规则发您？”
下一步 · 今天 11:00 前电话，拿到需求时间窗
建议来自客户卡、动作、阶段和案例库；销售可以换人、换顺序、写“不采纳”的原因。AI 只建议，不替销售发消息。
老板屏回答“公司今天怎么样、卡在哪、谁在干什么”；销售屏回答“我今天去哪、见谁、说什么、拿到什么下一步”。图 3 / 6
| 角色 | 默认数据范围 | 开源 | 变现 | 练兵 | 激励 | 经营 | 首屏 |
|---|---|---|---|---|---|---|---|
| 总经理 / 老板 | 全公司 | 配置 + 看板 | 全量 + 审批 | 汇总 | 配置 | 全量 | 签约 / 回款 / 交付卡点 / 预测 |
| 部门经理 | 本部门 | 分配 + 渠道 | 全量 + 陪访 | 查看 + 带教 | 查看 | 目标 + 周盯 | 部门漏斗 / 线索分配 / 周预测 |
| 科长 / 组长 | 本科室 | 录入 + 跟单 | 本科室单 | 带教 + 认证 | 查看 | 组目标 | 本科室任务 / 陪访 / 过程分 |
| 工程师 / 销售 | 本人 | 录入 + 首触 | 自己的单 | 对练 + 认证 | 看自己 | 看自己目标 | 我的今天 / 线索 / 3 家建议 |
| 市场 / 内勤（可配） | 线索池 / 本部门 | 渠道 + 培育 | 回款计划 | — | 榜单执行 | 渠道 ROI | 渠道账本 / 培育池 / 回款待办 |
| 方案 / 交付（可配） | 被指派单 | — | 方案 / 交付 | 案例贡献 | — | — | 方案任务 / 交付节点 / 卡点 |
表内“配置 / 全量 / 查看 / 录入 / 看自己”是功能点，不是岗位描述。一个 20 人团队里老板兼总负责人、老销售兼内勤，系统必须允许一人多角色。表 3
08 / DATA & API
一套客户 ID，一条事件链
数据底座只认四张主表：人、客户、单、动作；订单、交付、回款是单的延伸。所有插件围绕这四张表增补字段，不各自建一套。指标不单独存表，全部从动作和交易实时算；存了指标表，就一定要对账，一对账就永远对不上。
| 层 | 对象 | 回答什么问题 | 关键字段 / 规则 |
|---|---|---|---|
| 主数据 | tenant / org / person | 谁在用、属于哪一层、能看多少 | tenant_id 全表必带；一人多角色；数据范围：公司 / 部门 / 科室 / 本人 |
| 主数据 | customer / account / contact | 这个客户是谁、联系人是谁 | 企业主体 account_id；联系人手机号唯一；外部系统 ID 进映射表 |
| 过程 | lead | 线索从哪来、值不值得跟 | 六字段、来源、评分、分级、归属、状态、退回原因 |
| 过程 | deal / opportunity | 这一单跟到哪、卡在哪、下一动作是什么 | 阶段、金额、预计成交、四路、铁三角、决策链、丢单原因 |
| 交易 | quote / contract / order | 报了多少、签了什么、订单是什么 | 版本、折扣、审批、合同状态、订单号、回款计划 |
| 履约 | delivery / receivable / payment | 交付到哪、钱什么时候到 | 工单号、里程碑、验收单、应收、账期、到账流水、核销 |
| 行为 | action / task | 谁做了什么、下一步谁做 | 类型、时间、对象、录音/纪要、下一动作、优先级、处理率 |
| 经营 | target / kpi / forecast | 目标多少、差多少、下月能成多少 | 年/仗/月/周/人；三结果四过程；承诺 / 加权 / 最乐观 |
四张主表之外，插件只能增补自己的命名空间；分析统一走数据仓，不在生产库上跑大报表。表 4
客户 ID 的三个层次：企业主体用 account_id，联系人用手机号做唯一键，外部系统用 external_ref 映射。这样既保留“一个人可以有两个公司、一个公司有五个联系人”的现实，也不会让线索、商机、订单各认一个 ID。
- tenant_id：全表必带，任何查询先过租户隔离。
- customer_id：跨开源、变现、经营、激励统一；合并只改映射，不删历史。
- contact_phone：自然人唯一键；空号、停机、换号都进变更审计。
- external_ref：系统 + 实体 + 外部 ID → 内部 ID；CRM、ERP、MES、财务各一套。
- idempotency_key：所有写入 API 和事件必带，重试不重复建单。
| API 资源 | 用途 | 主要调用方 |
|---|---|---|
| /leads | 建线索、查重、评分、分配、退回 | 官网 / 表单 / 企微 / 市场 |
| /opportunities | 商机、阶段、四路、决策链、下一动作 | 销售 / CRM / AI |
| /quotes | 报价、折扣、审批、版本 | 方案 / 经理 / OA |
| /orders | 合同订单、交付计划、回款计划 | ERP / 合同 / 内勤 |
| /deliveries | 工单、里程碑、验收、卡点 | MES / ERP / 交付 |
| /receivables | 应收、账期、到账、核销 | 金蝶 / 用友 / 财务 |
| /actions | 拜访、电话、微信、录音、纪要 | 销售 / 移动端 / AI |
| /tasks | 今日任务、提醒、处理回执 | 全部角色 / 办公平台 |
| /forecasts | 预测快照、三口径、解释 | 经营 / 老板屏 |
| /plugins | 安装、配置、启停、健康检查 | 管理员 / 实施 |
核心事件目录域对象 + 过去式
lead.createdlead.qualifiedlead.assigneddeal.stage_changedquote.approvedcontract.signedorder.confirmeddelivery.milestone_changedpayment.receivedtraining.completedtarget.publishedforecast.updatedtask.created
接口约定：REST + JSON、OpenAPI 3.1；用户态 OAuth2 / OIDC，系统态 API Key + HMAC；所有写接口带 Idempotency-Key，所有更新带版本号；Webhook 签名 + 重放保护；失败进重试队列和死信队列。
- 版本：/api/v1；破坏性变更升主版本，旧版本至少保留两个发布周期。
- 分页：游标分页，不用 offset 翻全量；默认 50，最大 200。
- 错误：统一 code / message / details / trace_id，不把内部异常抛给前端。
- 审计：谁、何时、从哪来、改了什么、旧值是什么；AI 写入额外记录建议 ID。
权限三条硬规矩：排名只到团队层，不到个人公开；成本、毛利、提成，业务员一律不可见；老板能看全部，但默认进团队层，要看个人再点一次。
- RBAC + 数据范围：角色决定功能点，组织决定能看到哪一层。
- 字段级权限：金额、成本、毛利、联系方式按角色脱敏。
- 字段级审计：金额、阶段、回款、归属变更全部留痕。
- 私有化：大客户可单独部署；模型、向量库、对象存储都可落在客户机房。
09 / ROLLOUT & DECISIONS
先建主干，再装插件
第一版不要五个插件一起做。先做底座和变现主干，让“线索进来有人接、单子推进有证据、回款能对上”；再接开源和渠道，最后上经营预测、练兵与激励。每开一个插件，都必须能独立验收，而不是等五个都做完才看见效果。
PHASE 0
底座与连接器
租户、组织、角色、权限、客户 ID、事件总线、企微/钉钉免登、Excel 导入、插件清单。
3–4 周 · 全量共用
PHASE 1
变现主干
LTC 六段、四路落账、铁三角、报价闸门、丢单归因、回款计划、销售军师第一版。
6 周 · 第一个可验收闭环
PHASE 2
开源与渠道
官网/公众号/企微/表单留资、六渠道、查重评分、分配回收、来源归因、渠道 ROI、SEO/GEO 内容台。
5 周 · 线索可追源
PHASE 3
经营 / 预测 / 角色屏
七项指标、四刀分解、军令状、周盯帮扶、三口径预测、老板屏、经理屏、销售“我的今天”。
4–5 周 · 老板可见
后续再接练兵与激励，避免第一版战线过长；若客户最痛的是“没线索”，可把开源与变现并行，但主干数据模型必须先定稿。图 4 / 6
D01 / 主数据
客户主数据放 CRM，还是放本系统？
有 CRM 的客户建议 CRM 做主；本系统做行为、过程与 AI。没有 CRM 的客户，本系统做主。必须逐字段写清，不能“两边都是主”。
D02 / 客户 ID
手机号做联系人主键，企业主体另设 account_id？
建议是。手机号唯一解决“同一个人”，account_id 解决“同一家公司多个联系人”。外部系统全部走映射表，不做字符串硬拼。
D03 / 首发渠道
首批接哪几个获客入口？
建议先接官网、企微、表单、公众号四个自有入口；小红书/抖音/B站按客户实际投放再接，避免第一版被平台接口拖住。
D04 / 预测
预测只算 S4 以上，还是全漏斗加权？
建议只算 04 以上，S4 65%、S5 85%；S3 只进最乐观数。先跑三个月，用实际成交回测校准，不急着上复杂模型。
D05 / AI 部署
SaaS 多租户，还是客户机房私有化？
SaaS 为主，大客户单独部署。模型可混合：抽取/分类走便宜 API，敏感数据走私有模型；合同、录音、客户数据不进入公共训练。
D06 / 插件形态
现在拆微服务，还是模块化单体？
建议模块化单体 + 事件总线 + 连接器，先把插件契约跑通；AI、文档解析、渠道连接器可独立部署。等客户量和团队规模上来再拆。
6
开工前必须拍板：客户主数据归属、联系人 ID 规则、首批渠道、预测口径与历史数据、AI 部署方式、插件技术形态。这六件事不定，开发越往后返工越贵；定完再画接口清单和页面原型。