Yuhang Wu
|
c9d85b0815
|
feat(module/seckill): 限时抢购 Redis Lua 防超卖 + 一人一单兜底
- 实体 SeckillActivity、SeckillProduct、SeckillOrder
- 枚举：SeckillActivityStatusEnum（含 calcStatus 时间驱动动态状态）、SeckillResultEnum
- RedisKey 追加 4 个抢购相关 key：SECKILL_STOCK / SECKILL_USER_RECORD / SECKILL_RESULT / SECKILL_WARMUP
- Mapper：decrRemainStock / incrRemainStock（MySQL 兜底）、forceEnd、markAsPaid
- resources/lua/seckill.lua：原子完成"限购校验 + 库存校验 + 扣库存 + 累计已购"
- Service：seckillBuy（核心：Lua 防超卖 → 落库 → 唯一索引兜底 → 落库失败回滚 Redis）
- Service：queryResult（轮询接口，从 Redis 取抢购结果）
- Service：warmupActivity（管理端预热，把库存同步到 Redis）
- Service：forceEnd / deleteActivity（清理 Redis）
- DTO：SeckillBuyReq、SeckillActivitySaveReq、SeckillProductAddReq
- VO：SeckillActivityVO（含动态状态 + 倒计时秒数）、SeckillProductVO（含实时 Redis 库存 + 已售百分比 + 折扣率）、SeckillResultVO
- Controller：用户端（活动列表/详情/抢购/结果查询）+ 管理端（活动 CRUD + 预热 + 强制结束 + 商品管理）
- 一人一单：seckill_order UNIQUE KEY (user_id, activity_id, sku_id) 兜底
- 抢购失败回滚：MySQL 落库异常时 INCRBY Redis 释放库存
feat(common/storage): 文件存储抽象接口 + Local / S3 双实现
- 抽象接口 FileStorage：store / delete / getAccessUrl / parsePathFromUrl
- LocalFileStorage：本地 ./uploads/ 物理存储（默认）
- S3FileStorage：S3 协议实现（RustFS / MinIO / AWS S3 / 阿里云 OSS）
- S3StorageProperties：snack.s3.* 配置类
- @ConditionalOnProperty 自动按 snack.storage.type 切换
- 启动时自动 ensureBucket（headBucket + createBucket）
- DisposableBean 容器关闭时关闭 S3Client 连接池
文件模块：
- 实体 UploadFile（含 storageType / bizType 区分）
- 枚举：FileBizTypeEnum（avatar/admin-avatar/product/sku/category/banner/notice/chat/common）
- Service：upload / uploadWithUploader / deleteFile / deleteByPath
- FileController：/api/file/upload + /api/file/{id}
- 图片类型自动校验（jpg/png/gif/webp）
- URL → path 反查（删除商品时根据 main_image 字段自动清理物理文件）
- application.yml：snack.storage.type / snack.upload.* / snack.s3.* 配置
管理端：
- AdminAvatarController /api/admin/avatar/upload
- CategoryAdminController 加 /api/admin/category/{id}/icon
- 删除分类时同步清理 icon 物理文件
|
2026-06-05 11:11:19 +08:00 |
sparksfly