FastAdmin 定制版架构功能文档

项目概述

FastAdmin定制版是一款基于ThinkPHP 5.1 + Bootstrap的快速后台开发框架，专门针对电商业务场景进行了深度定制和扩展。该系统集成了完整的商城功能、验货系统、用户管理、订单处理等核心业务模块。

技术架构

核心技术栈

后端框架: ThinkPHP 5.1
前端框架: Bootstrap + jQuery
数据库: MySQL
PHP版本: >= 7.4.0
包管理: Composer

主要依赖包

topthink/framework: ThinkPHP核心框架
topthink/think-queue: 队列处理
overtrue/wechat: 微信SDK
yansongda/pay: 支付SDK
phpoffice/phpspreadsheet: Excel处理
fastadminnet/fastadmin-addons: 插件系统

系统架构

目录结构

模块架构

1. 管理后台模块 (admin)

用户管理: 管理员账户、权限控制、角色分配
商城管理: 商品、订单、库存、促销活动
验货管理: 验货任务、验货结果、质检流程
系统配置: 基础设置、支付配置、物流配置
数据统计: 订单统计、销售报表、用户分析

2. API接口模块 (api)

用户接口: 注册登录、个人信息、地址管理
商城接口: 商品展示、购物车、下单支付
验货接口: 验货申请、任务查询、结果上传
订单接口: 订单查询、物流跟踪、售后服务

3. 公共模块 (common)

枚举类: 订单状态、支付方式、商品状态等
服务类: 订单服务、支付服务、物流服务
模型类: 数据模型定义和业务逻辑
工具类: 通用工具函数和辅助类

核心功能模块

1. 商城系统

商品管理

商品分类管理
商品信息维护
SKU规格管理
库存管理
价格管理

订单系统

订单流程: 下单 → 支付 → 发货 → 验货 → 完成
订单状态: 待支付、已支付、已发货、验货中、已完成、已取消
订单类型: 普通订单、预售订单、团购订单
支付方式: 微信支付、支付宝、余额支付

售后服务

退货申请
退款处理
换货服务
售后跟踪

2. 验货系统

验货流程

验货申请: 用户提交验货申请
任务分配: 系统自动分配验货员
验货执行: 验货员进行商品检验
结果上传: 上传验货照片和结果
结果确认: 用户确认验货结果

验货功能

验货任务管理
验货结果记录
验货照片上传
验货报告生成
验货统计分析

3. 用户系统

用户管理

用户注册登录
个人信息管理
收货地址管理
积分系统
优惠券系统

权限系统

基于RBAC的权限控制
角色管理
菜单权限
操作权限
数据权限

4. 身体类型配置模块

功能特性

身体类型分类管理
按性别分类配置
支持导入导出
排序功能
多语言支持

应用场景

服装尺码推荐
个性化商品推荐
用户体型分析

插件系统

已集成插件

1. 管理增强插件

adminlogin: 管理员登录增强
command: 命令行工具
crontab: 定时任务管理
version: 版本管理

2. 云服务插件

alioss: 阿里云OSS存储
alisms: 阿里云短信服务
qcloudsms: 腾讯云短信服务

3. 功能增强插件

apilog: API日志记录
betterform: 表单增强
cropper: 图片裁剪
nkeditor: 富文本编辑器
previewfile: 文件预览
signin: 签到功能
sythumb: 缩略图生成
third: 第三方登录

数据库设计

核心数据表

用户相关

fa_user: 用户基础信息
fa_user_group: 用户组
fa_user_money_log: 资金变动日志
fa_user_score_log: 积分变动日志

商城相关

fa_shop_order: 订单主表
fa_shop_order_goods: 订单商品表
fa_shop_order_action: 订单操作记录
fa_shop_order_aftersales: 售后订单
fa_shop_order_express: 物流信息

验货相关

inspection_application: 验货申请
inspection_task: 验货任务
inspection_result: 验货结果
inspection_photo: 验货照片

系统相关

fa_admin: 管理员表
fa_auth_group: 权限组
fa_auth_rule: 权限规则
fa_config: 系统配置

API接口设计

接口规范

协议: HTTP/HTTPS
格式: JSON
认证: Token认证
版本: RESTful API

主要接口模块

1. 用户接口 (/api/user/)

用户注册登录
个人信息管理
地址管理
积分查询

2. 商城接口 (/api/shop/)

商品列表
商品详情
购物车操作
订单管理

3. 验货接口 (/api/inspection/)

验货申请
任务查询
结果上传
统计数据

4. 支付接口 (/api/pay/)

支付下单
支付回调
退款申请

部署架构

环境要求

PHP: >= 7.4.0
MySQL: >= 5.7
Web服务器: Nginx/Apache
扩展要求: json, curl, pdo, bcmath

部署方式

传统部署: LAMP/LNMP环境
Docker部署: 容器化部署
云服务部署: 阿里云、腾讯云等

性能优化

缓存策略: Redis缓存
数据库优化: 索引优化、读写分离
CDN加速: 静态资源CDN
队列处理: 异步任务处理

安全机制

数据安全

SQL注入防护
XSS攻击防护
CSRF防护
数据加密存储

访问控制

Token认证
权限验证
接口限流
IP白名单

扩展开发

插件开发

遵循FastAdmin插件规范
支持热插拔
独立配置管理
数据库迁移支持

二次开发

模块化架构
标准化接口
丰富的Hook机制
完善的文档支持

维护与监控

日志系统

系统日志
操作日志
错误日志
API访问日志

监控指标

系统性能监控
数据库性能监控
接口响应时间
错误率统计

清空数据SQL

# 订单数据
truncate fa_shop_order;
truncate fa_shop_order_goods;
truncate fa_shop_order_action;
truncate fa_shop_order_address;
truncate fa_shop_order_action;
truncate fa_shop_order_electronics;
truncate fa_shop_order_invoice;
truncate fa_shop_order_aftersales;
truncate fa_shop_order_express;
truncate fa_shop_order_express_log;
truncate fa_shop_order_express_log;
truncate fa_shop_comment;
# 支付数据
truncate fa_shop_pay;
# 验货端数据
truncate inspection_application;
truncate inspection_task;
truncate inspection_result;
truncate inspection_photo;
# 用户数据
truncate fa_user;
truncate fa_shop_user_address;
## 清空数据SQL

订单数据

truncate fa_shop_order; truncate fa_shop_order_goods; truncate fa_shop_order_action; truncate fa_shop_order_address; truncate fa_shop_order_action; truncate fa_shop_order_electronics; truncate fa_shop_order_invoice; truncate fa_shop_order_aftersales; truncate fa_shop_order_express; truncate fa_shop_order_express_log; truncate fa_shop_order_express_log; truncate fa_shop_comment;

支付数据

truncate fa_shop_pay;

验货端数据

truncate inspection_application; truncate inspection_task; truncate inspection_result; truncate inspection_photo;

用户数据

truncate fa_user; truncate fa_shop_user_address;

```

README.md 7.2 KB History Raw