Address
304 North Cardinal St.
Dorchester Center, MA 02124
Work Hours
Monday to Friday: 7AM - 7PM
Weekend: 10AM - 5PM
Customer Management Guide
客户与订单管理配置说明
按步骤把整条业务链跑通
适用场景：你要完整启用公库 / 私库、客户新增、客户跟进、发报价、申请合同、认领付款、下订单、交单、售后跟进和售后增值服务。
这份说明只写当前系统里已经落地、可以直接配置的内容，尽量避免“理想设计”和实际实现脱节。
6 张核心表
3 类上下文
9 个配置 Tab
10 条联调验证
3 类上下文
9 个配置 Tab
10 条联调验证
推荐主链路
- 客户先进入私库，再成交
- 先认领到账，再发报价或交单
- 交单前先完成合同审批
- 成交后继续承接到运营 / 售后
一、先定业务口径
如果你希望整条链条稳定，建议先统一这几个规则，再开始配表和字段。
推荐模式
`claim_then_order`
- `require_private_customer_before_order = true`
- `require_finance_claim_before_order = true`
- `require_contract_approval_before_submit_order = true`
- `require_operator_after_cooperation = true`
先统一的三类上下文
- 客户上下文：客户 ID、客户名称、负责人、公私池状态
- 财务上下文：到账记录、认领人、匹配客户
- 审批上下文：合同审批单号、交单审批单号、合同号
二、先准备 6 张核心表
想把完整链路跑通，不要只配客户主表，至少把下面 6 张表和 1 个关系准备好。
| 对象 | 作用 | 关键说明 |
|---|---|---|
| 客户主表 | 公库 / 私库、客户详情、客户摘要 | 整条链的主对象，必须最先配稳 |
| 跟进记录表 | 跟进内容、最近跟进、下次跟进、提醒计算 | 负责给客户主表回写跟进摘要 |
| 财务到账表 | 到账认领、付款信息、到账时间 | 如果要先认领到账再成交，这张表必不可少 |
| 报价草稿表 | 发报价、合同申请来源、报价详情 | 后续合同审批、交单常常都从这里承接 |
| 正式订单表 | 交单、正式成交、审批承接 | 成交主链路核心表 |
| 合同衍生单表 | 扩容、增购、续费、退款 | 售后和客户续费摘要的主对象 |
必须关系：`finance_to_customer`。如果成交模式要求先认领到账，这个关系必须启用，而且不能是 `disabled`。
三、每张表哪些字段必须有
下面这部分建议直接对着你的表去看，先补最小闭环，再补扩展字段。
客户主表
主链路必配
- 客户名称
- 客户编号
- 负责人
- 公私池状态
- 私库开始时间
- 私库到期时间
- 最近跟进时间
- 下次跟进时间
财务到账表
硬必填
- 付款账号字段
- 收款账号字段
- 金额字段
- 到账时间字段
认领付款时还要有
- 匹配客户 ID 字段
- 认领人字段
合同衍生单表
硬必填
- 关联客户 ID 字段
- 客户名称字段
- 来源合同号字段
- 变更类型字段
- 变更状态字段
- 生效时间字段
- 变更后到期字段
- 变更摘要字段
跟进记录表
- 关联客户 ID
- 客户名称
- 跟进人
- 跟进方式
- 跟进内容
- 跟进时间
- 下次跟进时间
报价草稿表
- 关联客户 ID
- 客户名称
- 需要先认领到账时：到账记录 ID
- 合同审批承接：审批单号、合同号
- 交单审批承接：交单审批单号
正式订单表
- 关联客户 ID
- 客户名称
- 合同号
- 订单状态
- 交单人
- 交单时间
- 草稿转订单时：报价草稿 ID
- 先收款时：到账记录 ID
四、关键动作启用前要满足什么
这几段是最容易踩坑的地方，动作本身不是重点，上下文是否完整才是重点。
发报价
- 必须先配置报价录入模板 `entry_config_id`
- 必须有报价草稿表
- 草稿表至少要有客户 ID、客户名称
- 如果先认领到账，草稿表还要能承接到账记录 ID
认领付款
- 财务表必须有匹配客户 ID 字段
- 财务表必须有认领人字段
- 建议同时配置认领状态、认领时间
申请合同号
- 必须先配置 `contract_apply_source`
- 如果从报价草稿承接，则草稿表要有审批单号、合同号
- 如果允许从客户入口发起，则客户表或草稿表至少一边能承接审批单号和合同号
交单 / 正式订单
- 必须先有正式订单表
- 必须有客户、合同、交单人、交单时间等基础上下文
- 草稿转订单时必须有报价草稿关联字段
- 默认先收款时必须有到账记录字段
- 特批 / 虚拟交单时必须有交单模式字段和审批单号字段
如果当前成交模式要求“交单前先完成合同审批”，启用交单前必须先配置 `contract_apply_source`，并保证客户入口或报价草稿入口能承接合同审批上下文。
五、按 Tab 的推荐配置顺序
下面这 9 步，基本就是你在后台从左到右最稳的配置顺序。
1
总览
先选 6 张表，先定成交模式，先决定是否先私库、先认领到账、先合同审批。
2
客户
先把客户名称、编号、负责人、公私池状态、私库时间、跟进时间这些客户底座配通。
3
跟进
把跟进表关联、跟进内容、跟进时间、下次跟进、提醒频率配好，让摘要能回写客户主表。
4
财务
把付款账号、收款账号、金额、到账时间、匹配客户、认领人配好，并启用 `finance_to_customer`。
5
报价
选报价草稿表，选报价录入模板，补齐客户 / 财务 / 审批上下文，保证报价能承接后续链路。
6
订单
配置正式订单表、交单动作、是否直接新增订单、是否先收款，以及审批承接字段。
7
售后
配置合同衍生单表、扩容 / 增购 / 续费 / 退款动作，并检查是否回写客户主表摘要。
8
入口
配置工作台入口、角色可见范围和深链，让销售、运营、管理员进到各自该看的页面。
9
提醒
最后再补客户跟进、报价跟进、订单跟进、售后到期和财务待处理提醒。
六、详情和录入字段的使用规则
详情配置
- 已覆盖：客户、报价草稿、正式订单、售后 4 个详情域
- `editable_fields` 必须属于 `detail_display_fields`
- `readonly_fields` 不能和 `editable_fields` 冲突
- 核心关系字段仍受后端保护，不能随意编辑
动作表单配置
- `create_customer`、`create_order_draft`、`submit_order` 支持 `form_fields`
- 但不建议直接放入：人员、附件、多选、复选框、公式、自动编号、创建/修改时间、地理位置
- 优先把表单字段控制在文本、数字、单选、日期等基础类型
前端交互口径建议统一：日期字段显示“点击选择日期”，点击整块弹日历，不允许手输；单选字段显示中文 `label`，内部仍保留编码值。
七、一轮联调最少验证什么
主链路验证
- 新增客户后是否进入预期池子
- 跟进写入后是否回写客户摘要
- 公库 / 私库切换是否符合规则
- 到账是否能认领到客户
- 报价是否能承接客户和到账上下文
后链路验证
- 合同审批单号和合同号能否正确承接
- 正式订单是否带齐客户、合同、报价、到账、审批上下文
- 售后动作是否写入合同衍生单表
- 售后摘要是否回写客户主表
- 详情页日期与单选交互是否符合当前标准
