CRMEB BZ v6.0 使用教程：从安装部署到后台基础配置

CRMEB BZ v6.0 使用教程：从安装部署到后台基础配置

CRMEB BZ v6.0 是一套面向多端商城场景的电商系统，后端基于 ThinkPHP 6.0，前端包含管理端、H5/小程序端和 PC 端。对于第一次接触这个项目的开发者来说，最重要的不是马上改业务代码，而是先把安装入口、运行依赖、后台配置、队列和定时任务这些基础链路理清楚。

这篇文章结合项目中的 README、架构说明和模块说明，整理一套更适合落地使用的入门流程。

一、先明确项目结构

项目整体可以理解为后端核心 + 多端前端：

• crmeb/：后端主程序，包含 API、Services、DAO、Model、Jobs、Listeners、配置和公共入口。
• template/admin：管理端前端，主要用于商品、订单、用户、营销、系统配置等后台操作。
• template/uni-app：移动端项目，可用于 H5、小程序和 App 场景。
• template/pc、template/pc-nuxt：PC 端相关模板。
• docs/：项目架构、模块、数据库和 API 文档。

后端承担核心业务能力，前端负责不同端的交互展示。理解这个分工后，再看安装和配置会清晰很多。

二、准备运行环境

根据项目 README，后端运行环境要求 PHP 7.1 到 7.4。部署前建议准备：

• PHP 7.1 - 7.4
• MySQL 5.7 或兼容版本
• Redis，用于缓存和队列
• Web 服务，例如 Nginx 或 Apache
• Composer 依赖环境
• Node.js，用于管理端或移动端前端构建

站点入口目录需要指向 public。这是 ThinkPHP 项目里非常关键的一步，如果入口目录指错，安装页、静态资源和路由都可能异常。

三、一键安装流程

官方推荐的一键安装方式比较直接：

1. 上传项目代码到服务器。
2. 将站点入口目录设置为 public。
3. 在浏览器中访问你的域名或 IP。
4. 根据安装向导填写数据库连接信息。
5. 完成安装后，建议删除安装目录或确认安装锁已生成。

安装过程中需要填写数据库地址、端口、数据库名、账号、密码、表前缀等信息。项目默认配置里也能看到典型的 MySQL、Redis、Cache、Queue 配置结构。

四、后台入口和默认账号

安装完成后，后台访问地址通常是：

http://你的域名/admin

README 中给出的默认账号是：

• 账号：admin
• 密码：crmeb.com

正式环境上线前，一定要第一时间修改默认密码，并检查管理员权限、角色菜单和登录安全配置。默认账号只适合初始化使用，不适合长期暴露在公网环境。

五、基础配置优先级

第一次进入后台后，不建议马上创建商品，而是先完成基础配置。一个比较稳妥的顺序是：

1. 系统配置：站点名称、基础开关、上传配置、缓存配置。
2. 存储配置：本地上传或云存储，例如对象存储。
3. 支付配置：微信、支付宝或其他支付渠道。
4. 物流配置：配送方式、电子面单、运费规则。
5. 用户配置：用户等级、标签、积分、余额规则。
6. 营销配置：优惠券、秒杀、拼团、积分商城等活动规则。

这些配置会影响后面的商品发布、订单支付、发货和售后流程。先配基础能力，可以减少后续联调时的反复排查。

六、商品模块的使用思路

商品管理通常可以按这个顺序操作：

1. 创建商品分类。
2. 配置商品属性和规格规则。
3. 创建品牌信息。
4. 新增商品，设置价格、库存、图片、详情和配送方式。
5. 检查库存预警和商品评价相关配置。

CRMEB BZ 的商品模块不仅支持普通实物商品，也可以扩展到虚拟商品、服务商品等场景。对于多规格商品，建议先维护统一规格模板，再创建商品，避免每个商品重复配置。

七、订单模块的核心流程

订单状态流转是商城系统的主链路。项目文档中给出的基础状态可以概括为：

待支付 -> 待发货 -> 待收货 -> 已完成

同时还会穿插取消、退款、售后等分支。后台使用时建议重点关注：

• 订单列表筛选条件是否符合运营需求。
• 发货流程是否正确关联物流信息。
• 售后入口是否能覆盖退款、退货和状态追踪。
• 自动收货、库存预警等定时任务是否正常运行。

订单问题通常不是单点问题，而是支付、库存、物流、用户和售后共同作用的结果，所以排查时要顺着状态流看。

八、队列和定时任务不要忽略

README 中明确提到队列和定时任务：

php think queue:listen --queue

定时任务用于自动收货、库存预警等功能：

php think timer start --d

如果这些进程没有启动，后台看起来可能能正常登录、商品也能创建，但订单后续处理、通知、自动任务就会出现延迟或不执行。正式部署时建议把队列和定时任务交给进程管理工具托管。

九、客服和长连接服务

CRMEB BZ 的 H5 聊天、后台管理员消息通知等场景会用到 Workerman 长连接服务。启动方式通常类似：

php think workerman start --d

客服链路依赖实时连接，如果这部分没有启动，用户咨询、管理员消息通知等能力可能无法正常工作。上线前建议单独测试：

• 用户端是否能发起咨询。
• 客服端是否能收到消息。
• 商品或订单信息是否能在客服场景中正常查看。
• 断线重连后状态是否恢复。

十、多端前端配置建议

移动端位于 template/uni-app，可以构建 H5、小程序和 App。管理端位于 template/admin，主要服务后台运营人员。

建议在联调前确认：

• API 域名配置是否指向正确后端。
• H5、小程序、PC 端是否使用一致的业务接口。
• 管理端登录、权限菜单和接口鉴权是否正常。
• 上传、支付、分享、客服等端能力是否按平台分别配置。

多端项目最容易出现的问题是"某一端能用，另一端不能用"。所以配置项最好集中梳理，不要在多个文件里无记录地临时修改。

结语

CRMEB BZ v6.0 的入门重点可以总结为三句话：入口目录指向 public，后台配置先于业务录入，队列、定时任务和 Workerman 必须纳入部署清单。

只要先把这些基础链路跑通，再去做商品、订单、营销、客服和多端适配，项目推进会顺畅很多。