L2C 业务领域建模建议

2.0 实体关系总览

flowchart LR
    Lead["线索<br/>(Lead)"] -->|"转换"| Customer["客户<br/>(Customer)"]
    Customer -->|"1:N"| Contact["联系人<br/>(Contact)"]
    Customer -->|"1:N"| Opportunity["商机<br/>(Opportunity)"]
    Opportunity -->|"1:N 业务线拆分"| SplitLine["业务线拆分<br/>(SplitLine)"]
    SplitLine -->|"带入报价"| Quote["报价<br/>(Quote)"]
    Quote -->|"1:N 产品拆分"| QuoteLine["产品明细<br/>(QuoteLine)"]
    QuoteLine -->|"N:1"| Product["产品<br/>(Product)<br/>业务场景为普通字段"]
    QuoteLine -->|"关联带入产品明细"| Order["订单<br/>(Order)"]
    Opportunity -->|"赢单后关联"| Order
    Order -->|"1:N"| SplitAssignment["业绩归属明细<br/>(SplitAssignment)"]
    Order -->|"N:M"| Contract["合同<br/>(Contract)"]
    Contract -->|"1:N"| PaymentPlan["回款计划<br/>(PaymentPlan)"]
    Order -->|"1:N"| InvoiceApplication["开票申请<br/>(InvoiceApplication)"]
    Contract -->|"1:N"| InvoiceApplication

关键关系说明：

• 赢单 是商机的状态属性（商机阶段 = "赢单"），不是独立实体，但走独立审批流程
• 商机 拆分到业务线维度（如雷达/数据智能/AI），报价 拆分到产品维度，产品自动归属业务线
• 报价流程：销售线下填 Excel → 上传 OA 报价系统 → AI 自动识别提取到表单台账 → 报价数据带入订单
• 订单 在赢单审批通过后由系统自动生成草稿；销售只提报产品明细和业绩划分比例，销管在审批中调整金额并补录提成
• 合同 时序上晚于订单；合同创建时必须关联一个或多个既有订单，订单可仍处于审批中，与订单为 N:M
• 全链路审批校验 按商机 → 最新有效报价（last）→ 订单回溯检查关联、内容和版本；不一致则报错修改后重审
• 金蝶边界 当前唯一确认动作是提交开票申请时直接同步申请数据，其他 CRM 财务协同不在本版预设

2.1 线索 (Lead) — 独立聚合根

线索是潜在客户或商机的初始信息入口。独立管理，拥有公海机制。

2.2 客户 (Customer) — 聚合根

已确认的合作主体，内部包含联系人和客户团队成员。客户责任人是业务归属概念，不是领导层级。

2.3 商机 (Opportunity) — 聚合根

对某个客户的潜在交易机会，含金额、赢率和业务线拆分。商机阶段包含"赢单"作为终态。

2.4 报价 (Quote) — 聚合根

基于商机业务线拆分的正式报价单，锁定到产品级别。提交前必须校验报价总额及各业务线汇总与商机完全一致。

报价流程：

1. 销售线下填 Excel 报价表，按产品分类填列（产品/对客报价/成本/交付方式）
2. 上传至 OA 报价系统（当前报价流程承载系统）
3. AI 自动识别提取 Excel 内容，结构化填入系统表单台账
4. 金额一致性校验（vs 商机拆分）→ 提交审批
5. 审批通过后成为该商机的最新有效报价（last）；赢单审批通过时由系统据此自动生成订单草稿

报价明细按产品分类，产品自动归属业务线；业务线用于审批路由和与商机业务拆分的金额一致性校验。

2.5 订单 (Order) — 聚合根

商机赢单审批通过后，系统从最新有效报价（last）自动生成订单草稿并提醒销售。销售只提报产品明细和业绩划分比例；销管在审批过程中调整订单/执行金额并补录提成信息。

2.6 合同 (Contract) — 独立聚合

与客户签署的法律文件。V2 已确认先有订单、后有合同：合同创建时必须选择一个或多个既有订单，订单可仍处于审批中；合同与订单形成 N:M。必要提取字段和审批链待 C-10。

2.7 联系人 (Contact) — CRM 实体，最终归属客户

联系人可基于线索创建或直接新建，按名称 + 电话查重；命中时可关联已有联系人并补充缺失信息，不创建重复记录。客户创建时再关联已有联系人，正式关系为客户 1:N 联系人。

2.8 销售活动 (SalesActivity) — 多态关联实体

规则：

• AI 自动判断拜访有效性（是否获取客户反馈、明确需求等）
• 虚假拜访触发高压线扣分
• 同一活动可关联多个对象

2.9 核心实体状态机

线索、联系人、客户、商机、报价、订单、合同、回款八个核心实体的状态机已独立成确认板块，统一见 《L2C核心实体状态机》。本文件不再重复维护状态枚举和迁移规则。

3.1 项目 (Project) — 聚合根

项目由 PMO 手动创建和管理。订单确认或合同审批通过均不自动生成正式项目或交付准备单；手动立项条件、关联订单/合同规则、编号、取消、重复校验和历史数据处理待 C-08。

