docs/COMMERCIALIZATION.md

# 商业化说明（Production）

最后更新：`2026-04-18`

## 1. 定位

PolyWeather 是面向温度结算场景的气象决策层，不是通用天气应用。

核心价值：

- 观测优先（METAR / 机场主站 / 明确官方站点；MGM、NMC、JMA、AMOS 等作为增强层）
- 结算导向（DEB + 校准概率桶）
- 气象判断优先（证据链、失效条件、下一观测点）
- 市场映射（行情对照 + 错价雷达），但不把交易建议放在第一层产品承诺

## 2. 当前收费能力状态

| 能力 | 状态 | 备注 |
| :-- | :-- | :-- |
| 登录注册（Google + 邮箱） | 已上线 | Supabase 鉴权 |
| 订阅套餐（Pro 月付） | 已上线 | `10 USDC / 30天` |
| 积分抵扣 | 已上线 | `500分=1U`，最多 `3U` |
| 合约支付 | 已上线 | Polygon，USDC + USDC.e |
| 支付自动确认 | 已上线 | Event Loop + Confirm Loop |
| 钱包绑定 | 已上线 | 浏览器钱包 + WalletConnect |
| 私有频道推送 | 已上线 | 可拆分业务频道 |

## 3. 权限模型（当前）

- 游客：可查看基础看板与简版信息。
- 登录用户：账户中心、钱包绑定、积分同步。
- Pro 用户：
  - 今日日内深度分析（含高温时段）
  - 专业气象结论条、证据链、失效条件、确认条件
  - 概率分布层（基于 DEB 融合 + 高斯分桶）
  - 历史对账 + 未来日期分析
  - 全平台智能气象推送

## 4. 收费与积分规则（默认）

- 套餐：`pro_monthly`（10 USDC / 30 天）
- 抵扣：500 积分抵 1 USDC，最高抵 3 USDC
- 实付下限：2 USDC（当积分满额时）

> 说明：具体运营策略可按阶段调整，生产参数建议放私有仓库。

## 5. 许可证与商用边界

当前仓库代码采用 `AGPL-3.0-only`：

- 公开：基础能力与通用支付流程源码。
- 不随代码许可证授权：商业风控、营销策略、关键运营参数、内部审计策略、品牌与托管服务资产。

详见：[AGPL-3.0 与商用边界](OPEN_CORE_POLICY.md)

## 6. 上线检查清单（收费前）

1. 支付链路：创建 intent、提交 tx、确认入账、订阅开通全链路可回放。
2. 权限链路：前端/后端/Bot 对 Pro 权限判定一致。
3. 审计能力：支付日志、订阅变更、异常重试可追溯。
4. 通知策略：支付成功私发、群内通知降噪。
5. 安全边界：敏感配置不进仓库。
6. 数据口径：机场市场按 METAR / 机场主站解释；Wunderground 只可描述为历史页面或参考入口，不描述成“站”。
7. 加载口径：日内分析和右侧详情在 full detail 未补齐前必须显示同步状态，不能把旧缓存伪装成完整付费内容。

## 7. 后续路线

- 支持更多链和稳定币。
- 引入退款与工单后台。
- 建立周/月留存与付费转化看板。
- 打通渠道分销与邀请码返利系统。
-											feat: Introduce open-core policy, commercialization, and payment verification documentation, and update README with new product status, payment architecture, and documentation index.
										
										
											2026-03-14 10:53:53 +08:00
+								# 商业化说明（Production）
-											feat: Introduce PolyWeather Pro commercialization, update project documentation, and add Telegram push utility.
										
										
											2026-03-06 19:16:48 +08:00
-											Use existing loading state for sparse detail
										
										
											2026-04-18 14:40:29 +08:00
+								最后更新：`2026-04-18`
-											feat: Introduce PolyWeather Pro commercialization, update project documentation, and add Telegram push utility.
										
										
											2026-03-06 19:16:48 +08:00
-											feat: Introduce open-core policy, commercialization, and payment verification documentation, and update README with new product status, payment architecture, and documentation index.
										
										
											2026-03-14 10:53:53 +08:00
+								## 1. 定位
-											feat: Introduce PolyWeather Pro commercialization, update project documentation, and add Telegram push utility.
										
										
											2026-03-06 19:16:48 +08:00
-											feat: Introduce open-core policy, commercialization, and payment verification documentation, and update README with new product status, payment architecture, and documentation index.
										
										
											2026-03-14 10:53:53 +08:00
+								PolyWeather 是面向温度结算场景的气象决策层，不是通用天气应用。
-											feat: Introduce PolyWeather Pro commercialization, update project documentation, and add Telegram push utility.
										
										
											2026-03-06 19:16:48 +08:00
-											feat: Introduce open-core policy, commercialization, and payment verification documentation, and update README with new product status, payment architecture, and documentation index.
										
										
											2026-03-14 10:53:53 +08:00
