# Active eCommerce CMS - 电子商务内容管理系统
## 项目概述
- **项目类型**：Web应用 - 多商户电商平台/CMS系统
- **主要功能**：完整的电商解决方案，支持多商户、多语言、多货币、多种支付方式、拍卖系统、联盟营销
- **技术栈**：
- 后端：PHP 8.2+, Laravel 10, MySQL
- 前端：Blade + Vue.js + Bootstrap
- 其他：Redis, Pusher, Flutter API, 多种支付网关
## 模块结构
```
app/
├── Console/
│ └── Kernel.php # 调度任务
├── Contracts/
│ └── SendSms.php # 短信接口
├── Enums/
│ └── NoteType.php # 枚举类
├── Exceptions/
│ ├── Handler.php
│ └── Redirectingexception.php
├── Http/
│ ├── Controllers/
│ │ ├── Admin/ # 管理员控制器
│ │ ├── Api/ # API控制器（Flutter App）
│ │ ├── Auth/ # 认证控制器
│ │ ├── Payment/ # 支付控制器
│ │ ├── Seller/ # 卖家控制器
│ │ └── ... # 其他控制器
│ ├── Middleware/ # 中间件
│ ├── Requests/ # 表单请求
│ ├── Resources/ # API资源
│ ├── Services/ # 服务层
│ └── ViewComposers/ # 视图Composer
├── Mail/ # 邮件类
├── Models/ # 数据模型
├── Notifications/ # 通知类
├── Providers/ # 服务提供者
├── Rules/ # 验证规则
├── Services/ # 业务服务
└── Traits/ # Trait类
```
## 核心业务逻辑
### 1. 多商户电商系统
**买家流程：**
```
浏览商品 → 加入购物车 → 结算 → 选择配送 → 支付 → 订单确认 → 物流追踪 → 确认收货 → 评价
```
**卖家流程：**
```
注册 → 店铺设置 → 商品上架 → 订单管理 → 发货处理 → 售后管理 → 资金提现
```
**主要功能：**
- 多商户入驻
- 店铺管理
- 商品管理（支持多规格、多属性）
- 库存管理
- 订单管理
- 物流追踪
- 评价系统
- 退款/退货处理
### 2. 拍卖系统
- 商品拍卖发布
- 出价竞拍
- 自动出价
- 拍卖倒计时
- 成交处理
### 3. 联盟营销系统
```
推广者注册 → 获取推广链接 → 分享推广 → 用户购买 → 佣金计算 → 佣金提现
```
**主要功能：**
- 推广链接生成
- 佣金比例设置
- 佣金统计
- 推广效果追踪
- 佣金提现
### 4. 会员积分系统
- 购物积分
- 积分兑换
- 会员等级
- 积分商城
### 5. 营销工具
- 优惠券系统
- 满减活动
- 限时折扣
- 闪购活动
- 组合购买
### 6. 支付系统
支持多种支付方式：
- Stripe
- PayPal
- Razorpay
- PayTM
- Paystack
- Instamojo
- Iyzico
- Authorize.net
- MyFatoorah
- MercadoPago
- 银行转账
- 货到付款
### 7. 配送系统
- 多种配送方式
- 运费模板
- 配送范围设置
- 物流追踪集成
- 自提点管理
## 核心代码分析
### 关键模型关系
```php
// 用户模型关系
User -> Shop (店铺)
User -> Order (订单)
User -> Cart (购物车)
User -> Wishlist (收藏)
User -> Review (评价)
User -> AffiliateUser (联盟用户)
// 商品模型关系
Product -> Category (分类)
Product -> Brand (品牌)
Product -> Shop (店铺)
Product -> ProductStock (库存)
Product -> ProductTranslation (多语言)
Product -> Review (评价)
// 订单模型关系
Order -> OrderDetail (订单详情)
Order -> Payment (支付记录)
Order -> DeliveryStatus (配送状态)
Order -> User (买家)
```
### API架构
系统提供完整的 RESTful API 供 Flutter App 使用：
```
app/Http/Controllers/Api/
├── AuthController.php # 认证API
├── CartController.php # 购物车API
├── CategoryController.php # 分类API
├── CouponController.php # 优惠券API
├── HomeController.php # 首页API
├── OrderController.php # 订单API
├── ProductController.php # 商品API
├── SearchController.php # 搜索API
├── ShopController.php # 店铺API
├── UserController.php # 用户API
└── ...
```
### 多语言实现
```
resources/lang/
├── en/ # 英语
├── ar/ # 阿拉伯语
├── bn/ # 孟加拉语
├── hi/ # 印地语
└── ... # 其他语言
```
数据库表使用翻译表模式：
- `products` - 主表
- `product_translations` - 翻译表
### 多货币支持
- 货币管理后台
- 实时汇率转换
- 自动汇率更新
- 多货币显示
### 文件上传系统
使用自定义上传组件 `AizUploadController`：
- 图片上传
- 文件管理
- 图片压缩
- 云存储支持（AWS S3）
... (content truncated)
