# PolyWeather 前端产品审查报告

> 审查日期：2026-06 | 视角：产品经理 | 范围：`frontend/` 全部页面、组件、用户流程 | 最后校准：2026-05-28

## 一、产品概览

PolyWeather 是一个面向天气衍生品交易者的气象情报平台。核心价值主张：**结合多模型气象预报 + 结构化实况层 + Polymarket 市场价格，为交易决策提供一站式证据链。**

### 产品分层

| 层级 | 功能 | 门槛 |
|------|------|------|
| 免费 | 交互式全球天气地图 + 城市简报 | 无需登录 |
| Pro 试用 | 3 天全功能 | 注册后自动获得 |
| Pro 订阅 | 城市决策卡（结构化实况 + 模型证据 + 市场层）、日内分析、历史对账、未来预报 | 月付 29.9 USDC / 30 天，季度 79.9 USDC / 90 天（月付最多抵 3 USDC，季度最多抵 8 USDC） |

### 页面结构（9 个路由）

| 路由 | 功能 | 是否必需登录 |
|------|------|-------------|
| `/` | 主看板 — 实时天气决策台 | 否 |
| `/account` | 账户中心 — 身份/订阅/钱包/积分/Bot 绑定 | 是 |
| `/auth/login` | 登录页（Google OAuth + 邮箱密码） | 否 |
| `/docs/[...slug]` | 产品文档中心（8 篇双语文档） | 否 |
| `/subscription-help` | 订阅 FAQ（双语） | 否 |
| `/entitlement-required` | 访问被拒页面 | 否 |
| `/ops` | 运营管理后台 | 是（管理员） |
| `/ops/truth-history` | 真值历史查看器 | 是（管理员） |

## 二、用户流程分析

### 主看板的两个视图

```
┌─ 分布视图（地图） ──────────────────────────────┐
│  Leaflet 交互式地图，城市彩色气泡                      │
│  点击城市 → 自动添加到决策卡工作区 + 切换到卡片视图          │
│  免费用户和 Pro 用户均可使用                            │
├─ 决策卡（分析） ──────────────────────────────┤
│  钉选的城市卡片：结构化实况 + 模型集群 + 市场层 + 实时图表     │
│  需要 Pro 订阅                                        │
└──────────────────────────────────────────────┘
        └── 右侧栏：城市简报面板（始终可见，免费可用）
```

### 关键用户路径

1. **新用户落地** → 看到 3 步引导 → 地图 + 城市列表 → 点击城市 → 看到城市简报 → 想深入分析 → 遇到 Pro 付费墙（含功能说明）
2. **Pro 用户工作流** → 地图选城市 → 自动钉选到决策卡 → 展开卡片 → 查看实测/DEB/概率/市场层 → 判断交易方向

## 三、做得好的地方

1. **地图 → 决策卡的自动流转设计** — 点击地图城市自动钉选到分析工作区并切换视图，"零步骤发现"
2. **双语覆盖完整** — 所有 UI 文案、文档、结构化解读都有中英文对照，覆盖率接近 100%
3. **数据新鲜度可视化** — DataFreshnessBar 让用户一眼看到 METAR/模型/市场数据的新鲜度
4. **结构化解读的产品化程度高** — 分层展示：快速判断 → 完整解读 → 证据链 → 风险提示
5. **免费层有实际价值** — 地图 + 城市简报不是"空壳"，用户可以看真实气象数据
6. **支付链路完整** — 从钱包绑定到链上签约到支付恢复，处理了多种异常情况
7. **空状态有引导文字** — "Click a city on the map" 告诉用户下一步做什么
8. **浅色/深色主题都有** — 两个主题都经过完整设计
9. **Ops 面板功能齐全** — 系统健康、转化漏斗、缓存状态、支付异常、用户管理一览无余

## 四、存在的问题与待办

| # | 问题 | 优先级 |
|---|------|------|
| 1 | **Docs 无搜索** — 8 篇文档没有搜索功能，用户必须逐篇浏览 | 🟢 待做 |
| 2 | **Ops 面板无审计日志** — 管理员补发积分等操作没有审计记录 | 🟢 需后端 |
| 3 | **注册后邮件验证引导** — 未验证邮箱的用户反复登录失败 | 🟡 需后端 |