大鹏AI教育 · 张大鹏 · 免费图文
学习目标
学完能说清 CRMEB 的三端各做什么,能从项目根目录找到后端、后台、移动端和安装入口,并能用实际文件和提交哈希核对 AI 对架构的解释。
前置知识与环境
会打开终端和浏览器即可。跟做源码观察需要 Git 和一个本地源码目录。首课阅读目录不需要本地数据库。安装演示来自独立的 Windows、WSL2 和 Docker 测试环境,使用 PHP 8.4、Nginx、MySQL 8.0.46 和文件缓存,并通过浏览器验证了 Admin 和 H5。安装步骤在第 3–5 课展开。
CRMEB 是什么,适合谁用
CRMEB 是一套开源电商商城。商家可以用管理后台维护商品、订单和用户,消费者从移动商城浏览商品。它适合需要验证自营商城、为小商家交付商城或学习 PHP 电商项目的团队。优惠、支付、配送等业务要结合实际所选的模块、驱动和商户配置验证。
白泽选它做实战项目,是因为商品、订单、用户贯通了前端、后端和数据层。用真实仓库学习时,目录、请求、数据库和测试可以交叉核对,适合练习从 AI 分析到人工验收的过程。
按经营任务核对版本能力
下表针对本课 CRMEB v8.0.0 白泽教学基线。
| 任务 | 入口和条件 | 验证情况 |
|---|---|---|
| 管理商品、分类、用户与订单 | Admin,需安装并配置操作权限 | 固定环境已核对管理员登录、菜单和商品 API。具体角色和订单操作按用例验收 |
| 顾客浏览商品与分类 | H5,依赖后台与商城 API | 隔离环境已验证首页、分类、商品列表 |
| 微信小程序入口 | 需目标构建、平台主体、域名和审核 | 独立审计已构建,真机和发布待验证 |
| 支付、营销和配送 | 需核对所选版本、插件、商户账户与渠道配置 | 实际三方交易、活动与配送按项目待验收 |
从选型到开店
- 写下要解决的经营问题、目标入口、关键流程和上线后维护人。
- 从合法来源获取源码,核对固定版本、Commit、许可证及第三方材料。第 2 课
- 准备 PHP、Web 服务、MySQL、缓存和独立空库,完成安装与初始化。第 3 课
- 在测试环境用合成数据配置商品、权限和业务数据。按需求准备域名、HTTPS、支付、短信或对象存储,在发布前验证成功与异常流程。
- 生产使用独立身份、数据库和凭据,确认上线窗口、备份恢复、回滚和日常维护责任。
有稳定接单业务、需要独立商城、能安排 PHP 与部署维护且版本满足关键需求时,适合先验证。仅展示商品可先评估展示页。核心业务差异大、关键能力缺失或暂无维护预算时,先比较替代方案。
商家和创业者可从选型、部署开始,个人开发者和工作室可从源码和二开发起,小型软件公司和企业团队可按验收清单选择专项交付或外部支持。CRMEB 上游维护官方产品,白泽维护自身下游改动并提供约定范围内的技术服务。白泽服务目录
打开真实项目
讲解基线为 BaizeCRMEB 的 CRMEB-KY v8.0.0,提交 8ccf4130c7bdc56087a2b20c6f070756a22416c8。官方 v8.0.0 和这份基线有共同祖先,白泽的开发环境与安装整改属于下游修改。仅跟读公开代码的同学可以照 第 2 课 获取官方版本。
在仓库根目录运行本课实际执行过的 Git 命令:
git rev-parse HEAD
git ls-tree --name-only HEAD
git ls-tree --name-only HEAD:frontend
git ls-files -- backend/composer.json frontend/admin/package.json frontend/uni-app/package.json backend/public/install/index.php
首次打开时,根目录先找 backend/、frontend/、help/,再读 AGENTS.md。前端目录下可找到 admin 和 uni-app。查看依赖文件时,以当前 Commit 中的实际版本范围为准。
| 位置 | 读什么 |
|---|---|
backend/composer.json | PHP 约束为 8.2 到 8.4,ThinkPHP 依赖为 topthink/framework ^8.0 |
backend/app/adminapi/route/ | 管理后台 API 路由,例如后台商品接口 |
backend/app/api/route/v1.php | 移动商城使用的 API,包含首页和商品列表 |
frontend/admin/package.json | 管理后台使用 Vue 3,后台页面从 frontend/admin/src/ 查找 |
frontend/uni-app/package.json | 移动端使用 uni-app 和 Vue,可按目标平台构建 |
backend/public/install/index.php | 普通网页安装向导入口 |
用商品列表理解架构
移动 H5 发起 GET /api/products。在固定源码的 backend/app/api/route/v1.php 中查找 Route::get('products',可定位到 CenterProductController::productList。管理员查看商品列表时走另一套后台 API,可从 backend/app/adminapi/route/center.php 查找。
Nginx 提供站点入口并转发 PHP 请求。ThinkPHP 将请求送到业务控制器,后续再沿着 Service 和 DAO 追数据。MySQL 保存商品、订单和用户等结构化数据。Redis 可以承担所选环境的缓存职责,安装时也可选择文件缓存。学习架构时先确认实际请求和路由,再向下定位类和表,避免按目录名猜业务逻辑。
git grep -n -F "Route::get('products'" HEAD -- backend/app/api/route/v1.php
演示中,移动首页和商品列表 API 分别以 HTTP 200、业务状态 200 返回。空白测试商城的列表数据可能为空,状态码与返回数据应同时检查。
操作实录

本课新建文件缓存实验环境,从普通网页走完安装,MySQL 保持默认严格模式。管理员实际登录,移动首页也完成浏览器检查。同一提交的前期安装验证另覆盖了 Redis 缓存。后台首页用户统计曾报 MySQL 1055,因此登录成功只能证明登录和相关检查通过,首页统计须单独验证。

给 AI 的源码核对任务
下列提示词可在 Codex 或 WorkBuddy 的独立教学工作区使用。本课提供提示词和已核对的源码依据。
只读当前 CRMEB 工作区。先运行 git rev-parse HEAD,并阅读 AGENTS.md
及其指向的项目规范。列出 PHP/ThinkPHP 后端、Vue 管理后台和 uni-app
移动端的真实路径与依赖证据。定位前台商品列表实际路由和控制器方法。
每项给出文件路径和核对命令,找不到就说明。不要编辑文件,也不要读取
.env、密钥、数据库配置或客户数据。
人工核对提交哈希、依赖文件与公开 API 路由。AI 的表述与源码不一致时,以该提交的源码和实测为准。
常见问题
- 官网仓库和演示仓库的文件怎么不完全一样? 官网链接指向 CRMEB 官方上游。演示使用基于官方版本的 BaizeCRMEB,下游增量要单独核对。
- 只会用浏览器,必须先学 PHP 吗? 先能认出后台页面、移动页面和 API 即可。读控制器和改代码放在后续课程。
- 能直接拿公司的数据库跟做吗? 安装与练习使用独立空库,采用合成账号和数据。
本课作业
记录源码来源、版本和 Commit。分别找到后端、后台、移动端三个依赖文件。提交一份不含凭据的目录清单,并用源码解释前台商品列表从哪个路由进入。
视频与配套资料
本课录播待录制。配套入口为 CRMEB 官方仓库 和本页的核对命令。
下一课实际克隆官方仓库,核对许可证、标签和下游差异。进入第 2 课