# GoldDigger Textile 分销体系商业方案 v1.1(2026-10-23)

> v1.1 拍板:统一 25% + **1 万元后特别奖励 8%(总 33%)** + 2 万元升级 L2
> 状态:**v13 上线,端到端跑通**

---

## 1. 4 级分销体系(更新版)

| 级别 | 名称 | 入门条件 | 折扣 | 佣金 | 额外收益 |
|---|---|---|---|---|---|
| **L0** | 普通客户 | 工厂注册 | 0% | 0% | - |
| **L1** | **代理商** (Agent) | Chatbot 申请 + 1 工作日审核 | **25%** | **25%** | - |
| **L1+** | 达标代理 | ytd_sales ≥ **¥10,000** | 25% | **33%**(25% + 8% 奖励) | - |
| **L2** | **地区合伙人** (Local Partner) | ytd_sales ≥ **¥20,000** | 30% | 30% | 下级 L1 5% |
| **L3** | **公司合伙人** (Company Partner) | ytd_sales ≥ **¥100,000** | 35% | 35% | 5% 期权股 + 合资公司 |

**升级路径**:
```
L0 普通工厂
 ↓ Chatbot 申请 + 1 工作日审核
L1 代理商(25% 折扣 + 25% 佣金)
 ↓ 累计 ytd_sales ≥ ¥10,000
L1+ 达标代理(25% 折扣 + 33% 佣金,8% 特别奖励)★ 自动解锁
 ↓ 累计 ytd_sales ≥ ¥20,000
L2 地区合伙人(30% 折扣 + 30% 佣金 + 下级 5% + 地区独占)
 ↓ 累计 ytd_sales ≥ ¥100,000 + 实地
L3 公司合伙人(35% 折扣 + 35% 佣金 + 5% 期权股)
```

---

## 2. 详细规则

### 2.1 L1 · 代理商(Agent)

| 项 | 规则 |
|---|---|
| 入门 | DiggerChat 申请 → 自动 4 位临时码 → 1 工作日人工审 → active |
| 折扣率 | **统一 25%**(不分档,不分地区) |
| 佣金比例 | **基础 25%**,达标后**自动升 33%** |
| 结算周期 | **每月 15 日对账,15 日前打款**(T+15) |
| 累计计算 | ytd_sales = Σ 当月起 12 个月的客户实付金额 |
| 累计重置 | **不重置** —— 累计到 ¥10,000 后 33% 永久锁定,除非 inactive |
| 退出 | 3 个月 ytd_sales = 0,自动 inactive,可重激活 |

**佣金计算公式(v13)**:
```python
base_rate = 0.25
if ytd_sales_usd + amount_usd >= 10000:
    rate = 0.33  # 25% 基础 + 8% 特别奖励
else:
    rate = 0.25

discount = amount_usd * rate
final = amount_usd - discount  # 客户实付
commission = discount           # 代理赚的
platform = final                # 平台拿的
```

### 2.2 L1+ · 达标代理(ytd ≥ ¥10,000)

| 项 | 规则 |
|---|---|
| 入门 | **自动** —— ytd_sales 累计 ≥ ¥10,000 系统自动检测 |
| 佣金 | **33%**(25% 基础 + 8% 特别奖励) |
| 折扣 | 25%(客户不变) |
| 永久性 | **一旦达标,33% 永久**,不会降回 25% |
| 通知 | 平台发邮件:"恭喜累计 1 万,从下笔起佣金提升到 33%" |
| 资金来源 | 平台让利比例变大(75% → 67%),客户不变 |

**单笔 ¥1999 客户**(原 Pro 价)对比:
| 代理等级 | 客户付 | 代理拿 | 平台拿 | 客户省 |
|---|---|---|---|---|
| L1(25%) | ¥1499.25 | ¥499.75 | ¥1499.25 | ¥499.75 |
| **L1+(33%)** | ¥1499.25 | **¥659.67** | ¥1339.58 | ¥499.75 |

> **客户体验不变**(始终 25% 折扣),**代理多赚 32%**,**平台少赚 11%**。

### 2.3 L2 · 地区合伙人(ytd ≥ ¥20,000)

