一个功能完整的综合性云服务平台，提供用户管理、论坛社区、应用商店、私聊系统等多种功能
快速开始 • 功能特性 • 技术栈 • 部署指南 • 接口文档
--- ## ✨ 功能特性 ### 🔐 用户系统 - 用户注册 / 登录 / 找回密码 - QQ 第三方登录集成 - 用户等级与徽章系统 - 签到、邀请、金币积分体系 - 用户关注与粉丝管理 ### 💬 论坛社区 - 板块管理（主板块 + 子板块） - 帖子发布、编辑、审核 - 评论互动、点赞收藏 - 帖子置顶、精华、热门推荐 - 回复评论通知 ### 🏪 应用商店 - 应用分类管理 - 应用上传、版本管理 - 应用评论与评分 - 付费下载支持 ### 💌 私聊系统 - 好友申请与管理 - 一对一私信聊天 - 消息已读 / 未读状态 - 系统通知推送 - 自动添加系统通知好友 ### 🛒 商城系统 - 虚拟商品管理 - 订单系统 - 卡密充值 / 登录 ### 📝 其他功能 - 笔记管理（个人笔记 CRUD） - 消息通知（系统通知、互动提醒） - 工具接口（邮件发送、文件上传） --- ## 🛠 技术栈 ### 后端 - **框架**: Flask 2.0+ - **数据库**: MySQL 5.7+ + SQLAlchemy ORM - **缓存**: Redis 7.2 - **认证**: Token + Session 混合认证 - **部署**: Docker + Docker Compose ### 前端 - **框架**: Vue 3 + Vite 5.2 - **UI 组件**: Element Plus - **路由**: Vue Router 4.3 - **状态管理**: Pinia --- ## 🚀 快速开始 ### 一键安装（推荐） ```bash bash <(curl -fsSL https://gitee.com/cgw0822/xw_api_v2/raw/master/install.sh) ``` 或 ```bash bash <(wget -qO- https://gitee.com/cgw0822/xw_api_v2/raw/master/install.sh) ``` ### 手动部署 ```bash # 克隆项目 git clone https://gitee.com/cgw0822/xw_api_v2.git cd xw_api_v2 # 运行部署脚本 chmod +x deploy.sh ./deploy.sh ``` ### 一键更新 项目部署后，可以使用一键更新脚本快速更新到最新版本： **远程一键更新（推荐）:** ```bash bash <(curl -fsSL https://gitee.com/cgw0822/xw_api_v2/raw/master/update-remote.sh) ``` 或 ```bash bash <(wget -qO- https://gitee.com/cgw0822/xw_api_v2/raw/master/update-remote.sh) ``` **本地更新脚本:** **Linux/macOS:** ```bash chmod +x update.sh ./update.sh ``` **Windows:** ```powershell Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser .\update.ps1 ``` 更新脚本会自动完成： 1. ✅ 自动查找项目目录 2. ✅ 拉取最新代码 3. ✅ 显示更新日志 4. ✅ 更新后端依赖 5. ✅ 更新前端依赖 6. ✅ 重启 Docker 服务（如果已安装） --- ## 📊 项目统计 | 项目 | 数量 | |------|------| | 接口总数 | 102+ 个 | | 功能模块 | 12 个 | | 数据库表 | 37 个 | | 前端页面 | 50+ 个 | ### API 模块分布 | 模块 | 接口数 | 主要功能 | |------|--------|----------| | 用户认证 | 8 | 登录、注册、验证码、QQ登录 | | 用户信息 | 10 | 个人资料、签到、修改密码 | | 论坛系统 | 29 | 板块、帖子、评论、点赞、收藏 | | 私聊系统 | 10 | 好友、聊天、消息通知 | | 应用商店 | 16 | 应用发布、下载、评论 | | 商城系统 | 4 | 商品、订单、支付 | | 笔记管理 | 5 | 笔记 CRUD | | 卡密系统 | 3 | 直充、登录卡密 | | 工具接口 | 2 | 邮件、文件上传 | --- ## 📖 接口文档 启动服务后访问： - **API 文档**: http://localhost:5000/docs - **后台管理**: http://localhost:5000/admin - **前端页面**: http://localhost:5173 ### 接口示例 **用户登录** ```http POST /api/login Content-Type: multipart/form-data appid=2&username=admin&password=admin123&captcha=xxxx ``` **获取帖子列表** ```http POST /api/get_posts_list Content-Type: multipart/form-data appid=2&page=1&limit=10 ``` **发送私聊消息** ```http POST /api/send_message Content-Type: multipart/form-data appid=2&usertoken=xxx&receiver_id=2&content=你好 ``` --- ## 🏗 项目结构 ``` xw_api_v2/ ├── backend/ # 后端代码 │ ├── app/ │ │ ├── api/ # API 接口（用户端 + 管理端） │ │ ├── models/ # 数据模型（37个表） │ │ ├── utils/ # 工具函数 │ │ └── views/ # 视图模板 │ ├── app.py # 应用入口 │ ├── schema.sql # 数据库表结构 │ └── requirements.txt ├── frontend/ # 前端代码 │ ├── src/ # 源代码 │ ├── public/ # 静态资源 │ └── package.json ├── deploy.sh # Linux/macOS 部署脚本 ├── deploy.ps1 # Windows 部署脚本 └── README.md # 项目说明 ``` --- ## 🔧 核心功能实现 ### 1. 统一认证机制 - 支持普通用户和 Admin 用户统一认证 - Token 自动验证，支持多平台登录 - 系统通知账号（admin）可登录所有应用 ### 2. 数据库设计 - 37 张数据表，涵盖完整业务场景 - 合理的索引设计，支持高并发查询 - 完善的关联关系（外键约束） ### 3. API 设计规范 - 统一的响应格式 `{code, msg, data, timestamp}` - RESTful API 规范 - 完善的参数验证与错误处理 - 自动生成在线文档 ### 4. 好友系统 - 自动添加系统通知账号为好友 - 支持好友申请、同意、删除 - 实时消息推送 --- ## 🐳 Docker 部署 ```bash # 启动所有服务 docker compose up -d # 查看服务状态 docker compose ps # 查看日志 docker compose logs -f # 重启服务 docker compose restart ``` ### 服务端口 | 服务 | 端口 | 说明 | |------|------|------| | Nginx | 80 | 前端服务 | | Flask | 5000 | 后端 API | | MySQL | 3306 | 数据库 | | Redis | 6379 | 缓存 | --- ## 🔐 安全特性 - ✅ 密码使用随机盐值 + MD5 加密存储 - ✅ Token 认证机制 - ✅ 验证码防刷 - ✅ SQL 注入防护（SQLAlchemy ORM） - ✅ XSS 防护 - ✅ CSRF 防护 --- ## 📝 更新日志 ### v2.1.0 (2026-03-24) - ✨ 新增回复评论功能，支持评论回复通知 - ✨ 新增系统通知账号，自动添加为好友 - ✨ 评论列表支持排序（正序/倒序） - ✨ 评论列表显示回复关系 - 🔧 优化好友列表，自动包含系统通知 - 🔧 修复多处接口认证问题 - 📚 更新 API 文档 ### v2.0.0 (2026-02-19) - ✨ 初始版本发布 - ✨ 完整的用户系统 - ✨ 论坛社区功能 - ✨ 应用商店功能 - ✨ 私聊系统 - ✨ 商城系统 --- ## 🤝 参与贡献 欢迎提交 Issue 和 Pull Request！ 1. Fork 本仓库 2. 创建特性分支 (`git checkout -b feature/AmazingFeature`) 3. 提交更改 (`git commit -m 'Add some AmazingFeature'`) 4. 推送到分支 (`git push origin feature/AmazingFeature`) 5. 开启 Pull Request --- ## 📄 许可证 本项目为私有项目，未经授权禁止商用。 --- ## 📧 联系方式 - 项目主页: https://gitee.com/cgw0822/xw_api_v2 - 问题反馈: https://gitee.com/cgw0822/xw_api_v2/issues ---如果这个项目对您有帮助，请给个 Star ⭐
Made with ❤️ by 小伟云团队