3.2 PMO 待办候选聚合/实体

以下对象均属于 PMO 待办，在确认前不属于正式领域模型：

项目成本分类和执行期管控不是新聚合，但会改变 CostItem 规则，待 C-13、C-19；验收和收入计划职责待 C-20。

4.1 供应商 (Supplier) — 聚合根

4.2 采购单 (PurchaseOrder) — 聚合根

本版只建模采购单和采购明细。是否新增 SupplierContract 聚合及其发起、签署、归档职责边界待 C-17；供应商验收责任待 C-20。

5.1 主链路 (Lead to Order) 跨职能流程

sequenceDiagram
    participant Mkt as 市场
    participant Sales as 销售
    participant XM as 销管运营
    participant Biz as 业务部门
    participant Approver as 审批人
    participant Sys as 系统
    participant AI as AI

    Note over Mkt,Sys: 阶段一：线索获取与分配
    Mkt->>Sys: 批量导入市场线索 → 部门线索池
    Sales->>Sys: 手工录入销售线索 → 销售拓展池并归属本人
    XM->>Sys: 分配市场线索，记录领取时间

    Note over Sales,XM: 阶段二：线索跟进
    Sales->>Sys: 24h 内首次跟进并持续记录销售活动
    Sys->>AI: 判断跟进有效性（仅提示，不硬阻断）
    alt 24h 未首跟或超过当前 14 天保有期
        Sys->>XM: 回收至回收线索池
    else 线索成熟
        Sales->>Sys: 标记有效并执行“转客户”
    end

    Note over Sales,AI: 阶段三：联系人创建
    Sales->>Sys: 基于线索创建或直接新建联系人
    Sys->>Sys: 名称 + 电话查重
    alt 命中已有联系人
        Sales->>Sys: 关联已有联系人并补充缺失信息
    end
    opt 名片或会议录音
        AI->>Sales: 生成联系人草稿，人工确认
    end

    Note over Sales,XM: 阶段四：客户创建
    Sales->>Sys: 客户查重并关联已有联系人
    Sales->>Approver: 提交客户创建审批
    alt 审批通过
        Approver->>Sys: 客户生效
    else 审批驳回
        Approver->>Sales: 补充后重新提交
    end

    opt 阶段四-b：产品试用申请（独立支线）
        Sales->>Biz: 基于客户提交试用申请
        Biz->>Sys: 审批通过后下发试用账号密码
    end

    Note over Sales,XM: 阶段五：商机创建与跟进
    Sales->>Sys: 关联客户/联系人，按业务线拆分金额
    Sys->>Sys: 校验拆分合计 = 商机总金额
    Sales->>Approver: 提交商机创建审批
    Approver->>Sys: 通过后商机进入推进中
    Sales->>Sys: 创建商机时填报销售赢单率
    AI->>Sys: 审批通过后计算并保存 AI 赢单率
    Sys->>Sys: 销管未填时有效赢单率引用 AI 值
    XM->>Sys: 填写销管赢单率后改用销管值，AI 值保留

    Note over Sales,Approver: 阶段六：报价
    Sales->>Sys: 上传线下 Excel 报价表
    AI->>Sales: 识别产品/金额/成本/业务线，等待人工确认
    Sys->>Sys: 校验报价总额和业务线汇总与商机一致
    Sales->>Approver: 按业务线提交报价审批
    Approver->>Sys: 全部必要节点通过 → 报价已审批
    Sys->>Sys: 标记为该商机最新有效报价（last）

    Note over Sales,Approver: 阶段七：赢单
    Sales->>Sys: 上传客户确认凭证并推至赢单
    Sys->>Sys: 校验存在业务线和金额一致的报价
    Sales->>Approver: 提交赢单审批
    Approver->>Sys: 通过 → 商机赢单并锁定
    Sys->>Sys: 赢单后按 last 报价自动生成订单草稿并提醒销售

    Note over Sales,Approver: 阶段八：订单
    Sales->>Approver: 提交产品明细和业绩划分比例
    Approver->>Sys: 回溯校验商机 → last 报价 → 订单
    XM->>Sys: 审批中调整金额并补录提成（可等待合同依据）
    Approver->>Sys: 最终通过 → 订单事实固定；否则驳回修改重提
    Note over Sys,Approver: 订单确认不自动创建项目；PMO 手动立项规则见 C-08

    Note over Sales,Approver: 阶段九：合同
    Sales->>Sys: 基于一个或多个订单发起合同
    AI->>Sales: 识别必要字段并人工确认（字段待 C-10）
    Sales->>Approver: 提交通用合同审批（审批链待 C-10）
    Approver->>Sys: 通过 → 合同审批通过

5.2 交付与采购链路 (Order to Cash) 跨职能流程

