# 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. 验货系统

#### 验货流程
1. **验货申请**: 用户提交验货申请
2. **任务分配**: 系统自动分配验货员
3. **验货执行**: 验货员进行商品检验
4. **结果上传**: 上传验货照片和结果
5. **结果确认**: 用户确认验货结果

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

### 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

### 部署方式
1. **传统部署**: LAMP/LNMP环境
2. **Docker部署**: 容器化部署
3. **云服务部署**: 阿里云、腾讯云等

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

## 安全机制

### 数据安全
- SQL注入防护
- XSS攻击防护
- CSRF防护
- 数据加密存储

### 访问控制
- Token认证
- 权限验证
- 接口限流
- IP白名单

## 扩展开发

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

### 二次开发
- 模块化架构
- 标准化接口
- 丰富的Hook机制
- 完善的文档支持

## 维护与监控

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

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

## 清空数据SQL

```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;

 ```