feat: 落地打赏(个人码捐赠)模式并将付费面改为免费+赞助(无ICP证合规)
- 新增 Donation 模型/迁移/后端 API(GET,POST /donations) - 新增前端 /donate 页:收款码+感谢留言+感谢墙 - 会员页/技能广场/用量包 下架付费,改免费开放+赞助入口 - 沙箱用量耗尽引导至 /donate 赞助 - 导航与页脚新增 赞助/联盟返佣 入口,补充 i18n
This commit is contained in:
TradeMate Dev
@@ -1,17 +1,17 @@
|
||||
# 宇之然 AI 平台 - 进度追踪
|
||||
|
||||
**文档版本:** v1.1.0
|
||||
**文档版本:** v1.2.0
|
||||
**最后更新:** 2026-07-11
|
||||
**状态:** 🟢 联盟返佣系统核心已完成（管理后台 UI 待补）
|
||||
**状态:** 🟢 联盟返佣 + 打赏（个人码捐赠）双变现模式已落地；付费订阅/付费 Skill/用量包已下线
|
||||
**负责人:** Hermes Agent
|
||||
|
||||
---
|
||||
|
||||
## 项目概览
|
||||
|
||||
- **目标:** 构建联盟返佣系统，并将「技能广场」与推广链接打通，作为当前（无 ICP 经营许可证前）合规的主力变现路径
|
||||
- **合规定位:** 会员付费/付费 Skill 属经营性收费，需 ICP 经营许可证。在取证前，以**联盟返佣**（第三方平台结算佣金，非平台经营性收款）为主力变现，配合免费内容 + SEO
|
||||
- **范围:** 数据库模型（规范化）、后端 API（ORM，去 SQL 注入）、前端展示与点击追踪、单元测试、种子数据
|
||||
- **目标:** 在「无 ICP 经营许可证」阶段，将全部经营性收费（会员订阅、付费 Skill、沙箱用量包）下架，改为合规的「打赏（个人码捐赠）+ 联盟返佣」模式
|
||||
- **合规定位:** 会员付费/付费 Skill/虚拟商品属经营性收费，需 ICP 经营许可证。在取证前：以**联盟返佣**（第三方平台结算佣金，非平台经营性收款）为主力变现；以**打赏/捐赠**（个人收款码，自愿赠与，平台不提供对价）作为补充；所有内容（技能、练习、工具指南）保持免费开放
|
||||
- **范围:** 打赏数据模型与 API、前端 /donate 页、会员/技能广场/用量包三处付费面改造为免费+赞助、导航与页脚入口、单元测试、种子数据
|
||||
|
||||
---
|
||||
|
||||
@@ -28,23 +28,44 @@
|
||||
| 测试 | `affiliate.service.spec.ts` | 4 个用例（聚合/点击/异常/过滤），已通过 |
|
||||
| 种子 | `prisma/seed-affiliate.ts` | 幂等 upsert 阿里云云大使计划 + 推广链接；`npx ts-node prisma/seed-affiliate.ts` |
|
||||
|
||||
### 打赏（个人码捐赠）模式 — v1.2.0
|
||||
|
||||
| 模块 | 内容 | 说明 |
|
||||
|------|------|------|
|
||||
| 数据模型 | `Donation` | Prisma 模型（`name`/`message`/`channel`/`amount`/`createdAt`），仅用于「感谢墙」展示，不记录支付流水 |
|
||||
| 迁移 | `prisma/migrations/20260711010000_add_donations` | 建 `donations` 表；部署时 `prisma migrate deploy` |
|
||||
| 后端服务 | `donations.service.ts` | `getList(limit)` 最近留言、`create(dto)` 保存自愿留言 |
|
||||
| 后端接口 | `donations.controller.ts` | `GET /donations`、`POST /donations`（公开，无鉴权） |
|
||||
| 前端页 | `donate/page.tsx` | 个人收款码（支付宝/微信，环境变量 `NEXT_PUBLIC_DONATE_ALIPAY_QR`/`NEXT_PUBLIC_DONATE_WECHAT_QR`）+ 感谢留言表单 + 感谢墙 |
|
||||
| 会员页 | `my/member/page.tsx` | 移除付费订阅与 PaymentModal，改为免费说明 + 赞助/联盟入口 |
|
||||
| 技能广场 | `marketplace/page.tsx` | 所有 Skill 免费开放，下架付费购买与 PaymentModal |
|
||||
| 用量包 | `practices/packages/page.tsx` | 下架付费用量包，仅展示免费配额 + 赞助入口 |
|
||||
| 沙箱 | `sandbox/page.tsx` | 用量耗尽提示改为引导至 /donate 赞助 |
|
||||
| 导航/页脚 | `header.tsx` / `footer.tsx` | 新增「赞助」「联盟返佣」入口 |
|
||||
| i18n | `zh.ts` / `en.ts` | 新增 `donate.*`、导航 `affiliate`/`donate`、说明文案 |
|
||||
|
||||
> **说明：** 后端 `orders` / `payment` 模块代码保留（取证后可复用），但前端已不再调用付费购买流程。
|
||||
|
||||
---
|
||||
|
||||
## 待办（下一阶段）
|
||||
|
||||
| 任务 | 说明 |
|
||||
|------|------|
|
||||
| 部署配置 | 在部署环境设置支付宝/微信收款码环境变量（`NEXT_PUBLIC_DONATE_*_QR`） |
|
||||
| 管理后台 UI | AffiliateProgram/Link 的列表与编辑页（T-009~T-013） |
|
||||
| 首页/工具页嵌入 | 在首页与工具详情侧边栏插入「云产品推荐」区块（T-016/T-017） |
|
||||
| 曝光埋点 | 记录推广位曝光（目前仅记录点击） |
|
||||
| 后端捐赠单测 | 为 `donations.service.spec.ts` 补充用例（mock Prisma） |
|
||||
|
||||
---
|
||||
|
||||
## 变现模式排序（无 ICP 证阶段）
|
||||
|
||||
1. **联盟返佣**（已落地）— 风险最低，第三方结算佣金
|
||||
2. 免费内容 + SEO 引流
|
||||
3. （取证后）会员订阅 / 付费 Skill / 企业版
|
||||
2. **打赏/个人码捐赠**（已落地）— 自愿赠与，平台不提供对价，不构成经营性收费
|
||||
3. 免费内容 + SEO 引流
|
||||
4. （取证后）会员订阅 / 付费 Skill / 企业版
|
||||
|
||||
---
|
||||
|
||||
@@ -54,3 +75,4 @@
|
||||
|------|------|------|----------|
|
||||
| 2026-06-25 | v1.0.0 | Hermes Agent | 初始化进度文档 |
|
||||
| 2026-07-11 | v1.1.0 | Hermes Agent | 规范化联盟数据模型+迁移+ORM服务+前端打通+测试+种子；明确无 ICP 证下的合规变现路径 |
|
||||
| 2026-07-11 | v1.2.0 | Hermes Agent | 落地打赏（个人码捐赠）模式：Donation 模型+迁移+API+前端 /donate 页；会员/技能广场/用量包三处付费面改造为免费+赞助；导航页脚入口；i18n 中文化 |
|
||||
|
||||
Reference in New Issue
Block a user