# GoldDigger 市场推广系统介绍

> 版本:2026-10-23 v1.0 · 适用所有垂直站(纺织 / 建材 / …)
> 配套:DiggerChat 关键词问答已同步上线,输入「月对账 PDF」可直接拿模板

---

## 一句话

**0 加盟费 + 25% 客户折扣 + 25%~33% 佣金 + 2 级嵌套(5%/3%)+ 月对账 T+15 打款。**

客户省 25%,代理拿 25%(达标 33%),平台让利。三方都不吃亏,平台从**成交总额**里赚,不是从加盟费里赚。

---

## 1. 系统架构 · 3 层

```
┌──────────────────────────────────────────────────────┐
│  L1  前端触点                                          │
│  · 客户网站 footer 折叠区(销售合伙人说明书)             │
│  · 纺织站 /textile/?ref=XXXX                          │
│  · DiggerChat 关键词自动答                             │
│  · 朋友圈 9 图 + 8 段话术                             │
└──────────────┬───────────────────────────────────────┘
               │
┌──────────────▼───────────────────────────────────────┐
│  L2  追踪与分配                                         │
│  · 4 位自动分配码(永久锁定)                            │
│  · GET /api/agent/track/{code}  写 cookie(7 天)       │
│  · POST /api/agent/apply  绑定上线                    │
│  · 防环:自引用 / 循环 / 超 2 级范围                     │
└──────────────┬───────────────────────────────────────┘
               │
┌──────────────▼───────────────────────────────────────┐
│  L3  结算与对账                                         │
│  · POST /api/agent/apply-discount  客户 25% 折扣       │
│  · 直接佣金 25% → 达标 33%                            │
│  · 嵌套佣金 1 级 5% / 2 级 3%                         │
│  · 每月 1 日出账 → 15 日 T+15 打款                     │
│  · 月对账 PDF(22 字段 A4 单页)                         │
└──────────────────────────────────────────────────────┘
```

---

## 2. 4 档等级 · 佣金表

| 等级 | 门槛 | 客户折扣 | 直接佣金 | 额外权益 |
|---|---|---|---|---|
| **L1 销售合伙人** | ytd ¥0 | 25% | **25%** | 4 位码终身锁定 |
| **L1+ 达标合伙人** | ytd **≥ ¥10,000** | 25%(不变) | **33%** | 25% 基础 + 8% 奖励,永久不降 |
| **L2 地区合伙人** | ytd ≥ ¥20,000 | 30% | 30% | 选 1 国家/城市,平台 6 个月不派其他代理 |
| **L3 公司合伙人** | ytd ≥ ¥100,000 | 35% | 35% | 当地合资公司 **5% 期权股** |

### L3 的 5% 期权股 · 完整条款

| 项 | 条款 |
|---|---|
| 标的股比 | 当地合资公司 **5% 期权股**(期权池 10% 中的一半) |
| 平台持股 | GoldDigger **控股**(不稀释合伙人的运营主导权)|
| 授予方式 | L3 达成后由董事会决议授予,签期权协议 |
| **Vesting** | **4 年成熟期**,按月成熟 |
| **Cliff** | **1 年 cliff**:满 1 年前离职 = **0 股权**;满 1 年后一次性成熟 25%,之后按月 |
| 成熟后 | 合伙人可按约定行权价(增资款)认购全部或部分 |
| 行权窗口 | 每年 1 次(1 月),或离职后 90 天内一次性 |
| 离职处理 | 未成熟部分作废;已成熟部分按公司约定回购 |
| 分红 | 与全部股东按持股比例,无优先权 |
| 转让 | 需董事会同意,平台有优先受让权(ROFR) |
| 稀释保护 | 后续融资按比例反稀释 |

**这是期权不是股份**:授予 ≠ 持股,需满 1 年 cliff + 行权才成为实际持股。销售话术必须说清,不能含糊说「给你 5% 股份」。

> **关键**:L1+ 触发后**永久锁定 33%**,不降回 25%,无需重新申请。
> 客户折扣**只由等级决定**,不因嵌套层级变化。
> `GET /api/agent/me` 返回 `ytd_bonus_unlocked` / `ytd_to_bonus_usd` / `next_tier_hint`。
> ⚠️ **期权条款涉及证券发行,须经法务 + 当地律师审核后才能对外承诺。**

---

## 3. 2 级销售 · 嵌套结构

```
你(代理 A,码 6799)
│
├─ 你直接推的客户 ────────────► 你拿 25%(达标 33%)
│
└─ 你推荐的代理 B(码 1983) ◄── B 是你的下线
   │
   ├─ B 直接推的客户 ──────────► B 拿 25%,你拿 5%
   │
   └─ B 推荐的代理 C(码 6944) ◄─ C 是 B 的下线
      │
      └─ C 直接推的客户 ───────► C 拿 25%,B 拿 5%,你拿 3%
         │
         └─ 第 4 层 ───────────► 0%(封顶,防套娃)
```

### 嵌套佣金口径

| 项 | 规则 |
|---|---|
| 基数 | **下线实际拿到的佣金额**,不是订单金额 |
| 1 级 | 5% |
| 2 级 | 3% |
| 3 级及以上 | 0% |
| 上线绑定 | 申请时填 `referrer_code`,自动成为下线 |
| 上线状态 | 必须是 `active`,否则不计嵌套 |
| 防环 | 拒绝自引用 / 循环引用 / 超 2 级范围 |
| 降级 | 下线被封 → 嵌套佣金暂停,恢复后补发 |

### 完整算例(李四推 1 笔 ¥1,999 Pro)

```
李四自己      25% × ¥1,999 = ¥499.75
上线张三(1级)  5% × ¥499.75 = ¥24.99
上上线王芳(2级) 3% × ¥499.75 = ¥14.99
```

