护航系统Pro版介绍

1：项目简介

七月云护航系统 是一个基于 ThinkPHP 8.0 构建的综合性服务平台，为用户提供完整的商城购物、在线客服、助手服务、工作室管理等全方位功能。平台整合了实时聊天系统、支付结算、文件存储等核心能力，为用户打造一站式数字服务平台。

2：核心业务场景

平台主要解决以下用户需求：

• 服务购买者：通过商城购买各类陪玩护航服务，实时与服务/陪玩人员沟通，跟踪服务进度
• 服务提供者：申请成为陪玩，提供专业陪玩服务，管理个人工作室，获得收益分成
• 团队协作：创建工作室，邀请成员协作，统一管理团队收益和客户资源

3：核心功能特性

• 🛒 商城系统：多级商品分类、服务商品展示、属性规格管理、订单流程处理
• 💬 实时聊天：基于WebSocket的在线客服系统，支持多终端实时通信
• 👥 助手服务：服务人员申请认证、分级管理、技能标签、收入分成体系
• 🏢 工作室管理：团队创建、成员邀请、权限管理、收益统一结算
• 💰 财务系统：多渠道支付集成、余额管理、提现申请、账单明细统计
• ❓ 智能问答：问题分类管理、常见问题解答、AI智能客服辅助
• 🎮 游戏娱乐：游戏卡片管理、游戏场次记录、娱乐服务扩展
• 🔧 管理后台：完整的后台管理系统，支持各项业务配置和数据统计

4：系统开发技术栈

• 后端框架: ThinkPHP 8.0+ (多应用架构)
• 编程语言: PHP 8.1+ (支持最新特性)
• 数据库: MySQL 5.7+ (支持事务和索引优化)
• 缓存系统: Redis 4.0+ (会话存储、在线状态缓存)
• Web服务器: Nginx/Apache (支持URL重写和负载均衡)
• 实时通信: Workerman 5.1+ (WebSocket服务器，支持WSS)
• 文件存储: 阿里云OSS / 腾讯云COS / 七牛云 (分布式存储)
• 支付集成: 支付宝 / 微信支付 (yansongda/pay SDK)
• 前端框架: Layui 2.9+ (响应式后台管理界面)
• AI能力: wolfcode/php-ai (智能助手和客服辅助)
• 开发工具: Composer (依赖管理) / Symfony VarDumper (调试)

5：项目架构与目录结构(Architecture)

