# SKU 销售限制 · 控区控量规则说明

| 项 | 内容 |
|---|---|
| 业务 | 2.0 业务 |
| 方案 | 方案B（控区 / 控量拆分） |
| 页面 | 供应商后台 → 选品管理 → SKU库 → 编辑 SKU → 销售设置 → 销售限制 |
| 原型 | `管理后台原型/2.0业务_商品管理_编辑SKU销售限制原型.html` |
| 状态 | 已定稿，可进入开发 |
| 更新 | 2026-10-19 |

---

## 1. 页面结构

销售设置卡片内的层级：

```
销售设置
├─ 等级定价
└─ 销售限制（提示：不限代表无限制）
   ├─ 每单限制（三级）
   │   ├─ 起购数量 / 最大可购数量
   │   └─ 倍数购买
   ├─ 控区（三级，带开关）
   │   └─ [开启] 判定粒度：省份 / 地市 / 区县 / 镇街
   └─ 控量（三级，带开关）
       └─ [开启] 配置行列表 + 添加配置
```

三级标题统一样式：11.5px 灰字 + 1px 浅灰竖线，左缩进比二级标题深一级，右侧紧跟 28×15 小开关与「开启 / 关闭」状态字。

---

## 2. 每单限制

| 字段 | 控件 | 规则 |
|---|---|---|
| 起购数量 | 数字输入 | 默认 1，单位件；正整数 |
| 最大可购数量 | 数字输入 | 留空 = 不限；填入后必须 ≥ 起购数量 |
| 倍数购买 | 开关 | 默认关闭；开启后下单数量必须为起购数量的整数倍 |

> 最大可购与起购的 ≥ 校验由后端二次校验，前端在失焦时提示。

---

## 3. 控区

### 3.1 开关

- 默认**关闭**。
- 关闭时：全国可售，不做区域限制。
- 开启时：展开判定粒度面板。
- 关闭不清空已选粒度，重新开启沿用上次选择。

### 3.2 判定粒度

| 项 | 说明 |
|---|---|
| 选项 | 省份 / 地市 / 区县 / 镇街（单选） |
| 默认 | 省份 |
| 语义 | 以用户注册认证地址的**对应层级**作为判定单位 |

判定逻辑：取用户注册认证地址 → 上溯到所选层级 → 该层级区域即为可售范围。

示例（粒度 = 地市）：用户认证地为「浙江省杭州市西湖区」→ 取到「杭州市」→ 只要杭州市在可售范围内即可下单。

### 3.3 提示文案

按所选粒度动态拼接：`按用户注册认证的{地市}判定，未覆盖区域不可售`。

---

## 4. 控量

### 4.1 开关

- 默认**关闭**。
- 关闭时：不做区域周期限量。
- 开启时：展开配置面板，面板标题「控量 · 按区域维度配置周期限量」。
- 关闭不清空已配置内容，重新开启沿用。

### 4.2 配置行

一行 = 一个「区域维度 + 时间周期」的限量组合。

| 列 | 控件 | 取值 | 默认 |
|---|---|---|---|
| 区域维度 | 单选 4 项 | 省份 / 地市 / 区县 / 镇街 | 省份 |
| 时间周期 | 下拉 | 不限 / 每天 / 每周 / 每月 / 每季 / 每年 | 不限 |
| 账号限制 | 数字输入 | 正整数，单位件；留空 = 不限 | 空 |
| 收货限制 | 数字输入 | 正整数，单位件；留空 = 不限 | 空 |

- 两个数量互不覆盖，可只填其一。
- 单位固定「件」，不随维度变化。

### 4.3 数量口径

| 字段 | 口径 |
|---|---|
| 账号限制 | 单个店主账号在该区域、该周期内**累计可下单**的件数 |
| 收货限制 | 单个收货人（按收货人手机号或收货地址主体识别）在该区域、该周期内**累计可收货**的件数 |

两者是**并列的双闸门**，任一超限即拦截下单，不是取其一。

### 4.4 周期口径

| 周期 | 统计区间 |
|---|---|
| 不限 | 历史累计，不重置 |
| 每天 | 自然日 00:00:00 — 23:59:59 |
| 每周 | 自然周（周一 00:00 起） |
| 每月 | 自然月 1 日 00:00 起 |
| 每季 | 自然季度（1/4/7/10 月 1 日 00:00 起） |
| 每年 | 自然年 1 月 1 日 00:00 起 |

### 4.5 增删规则

- 开启后面板内始终**至少保留 1 行**；只有 1 行时不显示「删除」。
- 点「+ 添加配置」追加一行，新行默认维度自动取**尚未被占用**的维度（维度用尽后按省份兜底）。
- 新行默认周期「不限」、两个数量为空。

