2569718930@qq.com
94 lines
1.9 KiB
Markdown
94 lines
1.9 KiB
Markdown
# PolyWeather 前端
|
||
|
||
PolyWeather Pro 的生产前端工程。
|
||
|
||
线上地址：
|
||
- [https://polyweather-pro.vercel.app/](https://polyweather-pro.vercel.app/)
|
||
|
||
## 技术栈
|
||
|
||
- Next.js App Router
|
||
- React + Tailwind
|
||
- Leaflet + Chart.js
|
||
- Supabase Auth
|
||
- WalletConnect + 浏览器 EVM 钱包
|
||
|
||
## 运行模型
|
||
|
||
1. 浏览器 -> Next 应用（`frontend`）
|
||
2. Next Route Handlers（`/api/*`）-> FastAPI 后端
|
||
3. FastAPI -> 分析服务 / 支付服务
|
||
|
||
## 本地开发
|
||
|
||
```bash
|
||
cd frontend
|
||
cp .env.example .env.local
|
||
npm install
|
||
npm run dev
|
||
```
|
||
|
||
## 必需环境变量
|
||
|
||
```env
|
||
POLYWEATHER_API_BASE_URL=https://<your-fastapi-host>
|
||
NEXT_PUBLIC_SUPABASE_URL=
|
||
NEXT_PUBLIC_SUPABASE_ANON_KEY=
|
||
POLYWEATHER_AUTH_ENABLED=true
|
||
POLYWEATHER_AUTH_REQUIRED=false
|
||
POLYWEATHER_BACKEND_ENTITLEMENT_TOKEN=
|
||
```
|
||
|
||
WalletConnect：
|
||
|
||
```env
|
||
NEXT_PUBLIC_WALLETCONNECT_PROJECT_ID=
|
||
NEXT_PUBLIC_WALLETCONNECT_POLYGON_RPC_URL=https://polygon-bor-rpc.publicnode.com
|
||
```
|
||
|
||
浮层链接：
|
||
|
||
```env
|
||
NEXT_PUBLIC_TELEGRAM_GROUP_URL=https://t.me/<your_group>
|
||
```
|
||
|
||
## 路由处理器
|
||
|
||
天气：
|
||
|
||
- `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`
|
||
|
||
## 缓存行为
|
||
|
||
- `cities` / `summary` / `history`：`ETag + Cache-Control`
|
||
- `summary?force_refresh=true`：`no-store`
|
||
- 支付相关路由：`no-store`
|
||
|
||
## 开源边界说明
|
||
|
||
此前端仓库包含通用产品界面和标准支付体验。
|
||
商业策略调优、私有运营流程和敏感生产参数不在公开文档范围内。
|
||
|
||
详见根目录策略文档：`docs/OPEN_CORE_POLICY.md`
|
||
|
||
最后更新：`2026-03-14`
|