企业微信CRM模块功能设计（一）—— 升鲜宝生鲜配送供应链管理系统源代码

企业微信CRM模块功能设计（一）—— 升鲜宝生鲜配送供应链管理系统源代码

1. 文档说明

本文档用于定义升鲜宝生鲜配送供应链管理系统----CRM 整合版的数据结构、表职责、字段语义、核心关系和业务约束。

设计来源包括：

升鲜宝现有 CRM/客户经营相关表：crm_lead、crm_contact、crm_customer_pool、crm_customer_visit、crm_customer_sign、crm_plan_visit、crm_plan_visit_info、crm_sales_team、crm_sales_team_member、crm_task、crm_opportunity、crm_payment、crm_payment_plan 等。

• 升鲜宝现有客户/财务/价格/账期相关表：客户主档字段片段、cus_customer_period、cus_customer_source、cus_customer_star、cus_customer_price、cus_customer_balance_info、fin_customer_bill、fin_collection_order*。
• CRM 功能文档中明确提出的功能：线索池、客户公海配置、客户限制配置、客户标签、发票管理、团队管理、成员管理、业绩管理、企业微信配置/员工/客户。
• CRM SQL 中更完整的标准表：crm_clue、crm_customer、crm_business、crm_business_status_type、crm_business_status、crm_contact_business、crm_customer_pool_config、crm_customer_limit_config、crm_follow_up_record、crm_receivable_plan 等。

2. 整合原则
   2.1 客户主数据不重复建设

升鲜宝现有业务表已大量使用 shop_id / trade_id 表达客户主档关系，因此 CRM 不再单独启用一张新的 crm_customer 作为唯一客户主表，而是采用“现有客户主档 (mall_shop)+ CRM 扩展画像”的方式。现有客户主档已具备 advance_payment、credit_amount、customer_balance、debt_amount、customer_source_id、customer_star_id、period_id 等核心字段。

2.2 合同与正式收款复用供应链/财务域

合同统一复用 cus_customer_contract，正式收款统一复用 fin_collection_order；CRM 的合同、应收、回款计划更多承担“销售过程管理”和“业务视图”角色。

2.3 字段风格统一采用升鲜宝规范

整合版统一采用升鲜宝现有字段风格：

审计：create_date、creator、update_date、updater
状态：enabled
删除：del_flag
组织：dept_id。

3. 数据域划分

   升鲜宝 CRM 建议划分为 10 个数据域：

• 3.1字典域
• 3.2客户域
• 3.3线索域
• 3.4联系人域
• 3.5商机域
• 3.6合同与回款域
• 3.7团队、任务、拜访域
• 3.8信用结算域
• 3.9消息提醒域
• 3.10企业微信集成域

这些数据域既覆盖 CRM 功能文档中的线索、客户、商机、合同、回款、团队、企业微信，也与升鲜宝现有表结构保持一致。

4. 字典域
   4.1 cus_customer_period

表说明：客户账期表。
用途：定义客户结算账期规则，供客户主档、信用档案、账单计算、应收到期日计算使用。
关键字段：

id：账期 ID
customer_period_name：账期名称
customer_period_date：固定天数
period_type：账期类型，0=固定天数，1=固定日期
period_day：固定日期（日）
enabled / del_flag：状态控制。

4.2 cus_customer_source

表说明：客户来源表。
用途：标准化客户来源、线索来源、CRM 统计口径。
关键字段：

id
source_name
use_count
enabled
del_flag。

4.3 cus_customer_star

表说明：客户星级表。
用途：表达客户等级、客户价值层级。
关键字段：

id
star_name
url_image
use_count
enabled
del_flag。

4.4 建议新增 crm_opportunity_stage_group

表说明：商机阶段组。
用途：用于按部门/业务线配置不同销售流程。
来源依据：独立 CRM 已有 crm_business_status_type，用于定义商机状态组。

4.5 建议新增 crm_opportunity_stage

表说明：商机阶段表。
用途：维护阶段名称、赢单率、排序。
来源依据：独立 CRM 已有 crm_business_status。

5. 客户域
   5.1 现有客户主档（表名(mall_shop)以客户主表为准）

表说明：客户主数据中心。
用途：承载客户基础信息、结算、配送、价格模式等核心属性。
当前可见关键字段：

advance_payment：预付款
credit_amount：信用额度
customer_balance：客户余额
customer_source_id：客户来源
customer_star_id：客户星级
debt_amount：欠款
pricing_mode：定价模式
period_id：账期 ID
price_ratio：客户折扣
delivery_type_id、line_id、workhouse_id：配送和仓配信息。

5.2 建议新增 crm_customer_profile

表说明：客户 CRM 画像扩展表。
用途：在不重复建设客户主表的前提下，补充 CRM 专属经营字段。
建议字段：

customer_id
owner_id
follow_up_status
contact_last_time
contact_last_content
contact_next_time
deal_status
lock_status
health_score
loss_risk_level
wecom_external_user_id
org_id、dept_id

