项目介绍

MineShop 是一套基于 Hyperf 3 + Vue 3 的企业级电商系统，采用 DDD（领域驱动设计） 架构，专为高并发、高性能场景设计。

🎯 项目定位

MineShop 定位为中大型电商平台的技术基座，适用于：

• 🛒 B2C 电商平台
• 🏪 多商户商城
• 🎁 营销活动系统（秒杀、团购、优惠券）
• 👥 会员运营系统
• 📊 数据分析平台

✨ 核心特性

高性能架构

┌─────────────────────────────────────────────────────────┐
│                    Swoole 协程引擎                        │
├─────────────────────────────────────────────────────────┤
│  Hyperf 3.1  │  协程 HTTP  │  协程 MySQL  │  协程 Redis  │
├─────────────────────────────────────────────────────────┤
│              Redis + Lua 原子操作                         │
│              • 库存扣减    • 分布式锁    • 限流           │
└─────────────────────────────────────────────────────────┘

• Swoole 5.0+ 协程引擎，充分利用多核 CPU
• Redis + Lua 原子操作，保证高并发下数据一致性
• 缓存预热 机制，热点数据提前加载到内存

DDD 分层架构

┌─────────────────────────────────────────────────────────┐
│                   Interface 接口层                        │
│            Controller / Request / Response               │
├─────────────────────────────────────────────────────────┤
│                  Application 应用层                       │
│         CommandService / QueryService / DTO              │
├─────────────────────────────────────────────────────────┤
│                    Domain 领域层                          │
│      Entity / ValueObject / Service / Repository         │
├─────────────────────────────────────────────────────────┤
│                Infrastructure 基础设施层                   │
│           Model / Cache / Queue / External API           │
└─────────────────────────────────────────────────────────┘

插件化设计

// 插件配置示例 plugin.json
{
    "name": "since/export-center",
    "version": "1.0.0",
    "description": "导出中心插件",
    "namespace": "Plugin\\ExportCenter",
    "configProvider": "Plugin\\ExportCenter\\ConfigProvider"
}

📦 功能模块

商品中心

• 品牌管理、分类管理
• 多规格 SKU 组合
• 库存预警机制
• 商品上下架流程

订单系统

• 异步下单（同步校验 + 异步入库）
• 订单状态机流转
• 多种订单类型（普通/秒杀/团购）
• 售后退款处理

营销活动

• 秒杀系统：活动 → 场次 → 商品三级管理
• 团购系统：开团、参团、成团自动处理
• 优惠券：满减、折扣、限时限量

会员系统

• 会员等级与成长值
• 积分体系
• 会员钱包
• 标签管理

基础设施

• 消息系统（多渠道推送）
• 导出中心（异步大数据导出）
• 系统配置（商城参数管理）
• 地址库（四级联动）

🏗️ 目录结构

mine-shop/
├── app/
│   ├── Interface/           # 接口层
│   │   ├── Admin/          # 后台管理接口
│   │   └── Api/            # 前端 API 接口
│   ├── Application/         # 应用层
│   │   ├── Admin/          # 后台应用服务
│   │   └── Api/            # 前端应用服务
│   ├── Domain/              # 领域层
│   │   ├── Trade/          # 交易域
│   │   ├── Member/         # 会员域
│   │   ├── Catalog/        # 商品域
│   │   └── Permission/     # 权限域
│   └── Infrastructure/      # 基础设施层
│       ├── Model/          # 数据模型
│       ├── Crontab/        # 定时任务
│       ├── Command/        # 命令行
│       └── Library/        # 工具库
├── plugins/                 # 插件目录
│   ├── export-center/      # 导出中心插件
│   └── wechat/             # 微信插件
├── config/                  # 配置文件
├── web/                     # 前端项目
└── databases/               # 数据库迁移

🔧 技术要求

组件	最低版本	推荐版本
PHP	8.1	8.2+
Swoole	5.0	5.1+
MySQL	5.7	8.0+
Redis	4.0	6.0+
Node.js	16	18+

📚 相关链接

• Hyperf 官方文档
• Swoole 官方文档
• MineAdmin 官网

下一步

• 环境要求 - 详细的环境配置说明
• 安装部署 - 完整的安装步骤
• 配置说明 - 系统配置详解