🍵 茶叶时刻（Chayeshike）· 管理后台系统
ThinkPHP 6.0 全栈管理后台 —— 为「茶叶时刻」微信小程序提供完整的企业级运营管理能力。
一、系统概述
| 项目 |
说明 |
| 项目定位 |
面向微信小程序运营者的 SPA 管理控制台，前后端分离 |
| 前端技术 |
HTML5 / CSS3 / JS(ES6) / Fetch |
| 后端技术 |
ThinkPHP 6 / PHP 7.2+7.4+8.0 / ORM 2.0 |
| 数据库 |
MySQL 5.6+ / InnoDB / utf8mb4 |
核心能力矩阵
| 领域 |
模块 |
功能描述 |
| 商城运营 |
产品管理 |
CRUD、规格、上下架、推荐/热销 |
|
分类管理 |
分类树、排序、启用/禁用 |
|
订单管理 |
CRUD、状态流转、发货、取消、搜索、日期查询、分页 |
|
积分管理 |
积分商品、兑换审核 |
| 内容管理 |
知识管理 |
茶文化文章、富文本 |
|
广场管理 |
帖子审核、显示/隐藏、置顶 |
|
茶叶种草 |
种草内容管理、审核 |
|
轮播图管理 |
首页轮播图 CRUD、排序 |
| 用户服务 |
用户管理 |
查询、禁用、积分调整 |
|
咨询管理 |
客户咨询回复 |
|
防伪管理 |
防伪码生成、验证记录 |
| 系统 |
系统配置 |
微信/公众号/支付配置 |
|
进销存 |
库存、采购单、销售单 |
|
仪表盘 |
销售额、订单量、用户数 |
二、系统架构
前端层 后端层 数据层
HTML5 / CSS3 / JS → ThinkPHP 6 / PHP → MySQL
Fetch API ORM / Middleware InnoDB
目录结构
| 目录 |
说明 |
| app/controller/admin |
管理后台 API 控制器（约 70 条路由） |
| app/model |
30+ 数据模型 |
| app/middleware |
AdminAuthMiddleware 鉴权 |
| public/admin |
SPA 页面（dashboard.html / app.js / style.css） |
| route/admin.php |
管理后台路由 |
| chayeshike.sql |
数据库结构与初始数据 |
三、安装部署
| 环境 |
要求 |
| PHP |
≥ 7.2.5（推荐 7.4 / 8.0） |
| MySQL |
≥ 5.6（推荐 5.7 / 8.0） |
| Nginx / Apache |
支持 URL 重写 |
| Composer |
≥ 1.10 |
快速部署
git clone <repo> chayeshike-admin
cd chayeshike-admin
composer install --no-dev
cp .example.env .env
mysql -u root -p chayeshike < chayeshike.sql
php think admin:reset-password
php think run
四、功能模块开发文档
| 模块 |
说明 |
| 前端架构 |
SPA、模块路由、API 调用规范 |
| 后端架构 |
控制器基类、路由规范、模型设计 |
| 订单管理 |
列表优化（批量加载）、CRUD、发货、取消 |
五、核心数据表
| 表名 |
说明 |
| cs_admin |
管理员 |
| cs_user |
微信用户 |
| cs_product |
产品 |
| cs_category |
分类 |
| cs_order |
订单 |
| cs_order_item |
订单商品 |
| cs_admin_token |
管理员 Token |
六、API 参考
| 方法 |
路径 |
说明 |
| GET |
/admin/orders |
订单列表 |
| POST |
/admin/orders |
新增订单 |
| PUT |
/admin/orders/:id |
编辑订单 |
| DELETE |
/admin/orders/:id |
删除订单 |
| POST |
/admin/orders/ship |
发货 |
| POST |
/admin/orders/cancel |
取消订单 |
七、开发规范
| 类型 |
规范 |
| PHP 命名 |
PSR‑4，大驼峰类名 |
| JS 命名 |
小驼峰函数名 |
| 数据库 |
下划线命名，cs_ 前缀 |
| Git |
feat / fix / refactor / docs |
八、常见问题
| 问题 |
排查方式 |
| 白屏 |
检查 Nginx 重写、PHP 日志、Console |
| 加载中卡死 |
检查 API 超时、SQL 异常 |
| 未登录 |
检查 Token、localStorage、有效期 |
| 数据库失败 |
检查 .env、HOSTNAME 使用 127.0.0.1 |
小程序前端演示：
