一款go语言的开源客户管理系统（CRM）

一套面向中小企业的一体化销售管理平台，覆盖线索 → 客户 → 商机 → 报价 → 合同 → 订单 → 回款 → 发票（L2C，Lead to Cash）的完整商业闭环。以销售过程管理为主线，兼顾协同办公、审批流转与经营分析，帮助企业把销售从"靠经验"变为"靠流程"，从"结果不可控"变为"过程可管理"。

一、行业对标：CRM 核心功能全景

市面主流 CRM（Salesforce、Microsoft Dynamics 365、纷享销客、销售易等）通常由五大核心模块构成。下表为行业公认的核心能力与 kzhcrm 的覆盖情况：

kzhcrm 已完整落地L2C 主交易闭环 + 查重防撞单 + 批量导入导出 + 销售预测/业绩目标 + AI线索评分 + 营销自动化 + 客服工单 + 审批 + 数据权限 + 自定义扩展 + 移动端，属于"以销售为核心、兼顾营销与服务"的轻量一体化 CRM；增强报表、线索自动分配、真实群发网关对接等能力见文末「规划路线图」。

二、功能明细

1. 客户与线索

• 客户管理：客户增删改查、批量转移负责人、详情查看全部字段、客户标签（如"重点客户/可复购"）、自定义扩展字段
• 客户查重 / 防撞单：新增客户时按「公司名 / 电话」自动查重，命中疑似重复客户即弹出确认（展示已占用客户与负责人，引导先核实再保存），并对导入数据同步防重——从源头避免同一客户被多个销售重复登记
• 批量导入 / 导出：客户与线索支持一键导出 CSV（按当前数据权限范围）与批量导入；导入按 公司名/电话 自动去重，重复行跳过并统计「新增 / 重复 / 失败」数量，导出的 CSV 自动带 BOM，Excel 打开中文不乱码
• 联系人：为客户维护多个联系人档案（电话、邮箱、职位等）
• 线索管理：线索登记，支持线索所属来源/渠道记录；可分配给负责人；一键转换为客户并自动派生商机，实现"从他提到成交"的全链路承接
• AI 线索评分：对每条线索自动计算 0~100 意向分 + A/B/C 档位（规则加权 + 纯 Go 逻辑回归监督增强），列表按意向排序、高意向线索自动提醒负责人；管理员可一键训练模型，评分依据随成交数据持续自学习
• 线索→商机派生：转换时自动把线索金额、预计成交时间带往新商机，减少重复录入

2. 销售过程（商机看板）

• 可视化管道：商机以看板卡片按阶段分组展示，拖拽即可推进阶段（新建 → 跟进 → 方案 → 谈判 → 成交 → 赢单）
• 阶段自定义：管理员可配置管道与各阶段名称、顺序，贴合企业实际打单流程
• 商机信息：金额（自动分↔元换算）、预计成交时间、关联客户、自定义字段，成交进度一目了然

3. 成交与收款（L2C 闭环）

• 产品目录：统一产品资料，为报价与订单提供标准价格依据
• 报价：生成报价单，可提交审批；审批驳回后修改可再次提交
• 合同：合同档案 + 回款计划 + 回款记录 + 发票四层结构，全程可控；草稿可提交审批
• 订单：新建订单并逐状态推进（待交付/已交付/结算等），新单可提交审批；进入结算自动生成同日的回款记录，杜绝漏记
• 收款看板：合同回款计划与实收对比，跟踪回款进度，防范坏账

4. 协同与提醒

• 跟进时间线：对客户/商机随时记录电话、拜访、会议、邮件等跟进，可设定下次跟进时间，形成完整跟进轨迹
• 任务管理：个人待办任务，支持标记完成
• 到期提醒：跟进到期、任务到期由后台任务自动生成站内通知，顶部铃铛实时统计未读，避免遗忘关键节点

5. 审批中心

• 审批模板：按业务类型（报价/合同/订单）配置多级审批模板，支持动态增删审批层级
• 审批视角：待办 / 我处理的 / 我发起的三视图
• 审批动作：通过、驳回（任一环节驳回立即终止）、撤回；多级审批进度全程可视化
• 闭环写回：审批结果自动写回业务状态——报价转生效、合同转生效、订单推进，审批无需人工同步

6. 数据分析（销售驾驶舱）

• 数据概览：客户/商机/合同/回款等核心指标一览，掌握经营全貌
• 销售漏斗：各阶段商机数量与金额分布，识别打单瓶颈环节
• 业绩看板：按业务员的业绩排行，营造团队竞争氛围
• 销售预测与业绩目标：销售预测页按「进行中商机 × 阶段成交概率」折算未来 6 个月预期业绩；管理员/经理可逐月为成员设置业绩目标，实时展示「本月赢单 vs 目标」达成率与每人目标/赢单/在进行预期对比，便于季度冲刺与经营预判
• 收款看板：回款计划与实收进度，跟踪现金流

6.1 营销自动化

