85 lines
5.6 KiB
Markdown
85 lines
5.6 KiB
Markdown
# 应用市场商业化流程（Discuz! 式插件/模板售卖闭环）
|
||
|
||
> 业务模型：**框架免费，靠卖插件/模板变现**。
|
||
> 中心站（market）承载商品/交易/授权，客户机（client）拉取并受授权闸门约束。
|
||
|
||
## 一、总体流程图
|
||
|
||
```
|
||
开发者提交 ──▶ 审核 ──▶ 上架 ──▶ 浏览详情 ──▶ 前台购买 ──▶ 支付 ──▶ 回调出授权
|
||
│ │ │ │ │ │ │
|
||
Market::submit 后台审核 catalog() Store::detail Store::buy Yansongda completeOrder()
|
||
│ │ │ │ │ │ │ → 写 license_key
|
||
│ │ │ │ │ │ │ → 写分润/开发者余额
|
||
└────────────┴─────────┴───────────┴────────────┴──────────┴───────────┴──▶ 下载安装(绑定域名)
|
||
│
|
||
Market::valid / index
|
||
│
|
||
启用闸门(运行期校验)
|
||
│
|
||
AddonService::verifyRuntimeLicense
|
||
│
|
||
AddonService::checkLicenses (crontab)
|
||
│
|
||
过期/吊销 → 自动禁用
|
||
│
|
||
分润提现 Withdrawal 模型
|
||
```
|
||
|
||
## 二、各阶段落地清单
|
||
|
||
| 阶段 | 状态 | 关键代码 | 说明 |
|
||
|------|------|----------|------|
|
||
| 1. 开发者提交 | ✅ | `Market::submit` | 支持 addon / template 两种类型，含安全扫描 |
|
||
| 2. 审核 / 上架 | ✅ | 后台审核 + `MarketService::catalog()` | 通过后才进 `catalog()` 列表 |
|
||
| 3. 浏览详情 | ✅ | `Store::detail` + `view/frontend/store/detail.html` | 价格/截图/版本/授权说明 |
|
||
| 4. 前台购买下单 | ✅ | `Store::buy`（POST `/appmall/store/buy`） | 取会员 uid；中心站直连 `MarketService::buy`，客户机经 `RemoteService::buy` |
|
||
| 5. 支付 | ✅ | `MarketService::buy` 内 `Yansongda\Pay`；`Market::notify` / `payResult` | 返回 `pay_params`（web 表单）前端 `window.open` 拉起收银台 |
|
||
| 6. 回调出授权 | ✅ | `MarketService::completeOrder` | 支付成功生成 `license_key`（HMAC 签名）+ 写分润/开发者余额 |
|
||
| 7. 订单轮询 | ✅ | `Store::orderStatus`（GET `/appmall/store/orderStatus`） | 前端拉起收银台后轮询，拿到 `license_key` |
|
||
| 8. 下载安装 + 域名绑定 | ✅ | `Market::index`（下载）/ `Market::valid`（安装时校验绑定域名） | 校验：免费→uid→存在→吊销→过期→域名绑定 |
|
||
| 9. 启用闸门 | ✅ | `AddonService::enable` → `verifyRuntimeLicense` | POST 中心站 `validDomain`；失败抛 `AddonException`（除非 `offline_tolerant`） |
|
||
| 10. 运行期过期巡检 | ✅ | `AddonService::checkLicenses` + `addon:license-check` 命令 | crontab 每日巡检，过期落库禁用 |
|
||
| 11. 分润 / 提现 | ✅ | `Withdrawal` 模型 + 收益后台 | 开发者余额可提现 |
|
||
|
||
## 三、配置开关
|
||
|
||
`config/ywxapp.php`：
|
||
- `market_mode` / `api_url`：决定中心站 or 客户机。客户机（`is_market_client()===true`）才启用授权校验。
|
||
- `addon_license_check`：`false`（关闭校验）/ `true`（中心站不可达也禁用）/ `'offline_tolerant'`（不可达放行，仅真实过期拒绝禁用）。
|
||
|
||
## 四、前端购买链路（detail.html）
|
||
|
||
```
|
||
点击「立即购买」
|
||
→ POST /appmall/store/buy {name}
|
||
← code=1, license_key → 提示已购，引导后台安装绑定域名
|
||
← code=1, trade_no+pay_params → window.open 收银台 + 轮询 orderStatus
|
||
← code=1, trade_no(无pay_params, mock) → 演示确认 → 轮询
|
||
← code=0, need_login → 跳 /member/login
|
||
```
|
||
|
||
## 五、部署清单
|
||
|
||
**中心站需同步**：`addon/appmall/`（Store 控制器 + route/app.php + view/frontend/store/detail.html）、`config/pay.php`（Yansongda 配置）。
|
||
|
||
**客户机需同步**：
|
||
- `ywxapp/service/AddonService.php`（`verifyRuntimeLicense` + `checkLicenses`）
|
||
- `ywxapp/service/AppService.php`（`addon:license-check` 注册）
|
||
- `ywxapp/command/AddonLicenseCheck.php`
|
||
- `config/ywxapp.php`（`addon_license_check`）
|
||
|
||
**定时巡检（客户机）**：
|
||
```
|
||
10 3 * * * cd /path/to/site && php think addon:license-check >> runtime/license_check.log 2>&1
|
||
```
|
||
|
||
## 六、待办（真实支付与增长）
|
||
|
||
1. 真实支付：当前 `pay_params` 来自 `Yansongda\Pay`（中心站 `config/pay.php`），mqpay 免签插件未参与此链路；如需接 mqpay 收银台需另接。
|
||
2. 域名绑定可视化：安装时填写域名并校验的 UI 提示。
|
||
3. 运营增长：优惠券/分销、开发者实名结算、SEO 内容填充。
|
||
|
||
---
|
||
*参考：`docs/自定义命令清单.md`（`addon:license-check`）、`docs/系统架构与解耦设计.md`。*
|