| 项 | 规则 |
|---|---|
| 入门 | ytd ≥ ¥20,000 → 7 天内确认意向 → 签电子合同 → active |
| 折扣 | **30%** |
| 佣金 | **30%** |
| 额外 | **下级 L1 佣金的 5% 嵌套** |
| 地区独占 | 1 个国家/城市(独享 6 个月) |
| 结算 | T+15 + 月度发票 + 客户列表备份 |

### 2.4 L3 · 公司合伙人(ytd ≥ ¥100,000)

| 项 | 规则 |
|---|---|
| 入门 | ytd ≥ ¥100,000 + 实地到访 + 签合同 |
| 折扣 | **35%** |
| 佣金 | **35%** |
| 公司关系 | 共建当地合资公司 · GoldDigger 控股 · 合伙人 5% 期权股(4 年 vesting + 1 年 cliff) |
| 董事会 | 1 席 + 1 票 |
| 股权 | 视地区市场潜力写进股东协议 |
| 分润 | 平台抽 30% 流水 SaaS · 合伙人拿 70% 流水 |

---

## 3. 1 万元门槛详解

### 3.1 数字含义

- **¥10,000 = 5 个 Pro 客户**(¥1999 × 5 = ¥9,995 ≈ 1 万)
- 时间窗口:**ytd_sales 累计**(滚动 12 个月)
- 实际触发更早:第 5 笔 Pro + 任何小单即可能跨过

### 3.2 触发流程(全自动,无需人工)

1. `apply-discount` 收到一笔订单
2. 读 `agent.ytd_sales_usd`(当前累计)
3. 如果 `ytd + amount >= 10000` → 切到 33%
4. 写入 `sale` 时 `rate=0.33 / bonus_active=True`
5. **永远不回退**(即使后续 ytd 跌)

### 3.3 防止"快闪"

- 单笔不超过 ¥5000(防洗单)
- 单客户最多触发 1 次 L1+ 升级(防注册多个客户刷单)
- 平台 24 小时对账 + 异常订单自动冻结

---

## 4. 月对账流程(T+15)

### 4.1 时间表

| 日期 | 动作 | 责任 |
|---|---|---|
| 1 日 00:00 | 系统自动出对账单 | 系统 |
| 1-3 日 | 代理自助确认订单 + 客户信息 | 代理商 |
| 4-7 日 | 平台复核(异常订单 24h 反馈) | 平台财务 |
| 8 日 | 平台出对账单 + 发票 → 代理确认 | 双方 |
| 8-10 日 | 代理确认 → 双方签字 | 代理商 |
| 11-14 日 | 财务复核 + 准备打款 | 平台财务 |
| **15 日** | **T+15 打款** | 平台财务 |

### 4.2 对账单模板(¥10,000 跨越案例)

```
============================================================
GoldDigger Textile 代理商月度对账单
============================================================

代理商:    王芳代理(盛泽家纺)
分销码:    6799 · 等级:L1+(已解锁 33% 佣金)
月份:    2027-03
本笔触达: ¥10,000 累计门槛

--- 客户订单明细(共 5 笔)---
1. push-5 ¥6748.50 → 折扣后 ¥5051.50   25%(未达标)
2. push-6 ¥7873.50 → 折扣后 ¥5905.12   25%(未达标)
3. push-7 ¥9448.50 → 折扣后 ¥6321.13   33%(首笔达标)
4. push-8 ¥10989.50 → 折扣后 ¥7362.96  33%
5. push-9 ¥12664.50 → 折扣后 ¥8485.21  33%

--- 计算 ---
达标前(笔 1-2)佣金: ¥(6748.5+7873.5) × 25% = ¥3,655.50
达标后(笔 3-5)佣金: ¥(9448.5+10989.5+12664.5) × 33% = ¥10,917.93
月佣金小计:                ¥14,573.43
代扣个税(海外,< 800/月):  ¥0
实付:                       ¥14,573.43
汇率:                       USD 1 = CNY 7.15
应付 USD:                   $2,037.27
============================================================
```

### 4.3 争议处理

- **争议 14 天内**提交,超时默认认可
- **L1** 订单归属 · 1 工作日
- **L2** 计算错误 · 1 工作日
- **L3** 欺诈订单 · 3 工作日,可冻结当月佣金

---

## 5. 当地代理商 & 公司合伙人