+								核心价值：
-											docs: Add comprehensive documentation for commercialization and technical debt, and streamline the main README.
										
										
											2026-03-11 11:18:48 +08:00
-											更新文档：KMA→AMOS、积分来源补全、信心指标移除、缓存 TTL 修正
										
										
											2026-05-11 17:56:45 +08:00
+								- 观测优先（METAR / 机场主站 / 明确官方站点；MGM、NMC、JMA、AMOS 等作为增强层）
-											Use existing loading state for sparse detail
										
										
											2026-04-18 14:40:29 +08:00
+								- 结算导向（DEB + 校准概率桶）
 								- 气象判断优先（证据链、失效条件、下一观测点）
 								- 市场映射（行情对照 + 错价雷达），但不把交易建议放在第一层产品承诺
-											docs: Add comprehensive documentation for commercialization and technical debt, and streamline the main README.
										
										
											2026-03-11 11:18:48 +08:00
-											feat: Introduce open-core policy, commercialization, and payment verification documentation, and update README with new product status, payment architecture, and documentation index.
										
										
											2026-03-14 10:53:53 +08:00
+								## 2. 当前收费能力状态
-											docs: Add comprehensive documentation for commercialization and technical debt, and streamline the main README.
										
										
											2026-03-11 11:18:48 +08:00
-											feat: Introduce open-core policy, commercialization, and payment verification documentation, and update README with new product status, payment architecture, and documentation index.
										
										
											2026-03-14 10:53:53 +08:00
+								| 能力 | 状态 | 备注 |
-											docs: Add commercialization, technical debt, and frontend documentation, and update project READMEs.
										
										
											2026-03-12 12:01:29 +08:00
+								| :-- | :-- | :-- |
-											feat: Introduce open-core policy, commercialization, and payment verification documentation, and update README with new product status, payment architecture, and documentation index.
										
										
											2026-03-14 10:53:53 +08:00
+								| 登录注册（Google + 邮箱） | 已上线 | Supabase 鉴权 |
-											Unify subscription pricing to 10 USDC, update documentation, and improve manual payment address copy experience
										
										
											2026-05-20 09:20:07 +08:00
+								| 订阅套餐（Pro 月付） | 已上线 | `10 USDC / 30天` |
-											feat: Introduce open-core policy, commercialization, and payment verification documentation, and update README with new product status, payment architecture, and documentation index.
										
										
											2026-03-14 10:53:53 +08:00
+								| 积分抵扣 | 已上线 | `500分=1U`，最多 `3U` |
 								| 合约支付 | 已上线 | Polygon，USDC + USDC.e |
 								| 支付自动确认 | 已上线 | Event Loop + Confirm Loop |
 								| 钱包绑定 | 已上线 | 浏览器钱包 + WalletConnect |
 								| 私有频道推送 | 已上线 | 可拆分业务频道 |
-											docs: Add comprehensive documentation for commercialization and technical debt, and streamline the main README.
										
										
											2026-03-11 11:18:48 +08:00
-											feat: Introduce open-core policy, commercialization, and payment verification documentation, and update README with new product status, payment architecture, and documentation index.
										
										
											2026-03-14 10:53:53 +08:00
+								## 3. 权限模型（当前）
-											docs: Add comprehensive documentation for commercialization and technical debt, and streamline the main README.
										
										
											2026-03-11 11:18:48 +08:00
-											feat: Introduce open-core policy, commercialization, and payment verification documentation, and update README with new product status, payment architecture, and documentation index.
										
										
											2026-03-14 10:53:53 +08:00
+								- 游客：可查看基础看板与简版信息。
 								- 登录用户：账户中心、钱包绑定、积分同步。
 								- Pro 用户：
 								  - 今日日内深度分析（含高温时段）
-											Use existing loading state for sparse detail
										
										
											2026-04-18 14:40:29 +08:00
+								  - 专业气象结论条、证据链、失效条件、确认条件
-											整理文档：删除 4 个已废弃 EMOS/LGBM 文档，更新 8 个引用了已删除功能的其他文档
										
										
											2026-05-19 14:53:37 +08:00
+								  - 概率分布层（基于 DEB 融合 + 高斯分桶）
-											feat: Introduce open-core policy, commercialization, and payment verification documentation, and update README with new product status, payment architecture, and documentation index.
										
										
											2026-03-14 10:53:53 +08:00
+								  - 历史对账 + 未来日期分析
 								  - 全平台智能气象推送
-											docs: Add comprehensive documentation for commercialization and technical debt, and streamline the main README.
										
										
											2026-03-11 11:18:48 +08:00
-											feat: Introduce open-core policy, commercialization, and payment verification documentation, and update README with new product status, payment architecture, and documentation index.
										
										
											2026-03-14 10:53:53 +08:00
