# Martfury - Multipurpose Laravel Ecommerce System
## 项目概述
- **项目类型**：Laravel多用途电商CMS系统
- **主要功能**：多供应商电商平台，支持B2B、B2C、C2C多种商业模式，包含完整的前端商城、卖家中心、管理后台
- **技术栈**：PHP 8.2/8.3、Laravel 12.44、MySQL、Vue.js、Bootstrap、Redis、Elasticsearch
## 模块结构
```
├── app/ # 应用核心代码
│ ├── Http/
│ │ └── Controllers/ # 控制器
│ ├── Models/
│ │ └── User.php # 用户模型
│ └── Providers/ # 服务提供者
├── bootstrap/ # 启动目录
├── config/ # 配置文件
│ ├── app.php
│ ├── auth.php
│ ├── database.php
│ └── ...
├── database/
│ ├── factories/ # 模型工厂
│ ├── migrations/ # 数据库迁移
│ └── seeders/ # 数据填充
│ ├── AdsSeeder.php
│ ├── BlogSeeder.php
│ ├── BrandSeeder.php
│ ├── CustomerSeeder.php
│ ├── ProductCategorySeeder.php
│ └── ...
├── lang/ # 语言文件
├── platform/ # Botble平台核心
│ ├── core/ # 核心系统
│ ├── packages/ # 扩展包
│ ├── plugins/ # 插件目录
│ │ ├── ads/ # 广告插件
│ │ ├── blog/ # 博客插件
│ │ ├── ecommerce/ # 电商插件
│ │ ├── marketplace/ # 多供应商市场插件
│ │ └── ...
│ └── themes/ # 主题目录
├── public/ # 公共资源
│ ├── storage/ # 上传文件存储
│ ├── themes/ # 主题资源
│ └── index.php # 入口文件
├── resources/
│ └── views/ # 视图文件
├── routes/
│ └── web.php # 路由配置
├── storage/ # 存储目录
├── tests/ # 测试文件
├── composer.json # Composer依赖
├── package.json # NPM依赖
└── artisan # Artisan命令
```
## 核心业务逻辑
### 1. 多供应商电商模式 (Multi-Vendor Marketplace)
#### 平台角色
1. **平台管理员 (Admin)**
- 系统配置管理
- 供应商审核
- 佣金设置
- 订单监控
- 平台数据统计
2. **供应商/卖家 (Vendor)**
- 店铺管理
- 商品发布
- 订单处理
- 库存管理
- 收入提现
3. **买家 (Customer)**
- 浏览商品
- 购物车
- 下单支付
- 订单跟踪
- 评价反馈
#### 店铺管理
- **店铺装修**：可视化店铺装修工具
- **店铺信息**：Logo、描述、联系方式
- **店铺分类**：自定义商品分类
- **店铺统计**：访问量、销售额、转化率
### 2. 商品管理系统
#### 商品类型
- **简单商品**：单一规格商品
- **可变商品**：多规格（颜色、尺寸等）
- **虚拟商品**：数字下载产品
- **团购商品**：拼团活动商品
- **预售商品**：预售模式商品
#### 商品属性
- 基本信息：名称、描述、图片
- 价格设置：原价、售价、会员价
- 库存管理：SKU管理、库存预警
- 物流设置：重量、尺寸、运费模板
- SEO优化：标题、关键词、描述
### 3. 订单管理系统
#### 订单流程
```
下单 → 支付 → 确认 → 发货 → 收货 → 评价
↓ ↓ ↓ ↓
待付款 待发货 待收货 已完成
↓ ↓ ↓
已取消 已退款 退货中
```
#### 订单功能
- **订单拆分**：多供应商订单自动拆分
- **物流跟踪**：集成物流查询API
- **退款退货**：完整售后流程
- **发票管理**：电子发票开具
### 4. 营销系统
#### 促销活动
- **限时折扣**：倒计时促销
- **满减优惠**：满额立减
- **优惠券**：代金券系统
- **积分系统**：购物积分奖励
- **会员等级**：VIP等级权益
- **秒杀活动**：限时秒杀
- **团购拼团**：社交裂变营销
#### 广告系统
- 轮播广告
- 分类广告
- 推荐位管理
- 弹窗广告
### 5. 支付系统
#### 支付方式
- **在线支付**：
- 支付宝
- 微信支付
- PayPal
- Stripe
- **货到付款**：COD支付
- **银行转账**：线下转账
- **钱包支付**：余额支付
#### 分账系统
- 订单金额自动分账
- 平台佣金自动扣除
- 供应商收入结算
- 提现申请处理
### 6. 内容管理系统 (CMS)
#### 博客系统
- 文章发布
- 分类管理
- 标签系统
- 评论管理
#### 页面管理
- 自定义页面
- 页面模板
- 短代码支持
## 核心代码分析
### 技术架构
#### Botble CMS平台
Martfury基于Botble CMS构建，采用模块化架构：
```
platform/
├── core/ # 核心平台
├── plugins/ # 功能插件
│ ├── ecommerce/ # 电商核心
│ ├── marketplace/ # 多供应商
│ ├── ads/ # 广告系统
│ ├── blog/ # 博客系统
│ ├── contact/ # 联系表单
│ ├── newsletter/ # 邮件订阅
│ └── ...
└── themes/ # 前端主题
├── martfury/ # Martfury主题
└── ...
```
#### 依赖分析 (composer.json)
```json
{
"require": {
"php": "^8.2|^8.3",
... (content truncated)