• 市场活动：活动策划与管理（名称、投放渠道、类型、预算、状态、起止日期），活动档案留痕，为渠道分析提供依据
• 客户细分：按等级 / 标签 / 行业 / 关键词多条件筛选客户并统计，快速定位目标受众，为群发做准备
• 渠道贡献分析：按线索来源聚合「线索量 → 转商机 → 赢单数 → 赢单金额 → 商机转化率 → 赢单转化率」，量化各渠道 ROI，指导投放
• 群发任务：从客户细分一键发起短信/邮件群发任务（记录受众、内容、目标数量与状态），打通"细分 → 触达 → 沉淀"闭环（真实网关对接见路线图）

6.2 客户服务

• 服务工单：新建工单（类别：投诉/咨询/售后/维修；优先级；可指派处理人），支持处理回复时间线、关闭工单并填写处理方案与满意度评分
• 知识库：客服可沉淀常见问题与排障文章，支持分类与搜索，为一次解决提供支撑
• 服务度量：实时统计待处理数、已解决数、平均首响时长、一次解决率（FCR）、平均满意度 及工单状态分布，量化客服响应与质量

7. 系统管理与扩展

• 用户管理：账号 + 角色（管理员/部门经理/销售）+ 所属部门 + 自定义字段
• 组织架构：多级部门树，可设部门经理；删除部门前强制清理子部门并自动解除成员归属（防误删）
• 字段配置：为 客户/商机/用户 自定义扩展字段（文本/数字/日期/下拉/多行），支持必填、启用、排序，自动注入表单与详情——无需改代码即可扩展数据模型
• 审批模板：多级审批人可视化配置
• 清空并重建测试数据：一键生成一套演示数据（客户、线索、商机、报价、合同、订单、产品等），便于演示与验收

三、数据权限

四、技术架构

目录结构

kzhcrm/
├── main.go
# 入口：配置加载、建表、路由、端口冲突处理
├── build.bat
# Windows 构建脚本（产出 Windows .exe 与 Linux ELF）
├── config.yaml
# 运行配置（数据库、JWT、COS 等，已被 .gitignore 排除）
├── configs/
# 配置结构体与加载
├── controllers/
# 业务逻辑（客户/商机/合同/审批/营销/客服/线索评分等）
├── middleware/
# 认证与数据权限中间件
├── models/
# 数据模型与自动建表
├── routers/
# 路由注册
├── templates/
# 前端页面与静态资源
└── utils/
# 工具（COS、通用响应、leadscore 评分引擎等）

五、接口约定

• 除页面与静态资源外，所有接口一律使用 POST + JSON（因加解密要求统一）
• 鉴权：请求头携带 Authorization: Bearer
• 统一响应结构：{ "code": 0, "msg": "...", "data": {} }；code=401 时前端自动跳转登录页
• 金额字段后端统一按「分」存储，前端展示换算为「元」
• 时间字段后端统一返回 RFC3339 字符串（含时区）；前端经 fmtTime 展示为本地时间 YYYY-MM-DD HH:mm，纯日期字段（活动起止等）原样显示
• api.js 全局引入，封装请求、token 管理与统一提示

六、构建与部署

Windows 构建

build.bat

自动完成：检查/下载 UPX → 清理旧文件 → 编译 Windows 可执行文件（.exe）→ 编译 Linux 静态可执行文件 → UPX 压缩。产物为项目根目录下的 kzhcrm.exe 与 kzhcrm(Linux ELF)。

Docker 部署

提供 Dockerfile 与 docker-compose.yml，单容器运行，可挂载 config.yaml 与数据目录。

端口冲突处理

启动时自动检测端口占用，Windows 下通过 netstat 定位占用进程并强杀，使新版本直接接管端口，便于本地反复迭代。

自动打开浏览器（Windows）

Windows 下启动时自动轮询探测端口，服务就绪后用默认浏览器打开首页（http://127.0.0.1:/，自动重定向到主工作台），启动即见界面，不必手动访问。

前端实时更新

系统为页面与静态资源统一设置 no-cache 响应头，前端改动随服务重启即时生效，不会因浏览器缓存误用旧界面（曾因旧缓存导致交互异常，如点击不响应）。

七、默认账号

admin

admin@2026（首次启动自动创建）

使用「系统设置 → 清空并重建测试数据」可快速生成演示账号 sales01 / manager01（密码 123456）。

八、配置说明

config.yaml 关键项：

• server.port：服务端口（默认 1533）
• database.path：SQLite 数据库文件路径
• jwt.secret：JWT 签名密钥，生产环境请改为随机长字符串
• cos：腾讯云 COS 附件存储

九、规划路线图（对齐行业核心能力）

以下为业界标准 CRM 能力，属于当前 kzhcrm 尚未实现、规划后续补齐的部分：

• 客户画像：基于标签、行业、规模、历史成交构建客户 360° 画像与智能推荐
• 线索自动分配：按区域/行业/产能，将 AI 评分的线索自动轮询分配到销售
• 真实群发网关对接：接入真实短信/邮件服务商，将群发任务从"记录模拟"升级为"真实触达"
• 增强报表：更丰富的多维多级可视化报表与自定义看板（如丢单分析、更细粒度的渠道归因）

十、移动端适配

屏幕 ≤768px 时，侧栏自动变为抽屉式菜单（汉堡按钮开合、半透明遮罩，选中菜单或点击遮罩自动收起），表格支持横向滚动，便于手机上管理客户、推进商机、处理审批。