报价、智能询价与报价规则专题

本文把 DGJ2.0 中“配置报价、计算价格、机器人询价、人工报价、生成报价单、转销售单”六个阶段拆开说明。它们共享客户和商品数据，但不是同一个业务对象。

1. 业务目标

报价域解决的是：服务站面对不同客户和商品时，如何在可售、可查、可报价的前提下，快速给出可解释的价格，并让客户继续下单。

具体目标包括：

1. 按服务站建立多套报价规则。
2. 将客户关联到一套生效规则。
3. 为规则下每个商品选择报价方式。
4. 支持最近销售价、指导价、自定义价和组合兜底。
5. 支持固定价与基于指导价/采购价的动态加价。
6. 限制机器人对指定客户可展示的分类和品牌范围。
7. 从 VIN、图片、关键词和车型中识别询价需求。
8. 自动报价失败时转人工待报价。
9. 将待报价转成正式报价单，再继续转销售单。
10. 记录价格变更、最近报价和迁移过程，便于解释与追踪。

2. 一句话业务地图

flowchart LR
  A["客户与商品基础数据"] --> B["报价规则：怎么算价"]
  A --> C["报价范围：允许机器人展示什么"]
  B --> D["价格中心计算候选价"]
  C --> E["智能询价筛选候选商品"]
  D --> E
  E --> F{"是否自动得到可展示价格"}
  F -->|是| G["机器人/IM 返回报价"]
  F -->|否| H["待报价申请"]
  H --> I["人工填写价格"]
  I --> J["正式报价单"]
  G --> K["客户选择商品"]
  J --> K
  K --> L["销售单/采购补货"]

3. 六个核心概念不能混用

3.1 最容易犯的三个错误

1. 把“机器人查询到了商品”理解成“商品一定有报价”。查询范围与价格规则是两次独立判断。
2. 把 IM 工作台 saveQuote 保存的会话价格理解成正式报价单。它首先写会话上下文并发消息，不等同于落 SCM_OFFER_ORDER。
3. 把 quote_type 理解成最终实际价格来源。组合规则可能配置为“最近售价 > 自定义价”，但最终实际使用的是自定义价，因此还要看 real_quote_type。

4. 系统边界

flowchart TD
  subgraph OPS["服务站后台"]
    Rule["报价规则管理"]
    Range["报价范围管理"]
    Apply["待报价管理"]
    Workbench["IM 人工工作台"]
  end
  subgraph DGJ["DGJ 领域服务"]
    QM["QuoteManagerSer"]
    PM["PriceManagerSer"]
    SI["SmartInquirySer / RobotV2"]
    OAS["OfferOrderApplySer"]
  end
  subgraph Data["数据层"]
    RuleData["规则/客户/商品/价格"]
    RangeData["范围/客户"]
    ConvData["会话/上下文"]
    OfferData["报价单"]
  end
  subgraph External["外部系统"]
    VIN["VIN/车型/物料服务"]
    IM["腾讯 IM / 微信机器人"]
    SAAS["SAAS 询价/销售"]
    Item["商品与价格数据源"]
  end
  Rule --> QM
  Range --> SI
  Apply --> OAS
  Workbench --> SI
  QM --> RuleData
  PM --> RuleData
  SI --> RangeData
  SI --> ConvData
  OAS --> OfferData
  SI --> VIN
  SI --> IM
  OAS --> SAAS
  Item --> RuleData

5. 主要代码入口

5.1 控制器

5.2 核心 Service

6. 核心表总览

6.1 V2 报价规则域

6.2 报价范围域

6.3 报价单与会话域

7. 分表与金额单位

7.1 分表规则

flowchart LR
  A["sid"] --> B["sid % 64"]
  B --> C["t_quote_rule_goods_N"]
  B --> D["t_quote_goods_base_N"]
  B --> E["t_contact_price_N"]
  B --> F["t_quote_change_event_detail_N"]

每次查询分表后仍要带 sid 条件。不能只依赖分片后缀，因为同一物理分片包含多个服务站。

7.2 金额单位

金额排查必须先确认单位，禁止用“看起来像价格”猜测。

8. 报价规则数据模型

