跳到正文
白泽软件开发

第1课:认识 CRMEB 开源商城与项目架构

第 01 篇 CRMEB开源商城AI辅助开发实战 CRMEBThinkPHP

大鹏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隔离环境已验证首页、分类、商品列表
微信小程序入口需目标构建、平台主体、域名和审核独立审计已构建,真机和发布待验证
支付、营销和配送需核对所选版本、插件、商户账户与渠道配置实际三方交易、活动与配送按项目待验收

从选型到开店

  1. 写下要解决的经营问题、目标入口、关键流程和上线后维护人。
  2. 从合法来源获取源码,核对固定版本、Commit、许可证及第三方材料。第 2 课
  3. 准备 PHP、Web 服务、MySQL、缓存和独立空库,完成安装与初始化。第 3 课
  4. 在测试环境用合成数据配置商品、权限和业务数据。按需求准备域名、HTTPS、支付、短信或对象存储,在发布前验证成功与异常流程。
  5. 生产使用独立身份、数据库和凭据,确认上线窗口、备份恢复、回滚和日常维护责任。

有稳定接单业务、需要独立商城、能安排 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.jsonPHP 约束为 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 返回。空白测试商城的列表数据可能为空,状态码与返回数据应同时检查。

操作实录

隔离测试环境中 CRMEB 网页安装向导的真实完成页

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

同一隔离课堂商城在移动浏览器中的真实 H5 首页

给 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 课

免费咨询 收起

想聊聊?选个顺手的方式

工作日会回复,原型范围与启动条件确认后,3 个工作日内提供核心流程原型。

加微信(个人好友)

微信号 yggaibc,长按也可复制。

拨打电话18010070052 打开微信需已安装微信

「打开微信」取决于系统是否支持 weixin://,不生效请用上方「复制微信号」。

在线填需求 →
案例可查:看项目案例 →

公众号「AI程序员张总」可看技术复盘。

更多方式:微信好友码 / 飞书 / QQ / 公众号 →

QQ 1156956636(长按复制)。二维码都在需求页「扫码联系」里。