# show

**Repository Path**: StupidWood/show

## Basic Information

- **Project Name**: show
- **Description**: 理发店极简会员管理系统
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 4
- **Forks**: 1
- **Created**: 2026-03-27
- **Last Updated**: 2026-06-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Show · 理发店极简会员管理系统

> 面向中小理发店、社区店、夫妻店的一体化轻量客户管理工具。  
> 目标是：安装即用、操作直接、数据清晰、成本可控。

![Java](https://img.shields.io/badge/Java-17-2f6f4f)
![Spring Boot](https://img.shields.io/badge/Spring%20Boot-3.1.5-2f6f4f)
![Vue](https://img.shields.io/badge/Vue-3.4-2f6f4f)
![SQLite](https://img.shields.io/badge/SQLite-3.46-2f6f4f)
![License](https://img.shields.io/badge/License-MIT-2f6f4f)

## 为什么是它

- 不依赖外部数据库服务，内置 SQLite，单机可运行，维护门槛低。
- 登录、注册、JWT 鉴权、租户隔离完整闭环，避免“裸奔接口”。
- 聚焦理发店高频场景：会员、充值、消费、员工、服务、业绩、审计。
- UI 统一为简洁时尚风格，减少培训成本，新员工也能快速上手。

## 主要功能

- 账号体系
  - 店长账号注册与登录
  - 修改密码
  - 所有业务接口默认鉴权（除登录/注册）
- 会员管理
  - 新增/编辑会员、状态切换、分页查询
  - 支持设置 4 位校验码（默认手机号后四位）
  - 新增会员可直接录入初次充值金额
- 充值与消费
  - 会员下拉支持模糊检索（姓名/手机号）
  - 消费时强校验会员校验码（与后端存储值比对）
  - 交易流水分页查询与导出
- 员工与服务
  - 员工管理、服务类型管理（均支持分页）
  - 注册后自动初始化默认服务类型（按租户）
- 统计与审计
  - 经营概览、服务分布、员工业绩（分页）
  - 审计日志分页，关键操作可追溯

## 截图展示

- 登录页与注册弹窗  
  ![登录与注册](./docs/screenshots/login-register.png)
- 工作台总览  
  ![工作台](./docs/screenshots/dashboard-overview.png)
- 会员管理与模糊检索下拉  
  ![会员管理](./docs/screenshots/customer-management.png)
- 充值/消费与校验码校验  
  ![充值消费](./docs/screenshots/transaction-verify-code.png)
- 统计报表与审计日志  
  ![报表审计](./docs/screenshots/report-audit.png)
  ![报表审计](./docs/screenshots/stat.png)

## 项目亮点

- 极简上手：围绕理发店真实日常，不做过度设计。
- 安全可用：统一鉴权 + 审计日志 + 租户隔离。
- 离线友好：SQLite 本地持久化，无需单独部署数据库。
- 可打包分发：可直接产出可执行程序，适合门店终端落地。

## 系统架构

```mermaid
flowchart LR
  A["Vue 3 + Vite 前端"] --> B["Spring Boot API"]
  B --> C["JWT 鉴权"]
  C --> D["租户上下文 TenantContext"]
  D --> E["SQLite 本地数据库"]
  B --> F["审计日志 recordLog"]
```

- 前端：`frontend`（Vue 3 单页应用）
- 后端：`src/main/java`（Spring Boot + JDBC）
- 数据库：SQLite（默认文件位于 `${user.home}/.show/show.db`）
- 租户隔离：所有核心业务表包含 `tenant_id`
- 安全策略：JWT 承载租户信息（加密后写入 token claim）

## 数据模型（核心表）

- `t_manager`：店长账号
- `t_customer`：会员（含 `verify_code`）
- `t_employee`：员工
- `t_service_type`：服务类型
- `t_recharge_record`：充值记录
- `t_consume_record`：消费记录
- `t_audit_log`：审计日志

建表脚本见：`src/main/resources/schema.sql`

## 依赖与版本

### 后端

- Java 17
- Spring Boot 3.1.5
- sqlite-jdbc 3.46.0.0
- JJWT 0.12.5
- Maven Compiler Plugin 3.11.0
- JavaFX 17.0.2（桌面壳相关）

### 前端

- Node.js 18+（建议）
- Vue 3.4.x
- Vue Router 4.3.x
- Vite 5.4.x
- @vitejs/plugin-vue 5.0.x

## 本地运行

1. 安装 JDK 17、Node.js、Maven。
2. 执行前端构建：`frontend` 目录 `npm install` + `npm run build`。
3. 执行后端启动或打包（见下节）。
4. 首次运行会自动创建数据库目录与表结构。

## 一键打包

项目已提供脚本：`compile_all.ps1`

```powershell
.\compile_all.ps1
```

脚本会依次完成：

1. 前端构建
2. 后端 Maven 打包
3. jpackage 生成应用目录
4. 输出 `Show.zip` 与 `Show.exe`

## 后续演进方向

- 多角色权限（店长/店员）与细粒度菜单权限。
- 会员标签、回访提醒、生日关怀、沉睡唤醒。
- 套餐卡/次卡/折扣券/积分体系。
- 收银扩展：多支付方式、交班对账、日结报表。
- 数据备份恢复、门店迁移、云端同步。
- 连锁门店管理：跨店汇总、店铺维度经营分析。

## License

MIT