feat: Introduce open-core policy, commercialization, and payment verification documentation, and update README with new product status, payment architecture, and documentation index.

docs/SUPABASE_SETUP_ZH.md

@@ -1,28 +1,30 @@
-# Supabase + Google 登录 + 合约支付接入说明（P1）
+# Supabase + 登录 + 支付接入说明（v1.4）
+
+最后更新：`2026-03-14`
 
 ## 1. 目标
 
-- 前端支持 `Google 一键登录`（优先）与 `邮箱注册/登录`（并列）。
-- 后端 API 支持 Supabase JWT 鉴权。
-- entitlement 检查可选：仅登录放行，或要求有效订阅。
+- 前端支持 Google 一键登录 + 邮箱注册/登录。
+- 后端支持 Supabase JWT 鉴权。
+- 支持 Polygon 合约支付（USDC / USDC.e）并自动确认开通订阅。
 
 ## 2. Supabase 控制台配置
 
-1. Auth -> Providers -> 打开 `Google`。
-2. Auth -> Providers -> `Email` 保持开启。
-3. 在 Google Cloud Console 配置 OAuth 回调地址：
-   - `https://<your-project-ref>.supabase.co/auth/v1/callback`
-4. 在 Auth -> URL Configuration 添加站点 URL（你的前端域名）。
+1. `Auth -> Providers` 打开 `Google` 与 `Email`。
+2. Google Cloud OAuth 回调配置：
+   - `https://<project-ref>.supabase.co/auth/v1/callback`
+3. `Auth -> URL Configuration` 添加：
+   - 站点 URL（生产域名）
+   - 回调 URL（例如 `https://polyweather-pro.vercel.app/auth/callback`）
 
-## 3. 执行数据库脚本
+## 3. 数据库脚本
 
-在 Supabase SQL Editor 运行：
+在 Supabase SQL Editor 执行：
 
 - `scripts/supabase/schema.sql`
 
-该脚本会创建：
+会创建支付与订阅相关表：
 
-- `profiles`
 - `subscriptions`
 - `payments`
 - `entitlement_events`
@@ -31,8 +33,6 @@
 - `payment_intents`
 - `payment_transactions`
 
-并建立 `auth.users -> profiles` 同步触发器。
-
 ## 4. 环境变量
 
 ### 4.1 前端（Vercel / frontend/.env.local）
@@ -41,86 +41,82 @@
 NEXT_PUBLIC_SUPABASE_URL=
 NEXT_PUBLIC_SUPABASE_ANON_KEY=
 POLYWEATHER_AUTH_ENABLED=true
-# true: 强制登录；false: 游客可用（可选登录）
 POLYWEATHER_AUTH_REQUIRED=false
 POLYWEATHER_API_BASE_URL=http://<backend-host>:8000
 POLYWEATHER_BACKEND_ENTITLEMENT_TOKEN=
+
+# WalletConnect（支持手机钱包扫码）
+NEXT_PUBLIC_WALLETCONNECT_PROJECT_ID=
+NEXT_PUBLIC_WALLETCONNECT_POLYGON_RPC_URL=https://polygon-bor-rpc.publicnode.com
+
+# Overlay 跳转
+NEXT_PUBLIC_TELEGRAM_GROUP_URL=https://t.me/<your_group>
 ```
 
 ### 4.2 后端 / Bot（.env）
 
 ```env
 POLYWEATHER_AUTH_ENABLED=true
-# true: 后端 API 强制鉴权；false: 游客可访问，若带会话则自动识别用户
 POLYWEATHER_AUTH_REQUIRED=false
 POLYWEATHER_AUTH_REQUIRE_SUBSCRIPTION=false
+
 SUPABASE_URL=
 SUPABASE_ANON_KEY=
 SUPABASE_SERVICE_ROLE_KEY=
 SUPABASE_HTTP_TIMEOUT_SEC=8
-SUPABASE_AUTH_CACHE_TTL_SEC=30
-SUPABASE_SUB_CACHE_TTL_SEC=60
 
-# P1 合约支付（MetaMask + Polygon USDC）
 POLYWEATHER_PAYMENT_ENABLED=true
 POLYWEATHER_PAYMENT_CHAIN_ID=137
-POLYWEATHER_PAYMENT_RPC_URL=https://polygon-rpc.com
-POLYWEATHER_PAYMENT_RECEIVER_CONTRACT=0x<your_payment_contract>
-POLYWEATHER_PAYMENT_TOKEN_ADDRESS=0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174
-POLYWEATHER_PAYMENT_TOKEN_DECIMALS=6
+POLYWEATHER_PAYMENT_RPC_URL=https://polygon-bor-rpc.publicnode.com
+POLYWEATHER_PAYMENT_RECEIVER_CONTRACT=0x<receiver_contract>
 POLYWEATHER_PAYMENT_CONFIRMATIONS=2
 POLYWEATHER_PAYMENT_INTENT_TTL_SEC=1800
 POLYWEATHER_PAYMENT_WALLET_CHALLENGE_TTL_SEC=600
-POLYWEATHER_PAYMENT_HTTP_TIMEOUT_SEC=10
 POLYWEATHER_PAYMENT_POLL_INTERVAL_SEC=4
 POLYWEATHER_PAYMENT_MAX_WAIT_SEC=50