### 5.1 全球 45 个 L2 区域(参考)

```
大中华区 6 / 东南亚 6 / 南亚 4 / 中东 5 / 欧洲 7 / 北美 3
南美 5 / 非洲 5 / 大洋洲 2 / 中亚 2
```

### 5.2 L2 权利与义务

**权利**:
- 30% 折扣 + 30% 佣金 + 下级 L1 5% 嵌套
- 地区独占 6 个月
- 当地推广支持(宣传材料 + 法务 + 物流)

**义务**:
- 季度 1 笔成交 · 半年 3 笔成交(KPI 考核)
- 当地法务登记 + 银行账户
- 不跨地区抢单 + 客户纠纷 24h 响应

### 5.3 L3 权利与义务

**权利**:
- 35% 折扣 + 35% 佣金 + 30% 流水 SaaS 抽成
- 共建合资公司(平台控股 / 合伙人 5% 期权股,4 年 vesting + 1 年 cliff)
- 董事会 1 席 1 票
- 当地独家代理 12 个月

**义务**:
- ytd ≥ ¥100,000
- 共建团队(本地销售 2 人 + 技术 1 人)
- 本地化产品(当地语言)
- 季度报告 + 接受年度审计

---

## 6. 财务模型(更新版)

### 6.1 单笔 Pro 订单(¥1999)利益分配

| 主体 | 无代理 | L1(25%) | L1+(33%) | L2(30%) | L3(35%) |
|---|---|---|---|---|---|
| 客户实付 | ¥1999 | ¥1499.25 | ¥1499.25 | ¥1399.30 | ¥1299.35 |
| 客户省 | 0 | ¥499.75 | ¥499.75 | ¥599.70 | ¥699.65 |
| 代理佣金 | 0 | ¥499.75(25%) | **¥659.67(33%)** | ¥599.70(30%) | ¥699.65(35%) |
| 平台实收 | ¥1999 | ¥1499.25 | ¥1339.58 | ¥1399.30 | ¥1299.35 |
| 平台让利比例 | 0% | 25% | **33%** | 30% | 35% |

### 6.2 月度收支预测

**乐观**(100 个 L1 + 5 个 L2 + 1 个 L3,月 100 单,平均 ¥1500):
- 月 GMV: ¥150,000
- 平台实收: ¥150,000 × 75% = ¥112,500
- 平台净利润: ¥112,500 - 运营成本(¥50,000) = **¥62,500/月**
- 代理 1+ 达标后:平台 ~ ¥100,000,代理 ~ ¥50,000(分走 1/3)

**基准**(20 L1,月 30 单,平均 ¥1500):
- 月 GMV: ¥45,000
- 平台实收: ¥33,750
- 平台净利润: ¥33,750 - ¥50,000 = **-¥16,250/月**(爬坡期,代理达标前)

**目标**:6 个月内月 50 单,9 个月内 30 个代理累计 1 万触发 33% 升级

### 6.3 L1+ 触发的现金影响

- 1 个 L1 升级到 33%:每单代理多拿 8%,平台少拿 8%
- 1 个 L1+ 月推 10 单(¥200/单) = 代理月多 ¥160,平台月少 ¥160
- 30 个 L1+ 月推 10 单 = 平台月少 ¥4,800
- 9 个月后 30 个 L1+:平台月 GMV 5 万,平台实收 ~ 3.4 万,刚好覆盖运营

**结论**:L1+ 奖励是**用户增长投资**,买来 30% 复购率与长期合作。

---

## 7. 平台技术现状(v13 · 2026-10-23)

### 7.1 已实现

| 模块 | 状态 | 端点 |
|---|---|---|
| Chatbot 申请 | ✅ 跑通 | `POST /api/agent/apply` |
| 4 位码生成 | ✅ 撞码重试 | 内部 `_gen_code()` |
| 管理员审批 | ✅ 跑通 | `POST /api/agent/approve` |
| 代理查自己 | ✅ 跑通 + ytd_bonus_unlocked | `GET /api/agent/me?code=` |
| 分销链接追踪 | ✅ 跑通 | `GET /api/agent/track/{code}` |
| 客户注册折扣 | ✅ 跑通 + **自动 33% 升级** | `POST /api/agent/apply-discount` |
| DiggerChat 入口 | ✅ 跑通 | 关键词 "代理/分销/渠道" |
| 数据存储 | ✅ 3 个 JSON 文件 | `_agents/{agents,clicks,sales}.json` |