设计依据：独立 CRM crm_customer 已经具备跟进状态、最后/下次联系时间、锁定状态、成交状态等字段。

5.3 crm_customer_pool

表说明：客户公海表。
用途：承载进入公海的客户记录。
关键字段：

id
shop_id
added_at
enabled
del_flag。

5.4 建议新增 crm_customer_pool_config

表说明：客户公海配置表。
用途：控制客户多久未跟进进入公海、多久未成交进入公海、提前提醒规则。
建议字段来源：独立 CRM 已有成熟设计：

enabled
contact_expire_days
deal_expire_days
notify_enabled
notify_days。

5.5 建议新增 crm_customer_limit_config

表说明：客户持有/锁定上限配置表。
用途：控制业务员客户持有数、锁定客户数等。
设计依据：CRM 文档明确提到客户限制配置，独立 CRM 中已有 crm_customer_limit_config 的数据结构。

5.6 建议新增 crm_customer_tag

表说明：客户标签表。
用途：客户标签定义。
设计依据：CRM 文档明确提出“客户标签”“新增客户标签”。

5.7 建议新增 crm_customer_tag_rel

表说明：客户标签关系表。
用途：客户与标签的多对多关系。
关键字段：

customer_id
tag_id

6. 线索域
   6.1 crm_lead

表说明：现有线索表。
用途：承载升鲜宝当前 CRM 线索。
当前字段特征：

lead_name
contact_name
contact_phone
company
source
status
owner_id。

6.2 线索表改造建议

现有 crm_lead 字段偏轻，而 CRM 文档和独立 CRM 的 crm_clue 已经明确要求支持：

跟进状态
最后跟进时间/内容
下次联系时间
转化状态
客户编号
手机、电话、QQ、微信、邮箱
地区、详细地址
所属行业
客户等级
客户来源。

因此建议在 crm_lead 上补充：

follow_up_status
contact_last_time
contact_last_content
contact_next_time
transform_status
customer_id
mobile
telephone
qq
wechat
email
area_id
detail_address
industry_id
level
source_id

6.3 建议新增 crm_lead_pool

表说明：线索池表。
用途：线索放池、线索领取、线索回收。
设计依据：文档明确提出线索池、线索放入线索池、从线索池中领取线索。

6.4 建议新增 crm_lead_pool_config

表说明：线索池规则表。
用途：控制线索多久未跟进进入线索池、提醒策略、领取策略。
设计依据：文档明确提出“线索池配置”。

7. 联系人域

   7.1 crm_contact

表说明：联系人表。
用途：承载客户联系人及销售联系信息。
现有/标准字段参考：

name
customer_id / shop_id
contact_last_time
contact_last_content
contact_next_time
owner_user_id
mobile
telephone
email
qq
wechat
area_id
detail_address
sex
master（是否关键决策人）
parent_id（直系上属）
post
remark。

7.2 建议新增 crm_contact_opportunity_rel

表说明：联系人与商机关联表。
用途：支持一个联系人参与多个商机。
设计依据：独立 CRM 已有 crm_contact_business。

8. 商机域

   8.1 crm_opportunity

表说明：商机表。
用途：承载商机名称、客户、团队、金额、预计成交日期、阶段、概率、负责人等。
当前字段：

shop_id
team_id
name
amount
expected_close
stage
probability
owner_id。

8.2 商机表改造建议

建议补充：

follow_up_status
contact_last_time
contact_next_time
status_type_id
status_id
end_status
deal_time
total_product_price
discount_percent
total_price
source_lead_id

设计依据：独立 CRM 的 crm_business 已支持这些能力。

8.3 建议新增 crm_opportunity_product

表说明：商机产品明细表。
用途：记录商机对应的产品、数量、单价、折扣后价格。
设计依据：独立 CRM 已有 crm_business_product。

9. 合同与回款域
   9.1 cus_customer_contract

表说明：客户合同主表。
用途：正式合同承载表。
关键字段：

contract_code
trade_id
contract_no
contract_title
contract_start_date
contract_end_date
bill_state
team_id
total_amount
tax_rate
tax_amount
freight。
9.2 cus_customer_contract_info

表说明：合同明细表。
用途：合同商品行。

9.3 cus_customer_contract_image

表说明：合同附件表。

9.4 cus_customer_contract_log

表说明：合同日志表。

9.5 crm_payment_plan

表说明：CRM 回款计划表。
用途：记录计划应收。
当前字段：

contract_id
phase
amount
due_date
status。
9.6 crm_payment

表说明：CRM 回款记录表。
用途：记录业务层回款登记。
当前字段：

plan_id
method
amount
received_date。

9.7 fin_collection_order

表说明：正式财务收款单主表。
用途：财务正式入账。
当前字段：

collection_code
collection_date
trade_id
account_id
bill_state
receivables_money
real_pay_amount
differences_amount
collection_state
erase_amount。

9.8 建议新增 crm_invoice

表说明：CRM 发票主表。
用途：承载“我的发票 / 下属发票 / 新增发票”。
设计依据：CRM 文档明确提出发票管理。