+								## 4. 收费与积分规则（默认）
-											docs: Add comprehensive documentation for commercialization and technical debt, and streamline the main README.
										
										
											2026-03-11 11:18:48 +08:00
-											Unify subscription pricing to 10 USDC, update documentation, and improve manual payment address copy experience
										
										
											2026-05-20 09:20:07 +08:00
+								- 套餐：`pro_monthly`（10 USDC / 30 天）
-											feat: Introduce open-core policy, commercialization, and payment verification documentation, and update README with new product status, payment architecture, and documentation index.
										
										
											2026-03-14 10:53:53 +08:00
+								- 抵扣：500 积分抵 1 USDC，最高抵 3 USDC
 								- 实付下限：2 USDC（当积分满额时）
-											docs: Add commercialization, technical debt, and frontend documentation, and update project READMEs.
										
										
											2026-03-12 12:01:29 +08:00
-											feat: Introduce open-core policy, commercialization, and payment verification documentation, and update README with new product status, payment architecture, and documentation index.
										
										
											2026-03-14 10:53:53 +08:00
+								> 说明：具体运营策略可按阶段调整，生产参数建议放私有仓库。
-											docs: Add commercialization, technical debt, and frontend documentation, and update project READMEs.
										
										
											2026-03-12 12:01:29 +08:00
-											Switch repository licensing to AGPL-3.0
										
										
											2026-03-30 00:46:01 +08:00
+								## 5. 许可证与商用边界
-											docs: Add commercialization, technical debt, and frontend documentation, and update project READMEs.
										
										
											2026-03-12 12:01:29 +08:00
-											Switch repository licensing to AGPL-3.0
										
										
											2026-03-30 00:46:01 +08:00
+								当前仓库代码采用 `AGPL-3.0-only`：
-											docs: Add comprehensive documentation for commercialization and technical debt, and streamline the main README.
										
										
											2026-03-11 11:18:48 +08:00
-											Switch repository licensing to AGPL-3.0
										
										
											2026-03-30 00:46:01 +08:00
+								- 公开：基础能力与通用支付流程源码。
 								- 不随代码许可证授权：商业风控、营销策略、关键运营参数、内部审计策略、品牌与托管服务资产。
-											feat: introduce PolyWeather web map API and frontend with integrated weather data collection and analysis.
										
										
											2026-03-09 04:41:24 +08:00
-											Switch repository licensing to AGPL-3.0
										
										
											2026-03-30 00:46:01 +08:00
+								详见：[AGPL-3.0 与商用边界](OPEN_CORE_POLICY.md)
-											feat: Introduce PolyWeather Pro commercialization, update project documentation, and add Telegram push utility.
										
										
											2026-03-06 19:16:48 +08:00
-											feat: Introduce open-core policy, commercialization, and payment verification documentation, and update README with new product status, payment architecture, and documentation index.
										
										
											2026-03-14 10:53:53 +08:00
+								## 6. 上线检查清单（收费前）
-											feat: Introduce PolyWeather Pro commercialization, update project documentation, and add Telegram push utility.
										
										
											2026-03-06 19:16:48 +08:00
-											feat: Introduce open-core policy, commercialization, and payment verification documentation, and update README with new product status, payment architecture, and documentation index.
										
										
											2026-03-14 10:53:53 +08:00
+. 支付链路：创建 intent、提交 tx、确认入账、订阅开通全链路可回放。
 . 权限链路：前端/后端/Bot 对 Pro 权限判定一致。
 . 审计能力：支付日志、订阅变更、异常重试可追溯。
 . 通知策略：支付成功私发、群内通知降噪。
 . 安全边界：敏感配置不进仓库。
-											Use existing loading state for sparse detail
										
										
											2026-04-18 14:40:29 +08:00
+. 数据口径：机场市场按 METAR / 机场主站解释；Wunderground 只可描述为历史页面或参考入口，不描述成“站”。
 . 加载口径：日内分析和右侧详情在 full detail 未补齐前必须显示同步状态，不能把旧缓存伪装成完整付费内容。
-											feat: Introduce PolyWeather Pro commercialization, update project documentation, and add Telegram push utility.
										
										
											2026-03-06 19:16:48 +08:00
-											feat: Introduce open-core policy, commercialization, and payment verification documentation, and update README with new product status, payment architecture, and documentation index.
										
										
											2026-03-14 10:53:53 +08:00
+								## 7. 后续路线
-											feat: Introduce PolyWeather Pro commercialization, update project documentation, and add Telegram push utility.
										
										
											2026-03-06 19:16:48 +08:00
-											feat: Introduce open-core policy, commercialization, and payment verification documentation, and update README with new product status, payment architecture, and documentation index.
										
										
											2026-03-14 10:53:53 +08:00
+								- 支持更多链和稳定币。
 								- 引入退款与工单后台。
 								- 建立周/月留存与付费转化看板。
 								- 打通渠道分销与邀请码返利系统。