业务和功能介绍
一、立项背景与目标
传统美容/美甲美睫/养生门店普遍依赖手工记账：老板用本子记次卡易错漏记、提成靠手工核算易扯皮、微信群里预约常撞单、卡到期客户流失没有任何提醒。本项目旨在打造一套多租户 SaaS 化的美业会员次卡管理系统，用「排班预约 + 次卡/储值管理 + 收银耗卡与提成自动核算 + 会员提醒 + 双口径经营看板」一套系统解决上述痛点，每家门店即一个租户，支持多门店数据隔离。
二、软件功能与核心模块
1. Web 管理端（老板/店长/前台使用）：服务项目（含提成规则）、卡产品（次卡/储值+充值档位）、员工档案与排班（营业时间管理）、会员档案（等级/推荐人/Excel 批量导入/会员码）、售卡开卡与延期退款、预约处理（确认/取消/爽约标记）、收银开单（一单多项目+卡扣与现金/微信组合支付）、作废冲正、提成报表、双口径经营看板。
2. 会员微信小程序（C 端）：自助预约（排班驱动、DB 唯一索引防撞单、爽约限制）、会员码出示、卡包（剩余次数/余额/有效期）、消费记录、在线购卡下单、到期/次数不足订阅消息提醒。
三、业务流程与功能路径
员工排班 → 会员线上/前台预约（可约时段=排班∩营业时间）→ 到店收银开单（次卡扣减+现金补差组合支付）→ 提成按服务/售卡双归属自动落库 → 报表与看板对账；系统定时扫描到期/次数不足/沉睡/生日会员，经订阅消息+短信双通道自动触达促复购。
传统美容/美甲美睫/养生门店普遍依赖手工记账：老板用本子记次卡易错漏记、提成靠手工核算易扯皮、微信群里预约常撞单、卡到期客户流失没有任何提醒。本项目旨在打造一套多租户 SaaS 化的美业会员次卡管理系统，用「排班预约 + 次卡/储值管理 + 收银耗卡与提成自动核算 + 会员提醒 + 双口径经营看板」一套系统解决上述痛点，每家门店即一个租户，支持多门店数据隔离。
二、软件功能与核心模块
1. Web 管理端（老板/店长/前台使用）：服务项目（含提成规则）、卡产品（次卡/储值+充值档位）、员工档案与排班（营业时间管理）、会员档案（等级/推荐人/Excel 批量导入/会员码）、售卡开卡与延期退款、预约处理（确认/取消/爽约标记）、收银开单（一单多项目+卡扣与现金/微信组合支付）、作废冲正、提成报表、双口径经营看板。
2. 会员微信小程序（C 端）：自助预约（排班驱动、DB 唯一索引防撞单、爽约限制）、会员码出示、卡包（剩余次数/余额/有效期）、消费记录、在线购卡下单、到期/次数不足订阅消息提醒。
三、业务流程与功能路径
员工排班 → 会员线上/前台预约（可约时段=排班∩营业时间）→ 到店收银开单（次卡扣减+现金补差组合支付）→ 提成按服务/售卡双归属自动落库 → 报表与看板对账；系统定时扫描到期/次数不足/沉睡/生日会员，经订阅消息+短信双通道自动触达促复购。
项目实现
一、整体架构与设计思路
技术栈：JDK 17 + Spring Boot 3.2 + MyBatis-Plus 3.5 + Sa-Token + XXL-Job + Redis + Druid + MySQL，Docker Compose 一键部署，springdoc 接口文档。Maven 多模块分层：xin-common（统一响应 R、全局异常、多租户上下文+MP 租户拦截器、Sa-Token 拦截器、Redis 封装、微信小程序客户端）、xin-system（租户/用户/角色/菜单、附件、审计日志）、xin-beauty（美业业务域，11 张 bty_ 业务表）、xin-api（启动模块）。多租户基于 MP 租户拦截器做行级隔离，登录态租户 ID 存 Sa-Token session 由拦截器注入上下文，Job 场景手动 set 防越权。金额统一存分（bigint），卡号/单号用 Redis INCR 按租户+日期发号。
二、负责模块与结果
主导 PRD 评审对标（fuint 等多套开源系统）与全部业务表设计，独立完成 xin-beauty 模块：基础档案 CRUD、排班预约、售卡收银、提成落库、提醒任务、报表看板及 C 端小程序接口。达成：并发压测 0 超扣、预约撞单 0 发生、提成月报汇总=逐笔明细和、看板双口径（实收/耗卡+卡耗率）可对账。
三、难点、坑与解决方案
1. 并发超扣：收银扣卡用条件更新 SQL（remain_count>0 / remain_amount>=扣减额）替代先查后改，杜绝并发超扣。
2. 预约撞单：可约时段=员工排班∩营业时间，应用层校验外再以 (tenant_id, staff_id, apt_start_time) 唯一索引兜底。
3. 发号重复：Redis INCR 按「租户+日期」隔离，SETNX 预热 + DB 兜底防重启丢号。
4. 数据一致性：作废冲正逐明细回滚卡余额与提成；提成服务/售卡双归属分列，报表与明细强一致。
5. C 端免登录：SaTokenConfig notMatch 放行 + controller 手动注入租户上下文，兼顾安全与隔离。
6. 提醒骚扰：订阅消息优先、短信兜底，同类型 30 天频控，XXL-Job 定时任务错峰执行。
技术栈：JDK 17 + Spring Boot 3.2 + MyBatis-Plus 3.5 + Sa-Token + XXL-Job + Redis + Druid + MySQL，Docker Compose 一键部署，springdoc 接口文档。Maven 多模块分层：xin-common（统一响应 R、全局异常、多租户上下文+MP 租户拦截器、Sa-Token 拦截器、Redis 封装、微信小程序客户端）、xin-system（租户/用户/角色/菜单、附件、审计日志）、xin-beauty（美业业务域，11 张 bty_ 业务表）、xin-api（启动模块）。多租户基于 MP 租户拦截器做行级隔离，登录态租户 ID 存 Sa-Token session 由拦截器注入上下文，Job 场景手动 set 防越权。金额统一存分（bigint），卡号/单号用 Redis INCR 按租户+日期发号。
二、负责模块与结果
主导 PRD 评审对标（fuint 等多套开源系统）与全部业务表设计，独立完成 xin-beauty 模块：基础档案 CRUD、排班预约、售卡收银、提成落库、提醒任务、报表看板及 C 端小程序接口。达成：并发压测 0 超扣、预约撞单 0 发生、提成月报汇总=逐笔明细和、看板双口径（实收/耗卡+卡耗率）可对账。
三、难点、坑与解决方案
1. 并发超扣：收银扣卡用条件更新 SQL（remain_count>0 / remain_amount>=扣减额）替代先查后改，杜绝并发超扣。
2. 预约撞单：可约时段=员工排班∩营业时间，应用层校验外再以 (tenant_id, staff_id, apt_start_time) 唯一索引兜底。
3. 发号重复：Redis INCR 按「租户+日期」隔离，SETNX 预热 + DB 兜底防重启丢号。
4. 数据一致性：作废冲正逐明细回滚卡余额与提成；提成服务/售卡双归属分列，报表与明细强一致。
5. C 端免登录：SaTokenConfig notMatch 放行 + controller 手动注入租户上下文，兼顾安全与隔离。
6. 提醒骚扰：订阅消息优先、短信兜底，同类型 30 天频控，XXL-Job 定时任务错峰执行。
示例图片视频
相似推荐
quick_server
1、背景和目标：对企业所有服务请求进行轻量级安全和速度优化，减轻服务器的并发压力。
2、quick_server系统，不依赖外部引用，即插即用，主要用来进行极速快捷安全的http请求。大大减轻服务器的并发压力。轻松实现高并发场景下极速快捷安全的http请求。
json解析转换器
1、背景和目标：一、超级快速、安全对json的解析与对象转换；二、支持分布式超高并发
2、json解析转换器，支持分布式高并发，支持百万级别访问。用于快速进行json的解析与对象转换。原有的开源工具，要么安全性不够，要么性能不够强悍，要么不支持定制，很难满足企业日益严苛的业务需求。开发的这个json解析转换器，可以同时满足以上三种需求。
消息中心
1、背景和目标：解决高并发，对外提供统一的消息处理业务
2、功能模块介绍：六大功能模块：http通讯模块、缓存模块、消息队列模块、消息重试中心模块、消息调度模块、公共模块；对外百万级别并发项目，TPS可达1000/s。作为中间件，对外提供统一的消息处理业务。所有系统，包括电子签章平台、一照通行平台、一网通办平台，消息的请求和处理都经过消息中心。轻松实现异步、解耦、削峰。
3、功能描述：支持企业所有的内部系统接入，包括电子签章平台、一照通行平台、一网通办平台。轻松实现异步、解耦、削峰。
CRM客户管理后台
立项背景：针对中小型企业客户信息分散、销售跟进过程不透明、合同管理混乱等痛点，旨在打造一个轻量级的客户全生命周期管理后台，提升销售团队协作与转化效率。
核心功能：涵盖管理员登录鉴权、客户主表管理、联系人维护、跟进记录追踪、合同管理等六大模块。支持客户信息分页查询、关键字搜索、新增编辑与逻辑删除；客户详情页以名片形式集中展示联系人、跟进记录及关联合同。
业务流程：从潜在客户录入，到日常跟进记录，再到最终合同签订与操作日志审计，覆盖完整的销售业务闭环。
个人记账与资产管理平台
本项目是一套从零搭建的全栈个人财务管理平台，目标是替代功能单一的记账工具，把日常记账、资金账户、借贷往来、预算控制、资产盘点收敛到一个数据自主的系统中。系统由 12 个业务模块、23 个控制器、170 个 REST 接口、36 张数据表构成：记账核心支持三级分类树、商家联想、多平台支付与 CSV 批量导入导出，每笔账单自动联动账户余额并留存流水日志；借贷模块实现未结清 / 已结清 / 已放弃三态模型，支持分期还款与坏账核销；预算模块提供月度 + 年度双层体系与阶梯式执行规则；资产模块通过快照与趋势图呈现净资产变化；报表模块支持从月度 / 年度报表下钻到分类明细。系统还包含完整 RBAC 权限体系、软删除回收站、8 套主题实时切换与中英双语国际化。核心业务流程为：记一笔 → 余额幂等联动 → 报表与预算同步更新；借据从创建、关联账单凭证、分期还款到三态判定的完整生命周期；以及登录后由后端菜单树动态生成侧边菜单、路由与区块双重门控的权限链路。
帮助文档
Copyright @ 2021-2024 程聚宝 | 浙ICP备2021014372号
人工客服