# #3059 满额999坚戈加价购 KZT 999 cart promotion

来源：https://gitlab.parsec.com.cn/umay/doc-and-issues/-/issues/3059

读取时间：2026-10-01T14:06:53.854019+00:00；当前更新时间：2026-09-30T07:49:39.995Z。

> 当前内容快照，非历史版本。身份提及、电话示例和订单编号经最小化处理；不据此认定需求已实现。

## 当前描述

首页活动 banner：

[图片/视频引用：image](https://gitlab.parsec.com.cn/umay/doc-and-issues/uploads/32bb6749e191df86366392f71738b4d5/image.png)


活动商品弹窗：

[图片/视频引用：image](https://gitlab.parsec.com.cn/umay/doc-and-issues/uploads/7f39d5389d61d977af1fa98e58a7d4dd/image.png)


商品详情弹窗：

[图片/视频引用：image](https://gitlab.parsec.com.cn/umay/doc-and-issues/uploads/ef9255d30e814d6125b386275885907a/image.png)
[图片/视频引用：image](https://gitlab.parsec.com.cn/umay/doc-and-issues/uploads/cc084ef25ff276f1c6fe9c795c3a846e/image.png)


购物车（ 2 件已加购 + 1 件预加购）：

[图片/视频引用：image](https://gitlab.parsec.com.cn/umay/doc-and-issues/uploads/c8581a687be7d8b881cfee83ba9fde1c/image.png)


加购订单结算：

[图片/视频引用：image](https://gitlab.parsec.com.cn/umay/doc-and-issues/uploads/a843f1ea8643c7382b6504cd0fa928f0/image.png)

加购订单支付成功：

[图片/视频引用：image](https://gitlab.parsec.com.cn/umay/doc-and-issues/uploads/5efdf73067abcc9836d29b02555a7d2b/image.png)



Web/mobile 在线原型：https://umay-zero-markup.dinoks742.chatgpt.site/promos/?v=20

_Figma 设计图_ https://www.figma.com/design/fnM7J7kQqRoKCN0fhm8Fzx/icons?node-id=0-1&p=f&t=fbBxdh9j1V4XU8Fq-0

## 0\. 通用规则

**•** 活动时间和周限购统一以服务器时间为准，时区为 Asia/Almaty。

**•** 付款前重新校验价格、活动时间和库存；旧页面显示的数据不能保证最终价格。

**•** 同一 SKU 不能同时参加两个价格促销；订单赠品可与任何价格促销同时存在。

**•** 原型中的 SKU、品类、日期、折扣比例和优惠码均为示例，不视为正式确认。

**•** 如果第3、第4或第5项需要当前系统没有的功能，业务方应简化规则或流程，本次上线不增加单独开发。

# 1\. 购物车满额后以 999 KZT 加购活动商品
| 需要开发 |
|------|
|  |

购物车中的普通商品金额越高，用户就能以每件 999 KZT 的价格购买更多指定活动商品。

## 用户操作流程

**1\.** 用户把普通商品加入购物车。

**2\.** 购物车显示距离 20,000、40,000 或 60,000 KZT 档位的进度。

**3\.** 达到档位后，用户点击“选择 999 KZT 商品”。

**4\.** 用户选择可购买的不同活动商品，加入购物车并付款。

## 明确规则

**•** 满 20,000 KZT 可选 1 件；满 40,000 KZT 可选 2 件不同商品；满 60,000 KZT 可选 3 件不同商品。

**•** 门槛按普通商品使用折扣后的实付金额计算。

**•** 本活动商品、其他价格促销商品、配送费和服务费不计入门槛。

**•** 同一个活动 SKU 不能重复选择；用户可以少于当前允许数量购买。

**•** 每件活动商品价格为 999 KZT，数量限制按单个订单计算。

**•** 活动只在配置的时间内有效，并受实际库存限制。

## 系统处理逻辑

**•** 实时计算符合条件的金额，并显示 0 / 1 / 2 / 3 件的当前额度。

**•** 只有达到相应档位后，才开放活动商品选择列表。

**•** 付款前再次校验金额、SKU 数量、价格、活动时间和库存。

**•** 金额降低导致超额时，阻止按 999 KZT 付款，并要求删除多余活动商品或补充普通商品。

## 团队需要完成的工作
| 负责范围 | 任务 |
|------|----|
| 后端 | 计算档位；保存活动 SKU 和时间；付款前校验规则与库存。 |
| 前端 | 显示进度、可选数量、商品选择、状态和清晰的错误提示。 |
| 后台配置 | 配置日期、档位、999 KZT 价格和活动 SKU 列表。 |
| 测试 | 覆盖所有档位、购物车变化、活动结束、价格变化和最后库存被抢购的场景。 |

## 验收标准

**☐** 金额为 19,999 KZT 时不可选；20,000 / 40,000 / 60,000 KZT 时可选 1 / 2 / 3 件。

**☐** 活动商品金额和配送费不会提高可选数量。

**☐** 不能重复选择同一 SKU，也不能支付超过允许数量的商品。

**☐** 购物车金额降低后立即重新计算并阻止错误支付。

**☐** 无库存商品不能选择或付款。

## 异常和边界情况

**•** 普通商品价格或折扣变化时，按新的实付价格重新计算门槛。

**•** 最后一件被其他用户买走时，付款页提示无库存并允许选择其他活动商品。

**•** 付款前活动已结束时，系统重新计算购物车并显示清晰提示。

**•** 普通商品部分退货后若不再满足门槛，上线前必须统一确定规则：退回活动商品，或者补收价格差额。

## 同期可观察评论（当前正文）

### 评论 231501

创建：2026-09-23T02:42:56.464Z；更新：2026-09-23T10:12:18.960Z。

[原评论](https://gitlab.parsec.com.cn/umay/doc-and-issues/-/issues/3059#note_231501)

特价购 banner 图片尺寸（整片），模块默认背景色建议设为绿色 #4DBAC0 [提及已隐藏] [提及已隐藏] 

[图片/视频引用：image](https://gitlab.parsec.com.cn/umay/doc-and-issues/uploads/d4d75acb26768913ce6af9db503952b9/image.png)

### 评论 231583

创建：2026-09-23T10:13:20.320Z；更新：2026-09-23T10:13:20.320Z。

[原评论](https://gitlab.parsec.com.cn/umay/doc-and-issues/-/issues/3059#note_231583)

应该是 960 * 240 和 600 * 516 [提及已隐藏] [提及已隐藏]

### 评论 231594

创建：2026-09-24T01:02:22.217Z；更新：2026-09-24T01:02:22.217Z。

[原评论](https://gitlab.parsec.com.cn/umay/doc-and-issues/-/issues/3059#note_231594)

需求变更：仅活动商品不支持积分抵扣，普通商品可使用积分抵扣，且可抵扣部分不计入阶梯门槛金额   [提及已隐藏] [提及已隐藏]  [提及已隐藏] [提及已隐藏]

### 评论 231607

创建：2026-09-24T02:12:59.430Z；更新：2026-09-24T02:34:54.504Z。

[原评论](https://gitlab.parsec.com.cn/umay/doc-and-issues/-/issues/3059#note_231607)

始终根据购物车金额数据去自动勾选或取消勾选已加入购物车的 999 商品，会干扰用户。再加上开发周期，先对整体流程实现吧，后面按需再实现。

1. 保持现有加购逻辑，只要对商品加入购物车，都默认选中，999 商品控制最多加入 3 个，超过 3 个即弹窗提示

2. 购物车内的 999 商品不做计算是否禁止选中、是否自动选中、是否取消选中，用户可任意选。最后提交的时候验证有问题就弹窗提示，告知用户可以添加或者需要移除，可以添加时滚动到添加交互部分，或者需要移除时滚动到 999 商品部分

[提及已隐藏] [提及已隐藏] 麻烦确认一下，是否合适

### 评论 231613

创建：2026-09-24T02:34:54.445Z；更新：2026-09-24T02:34:54.445Z。

[原评论](https://gitlab.parsec.com.cn/umay/doc-and-issues/-/issues/3059#note_231613)

- 购物车中的 999 商品不做计算时禁止选中，计算后按照对应的门槛等级自动选中，用户也可任意选择（但不得超过可加购数量）；
- 注意每个 999 商品限购 1 件。

### 评论 231618

创建：2026-09-24T02:47:48.406Z；更新：2026-09-24T02:47:48.406Z。

[原评论](https://gitlab.parsec.com.cn/umay/doc-and-issues/-/issues/3059#note_231618)

不做自动选中哦。先不做自动吧。后面按需，如果需要再实现

### 评论 231674

创建：2026-09-28T03:33:20.629Z；更新：2026-09-28T03:33:20.629Z。

[原评论](https://gitlab.parsec.com.cn/umay/doc-and-issues/-/issues/3059#note_231674)

菜单资源：
```
{
    "name": "Add-to-Cart 999 Purchase",
    "parentId": "1904741913071546370",
    "type": "MENU",
    "icon": null,
    "route": "/marketingManagement/addPurchaseActivity",
    "sortNo": 9,
    "defaultResource": false,
    "paths": "/product/manage/add-purchase-activity,/product/manage/add-purchase-activity/*,/product/manage/add-purchase-activity/disable/*,/product/manage/add-purchase-activity/enable/*,/product/manage/product/detail/*",
    "systemType": 1
}
```

## 固定版本代码关联候选

- `src/components/cart/AddPurchaseSummary/index.tsx`
- `src/pages/promotion/add-purchase.tsx`
- `src/lib/services/manejiajiagouduancekexuan.ts`

未核对完整实现；没有路径关联时，不代表需求不存在或已经实现。