gavindiaz/PolyWeather

Fork 0

Files

T

2569718930@qq.com 16404ccf71 Switch repository licensing to AGPL-3.0

2026-03-30 00:46:01 +08:00

4.7 KiB

Raw Blame History

PolyWeather 前端

PolyWeather Pro 的生产前端工程。

线上地址：

https://polyweather-pro.vercel.app/

技术栈

Next.js App Router
React + Tailwind
Leaflet + Chart.js
Supabase Auth
WalletConnect + 浏览器 EVM 钱包

运行模型

浏览器 -> Next 应用（frontend）
Next Route Handlers（/api/*）-> FastAPI 后端
FastAPI -> 分析服务 / 支付服务

当前前端能力

主站 Dashboard 支持地图、城市详情、今日日内分析、历史准确率对账和账户中心
/docs 已提供公开双语产品文档中心，解释日内结构信号、TAF、结算来源和历史对账
今日日内分析支持：
- 峰值窗口感知的近地面结构信号
- 高空结构信号
- 交易动作卡
- 非香港机场城市的 TAF 时段提示与走势图联动
历史对账支持：
- DEB / 最佳单模型 / 实测最高温 对比
- 峰值前 12 小时 DEB 参考（近似）
/ops 已支持桌面表格 + 手机端卡片化视图

本地开发

cd frontend
cp .env.example .env.local
npm install
npm run dev

Vercel 最小部署配置

只跑看板和基础鉴权时，先填这 4 项：

POLYWEATHER_API_BASE_URL=https://<your-fastapi-host>
NEXT_PUBLIC_SUPABASE_URL=https://<your-supabase-project>.supabase.co
NEXT_PUBLIC_SUPABASE_ANON_KEY=<your-anon-key>
POLYWEATHER_AUTH_ENABLED=true

建议显式补：

POLYWEATHER_AUTH_REQUIRED=true

如果你只是开放游客浏览，可改成：

POLYWEATHER_AUTH_ENABLED=false
POLYWEATHER_AUTH_REQUIRED=false

可选环境变量

仅在对应功能启用时填写：

# 看板分享令牌
POLYWEATHER_DASHBOARD_ACCESS_TOKEN=

# 前端 API 转发到后端时使用的共享令牌
POLYWEATHER_BACKEND_ENTITLEMENT_TOKEN=

# 钱包支付
NEXT_PUBLIC_WALLETCONNECT_PROJECT_ID=
NEXT_PUBLIC_WALLETCONNECT_POLYGON_RPC_URL=https://polygon-bor-rpc.publicnode.com
NEXT_PUBLIC_PAYMENT_ALLOWED_HOSTS=polyweather-pro.vercel.app
POLYWEATHER_OPS_ADMIN_EMAILS=yhrsc30@gmail.com

# 社群入口
NEXT_PUBLIC_TELEGRAM_GROUP_URL=https://t.me/<your_group>
NEXT_PUBLIC_TELEGRAM_BOT_URL=https://t.me/WeatherQuant_bot

更完整的 Vercel 配置说明见：

docs/FRONTEND_DEPLOYMENT_ZH.md

路由处理器

天气：

GET /api/cities
GET /api/city/[name]
GET /api/city/[name]/summary
GET /api/city/[name]/detail
GET /api/history/[name]

鉴权：

GET /api/auth/me

支付：

GET /api/payments/config
GET /api/payments/wallets
POST /api/payments/wallets/challenge
POST /api/payments/wallets/verify
POST /api/payments/intents
GET /api/payments/intents/[intentId]
POST /api/payments/intents/[intentId]/submit
POST /api/payments/intents/[intentId]/confirm

Ops：

GET /ops
GET /api/ops/users
GET /api/ops/leaderboard/weekly
GET /api/ops/memberships
GET /api/ops/payments/incidents
POST /api/ops/users/grant-points
POST /api/ops/payments/incidents/[eventId]/resolve

Ops 管理后台

当前前端已内置轻量管理页：

https://polyweather-pro.vercel.app/ops

页面当前支持：

系统状态
SQLite / rollout / 支付运行态
用户查询
当前会员
本周积分榜
手动补分
支付异常单筛选与标记已处理
手机端卡片化视图

注意：

/ops 现在是前后端双层管理员限制
Vercel 前端和后端都应配置相同的 POLYWEATHER_OPS_ADMIN_EMAILS
前端登录邮箱本身不会自动获得管理员权限

支付安全补充

为降低“旧页面/旧配置导致打到旧收款地址”的风险，支付区现在会：

点击支付前重新请求 /api/payments/config
若 receiver_contract 已更新，先切到最新地址
若后端返回的 tx_payload.to 与最新地址不一致，直接阻断支付
仅允许在 NEXT_PUBLIC_PAYMENT_ALLOWED_HOSTS 白名单域名上创建 payment intent
支付区会明确显示当前账号、付款钱包和收款合约，避免账号/钱包/地址混淆

这意味着：

旧标签页风险已明显降低
但支付地址变更后，仍建议在 Vercel 上 redeploy 当前 production，并清理明显过期 deployment

缓存行为

cities / summary / history：ETag + Cache-Control
summary?force_refresh=true：no-store
支付相关路由：no-store

AGPL 与商用边界说明

此前端代码随仓库一起采用 AGPL-3.0-only。生产私有运营流程、商业策略调优、敏感生产参数、品牌与托管服务能力不在代码许可证授权范围内。

详见根目录策略文档：docs/OPEN_CORE_POLICY.md

最后更新：2026-03-24

4.7 KiB Raw Blame History Unescape Escape