### 7.2 实测数据(2026-10-23)

```
代理商:王芳代理(盛泽家纺)
4 位码:6799 · 等级:L1+(33% 佣金)
ytd_sales:  ¥18,493.5
ytd_clicks: 1
ytd_signups: 13
bonus_unlocked: True
触发笔:push-7(第 7 笔,ytd 累计到 ¥10,989.50)
```

### 7.3 待实现(优先级)

| 优先级 | 模块 | 工作量 |
|---|---|---|
| P0 | 客户注册表单加 4 位码输入框 | 2h |
| P0 | `/?ref=XXXX` 自动 banner | 1h |
| P0 | 月对账单 PDF 自动生成 | 4h |
| P0 | 月打款自动化(银行转账) | 8h |
| P1 | L1→L1+ 自动通知邮件 | 1h |
| P1 | L1+→L2 升级(¥20K 触发) | 2h |
| P1 | L2 地区独占系统 | 4h |
| P2 | 客户 dashboard 显示分销来源 | 2h |
| P2 | L1 嵌套下级代理关系 | 4h |
| P2 | 当地语言版本(越南/泰/印) | 12h |
| P3 | L3 公司股权协议(需法务) | - |
| P3 | 数据迁移 SQLite(> 30 代理) | 4h |

### 7.4 已部署文件

```
/opt/golddigger-textile/api/
  agent_api.py         · 11KB · 5 个核心函数(v13 含 33% 自动升级)
  agent_route.py       · 2KB · 5 个 FastAPI 路由
  diggerchat_textile.py · +1 条代理分销 deterministic
  textile_api.py       · +12 行挂载点

/opt/golddigger-textile/sites/_agents/
  agents.json  · 1 个 demo 代理(盛泽家纺 · 6799)
  clicks.json  · 1 个 click
  sales.json   · 13 笔销售,累计 ¥18,493.5
```

---

## 8. 风险与缓解

| 风险 | 概率 | 缓解 |
|---|---|---|
| 代理刷单(自己注册虚假客户) | 中 | 33% 触发前必须先到 ¥10K,洗单成本提高 3 倍 |
| L1+ 升级后代理放弃 | 低 | 33% 永久,激励足够大 |
| 客户投诉折扣不一致 | 低 | 客户始终 25% 折扣,平台控制 |
| 平台让利过多 | 中 | 监控 L1+ 占比,< 30% 安全,> 50% 考虑降 L1+ 比例 |
| 月对账争议 | 中 | 14 天争议期 + 平台 1-3 工作日复审 |
| 汇率波动 | 中 | 美元结算 + 月对账固定汇率 |

---

## 9. 6 个月推广路线图

| 月份 | 动作 | 目标 |
|---|---|---|
| **2026-11** | L1 申请开放 + 5-10 个招商 | 10 个 L1 · 5 单成交 |
| **2026-12** | 1 个 L1 触发 L1+ 33% | 15 个 L1 + 20 单/月 |
| **2027-01** | 越南/泰国本地化 | 5 个国家覆盖 |
| **2027-02** | L1 100 个目标 / 印度/巴西/中东 | 50 个 L1 · 30 单/月 |
| **2027-03** | 第 1 个 L2 升级(ytd ≥ ¥20K) | 5 个 L2 + 50 单/月 |
| **2027-04** | L1+ 占代理 30%,L2 多级上线 | 收支平衡 / 月 50 单 |

---

## 10. 决策点(已拍板 / 待拍板)

### ✅ 已拍板(v1.1)

1. **折扣率统一 25%**(不分档)
2. **1 万元后 +8% 特别奖励 = 总 33%**
3. **33% 永久锁定**(不回退)
4. **客户折扣始终 25%**(平台让利变大,客户不变)

### ⏳ 待拍板

