趙健的技術筆記

QingSi 會員管理系統

GitHub

通用会员管理系统 - 适用于美业、美容、美发、美甲、按摩、瑜伽、培训、宠物等行业，收银、会员、预约、报表一站式解决方案。

幫助與支持：本項目完全開源免費，可自行下載部署使用。如需定制開發或專業技術支持，歡迎聯繫。

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

许可证

GPL-3.0

返回首頁