_GLWt2/
├── app/ # 应用目录 – 核心业务逻辑层
│ ├── admin/ # 后台管理模块 – 管理系统核心功能
│ │ ├── controller/ # 后台控制器 – 48个控制器处理管理业务
│ │ │ ├── chat/ # 聊天管理 – 评论、表情、邀请、消息、记录
│ │ │ ├── customer/ # 客服管理 – 客服人员管理
│ │ │ ├── finance/ # 财务管理 – 提现、充值、打赏等财务功能
│ │ │ ├── game/ # 游戏管理 – 游戏字段配置
│ │ │ ├── helper/ # 助手管理 – 申请、等级、打赏商品
│ │ │ ├── mall/ # 商城管理 – 商品、分类、转盘等
│ │ │ ├── manage/ # 管理员管理 – 申请和管理列表
│ │ │ ├── order/ # 订单管理 – 订单处理和审核
│ │ │ ├── questions/ # 问答管理 – 问题分类和解答
│ │ │ ├── single/ # 单页管理 – 单页面内容管理
│ │ │ ├── system/ # 系统管理 – 9个系统配置控制器
│ │ │ ├── work/ # 工作管理 – 工作申请和列表
│ │ │ ├── yue/ # 余额管理 – 用户余额相关操作
│ │ │ ├── Ajax.php # AJAX接口 – 通用异步请求处理
│ │ │ ├── Banner.php # 轮播图管理 – 首页轮播配置
│ │ │ ├── Feedback.php # 反馈管理 – 用户反馈处理
│ │ │ ├── Game.php # 游戏管理 – 游戏主控制器
│ │ │ ├── Helper.php # 助手管理 – 助手主控制器
│ │ │ ├── Index.php # 后台首页 – 后台仪表板
│ │ │ ├── Login.php # 后台登录 – 管理员认证
│ │ │ ├── User.php # 用户管理 – 用户信息管理
│ │ ├── entity/ # 实体类 – 数据实体定义
│ │ ├── middleware/ # 中间件 – 5个中间件处理认证和安全
│ │ ├── model/ # 数据模型 – 55个模型处理数据操作
│ │ ├── service/ # 业务服务 – 41个服务处理复杂业务逻辑
│ │ │ ├── annotation/ # 注解服务 – 自定义注解处理
│ │ │ ├── auth/ # 认证服务 – 用户权限验证
│ │ │ ├── curd/ # CRUD服务 – 代码生成和数据操作
│ │ │ ├── tool/ # 工具服务 – 系统工具函数
│ │ │ ├── ConfigService.php # 配置服务 – 系统配置管理
│ │ │ ├── NodeService.php # 节点服务 – 权限节点管理
│ │ │ ├── SystemLogService.php # 日志服务 – 系统日志处理
│ │ │ ├── TriggerService.php # 触发服务 – 事件触发机制
│ │ │ ├── UploadService.php # 上传服务 – 文件上传处理
│ │ ├── traits/ # 特性类 – Curd特性提供通用CRUD方法
│ │ └── view/ # 视图模板 – 191个HTML模板文件
│ ├── api/ # API接口模块 – 提供RESTful API服务
│ │ ├── controller/ # API控制器 – 12个控制器处理前端请求
│ │ │ ├── AuthBase.php # 认证基类 – API基础认证
│ │ │ ├── Chat.php # 聊天API – 聊天功能接口
│ │ │ ├── Goods.php # 商品API – 商品相关接口
│ │ │ ├── Help.php # 助手API – 助手服务接口
│ │ │ ├── Index.php # 首页API – 首页数据接口
│ │ │ ├── Login.php # 登录API – 用户认证接口
│ │ │ ├── Order.php # 订单API – 订单处理接口
│ │ │ ├── Payment.php # 支付API – 支付处理接口
│ │ │ ├── Single.php # 单页API – 单页面接口
│ │ │ ├── Test.php # 测试API – 开发测试接口
│ │ │ ├── Upload.php # 上传API – 文件上传接口
│ │ │ └── User.php # 用户API – 用户信息接口
│ │ ├── middleware.php # API中间件配置
│ │ └── service/ # API服务层
│ │ └── AuthService.php # 认证服务 – API认证逻辑
│ ├── common/ # 公共模块 – 跨应用的共享代码
│ │ ├── command/ # 命令行工具 – Curd生成、证书下载等
│ │ ├── constants/ # 常量定义 – 系统常量和枚举
│ │ ├── controller/ # 公共控制器 – AdminController基类
│ │ ├── entity/ # 公共实体 – 基础实体类
│ │ ├── model/ # 公共模型 – 共享数据模型
│ │ ├── plugin/ # 插件系统 – 微信描述修复插件
│ │ ├── service/ # 公共服务 – 8个跨应用服务
│ │ ├── tpl/ # 模板文件 – 异常处理和跳转模板
│ │ ├── traits/ # 公共特性 – 跳转特性
│ │ └── utils/ # 工具类 – 助手类和位置工具
│ ├── index/ # 前端展示模块 – PC端页面展示
│ │ └── controller/ # 前端控制器 – 4个页面控制器
│ │ ├── BaseController.php # 基础控制器
│ │ ├── Goods.php # 商品页面
│ │ ├── Index.php # 首页控制器
│ │ └── Install.php # 安装页面
│ ├── AppService.php # 应用服务 – 应用级服务类
│ ├── BaseController.php # 基础控制器 – 所有控制器的基类
│ ├── common.php # 公共函数 – 全局公共函数
│ ├── event.php # 事件定义 – 系统事件配置
│ ├── ExceptionHandle.php # 异常处理 – 全局异常处理器
│ ├── middleware.php # 中间件配置 – 应用中间件配置
│ ├── provider.php # 服务提供者 – 服务注册配置
│ ├── Request.php # 请求类 – 自定义请求处理
│ └── service.php # 服务配置 – 服务绑定配置
├── config/ # 配置文件目录 – 系统各项配置
│ ├── app.php # 应用配置 – 应用基础设置
│ ├── database.php # 数据库配置 – 数据库连接配置
│ ├── route.php # 路由配置 – URL路由规则
│ └── … # 其他配置 (15个配置文件)
├── extend/ # 扩展类库目录 – 自定义扩展
├── public/ # Web根目录 – 公开访问资源
│ ├── static/ # 静态资源目录
│ │ ├── admin/ # 后台静态资源 – 96个文件
│ │ ├── common/ # 公共静态资源 – 21个文件
│ │ ├── js/ # JavaScript文件
│ │ ├── plugs/ # 插件资源 – 516个文件 (Layui等)
│ │ └── config-admin.js # 后台配置文件
│ ├── storage/ # 文件存储目录 – 上传文件存储
│ ├── chat-test.html # 聊天测试页面
│ ├── favicon.ico # 网站图标
│ ├── index.php # 应用入口文件
│ ├── robots.txt # 爬虫规则
│ └── router.php # 路由文件
├── route/ # 路由配置目录
│ └── app.php # 应用路由配置
├── runtime/ # 运行时目录 – 临时文件和缓存
├── test_h5.php # H5测试文件
├── vendor/ # Composer依赖 – 第三方包
├── view/ # 视图模板目录
│ ├── index/ # 前端模板
│ └── README.md # 视图说明
├── workerman/ # WebSocket服务目录
│ ├── check-service.php # 服务检查脚本
│ ├── config.php # Workerman配置
│ ├── Events.php # 事件处理类 – 聊天逻辑核心
│ ├── start-windows.bat # Windows启动脚本
│ ├── start.php # 启动脚本
│ └── workerman.log # 服务日志
├── composer.json # Composer配置
├── composer.lock # Composer锁定文件
├── LICENSE # 开源协议
├── nginx-example.conf # Nginx配置示例
└── README.md # 项目说明文档