sequenceDiagram
    participant PMO as PMO/项目经理
    participant Finance as 财务
    participant Procure as 采购
    participant Customer as 客户
    participant Kingdee as 金蝶
    participant Sys as 系统

    PMO->>Sys: 手动创建和管理项目（规则待 C-08）
    PMO->>Sys: 手动选择关联订单/合同（基数待 C-08/C-12）
    PMO->>PMO: 执行交付

    opt 需要外采
        PMO->>Procure: 发起采购申请（关联订单产品行）
        Procure->>Sys: 创建采购单
        Procure->>Procure: 采购执行
        Procure->>Sys: 采购完成
        Sys->>PMO: PurchaseCompleted（采购成本回流）
        Sys->>Kingdee: 同步采购付款/供应商发票
    end

    PMO->>Customer: 交付完成，提请客户验收（内部验收待 C-14）
    alt 验收通过
        Customer->>Sys: 确认验收
        Sys->>Sys: AcceptanceCompleted → 通知 CRM 更新订单状态
    else 验收不通过
        Customer->>PMO: 退回修改
    end

    PMO->>Finance: 提交收入确认
    Finance->>Sys: 确认收入
    Sys->>Sys: RevenueRecognized → 回流 CRM
    Note over Sys,Kingdee: CRM 仅在提交开票申请时同步申请数据
    PMO->>Sys: 项目结项（条件待 C-15）

5.3 AI 辅助链路

AI 在 L2C 全链路中覆盖四大辅助场景：

场景一：录音提取（会议录音 → AI 草稿 → 人工确认）

sequenceDiagram
    participant Sales as 销售
    participant Sys as 系统/AI

    Sales->>Sys: 上传会议录音
    Sys->>Sys: 保存为 MeetingRecording
    Sys->>Sys: AI 提取结构化信息<br/>（竞品/客户意向/下一步计划）

    Sys->>Sys: 生成 AI 草稿 AIDraft<br/>状态: 候选 Candidate
    Sys->>Sys: 同时生成线索草稿 / 客户草稿 / 商机草稿

    Sys->>Sales: 推送草稿，等待人工确认
    alt 接受 / 修改
        Sales->>Sys: 确认并提交
        Sys->>Sys: 转为正式 CRM 事实<br/>（可追溯到原始录音片段）
    else 拒绝
        Sales->>Sys: 拒绝
        Sys->>Sys: 丢弃草稿，记录拒绝原因
    end

场景二：报价识别（Excel 上传 → AI 提取 → 台账回填）

销售线下填 Excel → 上传 OA 报价系统 → AI 自动识别提取产品/金额/成本/业务线 → 回填结构化表单台账 → 减少重复填报。

场景三：审批辅助

AI 在关键节点做判断辅助（如合同预审驳回），但不能代替真实业务流审批。

场景四：经营看板

以目标为导向（如"南区客户二部差 1 亿"），AI 从目标缺口倒推动作建议（挑商机/推方案/话术指导），交互式问答支持深入探索。

规则：

• 任何未经人工确认的草稿不得进入正式列表、经营报表或下游同步
• 正式对象可追溯到录音片段
• 记录原始 AI 候选值、人工修改结果、确认人和确认时间
• AI 工作台采用 Tab 分页/分层浏览，避免信息平铺
• 页面需引入经营看板视图，AI 主动指导而非被动展示

6.1 域间事件流

6.2 集成原则

1. 引用而非持有： 跨域只保存对方聚合根 ID，不复制数据
2. 事件驱动： 域间通过领域事件异步通信，不直接调用对方 API 做写操作
3. 最终一致性： 跨域数据允许短暂不一致，通过异常工作台处理同步失败
4. 单写： 每个事实只有一个域能写入，其他域只读引用

8.1 AI 工作台设计要点（新增）

AI 工作台建在 navy 平台，定位为 CRM、报价、合同、PMO、采购、金蝶与审批中心 的全链路统一入口；它是聚合展示层，不持有业务事实：

9.1 公共基类

9.2 属性设计原则

1. 必填属性 → 构造函数参数 / not-null 约束
2. 100%填充属性 → 类核心属性，优先纳入
3. 部分填充属性 → optional / nullable
4. 全空属性 → 权限控制类复用框架字段；其余业务字段暂不纳入初版

10.1 目标管理

独立的辅助表单，不直接影响 L2C 流程，但作用于管理层。

10.2 诊断点清单

系统应嵌入的多层级经营诊断能力：

10.3 经营卡 (S2M 经营动作推荐)

• 将标准销售动作转化为 AI 指导工具，嵌入客户/联系人/商机视图
• 自动提示下一步应建联的对象或推进的产品
• 通过回写系统记录验证销售是否落实了 AI 建议的动作
• 形成公司级上下文积累，确保 L to O 环节闭环管理

10.4 审批时效追踪

全流程审批效率监控，跨所有审批节点：

10.5 过桥项目 / 特殊业务类型

• 针对借主体签署等"过单"特殊场景，设立独立的"其他业务类型"选项
• 虽走完整链路，但可配置简化的审批流
• 管理员可通过配置临时将某角色定义为特定审批角色以适配特殊审批链路

核心原则： 每个域独立演进，但数据边界必须从一开始就清晰——哪个域拥有哪个事实、谁写谁读、通过什么事件通信，这些定下来后，代码可以逐步迁移。