fastadmin_tailored

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

# 订单数据
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_profile;
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;
truncate fa_shop_user_share;
truncate fa_shop_user_wallet_log;
truncate fa_shop_user_browse;
truncate fa_shop_third_oauth;
truncate fa_body_profile;
truncate fa_body_measurements;
truncate fa_body_type_selection;

# 分销相关
truncate  fa_shop_commission_agent;
truncate  fa_shop_commission_apply;
truncate  fa_shop_commission_goods;
truncate  fa_shop_commission_log;
truncate  fa_shop_commission_log;
truncate  fa_shop_commission_order;
truncate  fa_shop_commission_reward;
truncate  fa_shop_withdraw;
truncate  fa_shop_withdraw_log;
truncate  fa_shop_user_account;
# 显示折扣相关
truncate  shop_activity;
truncate  shop_activity_sku;
# 消费抽奖相关
truncate  shop_lottery_activity;
truncate  shop_lottery_condition;
truncate  shop_lottery_draw_record;
truncate  shop_lottery_prize;
truncate  shop_lottery_statistics;
truncate  shop_lottery_user_chance;
truncate  shop_lottery_user_chance_record;
truncate  shop_lottery_win_record;
# 意见反馈
truncate  shop_feedback;

### 队列说明

### 定时任务说明

商品定时上下架

折扣活动 下架更改状态

抽奖活动时间下架更改状态