mirror of
https://github.com/crmeb/CRMEB.git
synced 2026-10-28 21:40:50 +00:00
18 KiB
18 KiB
CRMEB 高品质开源商城系统 v8（PHP 版）
中台化架构 · 模块化扩展 · AI 原生 · 三端一体
用心做开源，我们也很需要你的鼓励！右上角Star🌟，等你点亮
📝 项目介绍
开源自由
CRMEB 开源商城系统代码 100% 开源，基于 Apache-2.0 协议 免费商用，无任何隐藏费用或功能限制，真正实现"零成本"部署与二次开发自由！
中台化架构
v8 全新升级为中台化电商架构：商品中台统一管理多产品类型商品，订单中台聚合多来源订单的状态与操作，售后退款中台提供统一售后单与幂等退款。产品类型（实物、网盘）与交易模式（普通、会员）解耦为两个独立维度，通过注册中心自由组合扩展。
模块化插件体系
业务能力按模块（modules/）与驱动（driver/）两类可插拔扩展组织：当前内置 22 个官方模块（实物商品、网盘产品、H5 渠道、微信小程序渠道、签到活动、AI Agent、MCP 服务等）与 30 个官方驱动（微信支付、云存储、短信、邮件、物流查询、电子面单、电子发票、商品采集、机器人、云打印等），新装默认安装 7 个模块（必装 1 + 默认 6）和 15 个驱动，均支持后台可视化安装、卸载、启用、禁用；扩展遵循统一规范，插件二开零侵入。
AI 原生
内置 AI Agent 模块，提供后台 AI 对话、流式响应与自动化任务；MCP 服务通过 /api/mcp 端点向 AI 客户端开放系统工具，让人与 AI 协同运营商城。
多端一体
一套 uni-app 源码覆盖 H5、微信小程序、支付宝小程序、APP，管理后台基于 Vue 3 + Element Plus，前后端分离设计，数据实时互通，助力商家一站式运营多渠道业务。
🧩 中台化核心能力
| 中台 | 说明 |
|---|---|
| 商品中台 | 商品主记录与产品类型扩展分离，跨类型共享分类、SKU、属性、评价与统计；产品类型模块化，内置实物商品、网盘产品，支持自定义新产品类型 |
| 交易模式注册中心 | "商品怎么卖"与"商品是什么"解耦：内置普通购买、会员交易两种模式，负责活动定价、下单校验与生命周期钩子，更多玩法按注册中心规范注册扩展 |
| 订单中台 | 多订单类型统一汇总，关联商品快照与状态日志；订单类型适配器统一输出状态树、支付状态、可操作按钮与订单进度 |
| 售后退款中台 | 统一售后申请与商品明细，产品类型通过规则注册中心声明可用售后类型与时限；统一退款单 + 退款副作用幂等记录，支持仅退款、退货退款、换货、维修 |
| 用户与资产 | 以用户为中心聚合地址、标签、等级、会员、余额、积分、佣金、优惠券、发票与推广关系 |
📦 模块与驱动生态
当前内置 22 个模块与 30 个驱动，新装默认安装 7 个模块（必装 1 + 默认 6）和 15 个驱动，均可在后台「扩展管理」中管理（实物商品为基础保护模块，不可卸载）。
内置模块
| 模块 | 能力 |
|---|---|
| 实物商品 | 通用商品与 SKU、物流/配送/自提履约（基础保护模块） |
| 网盘产品 | 数字资源类商品，支付后自动发放 |
| H5 浏览器 | H5 渠道接入与用户认证 |
| 微信小程序 | 微信小程序渠道接入与用户认证 |
| 签到活动 | 连续/累计签到规则、积分奖励、签到记录 |
| AI Agent | 后台 AI 对话、流式响应、自动化任务与运行记录 |
| MCP 服务 | POST /api/mcp 向 AI 客户端开放系统工具，独立密钥认证 |
内置驱动
| 类别 | 内置驱动 |
|---|---|
| 支付 | 微信支付、微信支付 V3 |
| 云存储 | 本地存储、阿里云 OSS |
| 短信 / 邮件 | 一号通短信、QQ 邮箱 |
| 机器人 | 企业微信机器人、钉钉机器人、飞书机器人 |
| 物流与履约 | 一号通物流查询、一号通电子面单、一号通电子发票、一号通商品采集 |
| 云打印 | 飞鹅云、易联云 |
🫧 技术特点
关于二开：
1.代码规范：遵循PSR-12命名规范、Restful标准接口、Controller→Services→Dao→Model严格分层、注释齐全、统一响应体{status,msg,data}；
2.权限管理：内置强大灵活的权限管理，菜单即权限规则，可以控制到每一个菜单与操作按钮；
3.模块脚手架：php think make:module 一键生成合规模块骨架（插件、产品类型、驱动、交易模式、营销观察者）；
4.架构守护：php think arch:check 自动扫描三层依赖铁律、跨模块互引、事件与注释规范，可接入CI拦截；
5.系统事件：核心与模块双事件注册表，业务监听器按事件锚点挂载，模块监听随安装状态加载；
6.定时任务：系统与模块双定时任务体系，随模块安装自动注册执行周期；
7.接口管理：后台可视化路由管理、接口导入与在线调试；
8.表单引擎：后端 form-builder PHP 快速生成表单，前端 @form-create 渲染；
9.代码生成：快速生成后台菜单、页面与增删改查；
10.开发文档：help/docs 内置中文项目文档（项目说明、架构、功能、数据库设计、部署、运维），后台可连接 MCP 开发知识服务（文档检索/路由检索/表结构查询）；
11.AI 开发体系：.crmeb 目录内置 AI 编码规则、技能与子智能体，兼容主流 AI 编码工具。
性能与拓展：
1.系统安全：JWT认证、角色权限校验、操作日志、系统生产日志、文件校验、数据备份；
2.高性能：Redis缓存、think-queue消息队列、Workerman长连接网关、多种云存储、支持集群部署；
3.多语言：管理端与用户端均支持多语言（vue-i18n），自动识别浏览器语言；
4.驱动扩展：支付、上传、短信、邮件、物流、电子面单、打印、机器人、采集、发票十大类驱动，同一能力多家供应商自由切换；
5.实时通信：统一 WebSocket 网关（/ws），支撑后台实时通知等场景；
6.一号通：通用第三方扩展，支持短信、物流查询、电子面单、电子发票、商品采集。
📖 系统功能
管理端功能总览（点击展开）
- 工作台：经营数据汇总、订单/用户趋势、交易排行、待处理提醒
- 商品管理：商品中台、分类、多规格 SKU、属性模板、评价、采集导入导出
- 订单管理：订单中台统一列表详情、发货/拆单发货、改价备注、物流轨迹、发票
- 售后退款：售后审核、退货收货、统一退款单、原路退款、幂等副作用
- 用户管理：用户分组标签等级、资产调整、注销管理
- 会员体系：会员套餐、会员权益、付费会员
- 营销中心：优惠券、积分、签到活动
- 页面装修：商城 DIY 拖拽装修、主题一键换色、底部导航、开屏广告、文章资讯
- 门店配送：门店自提、店员核销、运费模板、电子面单、云打印
- 财务管理：资金流水、支付渠道配置、经营统计
- 消息通知：站内信、短信、邮件、公众号模板消息、小程序订阅消息、机器人
- 微信生态：公众号 OAuth/菜单/素材/回复、小程序登录/订阅消息
- 扩展管理：模块与驱动的安装卸载启用禁用、管理员角色权限、配置项、定时任务、系统日志与备份
用户端功能总览（点击展开）
- 浏览购物：DIY 首页、分类搜索、商品详情、购物车、优惠券/积分/余额组合结算
- 订单支付：多状态订单管理、微信支付/余额支付、物流轨迹、评价
- 售后服务：动态售后表单、售后进度时间线、退货物流填写
- 个人中心：余额账单、积分、优惠券、会员权益、收货地址、消息中心
- 营销互动：签到领积分、优惠券领取
🔐 运行环境
| 运行环境 | 要求 |
|---|---|
| 操作系统 | Linux / Windows |
| WEB 服务 | Nginx / Apache / IIS |
| PHP 版本 | PHP 8.2 ~ 8.4 |
| 数据库 | MySQL 8.0（引擎：InnoDB，字符集：utf8mb4，表前缀：eb_） |
| 缓存 | Redis（生产环境必装，消息队列依赖） |
| 管理器 | Supervisor（用于管理消息队列等常驻进程） |
| Node.js | >= 18（仅前端工程构建需要） |
| PHP 扩展 | bcmath、curl、mbstring、json、zip、simplexml、fileinfo（可选）、redis（可选） |
| 需解除禁用函数 | proc_open, pcntl_signal, pcntl_signal_dispatch, pcntl_fork, pcntl_wait, pcntl_alarm（Workerman 与队列需要） |
| 消息队列 | 运行命令：php think queue:listen --queue（使用 Supervisor 守护） |
| 定时任务 | 运行命令：php think timer start --d（命令行执行） |
| 长连接 | 运行命令：php think workerman start --d（命令行执行，默认端口 40001） |
📺 开发环境及使用技术
开发环境：
| 工具 | 版本 | 下载链接 |
|---|---|---|
| PHP | 8.2 ~ 8.4 | PHP 官方下载 |
| Composer | 2.x | Composer 官网 |
| MySQL | 8.0 | MySQL 官网 |
| Redis | 6.0+ | Redis 官网 |
| Nginx | 1.22+ | Nginx 官网 |
| Node.js | 18 / 20+ | Node.js LTS 版本 |
后端技术栈
| 技术 | 名称 | 网址 |
|---|---|---|
| ThinkPHP 8 | 核心框架，多应用模式（adminapi / api / outapi 三入口） | https://www.thinkphp.cn/ |
| think-queue | 消息队列（Redis 驱动） | https://github.com/top-think/think-queue |
| workerman | 高性能 Socket 服务，长连接网关与定时任务调度 | https://www.workerman.net |
| easywechat 6 | 微信生态开发（公众号/小程序/支付） | https://github.com/w7corp/easywechat |
| php-jwt | JWT 令牌生成与验证 | https://github.com/firebase/php-jwt |
| form-builder | 快速构建表单的 PHP 工具 | https://form-create.com |
| phpspreadsheet | Excel 导入导出 | https://github.com/PHPOffice/PhpSpreadsheet |
| guzzlehttp | HTTP 客户端库 | https://guzzle-cn.readthedocs.io/zh-cn/latest |
| alipaysdk | 支付宝 SDK | https://github.com/alipay/alipay-easysdk |
| snowflake | 分布式唯一 ID | https://github.com/godruoyi/php-snowflake |
| aliyun-oss / qiniu | 云存储 SDK | https://github.com/aliyun/aliyun-oss-php-sdk |
Admin 管理端技术栈
| 技术 | 名称 | 官网 |
|---|---|---|
| vue 3.5 | Vue 框架 | https://vuejs.org/ |
| element-plus 2.9 | UI 框架 | https://element-plus.org/ |
| pinia 2 | 状态管理库 | https://pinia.vuejs.org/ |
| vue-router 4 | 路由管理 | https://router.vuejs.org/ |
| vite 5 | 构建工具 | https://vitejs.dev/ |
| vxe-table 4 | 高级表格组件 | https://vxetable.cn/ |
| echarts 5 | 图表库 | https://echarts.apache.org/ |
| wangeditor 5 | 富文本编辑器 | https://www.wangeditor.com/ |
| monaco-editor | 代码编辑器 | https://microsoft.github.io/monaco-editor/ |
| axios | HTTP 客户端 | https://axios-http.com/ |
| vue-i18n 9 | 多语言 | https://vue-i18n.intlify.dev/ |
| form-create | 动态表单渲染 | https://form-create.com |
| xlsx / exceljs | Excel 处理库 | https://sheetjs.com/ |
| sass | CSS 预处理器 | https://sass-lang.com/ |
移动端技术栈
| 技术 | 名称 | 官网 |
|---|---|---|
| uni-app（官方 CLI + Vite 5） | 跨端框架，一套代码编译 H5 / 微信小程序 / 支付宝小程序 / APP | https://uniapp.dcloud.net.cn/ |
| vue 3 | Vue 框架 | https://vuejs.org/ |
| pinia | 状态管理库 | https://pinia.vuejs.org/ |
| vue-i18n | 多语言 | https://vue-i18n.intlify.dev/ |
| sass | CSS 预处理器 | https://sass-lang.com/ |
🚀 快速开始
宿主机环境（推荐）
# 1. 后端
cd backend
composer install
php think run --host 127.0.0.1 --port 8011
# 2. 管理后台（开发服务器默认端口 1619，/adminapi 代理到 8011）
cd frontend/admin
npm ci
npm run dev
# 3. 移动端
cd frontend/uni-app
npm install
npm run dev:h5 # H5；微信小程序：npm run dev:mp-weixin
后台常驻进程
cd backend
php think queue:listen --queue # 消息队列（Supervisor 托管）
php think timer start --d # 定时任务
php think workerman start --d # WebSocket 长连接网关
Docker Compose（可选）
./run.sh start # 启动（Nginx 8011 / MySQL 33061 / Redis 63791 / WebSocket 40001）
./run.sh ps # 查看状态
./run.sh logs # 查看日志
前端一键命令（run.sh）
./run.sh admin:dev # 管理端开发测试启动（端口 1619）
./run.sh admin:build # 管理端编译打包并发布到 backend/public/admin
./run.sh uni:dev # 移动端 H5 开发测试启动
./run.sh uni:build # 移动端 H5 编译打包并发布到 backend/public
默认访问地址：
http://localhost:8011，管理后台http://localhost:8011/admin。 数据库连接等配置以backend/.env为准；详细部署说明见 部署指南。
📖 项目文档
系统内置完整中文文档（help/docs/）：
| 文档 | 内容 |
|---|---|
| 项目说明 | 项目定位、角色、入口、仓库结构、快速开始 |
| 项目功能 | 管理端/用户端全量功能清单与核心业务流程 |
| 项目架构 | 分层架构、模块与驱动体系、注册中心 |
| 模块与驱动 | 内置模块与驱动的清单与说明 |
| 数据库设计 | 核心数据表结构与关系 |
| 开发指南 | 本地开发、回归脚本、调试方法 |
| 部署指南 | 宿主机与 Docker 部署 |
| 运维手册 | 日常运维、备份恢复、故障排查 |
| 安全与配置 | 配置项说明与安全基线 |
| API 文档 | 管理端/用户端接口索引 |
📞 交流互动
欢迎通过 Gitee Issues 提交 Bug 与建议，通过 Pull Request 参与共建。
❤️ 以商业之名，护航开源之心
基于 CRMEB 开源版深度升级，遵循 Apache-2.0 协议开源。