← 业务文档目录
市场推广系统介绍
Marketing System Introduction · GoldDigger 销售合伙人系统
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 段话术 │
└──────────────┬───────────────────────────────────────┘
│
┌──────────────▼───────────────────────────────────────┐
│ 追踪与分配 │
│ · 4 位自动分配码(永久锁定) │
│ · GET /api/agent/track/{code} 写 cookie(7 天) │
│ · POST /api/agent/apply 绑定上线 │
│ · 防环:自引用 / 循环 / 超 2 级范围 │
└──────────────┬───────────────────────────────────────┘
│
┌──────────────▼───────────────────────────────────────┐
│ 结算与对账 │
│ · POST /api/agent/apply-discount 客户 25% 折扣 │
│ · 直接佣金 25% → 达标 33% │
│ · 嵌套佣金 1 级 5% / 2 级 3% │
│ · 每月 1 日出账 → 15 日 T+15 打款 │
│ · 月对账 PDF(22 字段 A4 单页) │
└──────────────────────────────────────────────────────┘
2. 佣金结构 · 2 级销售
| 角色 | 门槛 | 客户折扣 | 佣金 | 额外权益 |
| L1 销售合伙人 | 申请即得 | 25% | 25% | 4 位码终身锁定 |
| L1+ 达标合伙人 | 累计销售 ≥ ¥10,000 | 25%(不变) | 33% | 25% 基础 + 8% 奖励,永久不降 |
| 上 1 级 | 下线申请时填推荐码自动绑定 | — | 直接佣金的 5% | 被动收入 |
| 上 2 级 | 同上 | — | 直接佣金的 3% | 被动收入 |
3 级及以上不再分配上线佣金(0%)。跨线订单按 25%,下一笔开始 33%(不追溯)。
2 级上线佣金 · 完整条款
| 项 | 条款 |
| 上 1 级费率 | 直接佣金的 5% |
| 上 2 级费率 | 直接佣金的 3% |
| 3 级及以上 | 0%(不再往上分配) |
| 嵌套基数 | 下线的实际佣金,不是订单额 |
| 绑定方式 | 代理申请时填推荐码 referrer_code,自动绑定上线 |
| 防环 | 自引用 / 循环引用 / 超 2 级范围一律拒绝 |
| 写入时机 | 销售发生时在线写入,不依赖离线重算 |
| 4 位码 | 审批通过后终身锁定,介绍下线自动绑定 |
上线佣金与直接佣金同时结算,合并进同一张月对账单。
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 |