客户管理系统产品系统

这是一个面向保健品/大健康行业多门店销售体系的客户档案收集与管理系统（内部产品名"今助手"），技术上为 Spring Boot 2.7 + MyBatis + MySQL 后端 + 静态 HTML 页面 + 微信小程序的 CRM 类管理系统。
简单说：它是把保健品线下销售中"拉新—建档—转化—复购—团队考核"这条链路搬到线上的内部管理工具。

今助手是一个面向保健品/大健康行业多门店销售体系的客户档案管理系统，主要功能包括：

1、客户档案管理：维护客户健康症状、家庭状况、退休情况等详细信息，提供 VIP 重点客户深度档案；
2、订单与产品管理：支持订单录入与查询、产品维护、库存进销管理；
3、拓客与签到：员工生成专属二维码，客户通过微信小程序扫码注册、会议扫码签到；
4、业绩考核：月度目标设定与审核、业绩排行，按消费金额自动匹配客户等级与称号；
5、组织权限：决策层/管理层/员工三级角色体系，数据按上下级关系隔离；
6、培训学习：培训课程与考核、学习文章、内部论坛；
7、运营辅助：公告发布、市场拓展线索管理、字典配置。
整体上，系统围绕“员工二维码拓客 → 客户扫码建档 → 订单销售转化 → 月度业绩考核”这条主线，为门店销售团队提供从拉新、建档、转化到考核的完整数字化管理闭环。

技术栈与架构
Spring Boot 2.7 + MyBatis + MySQL 的经典三层单体架构（Controller → Service → Mapper），前端为纯原生 HTML 静态页 + REST API 半分离模式，另配微信小程序承接客户扫码注册与会议签到。

实现亮点
统一规范：统一返回结构 Result + 全局异常处理（会话过期/业务异常/兜底三级）+ 自定义 @PrintlnLog 注解式日志切面，业务代码零侵入；
数据权限隔离：基于 MySQL 递归 CTE 拉取全部下属，五级角色 + 字段级权限，各业务模块统一按上下级关系过滤数据；
扫码签到链路：小程序码双模式生成（开发/生产），access_token 内存缓存提前过期，事务内处理重复签到、客户归属校验、手机号查重确认等边界场景；
工程细节：Service 层统一事务注解、小程序码分业务缓存、定时任务自动结束到期培训。
实现难点
面向中老年客户的注册流程：手机号重复时需“确认本人后绑定”的两阶段确认，生日空值归一化、年龄反算等数据清洗逻辑较多；
多层级组织的数据隔离：组织树可变更，递归查询与各模块过滤规则的统一套用，客户指派还需限制“只能给本人或下属”；
微信生态对接：token 生命周期管理、多种码的缓存隔离、发布前后两种小程序码接口兼容；
多数据库兼容：为适配 Oracle、达梦等国产化环境保持 SQL 兼容性。