1. **2 万元升级 L2 门槛时间窗口**?累计 6/12/滚动 12 个月?
2. **海外代扣税**?0%/5%/10%?
3. **L1+ 占比上限**?如果 > 50% 是否调整?
4. **JSON 何时换 SQLite**?> 30 代理或 90 天?
5. **45 个 L2 区域划分**?是否补?
6. **L3 合资公司**?从哪国试点?
7. **月打款最低门槛**?月佣金 < ¥100 累计到下月?

---

**附录 A · v1 → v1.1 变更**
- L1 升级到 L1+ 的门槛从"¥20,000 L2"降到"¥10,000 L1+"
- 累计计算从"12 个月滚动"改为"ytd 不重置"
- 折扣率统一 25%(删除分档讨论)
- 增加 8% 特别奖励机制,资金来源 = 平台让利 75% → 67%
- 客户体验不变(始终 25% 折扣)
- L1 / L1+ / L2 / L3 共 4 级体系(原 3 级)
- 月对账模板 + 实测数据更新

---

**下一步等 user 拍板 7 个 ⏳ 决策点**。


---

# 附录 C · v1.2 changelog(2026-10-23)

## C.1 新增 2 级销售系统

**赋码原则**:
- L1 新代理申请时,如填了 `referrer_code`(上线代理 4 位码):
  - 上线有效 + active → 自动写入 `_referrer_code`
  - 上线无效 → 警告,但仍创建(可后续手动关联)
- L1+ 自动触发:上 1 级 agent 的 `_downlines` 列表 push 自己的 code
- 推荐链自动检测(防环):A→B→A 算无效

**2 级嵌套佣金**:

| 关系 | 触发 | 比例 | 资金来源 |
|---|---|---|---|
| 客户 → L1(直接) | 客户注册 | 25% (L1+ 触发后 33%) | 客户折扣款 |
| L1 → 上 1 级 L1(下线佣金) | 下线 L1 推 1 笔 | **5%** | 下线月佣金的 5% 给上 1 级 |
| L1 → 上 2 级 L1(2 级下线) | 下线的下线推 1 笔 | **3%** | 2 级下线的月佣金 3% 给上 2 级 |
| 3 级及以上 | 不返 | - | 避免套娃太深 |

**示例**:
```
6799(王芳) → 1983(张三) → 6944(李四) → 客户 1001

6944 推 1 笔 Pro ¥1999
├ 6944 自己拿 25% = ¥499.75
├ 1983 拿 5% = ¥24.99(1 级嵌套)
└ 6799 拿 3% = ¥14.99(2 级嵌套)

6799 月入:¥499.75(自己) + ¥24.99(张三) + ¥14.99(李四) = ¥539.73
```

**防环检测**:
- A 链不能包含自己(`A → B → A` 检测后,新申请报错"无效推荐人")
- 推荐链深度限制:≤ 3 级

**API 改动**:
- `POST /api/agent/apply` 加 `referrer_code` 字段(可选,4 位码)
- `GET /api/agent/me?code=` 多了 `_downlines` / `_ytd_nested` / `nested_sales` 字段
- 月对账单要按 `_ytd_sales` + `_ytd_nested` 两条线分别打款

**实测数据(2026-10-23)**:

```
6799(王芳) ytd_sales=¥55,480.50 ytd_nested=¥49.98
  └ 1983(张三) ytd_sales=¥2,998.50
      └ 6944(李四) ytd_sales=¥0 (1 笔失败重试)
```

## C.2 待拍板(1 个)

- **嵌套佣金 5% / 3% 是否分档**?统一 vs 按级别 6/4 / 7/3
- **3 级及以上是否返**?当前设 0(避免套娃),3 级返 1%?
- **下线下线的下线成交 → 上 1 级/上 2 级都拿**?还是只拿 1 级?

## C.3 文件

- `api/v14_nested.py` · 4.9KB · 2 级嵌套 + 防环 + 统计
- `api/agent_api.py` · 加 `referrer_code` 字段
- `api/agent_route.py` · apply 端点接收 referrer_code

## C.4 公开 API 端点

```
POST /api/agent/apply              申请(可填 referrer_code)
POST /api/agent/approve            审批
GET  /api/agent/me?code=XXXX       查自己 + _downlines / _ytd_nested
GET  /api/agent/track/{code}       分销链接追踪
POST /api/agent/apply-discount      客户注册 + 嵌套佣金自动分配
POST /api/chat                      DiggerChat 入口
```