# #3058 每周特价商品 Weekly Deals 来源：https://gitlab.parsec.com.cn/umay/doc-and-issues/-/issues/3058 读取时间：2026-10-01T14:06:53.854019+00:00；当前更新时间：2026-09-30T08:04:57.483Z。 > 当前内容快照，非历史版本。身份提及、电话示例和订单编号经最小化处理；不据此认定需求已实现。 ## 当前描述 活动进行中：（首页 banner & 商品栏） [图片/视频引用：image](https://gitlab.parsec.com.cn/umay/doc-and-issues/uploads/3e01cc52201c22e2ca127415b0be601d/image.png) 活动商品弹窗： [图片/视频引用：image](https://gitlab.parsec.com.cn/umay/doc-and-issues/uploads/31ffb6fc3d44cba8b1c3c6550ddfacba/image.png) 活动商品详情弹窗： [图片/视频引用：image](https://gitlab.parsec.com.cn/umay/doc-and-issues/uploads/fccbd5fc8cbf0174b1e577ef32407e5a/image.png) 活动商品加购： [图片/视频引用：image](https://gitlab.parsec.com.cn/umay/doc-and-issues/uploads/14b1e4f79afc921cb69fc761caa78881/image.png) [图片/视频引用：image](https://gitlab.parsec.com.cn/umay/doc-and-issues/uploads/5911f68b309ddbdcf2fbaaef70404a3b/image.png) 购物车：（~~活动商品订单不允许积分支付~~仅活动商品不允许积分抵扣） [图片/视频引用：image](https://gitlab.parsec.com.cn/umay/doc-and-issues/uploads/8b3e9bba8c0300f14f7811401a12ba5e/image.png) 确认结算：（活动商品订单） [图片/视频引用：image](https://gitlab.parsec.com.cn/umay/doc-and-issues/uploads/e2281d2cf640b051c7a6ce7f1c6e29a1/image.png) 支付成功：（活动商品订单） [图片/视频引用：image](https://gitlab.parsec.com.cn/umay/doc-and-issues/uploads/6204a0b2e9e7848bd113ee62f60834bf/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 ## 通用规则 **•** 活动时间和周限购统一以服务器时间为准，时区为 Asia/Almaty。 **•** 付款前重新校验价格、活动时间和库存；旧页面显示的数据不能保证最终价格。 **•** 同一 SKU 不能同时参加两个价格促销；订单赠品可与任何价格促销同时存在。 **•** 原型中的 SKU、品类、日期、折扣比例和优惠码均为示例，不视为正式确认。 **•** 如果第3、第4或第5项需要当前系统没有的功能，业务方应简化规则或流程，本次上线不增加单独开发。 # 每周商品 | 需要开发 | |------| | | UMAY 每周展示最多 5 个特价商品。已登录用户每个自然周只能从中选择 1 件，并享受一次本周价格。 ## 用户操作流程 **1\.** 用户登录账户并打开“每周商品”区域。 **2\.** 查看最多 5 个 SKU、原价、本周价和库存状态。 **3\.** 选择 1 件加入购物车并付款，不要求最低订单金额。 **4\.** 付款成功后，本周内不能再次使用该优惠。 ## 明确规则 **•** 限制是整个商品组共 1 件，不是每个 SKU 各 1 件。 **•** 每个已登录账户每个自然周只能成功购买一次。 **•** 自然周为周一 00:00 至下周一 00:00，统一使用 Asia/Almaty 时区。 **•** 每周商品可单独下单，配送费按现有规则计算。 **•** 每周活动单独配置 SKU、活动价和有效时间。 **•** 同一 SKU 不应同时参加其他价格促销。 ## 系统处理逻辑 **•** 校验登录状态、当前活动组、库存和用户本周资格。 **•** 用户发起付款时锁定资格，避免两个并行订单重复使用。 **•** 只有付款成功后才标记为已使用；付款失败或付款前取消不消耗资格。 **•** 新一周开始时自动恢复资格并启用新的商品组。 ## 团队需要完成的工作 | 负责范围 | 任务 | |------|----| | 后端 | 按账户和自然周记录资格；防止并行支付；在结算时校验。 | | 前端 | 展示最多 5 个商品及“可购买、已使用、无库存、活动结束”等状态。 | | 后台配置 | 配置自然周、1–5 个 SKU、活动价、顺序和发布时间。 | | 测试 | 测试周切换、重复/并行购买、支付失败、付款前取消和库存。 | ## 验收标准 **☐** 用户第一次可以从 5 个 SKU 中购买 1 件，且不需要最低订单金额。 **☐** 同一周内不能再次按本周活动价购买第二件。 **☐** 支付失败和付款前取消不会消耗资格。 **☐** 付款成功后资格变为已使用；新一周开始后自动恢复。 **☐** 同一账户的并行订单不能同时获得本周价格。 ## 异常和边界情况 **•** 部分 SKU 无库存时显示“已售罄”，其他 SKU 仍可选择。 **•** 全部 SKU 无库存时，区域保留清晰提示，说明活动暂时不可用。 **•** 付款成功后的退货不会自动恢复资格；仅在确认系统故障时，由客服人工恢复。 **•** 未登录用户可查看活动，但购买前必须登录。 ## 同期可观察评论（当前正文） ### 评论 230959 创建：2026-09-14T07:17:02.107Z；更新：2026-09-24T00:59:41.144Z。 [原评论](https://gitlab.parsec.com.cn/umay/doc-and-issues/-/issues/3058#note_230959) Admin-营销管理-每周特价（Weekly Deals） 活动列表： [图片/视频引用：image](https://gitlab.parsec.com.cn/umay/doc-and-issues/uploads/8fc7866b3ad27223a549a453a1503e28/image.png) - 每周特价与满额 999 加价购使用独立活动列表。每条活动维护自己的 GMT+5 周期、5 个固定商品槽位、销售价和划线参考价；全池每位买家每周限购 1 件为只读规则。 - 活动周期不得重叠，同一时间只能有一个活动生效。 - 仅未产生订单的活动可删除，删除前二次确认，确认后只移除当前活动。 新增/编辑活动： [图片/视频引用：image](https://gitlab.parsec.com.cn/umay/doc-and-issues/uploads/376f6eb86a5c88cfeb4c3b384f498806/image.png) - 两套促销独立：本页不配置 Cart 999 的金额门槛、加价购单价、候选池或跨机制开关。 - 周限购：5 款特价商品共用每位买家每周 1 件的额度，不是每款各限 1 件。 - 积分限制：订单只要包含活动标记商品（每周特价或 Cart 999），包括与普通商品混合的订单，~~整单不能使用积分抵扣或积分支付。前端可置灰或隐藏积分入口，~~ **活动商品不允许积分抵扣，普通商品可积分抵扣，** 服务端必须在下单和支付前再次校验。 - 商品名称：显示当前界面语言商品名（俄文、英文或哈文）和固定中文名。 - 可售 = 商品上架 & SKU 库存不为 0。状态由商品与库存数据回流，本页不提供数字库存输入或展示。 - 周特价金额不计入 Cart（999 门槛）。 原型已更新 [提及已隐藏] ~~[umay_促销活动原型.zip](https://gitlab.parsec.com.cn/umay/doc-and-issues/uploads/c0134a365fd967463f9eb8ba6a45cab1/umay_促销活动原型.zip)~~ [Umayshop 促销活动管理端原型](Https://umay-promotion.20140107.xyz) ### 评论 231593 创建：2026-09-24T01:01:07.766Z；更新：2026-09-24T01:01:07.766Z。 [原评论](https://gitlab.parsec.com.cn/umay/doc-and-issues/-/issues/3058#note_231593) 需求变更：仅活动商品不支持积分抵扣，普通商品可使用积分抵扣 [提及已隐藏] [提及已隐藏] [提及已隐藏] ### 评论 231642 创建：2026-09-24T09:21:19.608Z；更新：2026-09-24T09:21:19.608Z。 [原评论](https://gitlab.parsec.com.cn/umay/doc-and-issues/-/issues/3058#note_231642) [提及已隐藏] 平台管理端也完成了，麻烦与相关人员配置几个特价商品。最好是在 staging 环境吧。发布测试后，客户用的也是 staging 环境 ### 评论 231722 创建：2026-09-29T03:36:19.417Z；更新：2026-09-29T03:53:36.594Z。 [原评论](https://gitlab.parsec.com.cn/umay/doc-and-issues/-/issues/3058#note_231722) [图片/视频引用：image](https://gitlab.parsec.com.cn/umay/doc-and-issues/uploads/60fc18d542238f0716bd54a645f9528f/image.png) 根据设计稿，首页的特价商品列表展示，还缺 **分类**、**来源**、**销售数量** 字段返回，麻烦看下对不对，或还有遗漏 另外调用测试环境 _GET /product/public/special/product/activity_ 接口时，数据结构定义中有 skuId，但实际查看数据没有 skuId 字段返回，麻烦检查一下 [提及已隐藏] ### 评论 231725 创建：2026-09-29T03:41:07.321Z；更新：2026-09-29T03:54:35.760Z。 [原评论](https://gitlab.parsec.com.cn/umay/doc-and-issues/-/issues/3058#note_231725) [提及已隐藏] 1. 确认下这里每个卡片底部的按钮中的日期用什么值来展示？满额加购商品那边也是日期文本按钮，顺便也说一下吧。 2. 还有个问题需要确认一下，每周特价商品和满额加购商品的 sku 是否可改变？进入商品页或打开商品弹窗后，有没有规格属性的再选择？ ### 评论 231726 创建：2026-09-29T03:53:36.491Z；更新：2026-09-29T03:53:36.491Z。 [原评论](https://gitlab.parsec.com.cn/umay/doc-and-issues/-/issues/3058#note_231726) [提及已隐藏] 另外顺便方便把这里活动商品列表的商品 item 的数据结构调整为兼容之前商品列表的 item 的数据结构吗？如果性能有影响，像满额加购活动把基本信息和列表分开？ ### 评论 231727 创建：2026-09-29T03:54:35.653Z；更新：2026-09-29T03:55:10.154Z。 [原评论](https://gitlab.parsec.com.cn/umay/doc-and-issues/-/issues/3058#note_231727) - 1.应该是客户那边近期调整设计图，增加了商品卡片弹窗，商品卡片按钮可显示活动到期日期，同时详情页不再显示倒计时； - 2.绑定的是商品 id，活动中途是可以修改的，同时加购时也需要选择规格。 [提及已隐藏] ### 评论 231728 创建：2026-09-29T03:56:14.421Z；更新：2026-09-29T03:56:14.421Z。 [原评论](https://gitlab.parsec.com.cn/umay/doc-and-issues/-/issues/3058#note_231728) 不一样,很多这段是不需要的,按新接口返回数据为准 ### 评论 231757 创建：2026-09-30T02:52:06.723Z；更新：2026-09-30T02:52:06.723Z。 [原评论](https://gitlab.parsec.com.cn/umay/doc-and-issues/-/issues/3058#note_231757) 已添加相关字段 category:{ru,en,kz} 多语言分类名称 source: 来源 sales: 销量 ### 评论 231759 创建：2026-09-30T02:57:38.655Z；更新：2026-09-30T03:03:39.144Z。 [原评论](https://gitlab.parsec.com.cn/umay/doc-and-issues/-/issues/3058#note_231759) [图片/视频引用：image](https://gitlab.parsec.com.cn/umay/doc-and-issues/uploads/e53bcac5f6bda1942ed1505096ef284c/image.png) [提及已隐藏] [提及已隐藏] 预算订单可使用积分需要传对应订单商品明细的活动id ### 评论 231760 创建：2026-09-30T03:03:39.086Z；更新：2026-09-30T03:03:39.086Z。 [原评论](https://gitlab.parsec.com.cn/umay/doc-and-issues/-/issues/3058#note_231760) [提及已隐藏] 活动商品不参与积分计算？ https://gitlab.parsec.com.cn/umay/doc-and-issues/-/issues/3058#note_231593 ## 固定版本代码关联候选 - `src/components/home/DiscountCatalogBanner/WeeklyDealsSection.tsx` - `src/pages/promotion/weekly-deals.tsx` - `src/lib/services/gonggongjiekou.ts` 未核对完整实现；没有路径关联时，不代表需求不存在或已经实现。