erDiagram
  QUOTE_RULE ||--o{ QUOTE_RULE_CONTACT : binds
  QUOTE_RULE ||--o{ QUOTE_RULE_GOODS : configures
  BS_CONTACT ||--o| QUOTE_RULE_CONTACT : assigned
  BS_GOODS ||--o{ QUOTE_RULE_GOODS : priced
  QUOTE_GOODS_BASE ||--|| BS_GOODS : snapshot_of
  QUOTE_RULE ||--o{ CONTACT_PRICE : groups_history
  BS_CONTACT ||--o{ CONTACT_PRICE : owns_history
  BS_GOODS ||--o{ CONTACT_PRICE : has_history
  QUOTE_CHANGE_EVENT ||--o{ QUOTE_CHANGE_EVENT_DETAIL : contains

8.1 业务约束

9. 报价方式字典

枚举：application/KzData/Enums/QuoteRuleGoodsEnums.php

9.1 quote_type 与 real_quote_type

flowchart TD
  A["配置 quote_type"] --> B{"是否组合规则 6/7"}
  B -->|否| C["按配置来源取价"]
  B -->|是| D["先查对应最近售价"]
  D -->|找到| E["real_quote_type = 实际最近售价类型"]
  D -->|未找到| F["计算自定义价"]
  F -->|找到| G["real_quote_type = 3"]
  F -->|未找到| H["has_price = false"]
  C --> I["返回结果"]
  E --> I
  G --> I
  H --> I

排查前端文案或下单价格时，应同时记录 quote_type、real_quote_type、price 和 strategy。

10. 自定义价模型

10.1 两种自定义价

10.2 动态价基础

10.3 加价方式

金额加价：raw = base_price + add_amount
比例加价：raw = base_price * (1 + add_percent / 100)

取整类型：

10.4 计算链

flowchart TD
  A["读取规则商品配置"] --> B{"固定价还是动态价"}
  B -->|固定价| C["校验 fix_price 范围"]
  B -->|动态价| D{"指导价还是采购价"}
  D --> E["读取报价基础商品价格"]
  E --> F{"加金额还是加百分比"}
  F --> G["计算 raw price"]
  G --> H["按 round_type 取整"]
  C --> I["写 custom_price（分）"]
  H --> I

动态价是“配置变化后计算并保存最终 custom_price”还是“每次查询实时计算”，要结合具体更新入口看。buildQuoteRuleData() 和价格变更处理会重算，基础价变化后的异步/任务链必须纳入排查。

11. 最终价格计算主流程

核心：QuoteManagerBaseSer::getGoodsPrices()。

flowchart TD
  A["sid + contactId + invIds"] --> B["初始化所有商品 has_price=false"]
  B --> C{"是否显式传 quoteRuleId"}
  C -->|否| D["按 sid + contactId 查关联规则"]
  C -->|是| E["使用指定规则"]
  D --> F{"是否有规则"}
  E --> F
  F -->|否| Z["全部无价格"]
  F -->|是| G["从 t_quote_rule_goods_{sid%64} 查配置"]
  G --> H["按 quote_type 分组"]
  H --> I["查询最近销售价"]
  H --> J["查询指导价"]
  H --> K["计算/读取自定义价"]
  K --> L["附加充值价和现金价"]
  I --> M["组合规则执行兜底"]
  J --> N["合并结果"]
  L --> N
  M --> N
  N --> O["返回元、has_price、价格区间、配置/实际类型"]

11.1 返回结构

{
  "<invId>": {
    "has_price": true,
    "price": "128.00",
    "min_price": "120.00",
    "max_price": "135.00",
    "quote_type": 6,
    "real_quote_type": 5,
    "recharge_price": "126.00",
    "cash_price": "130.00"
  }
}

示例值只表达结构，不代表真实业务价格。

12. 最近销售价的三种范围

flowchart TD
  A["需要最近售价"] --> B{"quote_type"}
  B -->|1| C["只查当前客户"]
  B -->|4| D["当前客户 -> 站内其他客户"]
  B -->|5| E["规则关联客户组"]
  B -->|6| E
  B -->|7| C
  C --> F["按最近变更时间和有效天数取值"]
  D --> F
  E --> F

站点最近价有效天数由配置读取；代码支持 days=0 表示不限制历史。排查时要记录实际 days 和起始时间，不能固定认为都是 90 天。90 天主要出现在管理端统计和导出文案。

13. 价格扩展信息

getGoodsPricesExt() 不直接等同最终价，它给前端展示可解释的候选信息：

flowchart LR
  A["invIds"] --> B["站点最近售价"]
  C["contactId"] --> D["客户关联 quoteRuleId"]
  D --> E["自定义价"]
  D --> F["同组最近售价"]
  C --> G["客户最近售价"]
  B --> H["prices_ext"]
  E --> H
  F --> H
  G --> H

14. PriceManager 新旧版本编排

内部价格接口先调用 PriceManagerSer::getFullPrice()，再判断 QuoteManagerSer::isV2QuoteRule($sid)。

14.1 V2 判断

flowchart TD
  A["查 t_quote_station_version"] --> B{"存在记录且 current_version=2"}
  B -->|否| C["按 V1/旧价格逻辑"]
  B -->|是| D{"migrate_session_id 是否为空"}
  D -->|是| E["V2 生效"]
  D -->|否| F["查迁移会话 status"]
  F -->|3 成功| E
  F -->|其他/异常| C

isV2QuoteRule() 捕获异常后返回 false，因此数据库异常可能表现为静默回退 V1，而不是接口报错。排查新旧价格不一致时必须查该方法日志和版本表。

14.2 内部接口

检查是否有价格

POST /inner/pricemanager/checkhasprice
Content-Type: application/json

{
  "sid": 10001,
  "contactId": 20001,
  "invIds": [30001, 30002],
  "scene": "normal"
}

响应核心：

{
  "list": [
    {"inv_id": 30001, "has_price": true},
    {"inv_id": 30002, "has_price": false}
  ]
}

获取完整价格

POST /inner/pricemanager/getprices
Content-Type: application/json

{
  "sid": 10001,
  "contactId": 20001,
  "invIds": [30001],
  "scene": "offer"
}

返回包含 prices、is_v2；V2 时还包含 prices_ext。内部接口的真实鉴权由网关/基类决定，示例未包含凭证。

15. 报价规则后台 API

控制器路径按 CodeIgniter 规则映射，部署网关可能统一大小写或前缀，联调以真实路由为准。

15.1 接口总表

15.2 新增规则请求

POST /basedata/quotemanager/ruleset
Content-Type: application/json

{
  "sid": 10001,
  "id": 0,
  "name": "连锁客户报价",
  "description": "同组最近售价优先"
}

后端生成规则编码，站内有效规则名不能重复。

15.3 批量设置报价方式

POST /basedata/quotemanager/batchsetquotetype
Content-Type: application/json

{
  "sid": 10001,
  "user_id": 90001,
  "quote_rule_id": 40001,
  "inv_ids": [30001, 30002],
  "quote_type": 6
}

流程：校验规则和最大设置数，读取报价基础商品及旧配置，构建 upsert 数据，按 2000 条分批写入，最后写价格变更事件。

15.4 设置动态自定义价

POST /basedata/quotemanager/batchsetcustomprice
Content-Type: application/json

{
  "sid": 10001,
  "user_id": 90001,
  "quote_rule_id": 40001,
  "inv_ids": [30001],
  "custom_price_type": 2,
  "fix_price": 0,
  "price_base": 1,
  "price_method": 2,
  "add_amount": 0,
  "add_percent": 8,
  "round_type": 1
}

16. 规则 CRUD 流程

sequenceDiagram
  participant UI as PC 报价规则
  participant C as QuoteManager Controller
  participant S as QuoteManagerSer
  participant R as t_quote_rule
  participant RC as t_quote_rule_contact
  participant RG as t_quote_rule_goods_N
  UI->>C: ruleSet(name, description)
  C->>S: ruleSet
  S->>R: 检查同名并新增/更新
  UI->>C: ruleContactSet(contactIds)
  C->>S: 保存客户关系
  S->>RC: 删除旧关系/批量建立新关系
  UI->>C: batchSetQuoteType/customPrice
  C->>S: 配置商品
  S->>RG: upsert 商品报价配置
  S->>S: 写价格变更事件

16.1 删除规则

ruleDelete() 在事务中：主规则 is_delete=1，客户关系硬删除，规则商品分表硬删除。风险是历史 contact_price.quote_rule_id、报价变更事件和已生成报价不会同步删除，历史查询必须容忍规则主表已软删。

17. 客户绑定规则

17.1 业务语义

一个客户是否能得到 V2 报价，首先取决于 t_quote_rule_contact 是否存在关联。没有关联时 getGoodsPrices() 直接返回所有商品无价格，即使规则商品表中已经配置价格。

flowchart TD
  A["客户请求报价"] --> B["按 sid + contactId 查规则"]
  B -->|无关联| C["V2 规则不提供价格"]
  B -->|有关联| D["查该规则下商品配置"]
  D -->|无商品行| C
  D -->|有商品行| E["按 quote_type 计算"]

17.2 变更客户规则的影响

• 客户下一次报价会使用新规则。
• contact_price 中历史行带有旧/新 quote_rule_id，同组价格范围会变化。
• 正在进行中的机器人会话是否重新取规则，取决于查询时点和缓存。
• 已发出的会话报价和正式报价单不应被追溯改价。

18. 商品配置与基础商品

报价规则商品不是商品主数据。t_quote_goods_base_{sid%64} 是为了报价查询建立的站点级基础快照，包含分类、品牌、SKU、指导价、采购价、销量、库存和限价信息。

flowchart LR
  A["商品中心/BS_GOODS"] --> B["QuoteGoodsBase 任务同步"]
  C["指导价/结算价"] --> B
  D["库存"] --> B
  E["销量/车型适配"] --> B
  B --> F["t_quote_goods_base_N"]
  F --> G["规则商品选择"]
  F --> H["自定义动态价计算"]
  F --> I["报价范围分类品牌"]

报价异常时必须先判断是规则错，还是基础商品快照过期。直接改规则无法修复错误的指导价、采购价或库存快照。

19. 快速定价

快速定价从大数据价格分布中提供候选值，包括最低/最高销售价、客户数最多价、订单数最多价、省/市/全国高频价等，随后由用户批量设置固定价。

flowchart TD
  A["大数据价格统计"] --> B["getQuickPriceList"]
  B --> C["用户选择 use_price 字段"]
  C --> D["batchQuickFixPrice"]
  D --> E["写规则商品固定自定义价"]
  E --> F["写价格变更事件"]

统计价是配置建议，不是下单时实时价。批量应用前要看数据日期、样本量和异常价格。

20. 报价范围模型

报价范围只控制机器人查询/展示边界，不负责计算最终价格。

erDiagram
  QUOTE_RANGE ||--o{ QUOTE_RANGE_CONFIG : contains
  QUOTE_RANGE_CONFIG ||--o{ QUOTE_RANGE_CONFIG_INFO : expands
  QUOTE_RANGE ||--o{ QUOTE_RANGE_CONTACT : assigned
  BS_CONTACT ||--o| QUOTE_RANGE_CONTACT : uses

20.1 系统范围

系统模板通过特殊 ID 表达。客户没有显式范围关联时，代码将其理解为系统默认范围；绑定系统模板时会删除客户显式关系。

20.2 分类和品牌的全部标识

配置支持特殊 TAG_ALL：

batchQuoteRangeConfig() 会先删除该范围原配置和明细，再全量重建。因此调用必须在事务中，单独调用时也要确认外层事务。

21. 报价范围 API

21.1 新建范围请求

POST /movemall/wechat/setquoterange
Content-Type: application/json

{
  "sid": 10001,
  "uid": 90001,
  "id": 0,
  "name": "轮胎重点品牌",
  "remark": "仅用于指定客户群",
  "quote_config": [
    {
      "category_ids": [501],
      "brand_ids": [601, 602]
    }
  ]
}

21.2 保存流程

sequenceDiagram
  participant UI as 报价范围页面
  participant W as WechatSer
  participant Range as 范围主表
  participant Config as 配置主表
  participant Info as 展开明细
  UI->>W: setQuoteRange
  W->>W: 校验同范围内分类+品牌组合无重复
  W->>Range: 新增/更新主表
  W->>Config: 删除当前范围旧配置
  W->>Info: 删除当前范围旧明细
  loop 每组配置
    W->>Config: 插入逗号形式配置
    W->>Info: 展开并 batchInsertOrIgnore
  end
  W-->>UI: commit

22. 旧机器人白名单

RobotQuoteConfigInfoModel::getQuoteWhiteList() 返回：

[category_id => [brand_id => true]]

空配置表示全部允许；-1 可表示全部分类或全部品牌。这个“空即全部”语义在迁移、删除和异常时非常重要：误删明细可能把限制范围扩大成全量，而不是变成无权限。

flowchart TD
  A["读取客户白名单"] --> B{"配置是否为空"}
  B -->|是| C["全部允许"]
  B -->|否| D{"命中 全分类+全品牌"}
  D -->|是| C
  D -->|否| E{"命中 全分类+指定品牌"}
  E -->|是| C
  E -->|否| F{"命中 指定分类+全品牌/指定品牌"}
  F -->|是| C
  F -->|否| G["过滤商品"]

23. 智能询价总流程

sequenceDiagram
  participant Customer as 客户
  participant IM as 微信/腾讯IM
  participant Adapter as 消息适配器
  participant Robot as SmartInquiry/RobotV2
  participant VIN as VIN/车型服务
  participant Goods as 商品查询
  participant Range as 报价范围
  participant Price as PriceManager
  participant Apply as 待报价
  Customer->>IM: VIN/图片/关键词/语音
  IM->>Adapter: 标准化消息和 msgId
  Adapter->>Robot: 建立/恢复会话
  Robot->>VIN: 识别 VIN 或车型
  VIN-->>Robot: 单车型/多车型/失败
  Robot->>Goods: 按车型和关键词查商品
  Goods-->>Robot: 候选商品
  Robot->>Range: 按客户过滤分类/品牌
  Robot->>Price: 获取库存和价格
  alt 有可展示商品和价格
    Robot->>IM: 商品询价结果
  else 需要人工
    Robot->>Apply: 创建待报价申请
    Robot->>IM: 告知等待人工报价
  end

24. 输入识别

会话有效期常量为 3600 秒，报价回复时间为 600 秒。旧链路还存在 MSGTTL=600、LINKTTL=7200，不同链路的超时含义不能混用。

25. 会话状态与动作

25.1 会话类型

25.2 动作

stateDiagram-v2
  [*] --> WaitingInput
  WaitingInput --> ParsingVehicle: VIN/车型
  WaitingInput --> ParsingKeyword: 商品词
  ParsingVehicle --> WaitingCarSelect: 多车型
  WaitingCarSelect --> Querying: 用户选择
  ParsingVehicle --> Querying: 唯一车型
  ParsingKeyword --> Querying
  Querying --> Quoted: 找到商品和价格
  Querying --> WaitingManualQuote: 无价/需人工
  Quoted --> PlacingOrder: 用户回复序号
  Quoted --> Querying: 继续询价
  WaitingManualQuote --> Quoted: 人工报价
  PlacingOrder --> Completed
  WaitingInput --> Expired: 超时
  Quoted --> Expired: 超时

26. 自动报价决策

flowchart TD
  A["候选商品"] --> B{"客户是否允许询报价"}
  B -->|否| X["不自动报价/提示未开通"]
  B -->|是| C{"商品在报价范围"}
  C -->|否| Y["过滤"]
  C -->|是| D{"商品可售且库存规则通过"}
  D -->|否| Y
  D -->|是| E["调用价格中心"]
  E --> F{"has_price=true"}
  F -->|是| G["展示价格和商品"]
  F -->|否| H{"是否允许人工待报价"}
  H -->|是| I["创建待报价申请"]
  H -->|否| J["只展示无价/联系人工提示"]

自动报价不是只调用一个价格方法，还受客户开关、范围、商品状态、库存、限价和展示规则影响。

27. 待报价申请

表：t_scm_robot_offer_order_apply。

27.1 状态

stateDiagram-v2
  [*] --> Pending: 机器人/询价创建
  Pending --> Pass: 人工填写价格并转报价单
  Pending --> Invalid: 人工作废
  Pending --> Pass: 直接转销售流程中的有效化
  Pass --> [*]
  Invalid --> [*]

27.2 列表接口

POST /movemall/offerapply/quotations
Content-Type: application/json

{
  "page": 1,
  "rows": 20,
  "buId": 20001,
  "status": 0
}

列表会关联商品返回 SKU 和名称，并可合并客户最近正式报价。

27.3 转正式报价请求

控制器接收 postData JSON 字符串：

POST /movemall/offerapply/pass
Content-Type: application/x-www-form-urlencoded

postData=[{"id":70001,"salePrice":128.00}]

校验要求每项都有整数 id 和浮点 salePrice。

28. 待报价转正式报价单

sequenceDiagram
  participant UI as 待报价页面
  participant S as OfferOrderApplySer
  participant Apply as 待报价表
  participant Contact as 客户
  participant Goods as 商品
  participant Offer as 正式报价主/明细
  UI->>S: passOrders(id, salePrice)
  S->>Apply: 仅查 status=Pending 的申请
  S->>Contact: 校验客户存在且启用
  S->>Goods: 读取 SKU、热销/指导价等信息
  S->>S: 校验价格业务限制
  S->>Apply: 批量更新为 Pass
  S->>Offer: 按申请 bill_no 生成主单
  S->>Offer: 插入报价明细和 salePrice
  S-->>UI: 报价单生成成功

28.1 关键业务校验

• 申请仍为等待报价，防止重复转单。
• 客户未删除、未禁用。
• 所选申请要满足同客户等组合约束。
• 热销商品售价不能超过指导价的代码分支需按当前规则验证。
• 主单和明细创建成功后才能将申请视为完成。

28.2 并发风险

代码先查 Pending，再批量更新和插入。若没有行锁、条件更新或业务唯一键，两个请求可能同时读到 Pending。生产必须确认：

1. offer_order_apply.id 条件更新是否带 status=0。
2. 正式报价主单 billNo 是否唯一。
3. 报价明细是否有来源申请唯一键。
4. 事务是否覆盖申请更新和两张报价表插入。

29. 正式报价单

29.1 主从结构

erDiagram
  OFFER_ORDER ||--o{ OFFER_ORDER_INFO : contains
  BS_CONTACT ||--o{ OFFER_ORDER : receives
  BS_GOODS ||--o{ OFFER_ORDER_INFO : quoted
  OFFER_ORDER_APPLY }o--|| OFFER_ORDER_INFO : converted_to

29.2 obsolete 多重语义

旧报价链路使用 obsolete 区分有效、待报价和作废等状态。代码中可见：

• findOrderInfoByIds() 查询 obsolete=0 且未删除的有效明细。
• findByBillNo() 查询 obsolete=2 的待报价数据。
• 转销售时会将相应报价主/明细更新为有效或已处理状态。

完整枚举未在统一 Enums 中集中定义，生产历史值和前端文案需要结合 DDL/页面确认。这是待治理点。

30. 正式报价转销售单

sequenceDiagram
  participant UI as 报价/待报价页面
  participant Apply as OfferOrderApplySer
  participant Offer as 报价单
  participant InvSa as InvSaService
  participant Sale as 销售单
  participant MQ as SAAS 状态消息
  UI->>Apply: toSaleOrder(postData)
  Apply->>Apply: 校验待报价未重复转单
  Apply->>Offer: 激活/读取报价主从数据
  Apply->>InvSa: 构建销售开单商品和报价来源
  InvSa->>Sale: 创建销售单/后续出库链
  Apply->>Apply: 更新待报价状态
  Apply->>MQ: 同步 SAAS 订单状态

30.1 数量和价格

机器人等待报价转销售时，代码注释明确“数量使用报价单数量”。排查转单差异要对比：待报价 num、正式报价明细数量、销售单数量、库存可用数量和最终成交价。

30.2 状态一致性

若销售单创建成功但待报价状态更新失败，可能再次转单；若本地事务提交但 SAAS MQ 失败，外部状态会滞后。必须用来源报价单号/申请 ID 做幂等和补偿。

31. IM 工作台人工报价

31.1 获取商品报价信息

工作台会返回库存、销售价和今日已报价。今日报价来自同一 sid + contactId 当天所有腾讯 IM 会话的 CV_CTX_QUOTED_PRICES，同物料取最新时间。

31.2 保存报价 API

POST /movemall/imworkbench/savequote
Content-Type: application/json

{
  "conversation_id": 80001,
  "inv_id": 30001,
  "price": "128.00",
  "msg_id": "source-message-id"
}

31.3 数据流

sequenceDiagram
  participant UI as IM 工作台
  participant C as ImWorkbench
  participant Conv as 会话表
  participant Context as ConversationContext
  participant IM as IM Center
  UI->>C: saveQuote(conversation, inv, price, msgId)
  C->>Conv: 验证会话存在且 active
  C->>Context: 读取历史查询商品和车型
  C->>C: 找不到时按 invId 补查商品
  C->>Context: 覆盖 invId 对应 quoted price
  C->>IM: 发送 product_inquiry_result
  IM-->>C: 成功或异常
  C-->>UI: success=true, message_sent=bool

31.4 上下文结构

{
  "invId_30001": {
    "invId": 30001,
    "price": "128.00",
    "quotedAt": "2026-01-01 10:00:00",
    "quotedBy": "operator"
  }
}

31.5 已识别的一致性风险

上下文先保存，IM 发送异常被内部 catch，接口仍返回业务成功并通过 message_sent=false 表达发送失败。因此：

• 页面若只看顶层成功提示，坐席可能以为客户已收到。
• 重试发送会再次覆盖 quotedAt，今日最新报价时间变化。
• 没有看到基于 msg_id + inv_id 的本地唯一幂等记录。
• 会话报价没有自动落正式报价单。

32. IM 报价消息结构

{
  "bizType": "product_inquiry_result",
  "bizContext": {
    "conversationId": 80001,
    "conversationStatus": 1,
    "sourceMsgId": "source-message-id"
  },
  "bizData": {
    "inquiryOrderInfo": {"id": 80001},
    "products": [
      {
        "categoryName": "示例分类",
        "items": [
          {
            "invId": 30001,
            "name": "示例商品",
            "price": "128.00",
            "usage": "1",
            "tags": []
          }
        ]
      }
    ],
    "carInfo": null
  }
}

sourceMsgId 用于把报价结果关联回客户原消息，不能用新的发送消息 ID 替代。

33. 今日报价查询

flowchart TD
  A["sid + contactId"] --> B["查当天创建的全部 IM 会话"]
  B --> C["逐会话读取 CV_CTX_QUOTED_PRICES"]
  C --> D["按 invId 合并"]
  D --> E["同商品取 quotedAt 最新"]
  E --> F["按时间倒序返回"]

风险：按会话 created_at 判断“今日”，跨日但仍活跃会话中的当日报价可能被排除；服务器时区必须一致；字符串时间比较依赖统一格式。

34. 最近报价与最近销售价更新

t_contact_price_{sid%64} 同时保存：

• sale_price / sale_last_change_time
• offer_price / offer_last_change_time
• quote_rule_id

flowchart LR
  A["正式报价/报价变更"] --> B["offer_price + time"]
  C["销售成交"] --> D["sale_price + time"]
  E["客户规则变更"] --> F["quote_rule_id"]
  B --> G["t_contact_price_N"]
  D --> G
  F --> G
  G --> H["未来报价规则计算"]

需要继续确认每种报价入口是否都更新 offer_price。IM 会话上下文本身不等于 contact_price，不能默认会参与未来最近报价统计。

35. 价格变更事件

35.1 显式与隐式

sequenceDiagram
  participant Source as 用户操作/基础价变更
  participant QM as QuoteManagerSer
  participant RuleGoods as 规则商品
  participant Event as 变更事件
  participant Detail as 变更明细分表
  Source->>QM: 触发价格重算
  QM->>RuleGoods: 读取 before
  QM->>RuleGoods: 写 after
  QM->>Event: 新建 event
  QM->>Detail: 保存 before/after 价格与配置

变更日志用于解释“为什么今天报价变了”，但前提是所有入口都调用统一事件记录。直接 SQL、迁移或旧链路修改可能没有事件。

36. 导入导出

36.1 固定价导入

模板至少包含：

36.2 导出字段

可包含 SKU、分类、品牌、商品、系列、月销量、适配车系、车型价格范围、采购价、指导价、近 90 天销售价/报价、自定义定价方式、最终自定义价和报价方式。

导入导出通用安全参见 20_导入导出和Excel模板.md。报价专题额外要验证金额单位、公式单元格、重复 SKU、规则归属和变更事件。

37. 版本迁移

stateDiagram-v2
  [*] --> V1
  V1 --> Queued: 创建迁移会话
  Queued --> Migrating
  Migrating --> Success: status=3
  Migrating --> Failed: status=4
  Success --> V2: current_version=2 且会话成功
  Failed --> V1
  V2 --> V1: 回切

迁移内容包括客户分类、客户关系、加价/固定价规则、非价格规则、最近销售价规则、规则商品和站点版本。详细执行治理见 40_数据修复_迁移脚本与临时任务治理.md。

38. 关键缓存和异步链

39. 完整排查入口

用户报告“商品没有价格”时，按以下顺序排查：

flowchart TD
  A["确认 sid/contactId/invId/scene"] --> B{"站点实际走 V1 还是 V2"}
  B --> C{"客户是否关联报价规则"}
  C -->|否| X["补规则关联或确认应无价"]
  C -->|是| D{"规则商品分表是否有配置"}
  D -->|否| Y["同步基础商品并配置报价方式"]
  D -->|是| E{"quote_type 是否为 0"}
  E -->|是| Z["业务配置为不报价"]
  E -->|否| F{"所需价格源是否存在且有效"}
  F -->|否| G["检查最近价时间/指导价/采购价/自定义价"]
  F -->|是| H{"PriceManager 是否被场景、限价、库存覆盖"}
  H -->|是| I["检查完整价格策略"]
  H -->|否| J{"机器人是否又被报价范围过滤"}
  J -->|是| K["检查范围和客户绑定"]
  J -->|否| L["检查接口缓存和前端展示"]

40. 场景化排查表

41. 只读 SQL 模板

41.1 站点版本

SELECT sid, current_version, migrate_session_id, operator, error_msg, modify_time
FROM t_quote_station_version
WHERE sid = :sid;

SELECT id, sid, migrate_type, status, start_time, end_time, error_msg
FROM t_quote_migrate_session
WHERE id = :migrate_session_id;

41.2 客户规则

SELECT rc.sid, rc.contact_id, rc.quote_rule_id, r.name, r.is_delete
FROM t_quote_rule_contact rc
LEFT JOIN t_quote_rule r
  ON r.sid = rc.sid AND r.id = rc.quote_rule_id
WHERE rc.sid = :sid
  AND rc.contact_id = :contact_id;

41.3 商品规则

SELECT sid, quote_rule_id, inv_id,
       quote_type, custom_price_type,
       fix_price, custom_price,
       price_base, price_method, round_type,
       add_amount, add_percent
FROM <t_quote_rule_goods_sid_mod_64>
WHERE sid = :sid
  AND quote_rule_id = :quote_rule_id
  AND inv_id IN (:inv_ids);

41.4 基础商品

SELECT sid, inv_id, sku_id, category_id, brand_id,
       guide_price, last_settle_price, current_settle_price,
       has_stock, stock_qty, is_limit_price, modify_time
FROM <t_quote_goods_base_sid_mod_64>
WHERE sid = :sid
  AND inv_id IN (:inv_ids);

41.5 客户历史价

SELECT sid, contact_id, inv_id, quote_rule_id,
       sale_price, sale_last_change_time,
       offer_price, offer_last_change_time
FROM <t_contact_price_sid_mod_64>
WHERE sid = :sid
  AND contact_id = :contact_id
  AND inv_id IN (:inv_ids)
ORDER BY GREATEST(sale_last_change_time, offer_last_change_time) DESC;

41.6 报价范围

SELECT r.id, r.name, c.category_ids, c.brand_ids
FROM t_scm_quote_range r
LEFT JOIN t_scm_quote_range_config c
  ON c.sid = r.sid AND c.quote_range_id = r.id
WHERE r.sid = :sid
  AND r.id = :quote_range_id;

SELECT quote_range_id, contact_id
FROM t_scm_quote_range_contact
WHERE sid = :sid
  AND contact_id = :contact_id;

41.7 待报价和正式报价

SELECT id, bu_id, bill_no, inv_id, num, status, conversation_key, created_time
FROM t_scm_robot_offer_order_apply
WHERE id IN (:apply_ids);

SELECT o.id, o.sid, o.buId, o.billNo, o.billDate, o.obsolete,
       i.id AS info_id, i.invId, i.skuId, i.price, i.obsolete AS info_obsolete
FROM t_scm_offer_order o
JOIN t_scm_offer_order_info i ON i.billNo = o.billNo AND i.sid = o.sid
WHERE o.sid = :sid
  AND o.billNo = :bill_no;

SQL 仅作字段和关系模板，生产 DDL、字段名和分片必须先核验。

42. 代码检索命令

rg -n "function getGoodsPrices|getRecentSalePrices|calculateCustomPrice" \
  application/Services/BaseData/QuoteManagerBaseSer.php

rg -n "function ruleSet|batchSetQuoteType|batchSetCustomPrice|addChangeEventRecord" \
  application/Services/BaseData/QuoteManagerSer.php

rg -n "getQuoteRange|setQuoteRange|batchQuoteRangeConfig|bindQuoteRangeContact" \
  application/controllers/moveMall/Wechat.php application/Services/MoveMall/WechatSer.php

rg -n "applyOffer|passOrders|toSaleOrders|invalidOrders" \
  application/Services/MoveMall/OfferOrderApplySer.php

rg -n "saveQuote|getTodayQuotes|CV_CTX_QUOTED_PRICES|sourceMsgId" \
  application/controllers/moveMall/ImWorkbench.php application/Services/MoveMall/RobotV2

rg -n "QUOTE_TYPE_|CUSTOM_PRICE_TYPE_|PRICE_BASE_|ROUND_TYPE_" \
  application/KzData/Enums/QuoteRuleGoodsEnums.php

43. 故障树

flowchart TD
  A["报价结果错误"] --> B{"是查不到商品还是没有价格"}
  B -->|查不到商品| C["商品搜索/车型/VIN/报价范围/可售库存"]
  B -->|有商品无价格| D["版本/客户规则/商品配置/价格源"]
  B -->|价格数值错误| E["金额单位/quote_type/real_quote_type/基础价/取整"]
  B -->|回复未送达| F["会话状态/IM发送/sourceMsgId/message_sent"]
  B -->|无法转单| G["申请状态/客户状态/报价单/库存/销售校验"]
  C --> H["确认具体失败层"]
  D --> H
  E --> H
  F --> H
  G --> H

44. 已识别风险

45. 回归矩阵

45.1 报价方式

• [ ] 不报价返回 has_price=false。
• [ ] 当前客户最近售价有值和无值。
• [ ] 共用最近售价的客户优先和站内兜底。
• [ ] 同组最近售价只取规则关联客户。
• [ ] 指导价为正和为 0。
• [ ] 固定自定义价上下边界。
• [ ] 动态价按指导价/采购价。
• [ ] 金额加价和百分比加价。
• [ ] 三种取整方式。
• [ ] 组合规则 6/7 的最近价命中和自定义兜底。
• [ ] 现金价、充值价为正和为 0。

45.2 规则配置

• [ ] 新增、编辑、同名冲突、复制、删除。
• [ ] 一个客户从旧规则切到新规则。
• [ ] 商品批量设置 1 条、2000 条边界和超限。
• [ ] 导入成功、部分错误、重复 SKU、金额格式错误。
• [ ] 价格变更事件前后值和操作人正确。
• [ ] 基础价变化触发动态价隐式变更。

45.3 报价范围

• [ ] 系统默认范围。
• [ ] 指定分类+指定品牌。
• [ ] 指定分类+全部品牌。
• [ ] 全部分类+指定品牌。
• [ ] 重复组合拒绝。
• [ ] 客户切换范围和恢复系统模板。
• [ ] 空配置不会被误理解为禁止全部。

45.4 智能询价

• [ ] VIN 文本、VIN 图片、单车型、多车型、解析失败。
• [ ] 关键词、同义词、品牌、规格、方位。
• [ ] 无车轮胎、电池、油品。
• [ ] 有商品有价、有商品无价、无商品、有价无库存。
• [ ] 客户未开通询报价。
• [ ] 会话 10 分钟报价等待和 1 小时过期。
• [ ] 用户回复序号下单。

45.5 待报价和转单

• [ ] 创建待报价、重复消息幂等。
• [ ] 作废后不能通过。
• [ ] 已通过不能重复通过。
• [ ] 客户禁用/删除。
• [ ] 热销商品价格限制。
• [ ] 多明细同客户合并规则。
• [ ] 正式报价主从数量、价格一致。
• [ ] 转销售数量、价格、来源单号一致。
• [ ] SAAS 消息失败后的补偿。

45.6 IM 人工报价

• [ ] 会话不存在、非 active、商品不存在。
• [ ] 价格 0、负数、非数字和超大值。
• [ ] 缺 msg_id。
• [ ] 同物料重复报价取最新。
• [ ] 上下文保存成功、IM 发送成功。
• [ ] 上下文成功、IM 发送失败时页面明确提示。
• [ ] 跨日会话的今日报价。
• [ ] 并发坐席对同物料报价。

46. 改动风险和最小回归

47. 生产待确认项

1. t_quote_rule_contact 是否有 sid + contact_id 唯一索引。
2. t_quote_rule_goods_N 是否有 sid + quote_rule_id + inv_id 唯一索引。
3. t_quote_goods_special_price 的站点开关为何在代码中固定为 true。
4. 正式报价主从表 price 的生产金额单位和完整 obsolete 枚举。
5. 待报价转正式报价时数据库事务和并发锁的真实范围。
6. 待报价、正式报价和销售单之间的生产唯一来源字段。
7. 各报价入口更新 t_contact_price.offer_price 的完整清单。
8. IM 会话人工报价是否应同步正式报价单或客户最近报价。
9. 价格基础商品同步任务的调度频率、水位和失败告警。
10. V1/V2 的实际站点比例和回退开关。
11. 微信群、腾讯 IM、APP、PC 使用 PriceManager 的场景参数差异。
12. SAAS 报价状态 MQ 的 routing key、重试、死信和消费者幂等。
13. VIN/车型/物料服务的超时、缓存和降级策略。
14. 报价范围新旧表的流量归属和迁移完成度。
15. 报价、限价、活动价、VIP 价在最终 getFullPrice() 中的完整优先级。

48. 证据索引

49. 最终理解

flowchart LR
  A["规则正确"] --> F["可解释报价"]
  B["范围正确"] --> F
  C["商品/价格快照及时"] --> F
  D["会话和消息可靠"] --> F
  E["报价单与销售转化幂等"] --> F

报价系统的正确性不是“算出一个数字”这么简单。它要求：客户拿到的是自己应有的规则，商品处于允许展示的范围，价格来源和有效期可解释，人工与自动报价不会互相覆盖，报价转销售时数量和价格不变，并且任何一次价格变化都能追溯到规则、基础价、操作人或历史成交。

请求-日志-数据变更追踪卡

多入口请求链路

日志证据矩阵

| 链路段 | 日志来源 | 可检索锚点 | 成功信号 | 失败信号 | 与下一段关联方式 | | --- | --- | --- | --- | --- | --- | --- | | 规则命中 | QuoteManager/PriceManager Service | request_id、sid、customer、SKU、rule ID | 唯一可解释规则和基准价 | 多规则冲突、过期/范围误命中 | rule ID 进入报价计算 | | 智能识别 | SmartInquiry/Robot/AI | conversation/request ID、VIN、scenario | 候选商品和置信/来源可追踪 | VIN 解析/AI 超时、场景错 | request ID 关联 offer apply | | 报价落库 | Offer Service | offer ID、SKU、price source、operator | 主明细 commit | 人工/自动覆盖、价格过期 | offer ID 查 SCM_OFFER_ORDER | | 转销售 | InvSa/SaOrderSer | offer ID、sale billNo、SKU、price/qty | 数量价格快照保持一致 | 重复转换、转单价格被重算 | offer/sale 双向关系 |

环节数据变更台账

子模块追踪：quote-rule 报价规则配置

子模块追踪：quote-customer 客户绑定与报价范围

子模块追踪：quote-goods 商品配置与基础商品

子模块追踪：quote-calculate 最终价格计算

子模块追踪：quote-recent 最近报价与最近销售价

子模块追踪：smart-input 智能询价输入识别

子模块追踪：smart-decision 自动报价决策

子模块追踪：offer-apply 待报价申请

子模块追踪：offer-order 正式报价单

子模块追踪：offer-to-sale 正式报价转销售

子模块追踪：offer-im IM 工作台人工报价