docs: Add Chinese API documentation and a commercialization roadmap, alongside minor formatting updates to the main README.
This commit is contained in:
2569718930@qq.com
@@ -18,15 +18,15 @@ Official dashboard: [polyweather-pro.vercel.app](https://polyweather-pro.vercel.
|
||||
mindmap
|
||||
root((PolyWeather Pro))
|
||||
Data Layer
|
||||
METAR(Aviation Weather / METAR)
|
||||
MGM(Turkey MGM)
|
||||
Station 17130(Ankara Center 17130)
|
||||
"METAR(Aviation Weather / METAR)"
|
||||
"MGM(Turkey MGM)"
|
||||
"Station 17130(Ankara Center 17130)"
|
||||
Open-Meteo
|
||||
weather.gov(US cities)
|
||||
Polymarket(P0 Read-only)
|
||||
"weather.gov(US cities)"
|
||||
"Polymarket(P0 Read-only)"
|
||||
Analysis Layer
|
||||
DEB(Dynamic Error Balancing)
|
||||
Probability Engine(mu + buckets)
|
||||
"DEB(Dynamic Error Balancing)"
|
||||
"Probability Engine(mu + buckets)"
|
||||
Trend Engine
|
||||
Risk Profiles
|
||||
Mispricing Radar
|
||||
@@ -36,9 +36,9 @@ mindmap
|
||||
Telegram Bot
|
||||
Alert Push
|
||||
Ops Layer
|
||||
Docker Compose(VPS backend + bot)
|
||||
Vercel(frontend)
|
||||
Cache + force_refresh
|
||||
"Docker Compose(VPS backend + bot)"
|
||||
"Vercel(frontend)"
|
||||
"Cache + force_refresh"
|
||||
Speed Insights
|
||||
```
|
||||
|
||||
@@ -65,14 +65,14 @@ graph TD
|
||||
|
||||
## Current Source Policy
|
||||
|
||||
| Domain | Source Policy |
|
||||
| :-- | :-- |
|
||||
| Primary observation | Aviation Weather / METAR |
|
||||
| Ankara enhancement | MGM + nearby stations, lead station fixed to `17130` |
|
||||
| Forecast baseline | Open-Meteo |
|
||||
| US official context | weather.gov |
|
||||
| Market layer | Polymarket P0 read-only discovery + quotes |
|
||||
| Removed source | Meteoblue (fully removed from code and docs) |
|
||||
| Domain | Source Policy |
|
||||
| :------------------ | :--------------------------------------------------- |
|
||||
| Primary observation | Aviation Weather / METAR |
|
||||
| Ankara enhancement | MGM + nearby stations, lead station fixed to `17130` |
|
||||
| Forecast baseline | Open-Meteo |
|
||||
| US official context | weather.gov |
|
||||
| Market layer | Polymarket P0 read-only discovery + quotes |
|
||||
| Removed source | Meteoblue (fully removed from code and docs) |
|
||||
|
||||
## Recent Changes (2026-03-11)
|
||||
|
||||
@@ -114,12 +114,12 @@ npm run build
|
||||
|
||||
## Command Surface (Telegram)
|
||||
|
||||
| Command | Purpose |
|
||||
| :-- | :-- |
|
||||
| `/city <name>` | City real-time analysis |
|
||||
| `/deb <name>` | DEB historical reconciliation |
|
||||
| `/top` | User leaderboard |
|
||||
| `/help` | Help and command usage |
|
||||
| Command | Purpose |
|
||||
| :------------- | :---------------------------- |
|
||||
| `/city <name>` | City real-time analysis |
|
||||
| `/deb <name>` | DEB historical reconciliation |
|
||||
| `/top` | User leaderboard |
|
||||
| `/help` | Help and command usage |
|
||||
|
||||
## Documentation Index
|
||||
|
||||
|
||||
+25
-25
@@ -18,27 +18,27 @@
|
||||
mindmap
|
||||
root((PolyWeather Pro))
|
||||
数据层
|
||||
METAR(Aviation Weather / METAR)
|
||||
MGM(土耳其 MGM)
|
||||
安卡拉主站(17130 Center)
|
||||
"METAR(Aviation Weather / METAR)"
|
||||
"MGM(土耳其 MGM)"
|
||||
"安卡拉主站(17130 Center)"
|
||||
Open-Meteo
|
||||
weather.gov(美国城市)
|
||||
Polymarket(P0 只读)
|
||||
"weather.gov(美国城市)"
|
||||
"Polymarket(P0 只读)"
|
||||
分析层
|
||||
DEB(动态误差平衡)
|
||||
概率引擎(mu + 桶分布)
|
||||
"DEB(动态误差平衡)"
|
||||
"概率引擎(mu + 桶分布)"
|
||||
趋势引擎
|
||||
城市风险档案
|
||||
错价雷达
|
||||
交付层
|
||||
FastAPI
|
||||
Next.js 仪表盘
|
||||
Telegram Bot
|
||||
"Next.js 仪表盘"
|
||||
"Telegram Bot"
|
||||
预警推送
|
||||
运维层
|
||||
Docker Compose(VPS)
|
||||
Vercel(前端)
|
||||
缓存 + force_refresh
|
||||
"Docker Compose(VPS)"
|
||||
"Vercel(前端)"
|
||||
"缓存 + force_refresh"
|
||||
Speed Insights
|
||||
```
|
||||
|
||||
@@ -65,14 +65,14 @@ graph TD
|
||||
|
||||
## 当前数据源口径
|
||||
|
||||
| 领域 | 当前口径 |
|
||||
| :-- | :-- |
|
||||
| 主观测源 | Aviation Weather / METAR |
|
||||
| Ankara 增强 | MGM + 周边站，领先站固定 `17130` |
|
||||
| 预报基线 | Open-Meteo |
|
||||
| 美国官方语义层 | weather.gov |
|
||||
| 市场层 | Polymarket P0 只读发现 + 报价 |
|
||||
| 已移除 | Meteoblue（代码与文档已全部移除） |
|
||||
| 领域 | 当前口径 |
|
||||
| :------------- | :-------------------------------- |
|
||||
| 主观测源 | Aviation Weather / METAR |
|
||||
| Ankara 增强 | MGM + 周边站，领先站固定 `17130` |
|
||||
| 预报基线 | Open-Meteo |
|
||||
| 美国官方语义层 | weather.gov |
|
||||
| 市场层 | Polymarket P0 只读发现 + 报价 |
|
||||
| 已移除 | Meteoblue（代码与文档已全部移除） |
|
||||
|
||||
## 最近更新（2026-03-11）
|
||||
|
||||
@@ -113,12 +113,12 @@ npm run build
|
||||
|
||||
## Telegram 命令
|
||||
|
||||
| 命令 | 用途 |
|
||||
| :-- | :-- |
|
||||
| 命令 | 用途 |
|
||||
| :------------- | :----------- |
|
||||
| `/city <name>` | 城市实时分析 |
|
||||
| `/deb <name>` | DEB 历史对账 |
|
||||
| `/top` | 用户排行榜 |
|
||||
| `/help` | 帮助说明 |
|
||||
| `/deb <name>` | DEB 历史对账 |
|
||||
| `/top` | 用户排行榜 |
|
||||
| `/help` | 帮助说明 |
|
||||
|
||||
## 文档索引
|
||||
|
||||
|
||||
+14
-14
@@ -23,32 +23,32 @@
|
||||
mindmap
|
||||
root((PolyWeather API))
|
||||
城市列表
|
||||
GET /api/cities
|
||||
"GET /api/cities"
|
||||
城市主数据
|
||||
GET /api/city/{name}
|
||||
GET /api/city/{name}/summary
|
||||
GET /api/city/{name}/detail
|
||||
"GET /api/city/{name}"
|
||||
"GET /api/city/{name}/summary"
|
||||
"GET /api/city/{name}/detail"
|
||||
历史数据
|
||||
GET /api/history/{name}
|
||||
"GET /api/history/{name}"
|
||||
关键对象
|
||||
current
|
||||
forecast
|
||||
probabilities(mu + distribution)
|
||||
"probabilities(mu + distribution)"
|
||||
multi_model / multi_model_daily
|
||||
market_scan(P0 只读)
|
||||
"market_scan(P0 只读)"
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 3. 接口总览
|
||||
|
||||
| 接口 | 方法 | 用途 |
|
||||
| :-- | :-- | :-- |
|
||||
| `/api/cities` | GET | 城市清单与地图基础信息 |
|
||||
| `/api/city/{name}` | GET | 城市主分析数据（侧栏/今日分析主来源） |
|
||||
| `/api/city/{name}/summary` | GET | 轻量摘要（首屏预热/低开销更新） |
|
||||
| `/api/city/{name}/detail` | GET | 聚合详情 + Polymarket P0 只读市场层 |
|
||||
| `/api/history/{name}` | GET | 历史对账数据 |
|
||||
| 接口 | 方法 | 用途 |
|
||||
| :------------------------- | :--- | :------------------------------------ |
|
||||
| `/api/cities` | GET | 城市清单与地图基础信息 |
|
||||
| `/api/city/{name}` | GET | 城市主分析数据（侧栏/今日分析主来源） |
|
||||
| `/api/city/{name}/summary` | GET | 轻量摘要（首屏预热/低开销更新） |
|
||||
| `/api/city/{name}/detail` | GET | 聚合详情 + Polymarket P0 只读市场层 |
|
||||
| `/api/history/{name}` | GET | 历史对账数据 |
|
||||
|
||||
---
|
||||
|
||||
|
||||
+13
-13
@@ -29,8 +29,8 @@ mindmap
|
||||
Dashboard 5 USD
|
||||
Bundle 5.5 USD
|
||||
Access Control
|
||||
Manual activation(P1)
|
||||
Wallet/USDC detection(P2)
|
||||
"Manual activation(P1)"
|
||||
"Wallet/USDC detection(P2)"
|
||||
Entitlement middleware
|
||||
Growth
|
||||
Accuracy reports
|
||||
@@ -42,11 +42,11 @@ mindmap
|
||||
|
||||
## 3. Packaging and Pricing
|
||||
|
||||
| Tier | Price | Value |
|
||||
| :-- | :-- | :-- |
|
||||
| Telegram Channel | $1 / month | Low-noise proactive signal feed |
|
||||
| Web Dashboard | $5 / month | Full multi-model context + reconciliation |
|
||||
| VIP Bundle | $5.5 / month | Dashboard + signal stream |
|
||||
| Tier | Price | Value |
|
||||
| :--------------- | :----------- | :---------------------------------------- |
|
||||
| Telegram Channel | $1 / month | Low-noise proactive signal feed |
|
||||
| Web Dashboard | $5 / month | Full multi-model context + reconciliation |
|
||||
| VIP Bundle | $5.5 / month | Dashboard + signal stream |
|
||||
|
||||
Payment direction:
|
||||
|
||||
@@ -85,12 +85,12 @@ graph LR
|
||||
|
||||
## 5. Technical Dependencies for Revenue
|
||||
|
||||
| Dependency | Why it matters |
|
||||
| :-- | :-- |
|
||||
| Entitlement guard | Prevents unpaid dashboard/API access |
|
||||
| Subscriber store | Persistent paid user state |
|
||||
| Audit trail | Explains why each alert fired |
|
||||
| Observability | Detects degradation before churn |
|
||||
| Dependency | Why it matters |
|
||||
| :------------------- | :--------------------------------------------------------------- |
|
||||
| Entitlement guard | Prevents unpaid dashboard/API access |
|
||||
| Subscriber store | Persistent paid user state |
|
||||
| Audit trail | Explains why each alert fired |
|
||||
| Observability | Detects degradation before churn |
|
||||
| Frontend performance | Impacts conversion and retention (Speed Insights now integrated) |
|
||||
|
||||
---
|
||||
|
||||
Reference in New Issue
Block a user