9.9 建议新增 crm_invoice_log

表说明：发票日志表。

10. 团队、任务、拜访域
    10.1 crm_sales_team

表说明：销售团队表。
字段：

parent_id
leader_id
team_name
description。
10.2 crm_sales_team_member

表说明：销售团队成员表。
字段：

team_id
user_id。
文档中明确要求“一个团队里面有多个成员，一个成员只属于一个团队”。

10.3 crm_task

表说明：任务表。
用途：承载待办、跟进任务。
字段：

name
description
related_type
related_id
owner_id
due_date
priority
status。

10.4 crm_plan_visit

表说明：拜访计划主表。
字段：

plan_code
plan_name
plan_content
salesman_id
plan_start_visit_date
plan_end_visit_date
bill_state。
10.5 crm_plan_visit_info

表说明：拜访计划明细表。
字段：

plan_code
shop_id
visit_type
bill_state。

10.6 crm_customer_visit

表说明：客户拜访执行表。
字段：

visit_code
shop_id
visit_type
visit_content
visit_date
visit_status
salesman_id。
10.7 crm_customer_sign

表说明：客户拜访签到表。
字段：

visit_id
visit_code
sign_type
sign_date
longitude
latitude
sign_address
sign_image。

11. 信用结算域
    11.1 建议新增 cus_customer_credit_profile

表说明：客户信用结算档案表。
用途：统一管理账期、授信、余额、欠款、逾期。
设计依据：现有客户主档已包含 credit_amount、customer_balance、debt_amount、period_id，现有账期、余额流水、账单、收款单也都已具备，因此适合做统一信用结算中台表。

11.2 cus_customer_balance_info

表说明：客户余额流水表。
字段：

customer_id
customer_account_id
amount
order_code
record_type
reason。
11.3 建议新增 cus_customer_credit_change_log

表说明：授信变更流水表。

11.4 建议新增 cus_customer_credit_occupy_log

表说明：授信占用/释放流水表。

11.5 fin_customer_bill

表说明：客户账单表。
字段：

shop_id
bill_start_date
bill_end_date
before_debt_amount
present_amount
erase_amount
debt_amount
reconciler_state。

12. 消息提醒域
    12.1 sys_notice

表说明：通知主表。
字段：

type
title
content
receiver_type
receiver_type_ids
status
sender_name
sender_date
notice_category。
12.2 sys_notice_user

表说明：通知接收人与阅读状态表。
字段：

receiver_id
notice_id
read_status
read_date。

12.3 建议新增 crm_reminder_rule

表说明：CRM 提醒规则表。
用途：统一配置跟进提醒、公海提醒、回款提醒、拜访提醒。
设计依据：CRM 文档和独立 CRM 已明确存在“客户公海配置提前提醒”“线索池配置”“回款计划提醒”。

12.4 建议新增 crm_reminder_message

表说明：CRM 提醒消息表。

12.5 建议新增 crm_reminder_escalation_log

表说明：提醒升级日志表。

13. 企业微信集成域
    13.1 建议新增 crm_wecom_config

表说明：企业微信配置表。

13.2 建议新增 crm_wecom_user

表说明：企业微信员工映射表。

13.3 建议新增 crm_wecom_customer

表说明：企业微信客户映射表。

设计依据：CRM 文档明确提出企业微信配置、企业微信员工、企业微信客户。

14. 关键枚举建议
    14.1 线索状态
    0：未转化
    1：已转化
    来源：现有 crm_lead.status。

14.2 线索跟进状态（建议）
新客
待再次沟通
有意向
已加微信
转商机
无效
来源：CRM 文档明确列出。
14.3 商机终态（建议）
1：赢单
2：输单
3：无效
来源：独立 CRM crm_business.end_status。

14.4 客户公海规则
contact_expire_days：未跟进进入公海天数
deal_expire_days：未成交进入公海天数
notify_enabled
notify_days。

14.5 拜访状态
-1：取消拜访
0：待拜访
1：拜访中
2：拜访结束
3：已延期
来源：crm_customer_visit.visit_status。

14.6 拜访签到类型
0：签到
1：签出
来源：crm_customer_sign.sign_type。

14.7 回款状态
0：未回款
1：已回款
来源：crm_payment_plan.status。

14.8 信用状态（建议）
0：禁用
1：正常
2：预警
3：冻结

15. 核心关系说明
    客户主档 1 对 1 对应 crm_customer_profile。
    客户主档 1 对多 对应 crm_contact、crm_customer_pool、crm_customer_visit、crm_plan_visit_info、crm_opportunity、cus_customer_contract、crm_payment_plan、crm_payment、fin_customer_bill、cus_customer_balance_info。
    商机 1 对多 对应商机产品；商机与联系人为多对多。独立 CRM 已给出商机产品和联系人商机关联的设计范式。
    合同 1 对多 对应合同明细、回款计划、回款记录。
    余额、欠款、授信通过 cus_customer_credit_profile 统一汇总，明细分别来自余额流水、账单、收款单、应收计划。