-POLYWEATHER_PAYMENT_TELEGRAM_NOTIFY_ENABLED=true
-# 支付积分抵扣（500 积分 = 1 USDC，最高抵扣 3 USDC）
+
+# 支持双币种（示例）
+POLYWEATHER_PAYMENT_ACCEPTED_TOKENS_JSON=[{"code":"usdc_e","symbol":"USDC.e","name":"USDC.e (PoS)","address":"0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174","decimals":6,"receiver_contract":"0x<receiver>","is_default":true},{"code":"usdc","symbol":"USDC","name":"Native USDC","address":"0x3c499c542cef5e3811e1192ce70d8cc03d5c3359","decimals":6,"receiver_contract":"0x<receiver>"}]
+
+# 套餐（当前只保留月付）
+POLYWEATHER_PAYMENT_PLAN_CATALOG_JSON={"pro_monthly":{"plan_id":101,"amount_usdc":"5","duration_days":30}}
+POLYWEATHER_PAYMENT_ALLOWED_PLAN_CODES=pro_monthly
+
+# 积分抵扣
 POLYWEATHER_PAYMENT_POINTS_ENABLED=true
 POLYWEATHER_PAYMENT_POINTS_PER_USDC=500
 POLYWEATHER_PAYMENT_POINTS_MAX_DISCOUNT_USDC=3
-# JSON 示例:
-# {"pro_monthly":{"plan_id":101,"amount_usdc":"5","duration_days":30}}
-POLYWEATHER_PAYMENT_PLAN_CATALOG_JSON=
+
+# 支付自动补单
+POLYWEATHER_PAYMENT_EVENT_LOOP_ENABLED=true
+POLYWEATHER_PAYMENT_CONFIRM_LOOP_ENABLED=true
 ```
 
-可选（Bot 也走 Supabase 订阅）：
+## 5. 钱包异动频道拆分（推荐）
+
+如果要把“钱包异动监控”发到独立频道：
 
 ```env
-POLYWEATHER_BOT_REQUIRE_ENTITLEMENT=true
-POLYWEATHER_BOT_USE_SUPABASE_ENTITLEMENT=true
+POLYMARKET_WALLET_ACTIVITY_CHAT_ID=-1003821482461
 ```
 
-## 5. entitlement 策略
+说明：
 
-- `POLYWEATHER_AUTH_ENABLED=true`：启用 Supabase 登录能力（Google/邮箱）。
-- `POLYWEATHER_AUTH_REQUIRED=true`：网站与后端 API 强制登录。
-- `POLYWEATHER_AUTH_REQUIRED=false`：游客可访问全部功能，用户可主动登录。
-- `POLYWEATHER_AUTH_REQUIRE_SUBSCRIPTION=true`：在强制鉴权模式下，额外要求 `subscriptions` 表里存在有效 `active` 记录。
+- 设置了 `POLYMARKET_WALLET_ACTIVITY_CHAT_ID(S)` 后，钱包异动推送优先发该频道。
+- 未设置时，回退到全局 `TELEGRAM_CHAT_IDS/TELEGRAM_CHAT_ID`。
 
-## 6. 验证
+## 6. 验证步骤
 
-1. 访问 `/auth/login`，测试 Google 一键登录。
-2. `POLYWEATHER_AUTH_REQUIRED=false` 时，未登录访问首页与 `/api/cities` 应返回 200。
-3. 登录后访问 `/api/auth/me`，应返回 `authenticated=true` 与 `user_id`。
-4. `POLYWEATHER_AUTH_REQUIRED=true` 时，未登录访问受保护接口应返回 401 或跳转登录页。
-
-## 7. P1 支付链路验证
-
-1. 登录后访问 `GET /api/payments/config`，应看到 `enabled=true`、`configured=true`。
-2. 账户页点击“连接并绑定 MetaMask”，完成签名后 `GET /api/payments/wallets` 可看到地址。
-3. 点击“创建订单并支付”：
+1. 登录后请求 `/api/auth/me`，确认 `authenticated=true`。
+2. 请求 `/api/payments/config`，确认 `enabled=true`、`configured=true`。
+3. 钱包绑定：
+   - `POST /api/payments/wallets/challenge`
+   - `POST /api/payments/wallets/verify`
+4. 支付流程：
    - `POST /api/payments/intents`
-   - MetaMask 发交易到 `POLYWEATHER_PAYMENT_RECEIVER_CONTRACT`
-   - `POST /api/payments/intents/{intent_id}/submit`
-   - `POST /api/payments/intents/{intent_id}/confirm`
-4. 确认后应自动写入：
-   - `payments`（`status=confirmed`）
-   - `subscriptions`（新增 `active` 记录）
-   - `entitlement_events`（`subscription_granted`）
-
-合约事件要求：
-
-- 合约需在 `pay(orderId, planId, amount, token)` 成功后发出  
-  `OrderPaid(bytes32 orderId, address payer, uint256 planId, address token, uint256 amount)`  
-  （字段顺序和类型需一致）。
+   - 发链上交易
+   - `POST /api/payments/intents/{id}/submit`
+   - `POST /api/payments/intents/{id}/confirm`
+5. 若前端显示 pending，轮询：
+   - `GET /api/payments/intents/{id}`
+6. 确认订阅：`/api/auth/me` 返回 `subscription_active=true`。