# foot-erp **Repository Path**: humankeji/foot-erp ## Basic Information - **Project Name**: foot-erp - **Description**: 足疗erp,适用于b,c端中小型客户.欢迎使用 - **Primary Language**: Python - **License**: Not specified - **Default Branch**: dev - **Homepage**: http://111.228.59.114:7777/ 账号admin 密码admin123 pc打开 - **GVP Project**: No ## Statistics - **Stars**: 6 - **Forks**: 0 - **Created**: 2026-02-25 - **Last Updated**: 2026-08-13 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # 🏪 足疗ERP系统 - 操作说明 **专业的足疗店管理解决方案，让经营管理更简单高效** 这是一套完整的足疗店管理系统，包含会员管理、技师管理、房间管理、服务项目管理、预约管理、收银台和报表统计等核心功能。本说明文档专为您的团队编写，帮助您快速上手系统。 ###原型 ![输入图片说明](e8f7a10e68c6caa939b6dbfc27d06871.png) ![输入图片说明](476d6695b490fcc6a82900eb277fa520.png) ## 技术栈 ### 后端 - Django 4.2.7 - Django REST Framework - Django REST Framework SimpleJWT - SQLite (可配置MySQL/PostgreSQL) ### 前端 - Vue 3 - Vite - Vue Router - Pinia - Element Plus - Axios ## 项目结构 ``` foot-erp/ ├── backend/ # Django后端 │ ├── foot_erp/ # 项目配置 │ ├── apps/ # 核心业务模块 │ │ ├── auth/ # 认证模块 │ │ ├── members/ # 会员管理 │ │ ├── technicians/ # 技师管理 │ │ ├── rooms/ # 房间管理 │ │ ├── services/ # 服务管理 │ │ ├── bookings/ # 预约管理 │ │ ├── orders/ # 订单管理 │ │ ├── reports/ # 报表统计 │ │ ├── chat/ # 聊天模块 │ │ ├── feedback/ # 反馈模块 │ │ └── mall/ # 商城模块 │ ├── app/ # 公共工具 │ │ └── utils/ # 权限、验证器等 │ ├── test/ # 后端测试 │ ├── manage.py │ └── requirements.txt ├── frontend/ # Vue前端 │ ├── src/ │ │ ├── api/ # API接口 │ │ ├── components/ # 组件 │ │ ├── router/ # 路由 │ │ ├── stores/ # 状态管理 │ │ ├── views/ # 页面 │ │ └── utils/ # 工具 │ ├── index.html │ ├── package.json │ └── vite.config.js ├── uniapp/ # uni-app 移动端 ├── deploy/ # 部署脚本、Docker、Nginx 配置 ├── docs/ # 项目文档 │ └── images/ # 文档图片 ├── scripts/ # 临时/维护用脚本 ├── test/ # 顶层测试（backend + frontend + integration） └── html/ # 静态 HTML 页面 ``` ## 扫码访问 我们提供了便捷的扫码访问功能，让您可以快速通过手机访问系统： ### 访问方式 1. **二维码生成页面**: 访问 `/qr-access.html` 或系统内的"扫码访问"页面 2. **访问指南**: 访问 `/access-guide.html` 查看各种访问方式 3. **系统内访问**: 登录系统后在首页点击"扫码访问网站"按钮 ### 功能特点 - 支持自定义网址生成二维码 - 二维码清晰度高，易于扫描 - 支持下载二维码图片保存到手机 - 响应式设计，适配各种设备 ## 🚀 快速开始 - 三种使用方式 ### 方式一：一键启动（推荐） 我们为您准备了便捷的一键启动脚本： **Windows用户：** 1. 双击运行 `START_FULL_SYSTEM.bat` 文件 2. 等待系统自动启动（约1-2分钟） 3. 浏览器自动打开系统页面 **仅启动后端：** 双击 `START_BACKEND.bat` ### 方式二：手动启动 #### 后端启动步骤： 1. 打开命令提示符（CMD） 2. 进入后端目录：`cd backend` 3. 运行启动脚本：`python simple_server.py` 4. 看到"服务器启动成功"提示即可 #### 前端启动步骤： 1. 打开新的命令提示符窗口 2. 进入前端目录：`cd frontend` 3. 安装依赖：`npm install`（首次运行需要） 4. 启动前端：`npm run dev` 5. 浏览器访问：`http://localhost:3000` ### 方式三：生产环境部署 如需正式部署到服务器，请参考 `OPERATION_MANUAL.md` 文件的详细部署说明。 ## 🎯 核心功能模块 ### 📱 日常运营必备 **💼 收银台** - 核心业务功能 - 快速下单收银，支持现金、微信、支付宝、会员卡支付 - 自动计算会员折扣和积分 - 一键生成订单，支持退款操作 **📅 预约管理** - 提升客户体验 - 客户预约登记，避免排队等候 - 实时查看预约状态，合理安排技师时间 - 支持预约确认、开始服务、完成、取消等操作 **👥 会员管理** - 客户价值最大化 - 会员信息录入和档案管理 - 4个会员等级：普通、银卡、金卡、钻石 - 会员充值、积分累计、消费记录查询 ### 👨‍💼 管理决策支持 **📊 报表统计** - 经营数据一目了然 - 日报表：今日营业额、订单数、新增会员等 - 月报表：月度趋势分析、技师业绩排行 - 支持Excel、PDF格式导出 **💆‍♂️ 技师管理** - 团队管理更高效 - 技师信息管理、等级设置、提成比例配置 - 排班管理，支持早班、晚班、通班 - 业绩统计和客户满意度跟踪 **🏠 房间管理** - 资源利用最优化 - 房间信息管理（单人房、双人房、多人房、VIP房） - 实时房间状态监控（空闲、使用中、清洁中、维修中） - 提高房间使用率 **🛍️ 服务管理** - 业务标准化 - 服务项目设置、价格管理、会员折扣配置 - 服务套餐组合，提升客单价 - 服务分类管理（足疗、按摩、特色服务等） ## API接口 ### 认证 - `POST /api/auth/login/` - 用户登录 - `GET /api/auth/me/` - 获取当前用户信息 ### 会员 - `GET /api/members/` - 获取会员列表 - `POST /api/members/` - 创建会员 - `PUT /api/members/{id}/` - 更新会员 - `DELETE /api/members/{id}/` - 删除会员 - `POST /api/members/{id}/recharge/` - 会员充值 ### 技师 - `GET /api/technicians/` - 获取技师列表 - `POST /api/technicians/` - 创建技师 - `GET /api/technicians/{id}/performance/` - 获取技师业绩 ### 房间 - `GET /api/rooms/` - 获取房间列表 - `POST /api/rooms/` - 创建房间 - `POST /api/rooms/{id}/change_status/` - 更改房间状态 ### 服务 - `GET /api/services/` - 获取服务列表 - `POST /api/services/` - 创建服务 ### 预约 - `GET /api/bookings/` - 获取预约列表 - `POST /api/bookings/` - 创建预约 - `POST /api/bookings/{id}/confirm/` - 确认预约 - `POST /api/bookings/{id}/start_service/` - 开始服务 - `POST /api/bookings/{id}/complete/` - 完成服务 ### 订单 - `GET /api/orders/` - 获取订单列表 - `POST /api/orders/` - 创建订单 - `POST /api/orders/{id}/pay/` - 订单支付 - `POST /api/orders/{id}/refund/` - 订单退款 ### 报表 - `GET /api/reports/daily/` - 获取日报表 - `GET /api/reports/daily/generate_today/` - 生成今日报表 - `GET /api/reports/monthly/` - 获取月报表 ## 🚀 部署方案 ### 🐧 Linux服务器部署（推荐） 我们提供了专门的Linux部署方案，支持Ubuntu 20.04/22.04： **📦 提供的部署文件：** - `ubuntu-deploy.sh` - 一键部署脚本（适合新手） - `production-deploy.sh` - 生产环境部署脚本 - `docker-compose.production.yml` - 生产环境Docker配置 - `UBUNTU_DEPLOYMENT_GUIDE.md` - 详细的Ubuntu部署指南 **🚀 一键部署步骤：** ```bash # 1. 上传项目到服务器 scp -r ./* root@your-server-ip:/tmp/foot-erp/ # 2. 执行部署 ssh root@your-server-ip cd /tmp/foot-erp sudo bash ubuntu-deploy.sh ``` ### 📋 详细部署指南 完整的部署文档请查看项目中的： - `OPERATION_MANUAL.md` - Windows和通用部署指南 - `UBUNTU_DEPLOYMENT_GUIDE.md` - Ubuntu服务器详细部署指南 包含： - 服务器环境配置 - 数据库设置 - 域名绑定 - 安全配置 - 备份策略 - 性能优化 ### 📱 移动端访问 **扫码快速访问：** 1. 登录系统后点击"扫码访问"按钮 2. 使用手机扫描二维码 3. 即可在手机浏览器中使用系统 **支持功能：** - 技师查看排班和预约 - 快速收银操作 - 会员信息查询 - 个人业绩查看 ### 📱 移动端应用打包 系统支持打包成原生Android和iOS应用，提供更好的移动端体验： **快速打包命令：** ```bash cd frontend # Android应用 npm run mobile:android # 打开Android Studio # iOS应用 npm run mobile:ios # 打开Xcode ``` **打包步骤：** 1. **安装依赖** ```bash cd frontend npm install ``` 2. **构建Web应用** ```bash npm run build ``` 3. **Android打包** ```bash # 打开Android Studio进行打包 npm run cap:open:android # 在Android Studio中配置签名并生成APK/AAB ``` 4. **iOS打包** ```bash # 在Mac上打开Xcode进行打包 npm run cap:open:ios # 在Xcode中配置证书并提交到App Store ``` **移动端特性：** - ✅ 原生应用体验 - ✅ 触摸反馈优化 - ✅ 键盘智能处理 - ✅ 网络状态检测 - ✅ 设备信息获取 - ✅ 安全区域适配 - ✅ 暗色模式支持 **详细打包指南请参考：** `frontend/MOBILE_PACKAGING.md` ### 🔧 技术支持 **遇到问题？** - 查看详细操作手册：`OPERATION_MANUAL.md` - 检查部署状态：`DEPLOYMENT_STATUS.md` - 系统优化建议：`PERFORMANCE_OPTIMIZATIONS.md` **性能优化：** - 系统已进行前端性能优化 - 后端安全配置优化 - 数据库查询优化 ## 🔐 账户说明 ### 首次使用设置 **管理员账户创建：** 系统首次启动时，需要创建管理员账户： ```bash cd backend python manage.py createsuperuser ``` 按提示输入： - 用户名（建议使用：admin） - 邮箱地址 - 密码（建议设置强密码） ### 用户角色权限 系统支持4种角色，分工明确： | 角色 | 权限范围 | 适合人员 | |------|----------|----------| | **店长** | 所有功能管理 | 店长、经理 | | **收银员** | 收银、会员、预约、订单 | 前台、收银员 | | **技师** | 查看预约、个人业绩 | 技师 | | **超级管理员** | 系统设置、用户管理 | 系统管理员 | ### 访客模式 客户体验功能： - 选择"访客模式"可体验系统基本功能 - 无需登录即可了解系统界面和功能 ## 📞 联系与支持 ### 客户支持 我们为甲方客户提供了完整的支持体系： **📖 操作文档：** - `README.md` - 本文件，快速开始指南 - `OPERATION_MANUAL.md` - 详细操作手册 - `DEPLOYMENT_STATUS.md` - 部署状态报告 - `FINAL_DEPLOYMENT_REPORT.md` - 最终部署报告 **🛠️ 技术文档：** - `PERFORMANCE_OPTIMIZATIONS.md` - 性能优化说明 - `SECURITY_OPTIMIZATIONS.md` - 安全优化说明 - `CODE_QUALITY_OPTIMIZATIONS.md` - 代码质量优化 - `FRONTEND_OPTIMIZATIONS.md` - 前端优化说明 ### 系统特点 ✅ **简单易用** - 界面友好，操作简单 ✅ **功能完整** - 覆盖足疗店所有业务场景 ✅ **移动优先** - 完美支持手机和平板 ✅ **数据安全** - 多重备份，安全可靠 ✅ **性能优化** - 快速响应，流畅体验 --- **感谢您选择足疗ERP系统！** 🎊 如有任何问题或需要技术支持，请随时联系我们。微信号z592373205 ![输入图片说明](98b129fa8db7c2330d30364475474578.jpg)