---

## 4. 月对账 · T+15

| 日期 | 动作 | 责任 | 产出 |
|---|---|---|---|
| **1 日** | 系统自动出对账单 | 系统 | PDF + HTML + JSON |
| 1-3 日 | 代理在 dashboard 自助确认订单 | 代理 | 确认/异议 |
| 4-7 日 | 平台财务复核(异常 24h 反馈) | 平台 | 复核结论 |
| **8 日** | 出对账单 + 发票 → 双方签字锁定 | 双方 | 锁定版本 |
| 11-14 日 | 财务准备打款 | 平台 | 付款指令 |
| **15 日** | **银行打款(T+15)** | 平台 | 到账 |

**争议期**:收到对账单后 3 个自然日内可提异议,逾期视为确认。

### 月对账 PDF · 22 字段

```
year  month  agent_code  agent_name  rate_label  downline_chain
level_label  bonus_unlocked
ytd_sales_prev  ytd_sales_current
ytd_nested_prev  ytd_nested_current
sales_detail_json
direct_commission  nested_commission  total_commission
withholding_tax  net_payment  exchange_rate
agent_email  agent_whatsapp  agent_bank_info
statement_date  settlement_date
agent_recipient_name  signature  platform_signature
```

**PDF 版式**(A4 单页):
- 顶部:对账单标题 + 结算周期 + 出账日 + 打款日
- 代理信息 / 收款信息 两栏
- **3 个 KPI 大数字**:直接佣金 / 嵌套佣金 / 月总佣金
- YTD 对比表:上月 vs 本月 vs 增量
- 订单明细表:日期 / 客户 / SKU / 原价 / 折扣 / 实付 / 佣金率 / 我的佣金
- 结算明细:直接 + 嵌套 = 总佣金 − 税 = 实付
- 汇率折算(海外代理 USD 结算)
- 三方签字栏 + 平台签名 + 争议期说明

**下载**:
- 每月 1 日邮件推送(默认)
- dashboard 自助下载
- 空白模板:📄 `business/GoldDigger-Monthly-Statement-Template.pdf`

---

## 5. 申请流程(30 秒)

| 步 | 动作 |
|---|---|
| 1 | DiggerChat 输「申请代理」,或邮件 factorihub@outlook.com(主题「代理申请」)|
| 2 | 填 `referrer_code`(可选,填了就是某人的下线)|
| 3 | 平台 1 工作日审核 |
| 4 | 通过 → 4 位码**永久锁定** |
| 5 | 分享 `https://golddigger.gold/textile/?ref=XXXX` |

**0 加盟费 · 0 押金 · 0 月费。**

---

## 6. DiggerChat 关键词速查

| 你问 | 命中 |
|---|---|
| 代理 / 分销 / 加盟 / 渠道 / 合伙人 | 2 级销售总览 |
| 佣金 / 分佣 / 返佣 / 比例 | 佣金简表 |
| 下级 / 下线 / 嵌套 / 2 级 | 嵌套机制 |
| 1 万 / 33% / 达标 / 升级 | ¥10,000 触发规则 |
| 月对账 / T+15 / 结算 / 打款 | 对账流程 |
| **月对账 PDF / 对账单 PDF / 模板** | **PDF 模板 + 22 字段** |
| 4 档 / 月费 / 价格 | 4 档订阅 |

> 全部命中确定性答案,不编数字。
> 验证:`POST /textile/api/chat` `{"message":"月对账 PDF"}` → `source: deterministic`

---

## 7. API 清单

| 方法 | 路径 | 用途 |
|---|---|---|
| POST | `/textile/api/agent/apply` | 申请(含 `referrer_code`)|
| POST | `/textile/api/agent/approve` | 审批 ⚠️ **需加鉴权** |
| GET | `/textile/api/agent/me?referral_code=XXXX` | 查等级 / YTD / 下线 |
| GET | `/textile/api/agent/track/{code}` | 点击追踪 + 7 天 cookie |
| POST | `/textile/api/agent/apply-discount` | 应用 25% 折扣 |
| POST | `/textile/api/chat` | DiggerChat 问答 |

---

## 8. 待办与风险

| 项 | 状态 | 优先级 |
|---|---|---|
| `/api/agent/approve` 加管理员鉴权 | ❌ 未做 | **P0** |
| 推荐链防环 / 深度校验落到 apply | ⚠️ 部分 | **P0** |
| ¥10,000 跨线订单口径(追溯 vs 下一笔)| ⚠️ 未拍板 | P0 |
| 嵌套佣金在线原子写入 | ⚠️ 离线脚本重算 | P1 |
| 月对账 PDF 自动生成 + 邮件推送 | ✅ 渲染器已就绪,未接 cron | P1 |
| 代理测试数据清理(6799/1983/6944)| ❌ 污染生产 | P1 |
| flat JSON → SQLite(>30 代理)| ❌ 未迁 | P2 |
| 法务 / 税务 / 支付合规复核 | ❌ 未做 | **P0** |

---

## 附:公网文件

| 文件 | 路径 |
|---|---|
| 本文档 | `/textile/business/MARKETING_SYSTEM_INTRO.md` |
| 空白对账 PDF 模板 | `/textile/business/GoldDigger-Monthly-Statement-Template.pdf` |
| 对账模板说明 | `/textile/business/STATEMENT_TEMPLATE.md` |
| 销售合伙人说明书 | `/textile/business/SALES_PARTNER_GUIDE.md` |
| 内部商业方案 | `/textile/business/DISTRIBUTION_PLAN.md` |
| 客户友好版 | `/textile/business/MARKETING_INTRO.md` |
| PDF 生成器源码 | `/textile/business/gen_statement_pdf.py` |