2569718930@qq.com
4fc4b538a5
调低地图详情面板隐藏断点 1680→1400px，MacBook 14" 可见 原 1680px 导致 MacBook Pro 14" (1512px) 地图模式详情面板被隐藏。 同时 max-height 从 900→860 避免误触发。 @
PolyWeather 前端
PolyWeather Pro 的生产前端工程。
线上地址：
技术栈
- 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时段提示与走势图联动
/ops已支持桌面表格 + 手机端卡片化视图- 点击城市图标后会显示地图顶部同步提醒与详情面板内同步徽标，避免用户误判为卡住
- 城市详情会自动识别“单模型 / 单日”的稀疏缓存并主动刷新，避免误把残缺 detail 当作完整结果
- 右侧详情面板在多日预报仍未补齐时会显示同步占位卡，不再把“只有今天一张卡”的中间态伪装成完整数据
- 日内分析弹窗在 full detail / market scan 同步时会锁住旧内容并显示刷新状态，避免用户短暂看到旧城市或旧日期的数据
- 城市决策卡支持从地图点击城市进入；机会榜和日历仍按 Pro 权限控制，地图探索和城市简报可作为轻量入口
- 城市决策卡的 AI 机场报文解读包括最终判断、METAR 解读、推理说明、模型集群备注、风险提示和原始 METAR
- AI 机场报文解读按
city + local_date + locale + METAR signature做页面内存缓存和localStorage最终结果缓存；切换选项卡返回时会优先恢复已有内容 - 市场价格层使用完整
all_buckets匹配温度桶，并把模型-市场差解释为模型概率 - 市场隐含概率 - 概率区展示当前生产概率引擎输出；EMOS / LGBM 只在评估通过或 shadow 对照时进入解释层，模型共识和市场价格只作为辅助说明
/ops现已展示 prewarm worker 运行态、缓存桶状态与 summary cache hit/miss
本地开发
cd frontend
cp .env.example .env.local
npm ci
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
# 推荐默认关闭的前端观测 / 预热开关
NEXT_PUBLIC_POLYWEATHER_APP_ANALYTICS=false
NEXT_PUBLIC_POLYWEATHER_WEB_VITALS=false
NEXT_PUBLIC_POLYWEATHER_EAGER_CITY_SUMMARIES=false
更完整的 Vercel 配置说明见：
路由处理器
天气：
GET /api/citiesGET /api/city/[name]GET /api/city/[name]/summaryGET /api/city/[name]/detail
鉴权：
GET /api/auth/me
支付：
GET /api/payments/configGET /api/payments/walletsPOST /api/payments/wallets/challengePOST /api/payments/wallets/verifyPOST /api/payments/intentsGET /api/payments/intents/[intentId]POST /api/payments/intents/[intentId]/submitPOST /api/payments/intents/[intentId]/confirm
Ops：
GET /opsGET /api/ops/usersGET /api/ops/leaderboard/weeklyGET /api/ops/membershipsGET /api/ops/payments/incidentsPOST /api/ops/users/grant-pointsPOST /api/ops/payments/incidents/[eventId]/resolve
Ops 管理后台
当前前端已内置轻量管理页：
页面当前支持：
- 系统状态
- SQLite / rollout / 支付运行态
- prewarm worker 运行态
- 缓存桶状态与 summary cache hit/miss
- 用户查询
- 当前会员
- 本周积分榜
- 手动补分
- 支付异常单筛选与标记已处理
- 手机端卡片化视图
注意：
/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-Controlsummary?force_refresh=true：no-store- 支付相关路由：
no-store - 当 detail 缓存只返回单模型或单日 forecast 时，前端会自动强刷完整 detail，并在补齐前显示同步提示 / 占位卡
- 今日日内分析打开时如果正在切换城市、日期或 detail 深度，弹窗会阻断旧内容点击并显示刷新锁
Vercel 节流建议
- 生产环境建议关闭
Web Analytics和Speed Insights - 建议把自建
app analytics / web vitals / eager city summaries默认保持关闭 - 如果你部署在 Vercel，可在 Firewall 中加一条
WordPress / php scanner拦截规则，避免无效扫描白白触发 middleware
AGPL 与商用边界说明
此前端代码随仓库一起采用 AGPL-3.0-only。
生产私有运营流程、商业策略调优、敏感生产参数、品牌与托管服务能力不在代码许可证授权范围内。
详见根目录策略文档：docs/OPEN_CORE_POLICY.md
最后更新：2026-04-19