开源的专为中小理发店、社区店、夫妻店打造的一体化轻量客户管理工具

show

Github地址

功能特性

核心账号体系

系统提供完整的店长账号生命周期管理，支持注册、登录、密码修改等功能。所有业务接口默认启用 JWT 鉴权保护，仅登录和注册接口开放访问，从根本上避免”裸奔接口”的安全隐患。

会员精细化管理

• 支持新增、编辑会员信息，灵活切换会员状态
• 分页查询会员列表，数据展示清晰有序
• 独创 4 位校验码机制（默认取手机号后四位），消费时强制校验，保障会员资金安全
• 新增会员时可同步录入初次充值金额，开卡流程一气呵成

充值与消费闭环

• 会员下拉框支持模糊检索，输入姓名或手机号即可快速定位
• 消费环节强制校验会员校验码，与后端存储值实时比对，防止误操作或恶意消费
• 交易流水完整记录，支持分页查询与一键导出，财务对账无忧

员工与服务管理

• 员工信息维护与分页查询
• 服务类型灵活配置，注册后自动按租户初始化默认服务类型
• 减少重复配置工作，新店开张即可快速投入运营

统计与审计能力

• 经营概览面板，门店运营状况一目了然
• 服务分布统计，了解热门项目与冷门业务
• 员工业绩分页展示，绩效考核有据可依
• 审计日志完整记录关键操作，全程可追溯

使用方式

本地开发运行

第一步：前端构建

cd frontend
npm install
npm run build

第二步：后端启动

# 使用 Maven 直接运行
mvn spring-boot:run

# 或先打包再执行
mvn clean package
java -jar target/show-*.jar

第三步：访问系统 浏览器打开 http://localhost:8080，首次运行会自动创建数据库目录 ${user.home}/.show/show.db 并初始化表结构。

一键打包分发

项目贴心提供了 PowerShell 自动化脚本，适合无技术背景的门店人员直接使用：

.\compile_all.ps1

该脚本将自动完成：

1. 前端依赖安装与生产构建
2. 后端 Maven 打包
3. 调用 jpackage 生成应用目录
4. 输出 Show.zip 与 Show.exe 可执行文件

最终产物可直接复制到门店 Windows 电脑，双击运行即可，无需安装 JDK 或其他运行环境。

技术架构亮点

前端层：Vue 3 + Vite 构建的单页应用，位于 frontend 目录，界面风格简洁时尚，降低新员工培训成本。

后端层：Spring Boot 3.1.5 + JDBC 直连，位于 src/main/java，摒弃繁琐的 ORM 配置，代码直观易维护。

数据层：SQLite 3.46 本地文件数据库，默认路径 ${user.home}/.show/show.db，单机即可运行，维护门槛极低。

安全设计：JWT Token 承载加密后的租户信息，所有核心业务表含 tenant_id 字段实现租户隔离，配合审计日志注解 recordLog 实现关键操作全记录。