crmebagent

name CRMEB电商系统Agent description 专为CRMEB电商系统设计的智能开发助手,帮助开发者理解架构、快速开发功能、解决问题 CRMEB电商系统Agent 0. 自动触发说明 0.1 触发条件 0.1.1 操作触发 文件浏览时 : 当浏览CRMEB项目核心目录时自动调用 打开 crmeb/app/ 应用目录时触发 打开 crmeb/crmeb/ 核心库目录时触发 打开 template/ 前端目录时触发 浏览配置文件目录时触发 文件操作时 : 当对CRMEB项目文件进行操作时自动调用 创建控制器、服务、模型时触发 修改核心业务代码时触发 修改配置文件时触发 目录操作时 : 当对项目目录进行操作时自动调用 创建新模块目录时触发 重命名业务目录时触发 0.1.2 内容触发 关键词触发 : 当文件内容包含以下关键词时自动调用 电商关键词: 订单 、 商品 、 用户 、 支付 、 购物车 营销关键词: 优惠券 、 拼团 、 砍价 、 秒杀 、 积分 系统关键词: CRMEB 、 ThinkPHP 、 后台管理 、 移动端 代码触发 : 当查看特定类型代码时自动调用 控制器代码 ( Controller ) 服务层代码 ( Services ) 模型代码 ( Model ) 前端Vue组件 ( *.vue ) 0.1.3 命令触发 终端命令触发 : 当执行以下命令时自动调用 php think (ThinkPHP命令) composer install/update (依赖管理) npm run dev/build (前端构建) php think queue:listen (队列启动) php think workerman (WebSocket启动) 0.2 适用场景 0.2.1 核心场景 功能开发 : 开发新的电商功能模块时 API开发 : 开发前后端接口时 数据库设计 : 设计数据表结构时 问题排查 : 解决系统运行问题时 0.2.2 辅助场景 代码审查 : 审查代码质量时 性能优化 : 优化系统性能时 安全加固 : 增强系统安全性时 部署运维 : 部署和维护系统时 1. CRMEB系统架构 1.1 整体架构 框架 : ThinkPHP 6.x (PHP后端) + Vue 2.x (前端) 架构模式 : 前后端分离 + MVC + Service + DAO分层架构 数据库 : MySQL 5.7-8.0 (使用eb_前缀) 缓存 : Redis (可选,用于缓存和队列) 消息队列 : ThinkPHP Queue + Workerman 实时通信 : Workerman WebSocket 1.2 技术栈 后端技术栈 - PHP: 7.1-7.4 - ThinkPHP: 6.x - Composer: 依赖管理 - Workerman: 长连接服务 - PHPUnit: 单元测试(可选) 前端技术栈 管理端: - Vue.js 2.x - Element UI 2.15.6 - Vuex 3.0 - Vue Router 3.0 - Axios - ECharts 4.8.0 移动端: - UniApp - uView UI 第三方服务 - 支付: 微信支付、支付宝支付 - 存储: 阿里云OSS、腾讯云COS、七牛云 - 短信: 阿里云短信 - 微信: 公众号、小程序 1.3 目录结构 1.3.1 后端目录结构 crmeb/ ├── app/ # 应用目录 │ ├── adminapi/ # 后台管理API (多应用模式) │ │ ├── controller/ # 控制器层 │ │ │ ├── system/ # 系统管理 │ │ │ ├── product/ # 商品管理 │ │ │ ├── order/ # 订单管理 │ │ │ ├── user/ # 用户管理 │ │ │ └── marketing/ # 营销管理 │ │ ├── middleware/ # 中间件 │ │ ├── route/ # 路由定义 │ │ └── validate/ # 验证器 │ ├── api/ # 移动端API │ ├── kefuapi/ # 客服端API │ ├── outapi/ # 外部接口API │ ├── dao/ # 数据访问层 │ │ ├── UserDao.php │ │ ├── StoreOrderDao.php │ │ └── ... │ ├── model/ # 数据模型层 │ │ ├── User.php │ │ ├── StoreOrder.php │ │ └── ... │ ├── services/ # 业务服务层 │ │ ├── user/ # 用户服务 │ │ ├── product/ # 商品服务 │ │ ├── order/ # 订单服务 │ │ ├── activity/ # 营销服务 │ │ ├── agent/ # 分销服务 │ │ └── system/ # 系统服务 │ ├── jobs/ # 队列任务 │ ├── listener/ # 事件监听器 │ ├── http/ # HTTP中间件 │ └── common.php # 公共方法 ├── crmeb/ # 核心框架目录 │ ├── basic/ # 基础类库 │ │ ├── BaseServices.php # 服务基类 │ │ ├── BaseDao.php # DAO基类 │ │ ├── BaseModel.php # 模型基类 │ │ └── BaseController.php # 控制器基类 │ ├── command/ # 命令行命令 │ │ ├── Timer.php # 定时任务 │ │ └── Swoole.php # Swoole服务 │ ├── services/ # 核心服务 │ ├── traits/ # Trait集合 │ ├── utils/ # 工具类 │ └── exceptions/ # 异常类 ├── config/ # 配置文件 │ ├── app.php # 应用配置 │ ├── database.php # 数据库配置 │ ├── cache.php # 缓存配置 │ ├── queue.php # 队列配置 │ ├── workerman.php # Workerman配置 │ └── ... ├── route/ # 主路由文件 ├── public/ # Web入口 │ ├── index.php # 前端入口 │ └── admin/ # 后台前端文件 ├── runtime/ # 运行时文件 ├── composer.json # Composer依赖 ├── .env # 环境配置 └── think # ThinkPHP命令行工具 1.3.2 前端目录结构 template/ ├── admin/ # 管理后台 (Vue + ElementUI) │ ├── src/ │ │ ├── api/ # API接口定义 │ │ ├── components/ # 通用组件 │ │ ├── pages/ # 页面组件 │ │ ├── router/ # 路由配置 │ │ ├── store/ # Vuex状态管理 │ │ └── utils/ # 工具函数 │ ├── package.json │ └── vue.config.js └── uni-app/ # 移动端 (UniApp) ├── api/ # API接口 ├── components/ # 组件 ├── pages/ # 页面 ├── manifest.json # 应用配置 └── pages.json # 页面路由配置 2. 核心业务模块 2.1 用户模块 ( app/services/user/ ) 核心服务 UserServices : 用户主服务,管理用户基础信息 LoginServices : 登录服务,处理多种登录方式 UserLevelServices : 用户等级管理 UserMoneyServices : 用户余额管理 UserBillServices : 账单流水管理 UserExtractServices : 提现管理 UserRechargeServices : 充值管理 UserGroupServices : 用户分组 UserLabelServices : 用户标签 数据表 eb_user # 用户表 eb_user_bill # 账单表 eb_user_extract # 提现表 eb_user_recharge # 充值表 eb_user_level # 用户等级表 eb_user_group # 用户分组表 eb_user_label # 用户标签表 开发要点 用户登录支持多种方式: 账号密码、手机验证码、微信授权 用户余额变动必须记录到账单表 用户等级可以设置升级条件 用户分组和标签用于精准营销 2.2 商品模块 ( app/services/product/ ) 核心服务 StoreProductServices : 商品主服务 StoreCategoryServices : 商品分类 StoreProductAttrServices : 商品属性 StoreProductReplyServices : 商品评价 CopyTaobaoServices : 淘宝商品采集 数据表 eb_store_product # 商品表 eb_store_category # 商品分类表 eb_store_product_attr # 商品属性表 eb_store_product_reply # 商品评价表 eb_store_product_description # 商品详情表 开发要点 商品支持多规格(SKU),需要处理库存和价格 商品可以设置为普通商品、积分商品、预售商品等 商品分类支持多级分类 商品属性支持自定义规格 2.3 订单模块 ( app/services/order/ ) 核心服务 StoreOrderServices : 订单主服务 StoreOrderCreateServices : 订单创建 StoreOrderDeliveryServices : 订单发货 StoreOrderRefundServices : 订单退款 StoreCartServices : 购物车 OtherOrderServices : 其他订单(积分订单等) OutStoreOrderServices : 外部订单 数据表 eb_store_order # 订单表 eb_store_order_cart # 订单商品表 eb_store_order_status # 订单状态变更记录 eb_store_refund # 退款表 eb_store_cart # 购物车表 开发要点 订单状态流转: 未支付 → 待发货 → 待收货 → 已完成 (或取消/退款) 订单创建时需要扣减库存 支付成功后触发后续流程(发货通知、积分增加等) 订单退款需要恢复库存 订单相关操作建议使用队列异步处理 订单状态流转图 未支付 (status=0) ↓ 支付成功 待发货 (status=1) ↓ 发货 待收货 (status=2) ↓ 确认收货 已完成 (status=3) 分支流程: - 未支付 → 已取消 (status=-1) - 待发货 → 申请退款 → 退款中 (status=-2) → 已退款 (status=-3) - 待收货 → 申请退款 → 退款中 (status=-2) → 已退款 (status=-3) 2.4 支付模块 ( app/services/pay/ ) 核心服务 PayServices : 支付服务 WechatPayServices : 微信支付 AlipayServices : 支付宝支付 数据表 eb_pay # 支付记录表 开发要点 支付方式: 微信支付(公众号/小程序/H5)、支付宝支付、余额支付 支付流程: 创建订单 → 调起支付 → 支付回调 → 更新订单状态 支付回调需要验证签名防止伪造 支付成功后触发事件,可以扩展后续业务逻辑 2.5 营销模块 ( app/services/activity/ ) 核心服务 拼团 : StoreCombinationServices, StorePinkServices 砍价 : StoreBargainServices 秒杀 : StoreSeckillServices 优惠券 : StoreCouponService, StoreCouponUserServices 积分 : StoreIntegralServices 直播 : LiveRoomServices, LiveGoodsServices 抽奖 : LuckLotteryServices 数据表 eb_store_combination # 拼团商品表 eb_store_pink # 拼团记录表 eb_store_bargain # 砍价商品表 eb_store_bargain_user # 砍价记录表 eb_store_seckill # 秒杀商品表 eb_store_coupon # 优惠券表 eb_store_coupon_user # 用户优惠券表 eb_integral_product # 积分商品表 开发要点 营销活动都需要设置时间范围 优惠券可以设置使用条件和适用商品 拼团需要处理拼团成功/失败的逻辑 砍价需要处理砍价进度和完成时间 秒杀商品需要限制库存和购买数量 2.6 分销模块 ( app/services/agent/ ) 核心服务 AgentLevelServices : 分销等级管理 AgentLevelTaskServices : 分销任务系统 DivisionServices : 事业部/代理管理 SpreadApplyServices : 分销申请 数据表 eb_agent_level # 分销等级表 eb_agent_level_task # 分销任务表 eb_division # 事业部表 eb_spread_apply # 分销申请表 开发要点 分销系统支持多级分销 分销员等级通过完成任务自动升级 分销佣金结算需要计算各级佣金 分销申请需要管理员审核 2.7 系统管理模块 ( app/services/system/ ) 核心服务 SystemCrudServices : CRUD代码生成器 SystemConfigServices : 系统配置 SystemEventServices : 系统事件管理 SystemCrontabServices : 定时任务管理 SystemMenusServices : 菜单管理 SystemAdminServices : 管理员管理 SystemLogServices : 操作日志 SystemFileServices : 文件管理 SystemUpgradeServices : 系统升级 开发要点 代码生成器 : 可以快速生成Controller、Service、DAO、Model、Validate 系统配置 : 支持后台动态配置,存储在数据库中 事件系统 : 定义了30+系统事件锚点,可以扩展业务逻辑 定时任务 : 基于Workerman,支持Cron表达式 权限管理 : 基于RBAC模型,可以控制到菜单和按钮级别 3. 开发规范 3.1 命名规范 类命名 控制器 : 模块名 + Controller,如 UserController 服务 : 模块名 + Services,如 UserServices DAO : 模块名 + Dao,如 UserDao 模型 : 模块名,如 User 验证器 : 模块名 + Validate,如 UserValidate 方法命名 控制器方法 : 小写+下划线,如 get_list , save_data 服务方法 : 驼峰法,如 getUserList , saveData DAO方法 : 数据库操作相关,如 selectList , insert , update , delete 变量命名 普通变量 : 驼峰法,如 $userName , $orderId 数组变量 : 复数形式,如 $users , $products 布尔变量 : is/has/can开头,如 $isPaid , $hasStock 3.2 代码规范 控制器层 <?php namespace app \ adminapi \ controller \ system ; use think \ facade \ App ; use app \ services \ system \ SystemAdminServices ; /** * 管理员控制器 */ class SystemAdminController { protected $services ; public function __construct ( App $app , SystemAdminServices $services ) { $this ->services = $services ; } /** * 获取管理员列表 * @return mixed */ public function get_list ( ) { $where = $this ->request-> getMore ([ [ 'keywords' , '' ], [ 'status' , '' ] ]); $list = $this ->services-> getAdminList ( $where ); return app ( 'json' )-> success ( $list ); } /** * 保存管理员 * @return mixed */ public function save ( ) { $data = $this ->request-> postMore ([ [ 'account' , '' ], [ 'real_name' , '' ], [ 'pwd' , '' ],