# pet_service_platform **Repository Path**: Jackzhou1/pet_service_platform ## Basic Information - **Project Name**: pet_service_platform - **Description**: 🐾 宠物服务平台 - 基于 Flask + MySQL 的一站式宠物服务管理系统 - **Primary Language**: Unknown - **License**: MIT - **Default Branch**: main - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-04-02 - **Last Updated**: 2026-04-02 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # 🐾 Pet Service Platform ``` _____ _ _____ _ _ | __ \ | | / ____| | | | | |__) |___ | |_| | | |__ __ _| |_ | ___// _ \| __| | | '_ \ / _` | __| | | | (_) | |_| |____| | | | (_| | |_ |_| \___/ \__|\_____|_| |_|\__,_|\__| _____ _ _ | __ \ | | | | | |__) |___ | |__ __ _ _ __ _ _ __| | | ___// _ \| '_ \ / _` | '_ \| | | |/ _` | | | | (_) | |_) | (_| | | | | |_| | (_| | |_| \___/|_.__/ \__,_|_| |_|\__,_|\__,_| ``` > 🚀 下一代宠物服务管理平台 | Next-Gen Pet Service Management Platform --- ## 📡 项目概览

[![Python](https://img.shields.io/badge/Python-3.10+-3776AB?style=for-the-badge&logo=python&logoColor=white)](https://www.python.org/) [![Flask](https://img.shields.io/badge/Flask-3.1.0-000000?style=for-the-badge&logo=flask&logoColor=white)](https://flask.palletsprojects.com/) [![MySQL](https://img.shields.io/badge/MySQL-8.0-4479A1?style=for-the-badge&logo=mysql&logoColor=white)](https://www.mysql.com/) [![JWT](https://img.shields.io/badge/JWT-Auth-000000?style=for-the-badge&logo=json-web-tokens&logoColor=white)](https://jwt.io/) [![License](https://img.shields.io/badge/License-MIT-yellow?style=for-the-badge)](LICENSE) [![Status](https://img.shields.io/badge/Status-Production%20Ready-brightgreen?style=for-the-badge)](.)

一个**功能完备**的宠物服务生态系统，提供在线预约、订单管理、支付集成和后台管理的一站式解决方案。 --- ## ⚡ 快速启动 ```bash # 1. 克隆军火库 git clone https://github.com/JackZho/pet_service_platform.git cd pet_service_platform # 2. 安装依赖 pip install -r requirements.txt # 3. 配置环境变量 cp .env.example .env # 编辑 .env 文件，配置数据库连接 # 4. 导入数据库 mysql -u root -p < pet_service_platform.sql # 5. 启动服务器 python app.py ``` **访问地址：** `http://localhost:5000` --- ## 🛠️ 技术栈 ``` ┌─────────────────────────────────────────────────────────────┐ │ FRONTEND │ ├─────────────────────────────────────────────────────────────┤ │ HTML5 │ CSS3 │ JavaScript (ES6+) │ Fetch API │ └─────────────────────────────────────────────────────────────┘ ▼ ┌─────────────────────────────────────────────────────────────┐ │ BACKEND │ ├─────────────────────────────────────────────────────────────┤ │ Flask 3.1.0 │ JWT Auth │ RESTful API │ CORS │ └─────────────────────────────────────────────────────────────┘ ▼ ┌─────────────────────────────────────────────────────────────┐ │ DATABASE │ ├─────────────────────────────────────────────────────────────┤ │ MySQL 8.0 │ PyMySQL │ Relational Schema │ └─────────────────────────────────────────────────────────────┘ ``` ### 核心依赖 | 组件 | 版本 | 用途 | |------|------|------| | Flask | 3.1.0 | Web 框架 | | Flask-Cors | 3.0.10 | 跨域支持 | | Werkzeug | 3.1.3 | WSGI 工具 | | PyJWT | 2.10.1 | JWT 认证 | | PyMySQL | 1.0.2 | 数据库驱动 | | python-dotenv | 1.0.0 | 环境变量 | --- ## 🎯 核心功能 ### 🏠 用户端功能 | 功能模块 | 描述 | |----------|------| | 🔐 **认证系统** | JWT 令牌认证，支持注册/登录/密码修改 | | 🐕 **服务浏览** | 多类别宠物服务展示，支持搜索和分页 | | 📅 **预约下单** | 在线预约服务，选择时间和地址 | | 💳 **模拟支付** | 支持支付宝/微信支付模拟 | | 📦 **订单管理** | 查看订单历史，取消订单，确认收货 | | ⭐ **评价系统** | 服务评分和评论 | | 👤 **个人中心** | 个人信息管理，头像上传 | ### 🛡️ 管理员后台 | 功能模块 | 描述 | |----------|------| | 📊 **数据仪表盘** | 实时统计数据，收入图表，热门服务 | | 📋 **订单管理** | 全平台订单查看，状态更新 | | 🏷️ **服务管理** | CRUD 服务类别和项目，图片上传 | | 👥 **用户管理** | 用户列表，权限分配 | | 💬 **评价管理** | 查看评论，删除不当内容 | --- ## 📐 系统架构 ``` ┌────────────────────────────────────────────────────────────────┐ │ CLIENT LAYER │ │ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌────────────────┐ │ │ │ Index │ │ Auth │ │ Services │ │ User Center │ │ │ └──────────┘ └──────────┘ └──────────┘ └────────────────┘ │ │ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌────────────────┐ │ │ │ Orders │ │ Detail │ │ Admin │ │ Profile │ │ │ └──────────┘ └──────────┘ └──────────┘ └────────────────┘ │ └────────────────────────────────────────────────────────────────┘ │ ▼ HTTP/REST + JSON ┌────────────────────────────────────────────────────────────────┐ │ API GATEWAY │ │ ┌────────────────────────────────────────────────────────────┐│ │ │ Flask Application (app.py) ││ │ │ ┌────────────┐ ┌────────────┐ ┌────────────────────┐ ││ │ │ │ Auth Routes│ │Service Routes│Admin Routes │ ││ │ │ └────────────┘ └────────────┘ └────────────────────┘ ││ │ │ ┌────────────┐ ┌────────────┐ ┌────────────────────┐ ││ │ │ │Order Routes│ │Payment Routes│Review Routes │ ││ │ │ └────────────┘ └────────────┘ └────────────────────┘ ││ │ └────────────────────────────────────────────────────────────┘│ └────────────────────────────────────────────────────────────────┘ │ ▼ SQLAlchemy-ish Queries ┌────────────────────────────────────────────────────────────────┐ │ DATABASE LAYER │ │ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌────────────────┐ │ │ │ users │ │ services │ │ orders │ │ payments │ │ │ └──────────┘ └──────────┘ └──────────┘ └────────────────┘ │ │ ┌──────────┐ ┌──────────┐ ┌──────────┐ │ │ │ reviews │ │categories│ │service_ │ │ │ └──────────┘ └──────────┘ └──────────┘ │ └────────────────────────────────────────────────────────────────┘ ``` --- ## 📂 项目结构 ``` pet_service_platform/ ├── app.py # 主应用入口 ├── requirements.txt # Python 依赖 ├── .env # 环境变量配置 ├── pet_service_platform.sql # 数据库脚本 ├── templates/ # HTML 模板 │ ├── index.html │ ├── auth.html │ ├── services.html │ ├── orders.html │ ├── profile.html │ └── admin/ # 后台管理页面 ├── static/ # 静态资源 │ ├── css/ # 样式表 │ ├── js/ # JavaScript │ │ ├── main.js │ │ ├── auth.js │ │ └── admin/ # 后台 JS │ └── images/ # 图片资源 └── README.md # 项目文档 ``` --- ## 🔑 API 端点 ### 认证相关 ```http POST /api/auth/register # 用户注册 POST /api/auth/login # 用户登录 GET /api/auth/me # 获取当前用户 PUT /api/auth/me # 更新用户信息 PUT /api/auth/me/password # 修改密码 POST /api/auth/me/avatar # 上传头像 ``` ### 服务相关 ```http GET /api/services # 获取服务列表 GET /api/services/:id # 获取服务详情 GET /api/categories # 获取服务类别 ``` ### 订单相关 ```http POST /api/orders # 创建订单 GET /api/orders # 获取用户订单 GET /api/orders/:id # 获取订单详情 PUT /api/orders/:id/cancel # 取消订单 ``` ### 支付相关 ```http POST /api/payments/:id/pay # 模拟支付 ``` ### 评价相关 ```http POST /api/reviews # 添加评价 POST /api/reviews/check # 检查订单评价 GET /api/services/:id/reviews # 获取服务评价 ``` ### 管理员端点 ```http GET /api/admin/dashboard # 仪表盘数据 GET /api/admin/orders # 所有订单 PUT /api/admin/orders/:id/status # 更新订单状态 GET /api/admin/services # 服务管理 POST /api/admin/services # 添加服务 PUT /api/admin/services/:id # 更新服务 DELETE /api/admin/services/:id # 删除服务 GET /api/admin/users # 用户管理 PUT /api/admin/users/:id/admin # 权限分配 GET /api/admin/reviews # 评价管理 DELETE /api/admin/reviews/:id # 删除评价 ``` --- ## 🔧 配置说明 ### 环境变量 (.env) ```env # 安全密钥 SECRET_KEY=your-super-secret-key-here # 数据库配置 MYSQL_HOST=localhost MYSQL_USER=root MYSQL_PASSWORD=your-password MYSQL_DB=pet_service_platform # 上传配置 MAX_CONTENT_LENGTH=16777216 UPLOAD_FOLDER=static/images ``` --- ## 🚀 部署指南 ### Docker 部署 (Coming Soon) ```bash docker-compose up -d ``` ### 生产环境 1. 使用 Gunicorn 作为 WSGI 服务器 2. Nginx 反向代理 3. 配置 HTTPS 4. 设置合理的缓存策略 --- ## 📸 功能截图 > 项目正在运行中，截图敬请期待... --- ## 🤝 贡献指南欢迎提交 Issue 和 Pull Request！ ```bash # Fork 项目 git clone https://github.com/JackZho/pet_service_platform.git # 创建功能分支 git checkout -b feature/AmazingFeature # 提交更改 git commit -m 'Add some AmazingFeature' # 推送到分支 git push origin feature/AmazingFeature ``` --- ## 📄 许可证本项目采用 MIT 许可证 - 查看 [LICENSE](LICENSE) 文件了解详情。 --- ## 👨‍💻 开发者

**Made with ❤️ by the Pet Service Team** [![GitHub](https://img.shields.io/badge/GitHub-@JackZho-181717?style=for-the-badge&logo=github)](https://github.com/JackZho)

---

**如果这个项目对你有帮助，请给一个 ⭐️ Star 支持一下！** ``` 🐾 Happy Coding with Pets! 🐾 ```