6：核心模块职责

7：接口文档 (API Documentation)

3.1用户认证相关接口 (Authentication APIs)

接口名称	Method	Endpoint	关键参数	功能描述
发送验证码	POST	/api/login/postSentCode	phone	发送短信验证码用于登录注册
用户登录	POST	/api/login/postLogin	phone, password/code	支持密码登录和验证码登录
微信登录	POST	/api/login/wechatLogin	code	微信授权登录
获取用户信息	GET	/api/user/getUserInfo	token	获取当前登录用户的基本信息
更新用户信息	POST	/api/user/setUser	title, sex, logo, height, birthday, signature, background	更新用户个人资料信息

3.2 商城商品相关接口 (Mall APIs)

接口名称	Method	Endpoint	关键参数	关键参数
商品分类	GET	/api/goods/class	–	获取商品分类列表
商品列表	GET	/api/goods/list	cate_id, page, keyword	获取商品列表，支持分类筛选和关键词搜索
商品详情	GET	/api/goods/detail	goods_id	获取商品详细信息包括规格和价格
商品评价	GET	/api/goods/reviews	goods_id, page	获取商品评价列表
助手评价	GET	/api/goods/helperReviews	helper_id, page	获取助手评价列表
商品打赏	POST	/api/goods/dashou	goods_id, amount	打赏商品或服务
商品打赏列表	GET	/api/goods/dashou_detail	goods_id, page	获取商品打赏记录
助手动态	GET	/api/goods/dashou_dynamic	helper_id, page	获取助手动态列表

3.3 订单管理相关接口 (Order APIs)

接口名称	Method	Endpoint	关键参数	功能描述
我的订单	GET	/api/order/myOrder	type, page, page_size	获取用户订单列表，支持状态筛选
订单详情	GET	/api/order/detail	order_id	获取订单详细信息
提交订单	POST	/api/order/submitDocuments	goods_id, requirements	提交服务订单
抢单	POST	/api/order/order_grabbing	order_id	助手抢单操作
支付订单	POST	/api/order/pay	order_id, payment_type	订单支付，支持微信和支付宝
退款订单	POST	/api/order/refundOrder	order_id, reason	申请订单退款
取消订单	POST	/api/order/cancelOrder	order_id	取消订单
确认订单	POST	/api/order/confirmOrder	order_id	确认订单完成
评价订单	POST	/api/order/reviewOrder	order_id, rating, content	提交订单评价
转单	POST	/api/order/orderTurntableInfo	order_id, helper_id	订单转单操作

3.4 助手服务相关接口 (Helper APIs)

接口名称	Method	Endpoint	关键参数	功能描述
申请助手	POST	/api/help/apply	real_name, phone, skills	提交助手申请
我的助手	GET	/api/help/my_dashou	page, status	获取我的助手列表
助手收入	GET	/api/help/helperIncome	start_date, end_date	查询助手收入统计
发送邀请	POST	/api/help/send_invitation	phone, message	发送助手邀请
助手提现	POST	/api/help/withdrawApply	amount, account_info	提交提现申请
关注助手	POST	/api/help/follow	helper_id	关注指定助手
取消关注	POST	/api/help/unfollow	helper_id	取消关注助手
我的关注	GET	/api/help/my_follows	page	获取我的关注列表
助手等级	GET	/api/goods/helper_levels	–	获取助手等级配置

3.5 聊天通信相关接口 (Chat APIs)

接口名称	Method	Endpoint	关键参数	功能描述
随机客服	GET	/api/chat/randomCustomer	–	获取随机在线客服
官方消息	GET	/api/chat/officialMessages	page	获取官方消息
我的消息	GET	/api/chat/myMessages	page, conversation_id	获取我的消息列表
会话列表	GET	/api/chat/conversations	page	获取会话列表
会话详情	GET	/api/chat/conversationDetail	conversation_id	获取会话详细信息
创建会话	POST	/api/chat/createConversation	receiver_id, message	创建新的聊天会话
发送消息	POST	/api/chat/messages	conversation_id, content	发送聊天消息
在线状态	GET	/api/chat/onlineStatus	user_id	查询用户在线状态
WebSocket信息	GET	/api/chat/wsInfo	–	获取WebSocket连接信息
表情列表	GET	/api/chat/expressions	–	获取聊天表情列表

3.6 工作室管理相关接口 (Workshop APIs)

《接口持续更新编写中》