### 4.6 唯一性校验

- 同一「区域维度 + 时间周期」只允许一行。例如已有「省份 + 每月」，再加「省份 + 每月」即冲突。
- 冲突时：两行的两个数量框同时标红（边框红 + 浅红底），提示文案变为红色「同一区域维度在同一周期下只能配置一条，请调整维度或周期」。
- 修改维度或周期使冲突消失后，标红与提示立即恢复常态。
- 保存前若仍存在冲突，**阻断保存**并定位到冲突行（原型仅提示，开发需补拦截）。

### 4.7 底部提示

- 常态：`同一区域维度同一周期只能配置一条；账号限制 / 收货限制留空表示不限`
- 冲突态：`同一区域维度在同一周期下只能配置一条，请调整维度或周期`（红色）

---

## 5. 控区与控量的关系

- **两个开关相互独立**，可只开控区、只开控量、或同时开。
- 控区管「哪些区域能卖」，控量管「能卖多少」，判定顺序：先控区后控量。
- **控区粒度与控量维度目前不做联动**：控区选「省份」时，控量仍可配「镇街」。若业务要求控量不能细于控区粒度，需单独提需求。

---

## 6. 右侧摘要

| 位置 | 控区关闭 | 控区开启 |
|---|---|---|
| 控区 | 全国 | 按{省份/地市/区县/镇街} |

| 位置 | 控量关闭 | 控量开启且无有效行 | 控量开启且有值 |
|---|---|---|---|
| 控量 | 未开启 | 待配置 | N 条限量 |

「有效行」= 该行账号限制或收货限制至少一个填了值。

---

## 7. 数据结构建议

```json
{
  "skuId": "123456",
  "orderLimit": {
    "minQty": 1,
    "maxQty": null,
    "multiple": false
  },
  "areaControl": {
    "enabled": true,
    "level": "city"
  },
  "qtyControl": {
    "enabled": true,
    "rules": [
      {
        "id": "r1",
        "dimension": "city",
        "cycle": "month",
        "accountLimit": 500,
        "receiveLimit": 2
      }
    ]
  }
}
```

枚举值：

| 字段 | 枚举 |
|---|---|
| `areaControl.level` / `rules[].dimension` | `province` / `city` / `district` / `town` |
| `rules[].cycle` | `none` / `day` / `week` / `month` / `quarter` / `year` |

约束：

- `qtyControl.rules` 最少 1 条、最多 4 条（4 个维度 × 周期组合，实际按唯一性约束收敛）。
- `accountLimit` / `receiveLimit` 允许 `null`（不限），非空时须为 ≥ 1 的整数。
- 同一 `dimension + cycle` 不允许重复，后端需做二次校验。

---

## 8. 待确认（开发前需业务拍板）

| # | 问题 | 当前默认 | 影响 |
|---|---|---|---|
| 1 | 控量按「该维度下每个区域单元分别计量」还是「全国整体合计」？ | 按每个区域单元分别计量（如「地市 + 每月 500」= 每个地市每月各 500） | 直接决定统计 key，必须定 |
| 2 | 多个维度同时命中时（如配了「省份 + 每月」和「区县 + 每月」），取哪条？ | 建议取**最细粒度**那条，不叠加 | 影响拦截逻辑 |
| 3 | 收货限制的「收货人」按什么识别？手机号 / 收货地址 / 实名信息 | 建议按收货人手机号 | 影响去重与防刷 |
| 4 | 周期「不限」与具体周期同时配在同一维度，是否允许并存？ | 允许（维度相同、周期不同即合法） | 可能造成重复限制叠加 |
| 5 | 修改 SKU 限量后，已生成的订单是否回算？ | 不回算，只影响后续下单 | 影响对账口径 |
| 6 | 控区粒度是否需要与控量维度联动 | 不联动 | 见第 5 节 |

---

## 9. 验收要点

| # | 场景 | 预期 |
|---|---|---|
| 1 | 两开关默认状态 | 均关闭，无面板展开，摘要「全国 / 未开启」 |
| 2 | 只开控区 | 控量面板不出现；摘要「按省份 / 未开启」 |
| 3 | 控区切粒度 | 提示文案与摘要同步变化 |
| 4 | 开控量后单行 | 删除按钮不可见 |
| 5 | 添加第二行 | 默认维度自动选未被占用的那个 |
| 6 | 同维度同周期两行 | 两个数量框标红 + 红色提示；保存被阻断 |
| 7 | 改周期消解冲突 | 标红与提示消失，可正常保存 |
| 8 | 两数量都留空 | 该行不计入摘要「N 条限量」 |
| 9 | 关闭再开启 | 已配置内容原样保留 |
| 10 | 数量填 0 或负数 | 视为非法，保存时提示 |
