QingSi Membership System
GitHub通用会员管理系统 - 适用于美业、美容、美发、美甲、按摩、瑜伽、培训、宠物等行业，收银、会员、预约、报表一站式解决方案。
Help & Support: This project is fully open source and free. You can download and deploy it yourself. For custom development or professional technical support, feel free to contact me.
QingSi 会员管理系统
简单高效，管理不用愁，经营更省心
适用于：美业、美容、美发、美甲、按摩、瑜伽、培训、宠物等行业的会员管理系统。
功能
| 模块 | 功能 |
|---|---|
| 收银台 | 快速结算、多支付方式、会员卡支付、智能多卡组合、价格调整 |
| 会员管理 | 会员档案、办卡充值、余额查询、挂账管理、消费记录 |
| 预约管理 | 在线预约、状态追踪 |
| 营业报表 | 营业概览、支付统计、项目排行、生日提醒、沉睡会员 |
| 系统设置 | 服务项目、卡类型、员工管理、交易撤销 |
技术栈
- 前端：Vue 3 + Element Plus + Vite + Pinia
- 后端：Node.js + Fastify + Prisma
- 数据库：MySQL
- 部署：Docker Compose
快速开始
1. 克隆项目
git clone https://github.com/zhaojiannet/QingSi.git
cd QingSi
2. 配置环境变量
cp backend/app/.env.example backend/app/.env
编辑 backend/app/.env：
JWT_SECRET=your-jwt-secret-here
SESSION_SECRET=your-session-secret-here
ADMIN_USERNAME=admin@yourdomain.com
ADMIN_PASSWORD=your-secure-password-here
DATABASE_URL=mysql://user:password@localhost:3306/database
生成密钥：openssl rand -hex 64
3. 启动服务
docker network create docker-net # 如不存在
docker-compose up -d
4. 访问
品牌定制
编辑 frontend/app/src/config/app.js：
export default {
brandName: '青丝', // 店铺名称
industryType: '美业', // 可选：美业、美容、美发、美甲、按摩、瑜伽、培训、宠物
systemName: '会员管理系统',
slogan: '简单高效，管理不用愁，经营更省心',
logo: '/images/logo.png',
};
行业类型对应背景图：
| industryType | 背景图 |
|---|---|
| 美业 | login_bg01.jpg |
| 美容 | login_bg02.jpg |
| 美发 | login_bg03.jpg |
| 美甲 | login_bg04.jpg |
| 按摩 | login_bg05.jpg |
| 瑜伽 | login_bg06.jpg |
| 培训 | login_bg07.jpg |
| 宠物 | login_bg08.jpg |
图片位于 frontend/app/public/images/ 目录。
生产部署
Docker 部署
同"快速开始"。
传统部署（nginx + Node.js）
前端：
cd frontend/app
pnpm install && pnpm build
# 将 dist/ 上传到 nginx 静态目录
后端：
cd backend/app
pnpm install --prod
npx prisma generate
pm2 start src/server.js --name qingsi
nginx 配置：
server {
listen 80;
server_name your-domain.com;
location / {
root /var/www/qingsi/dist;
try_files $uri $uri/ /index.html;
}
location /api {
proxy_pass http://127.0.0.1:3000;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
}
}
开发
docker-compose up # 启动
docker-compose logs -f backend # 查看日志
# 进入容器
docker exec -it qingsi_backend sh
npx prisma studio # 数据库可视化
node init-admin.js # 重置管理员
项目结构
QingSi/
├── backend/app/
│ ├── src/routes/ # API 路由
│ ├── prisma/ # 数据模型
│ └── .env.example
├── frontend/app/
│ └── src/
│ ├── views/ # 页面
│ ├── components/ # 组件
│ └── config/ # 配置
└── docker-compose.yml