diff --git a/README.md b/README.md index 55aa799a..f3d702a5 100644 --- a/README.md +++ b/README.md @@ -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 ` | City real-time analysis | -| `/deb ` | DEB historical reconciliation | -| `/top` | User leaderboard | -| `/help` | Help and command usage | +| Command | Purpose | +| :------------- | :---------------------------- | +| `/city ` | City real-time analysis | +| `/deb ` | DEB historical reconciliation | +| `/top` | User leaderboard | +| `/help` | Help and command usage | ## Documentation Index diff --git a/README_ZH.md b/README_ZH.md index 3cc8c271..fa11a3a6 100644 --- a/README_ZH.md +++ b/README_ZH.md @@ -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 ` | 城市实时分析 | -| `/deb ` | DEB 历史对账 | -| `/top` | 用户排行榜 | -| `/help` | 帮助说明 | +| `/deb ` | DEB 历史对账 | +| `/top` | 用户排行榜 | +| `/help` | 帮助说明 | ## 文档索引 diff --git a/docs/API_ZH.md b/docs/API_ZH.md index 5c668b75..1a595231 100644 --- a/docs/API_ZH.md +++ b/docs/API_ZH.md @@ -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 | 历史对账数据 | --- diff --git a/docs/COMMERCIALIZATION.md b/docs/COMMERCIALIZATION.md index 0e133ac2..888a20fe 100644 --- a/docs/COMMERCIALIZATION.md +++ b/docs/COMMERCIALIZATION.md @@ -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) | ---