# 电商库存秒杀-分布式

**Repository Path**: winterr11/E-commerceSystem

## Basic Information

- **Project Name**: 电商库存秒杀-分布式
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-08
- **Last Updated**: 2026-03-08

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 电商库存秒杀-分布式

#### 系统设计文档

#### 软件架构
软件架构草图如下
![输入图片说明](%E7%9B%B8%E5%85%B3%E8%AE%BE%E8%AE%A1%E6%96%87%E6%A1%A3/%E6%9E%B6%E6%9E%84%E8%8D%89%E5%9B%BE.png)

#### 软件架构说明

1.API网关统一入口，处理路由、限流、认证等通用逻辑

2.Redis用于秒杀场景的缓存、分布式锁、库存预热

3.消息队列处理异步下单和库存补偿，避免同步阻塞


#### 各服务API接口定义
1.用户服务API
| 接口路径                | 请求方法 | 功能描述   | 请求参数                                                          | 响应示例                                                                                   |
|-------------------------|----------|------------|-------------------------------------------------------------------|--------------------------------------------------------------------------------------------|
| /api/users/register     | POST     | 用户注册   | {"username":"test","password":"123456","phone":"13800138000"}     | {"code":200,"msg":"注册成功","data":{"userId":1001}}                                       |
| /api/users/login        | POST     | 用户登录   | {"username":"test","password":"123456"}                           | {"code":200,"msg":"登录成功","data":{"token":"eyJhbGciOiJIUzI1NiJ9...","userId":1001}}       |
| /api/users/{userId}     | GET      | 获取用户信息 | 路径参数：userId                                                  | {"code":200,"msg":"成功","data":{"userId":1001,"username":"test","phone":"13800138000"}}   |

2.商品服务API
| 接口路径                              | 请求方法 | 功能描述     | 请求参数                    | 响应示例                                                                                                                               |
|---------------------------------------|----------|--------------|-----------------------------|----------------------------------------------------------------------------------------------------------------------------------------|
| /api/products                         | GET      | 查询商品列表 | 分页参数（pageNum, pageSize） | {"code":200,"msg":"成功","data":{"list":[{"productId":101,"name":"秒杀商品A","price":99.9,"stock":1000,"seckillStatus":1}],"total":1}}   |
| /api/products/{productId}             | GET      | 查询商品详情 | 路径参数：productId          | {"code":200,"msg":"成功","data":{"productId":101,"name":"秒杀商品A","price":99.9,"stock":1000,"seckillStartTime":"2026-03-08 10:00:00"}} |
| /api/products/seckill/{productId}     | GET      | 查询秒杀商品状态 | 路径参数：productId          | {"code":200,"msg":"成功","data":{"productId":101,"seckillStatus":1,"remainStock":980}}                                               |

3.库存服务API
| 接口路径                   | 请求方法 | 功能描述        | 请求参数                                        | 响应示例                                                                                    |
|----------------------------|----------|-----------------|-------------------------------------------------|---------------------------------------------------------------------------------------------|
| /api/stock/{productId}     | GET      | 查询商品库存    | 路径参数：productId                              | {"code":200,"msg":"成功","data":{"productId":101,"totalStock":1000,"availableStock":980}}   |
| /api/stock/lock            | POST     | 锁定库存（秒杀预扣减） | {"productId":101,"userId":1001,"lockNum":1}     | {"code":200,"msg":"库存锁定成功","data":{"lockId":"lock_101_1001"}}                           |
| /api/stock/deduct          | POST     | 扣减库存（订单确认）  | {"productId":101,"lockId":"lock_101_1001"}      | {"code":200,"msg":"库存扣减成功","data":{"remainStock":979}}                                  |
| /api/stock/unlock          | POST     | 解锁库存（订单取消）  | {"lockId":"lock_101_1001"}                      | {"code":200,"msg":"库存解锁成功","data":{"availableStock":980}}                               |

4.订单服务API
| 接口路径                         | 请求方法 | 功能描述       | 请求参数                                                     | 响应示例                                                                                                                                        |
|----------------------------------|----------|----------------|--------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------|
| /api/orders                      | POST     | 创建订单（秒杀下单） | {"productId":101,"userId":1001,"lockId":"lock_101_1001"}     | {"code":200,"msg":"订单创建成功","data":{"orderId":"ORD202603081001001"}}                                                                       |
| /api/orders/{orderId}            | GET      | 查询订单详情   | 路径参数：orderId                                             | {"code":200,"msg":"成功","data":{"orderId":"ORD202603081001001","productId":101,"userId":1001,"status":1,"createTime":"2026-03-08 10:01:00"}} |
| /api/orders/{orderId}/cancel     | POST     | 取消订单       | 路径参数：orderId                                             | {"code":200,"msg":"订单取消成功","data":{"orderId":"ORD202603081001001","status":0}}                                                          |

#### 数据库ER图
![输入图片说明](%E7%9B%B8%E5%85%B3%E8%AE%BE%E8%AE%A1%E6%96%87%E6%A1%A3/%E6%95%B0%E6%8D%AE%E5%BA%93ER%E5%9B%BE.png)

#### 技术栈选型说明
| 类型        | 选型                     |
|-------------|--------------------------|
| 编程语言    | Java 21                  |
| 核心框架    | Spring Boot 3.x          |
| 持久层框架  | MyBatis + MyBatis-Plus   |
| 数据库      | MySQL 9.0                |
| 缓存 / 分布式锁 | Redis 5.x            |
| 消息队列    | RabbitMQ                 |
| API 网关    | Spring Cloud Gateway     |
| 安全认证    | Spring Security + JWT    |
| 版本控制    | Git                      |