基于 **Flask + SQLite** 的理发门店会员管理系统，覆盖会员档案、充值、消费扣款、积分、等级折扣、账单统计、流水对账与操作日志。
*部署极简：装一个 Flask 就能跑，无需 MySQL、无需 Redis、无需前端打包。**
一、技术选型（面向"好部署"）
| 层次 | 选型 | 理由 |
|---|---|---|
| 后端 | Python 3 + Flask 3 | 单文件依赖，Windows / Linux / macOS 通吃 |
| 数据库 | SQLite（Python 内置） | 零安装、零配置，数据库就是一个文件，拷走即迁移 |
| 前端 | Jinja2 服务端渲染 + 原生 CSS/JS | 无 Node、无构建、无 CDN，断网可用 |
| 部署 | python app.py / 双击 start.bat / waitress 生产模式 |
三种方式任选，详见部署说明 |
全部第三方依赖只有 Flask 一个 （requirements.txt 仅 1 行）。
二、快速开始
方式一：本地直接运行（推荐毕设演示）
pip install -r requirements.txtpython app.py浏览器打开 http://127.0.0.1:5000
目录
-
- 系统简介
-
- 会员管理
-
- 会员充值
-
- 消费扣款
-
- 统计与对账
-
- 系统管理
1. 系统简介
系统登录页：输入管理员/收银员账号密码即可进入。
图：系统登录页：输入管理员/收银员账号密码即可进入。
工作台首页：以理发店风格的经营看板展示今日充值、今日消费、新增会员、在册会员、今日流水、会员结构与经营、高频客户排行与操作日志。
图：工作台首页：以理发店风格的经营看板展示今日充值、今日消费、新
2. 会员管理
会员管理列表：支持按手机号、姓名、会员编号模糊搜索，按状态与等级筛选；提供详情、编辑、充值、扣款、禁用/启用、删除等操作。
图：会员管理列表：支持按手机号、姓名、会员编号模糊搜索，按状态与
新增会员：填写姓名、性别、手机号与备注，系统自动生成唯一会员编号，初始余额为 0，默认状态为正常可用。
图：新增会员：填写姓名、性别、手机号与备注，系统自动生成唯一会员
会员详情：集中展示账户概览、充值记录、消费订单与全部账单流水；流水数据由数据库触发器强制只读，保障账务真实性。
图：会员详情：集中展示账户概览、充值记录、消费订单与全部账单流水
3. 会员充值
会员充值：输入手机号自动匹配会员；可选择常用档位一键带入"充 X 送 Y"，也可自定义金额与赠送套餐；提交后余额实时到账并生成永久存档的充值流水。
图：会员充值：输入手机号自动匹配会员；可选择常用档位一键带入"充
充值记录：支持按手机号、时间段、操作员工、金额区间筛选；汇总充值笔数、实收金额与赠送金额，支持打印对账。
图：充值记录：支持按手机号、时间段、操作员工、金额区间筛选；汇总
4. 消费扣款
消费扣款：手机号匹配会员后，勾选多个服务项目并输入数量；系统自动计算会员等级折扣、积分抵扣与实扣余额；余额不足时拦截并提示需补金额。
图：消费扣款：手机号匹配会员后，勾选多个服务项目并输入数量；系统
消费记录：按会员、服务项目、操作员工、时间、金额等多条件筛选；展示原价、折扣、积分抵扣、实扣金额、获得积分等信息。
图：消费记录：按会员、服务项目、操作员工、时间、金额等多条件筛选
消费订单明细：展示该笔订单的服务项目、价格、数量、折扣、积分抵扣与实扣金额，支持打印小票。
图：消费订单明细：展示该笔订单的服务项目、价格、数量、折扣、积分
5. 统计与对账
统计报表：支持按日/月/年查看门店充值总额、消费总额、新增会员数及趋势明细，并展示高频客户 TOP10 与项目热度 TOP10。
图：统计报表：支持按日/月/年查看门店充值总额、消费总额、新增会
流水对账：按收银员汇总指定日期区间的充值/消费笔数与金额，计算账面净额，方便每日交接班时核对账目。
图：流水对账：按收银员汇总指定日期区间的充值/消费笔数与金额，计
6. 系统管理
服务项目管理：管理员可维护剪发、染发、烫发、护理、造型等服务项目，设置单价、分类与启停状态，供消费扣款时多选使用。
图：服务项目管理：管理员可维护剪发、染发、烫发、护理、造型等服务
员工账号：管理员可新增收银员/管理员账号，进行启用/停用与密码重置，实现角色与权限分离。
图：员工账号：管理员可新增收银员/管理员账号，进行启用/停用与密
操作日志：记录所有充值、扣款、会员变更、账号操作等行为，包含操作人、角色、对象、详情与时间，满足可追溯、可追责要求。
图：操作日志：记录所有充值、扣款、会员变更、账号操作等行为，包含
数据备份与恢复：一键创建数据库备份，支持下载、上传迁移与一键恢复；恢复前系统会自动对当前数据库做一次快照，保证随时可回滚。
图：数据备份与恢复：一键创建数据库备份，支持下载、上传迁移与一键
附录：部署与运行
本系统采用 Flask + SQLite 架构，第三方依赖仅 Flask 一个，数据库以文件形式存储，部署非常简单。
- 本地运行：pip install -r requirements.txt 后执行 python app.py，访问 http://127.0.0.1:5000。
- 演示数据：执行 python tools/init_demo.py 自动生成 8 位会员及充值/消费流水。
- Windows 一键：双击 start.bat 即可自动创建虚拟环境、安装依赖并打开浏览器。
- 生产模式：pip install -r requirements-prod.txt 后执行 python app.py --prod（waitress），Linux 亦可用 gunicorn。
- 环境自检与备份：python tools/check_env.py 检查运行环境；python tools/backup_db.py 备份数据库。