feat: enhance project documentation with new overview diagrams, commercialization roadmap, and technical debt backlog.
This commit is contained in:
2569718930@qq.com
@@ -12,34 +12,47 @@ Official dashboard: [polyweather-pro.vercel.app](https://polyweather-pro.vercel.
|
|||||||
- Maps model view to Polymarket read-only market data for mispricing/risk scan.
|
- Maps model view to Polymarket read-only market data for mispricing/risk scan.
|
||||||
- Delivers the same core logic to web dashboard and Telegram bot.
|
- Delivers the same core logic to web dashboard and Telegram bot.
|
||||||
|
|
||||||
## Mindmap
|
## Overview Diagram
|
||||||
|
|
||||||
```mermaid
|
```mermaid
|
||||||
mindmap
|
flowchart TD
|
||||||
root((PolyWeather Pro))
|
A["PolyWeather Pro"]
|
||||||
"Data Layer"
|
|
||||||
"METAR (Aviation Weather / METAR)"
|
subgraph DL["Data Layer"]
|
||||||
"MGM (Turkey MGM)"
|
DL1["METAR (Aviation Weather / METAR)"]
|
||||||
"Station 17130 (Ankara Center 17130)"
|
DL2["MGM (Turkey MGM)"]
|
||||||
"Open-Meteo"
|
DL3["Station 17130 (Ankara Center 17130)"]
|
||||||
"weather.gov (US cities)"
|
DL4["Open-Meteo"]
|
||||||
"Polymarket (P0 Read-only)"
|
DL5["weather.gov (US cities)"]
|
||||||
"Analysis Layer"
|
DL6["Polymarket (P0 Read-only)"]
|
||||||
"DEB (Dynamic Error Balancing)"
|
end
|
||||||
"Probability Engine (mu + buckets)"
|
|
||||||
"Trend Engine"
|
subgraph AL["Analysis Layer"]
|
||||||
"Risk Profiles"
|
AL1["DEB (Dynamic Error Balancing)"]
|
||||||
"Mispricing Radar"
|
AL2["Probability Engine (mu + buckets)"]
|
||||||
"Delivery Layer"
|
AL3["Trend Engine"]
|
||||||
"FastAPI"
|
AL4["Risk Profiles"]
|
||||||
"Next.js Dashboard"
|
AL5["Mispricing Radar"]
|
||||||
"Telegram Bot"
|
end
|
||||||
"Alert Push"
|
|
||||||
"Ops Layer"
|
subgraph DEL["Delivery Layer"]
|
||||||
"Docker Compose (VPS backend + bot)"
|
DEL1["FastAPI"]
|
||||||
"Vercel (frontend)"
|
DEL2["Next.js Dashboard"]
|
||||||
"Cache + force_refresh"
|
DEL3["Telegram Bot"]
|
||||||
"Speed Insights"
|
DEL4["Alert Push"]
|
||||||
|
end
|
||||||
|
|
||||||
|
subgraph OL["Ops Layer"]
|
||||||
|
OL1["Docker Compose (VPS backend + bot)"]
|
||||||
|
OL2["Vercel (frontend)"]
|
||||||
|
OL3["Cache + force_refresh"]
|
||||||
|
OL4["Speed Insights"]
|
||||||
|
end
|
||||||
|
|
||||||
|
A --> DL
|
||||||
|
A --> AL
|
||||||
|
A --> DEL
|
||||||
|
A --> OL
|
||||||
```
|
```
|
||||||
|
|
||||||
## Architecture
|
## Architecture
|
||||||
|
|||||||
+39
-26
@@ -12,34 +12,47 @@
|
|||||||
- 将模型概率与 Polymarket 只读市场数据对齐，输出错价/风险信号。
|
- 将模型概率与 Polymarket 只读市场数据对齐，输出错价/风险信号。
|
||||||
- Web 仪表盘与 Telegram 机器人共用同一套核心逻辑。
|
- Web 仪表盘与 Telegram 机器人共用同一套核心逻辑。
|
||||||
|
|
||||||
## 思维导图
|
## 概览图
|
||||||
|
|
||||||
```mermaid
|
```mermaid
|
||||||
mindmap
|
flowchart TD
|
||||||
root((PolyWeather Pro))
|
A["PolyWeather Pro"]
|
||||||
"数据层"
|
|
||||||
"METAR (Aviation Weather / METAR)"
|
subgraph DL["数据层"]
|
||||||
"MGM (土耳其 MGM)"
|
DL1["METAR (Aviation Weather / METAR)"]
|
||||||
"安卡拉主站 (17130 Center)"
|
DL2["MGM (土耳其 MGM)"]
|
||||||
"Open-Meteo"
|
DL3["安卡拉主站 (17130 Center)"]
|
||||||
"weather.gov (美国城市)"
|
DL4["Open-Meteo"]
|
||||||
"Polymarket (P0 只读)"
|
DL5["weather.gov (美国城市)"]
|
||||||
"分析层"
|
DL6["Polymarket (P0 只读)"]
|
||||||
"DEB (动态误差平衡)"
|
end
|
||||||
"概率引擎 (mu + 桶分布)"
|
|
||||||
"趋势引擎"
|
subgraph AL["分析层"]
|
||||||
"城市风险档案"
|
AL1["DEB (动态误差平衡)"]
|
||||||
"错价雷达"
|
AL2["概率引擎 (mu + 桶分布)"]
|
||||||
"交付层"
|
AL3["趋势引擎"]
|
||||||
"FastAPI"
|
AL4["城市风险档案"]
|
||||||
"Next.js 仪表盘"
|
AL5["错价雷达"]
|
||||||
"Telegram Bot"
|
end
|
||||||
"预警推送"
|
|
||||||
"运维层"
|
subgraph DEL["交付层"]
|
||||||
"Docker Compose (VPS)"
|
DEL1["FastAPI"]
|
||||||
"Vercel (前端)"
|
DEL2["Next.js 仪表盘"]
|
||||||
"缓存 + force_refresh"
|
DEL3["Telegram Bot"]
|
||||||
"Speed Insights"
|
DEL4["预警推送"]
|
||||||
|
end
|
||||||
|
|
||||||
|
subgraph OL["运维层"]
|
||||||
|
OL1["Docker Compose (VPS)"]
|
||||||
|
OL2["Vercel (前端)"]
|
||||||
|
OL3["缓存 + force_refresh"]
|
||||||
|
OL4["Speed Insights"]
|
||||||
|
end
|
||||||
|
|
||||||
|
A --> DL
|
||||||
|
A --> AL
|
||||||
|
A --> DEL
|
||||||
|
A --> OL
|
||||||
```
|
```
|
||||||
|
|
||||||
## 系统架构
|
## 系统架构
|
||||||
|
|||||||
+21
-16
@@ -20,22 +20,27 @@
|
|||||||
## 2. API 思维导图
|
## 2. API 思维导图
|
||||||
|
|
||||||
```mermaid
|
```mermaid
|
||||||
mindmap
|
flowchart TD
|
||||||
root((PolyWeather API))
|
A["PolyWeather API"]
|
||||||
"城市列表"
|
|
||||||
"GET /api/cities"
|
subgraph E["接口分组"]
|
||||||
"城市主数据"
|
E1["GET /api/cities"]
|
||||||
"GET /api/city/{name}"
|
E2["GET /api/city/{name}"]
|
||||||
"GET /api/city/{name}/summary"
|
E3["GET /api/city/{name}/summary"]
|
||||||
"GET /api/city/{name}/detail"
|
E4["GET /api/city/{name}/detail"]
|
||||||
"历史数据"
|
E5["GET /api/history/{name}"]
|
||||||
"GET /api/history/{name}"
|
end
|
||||||
"关键对象"
|
|
||||||
"current"
|
subgraph O["关键对象"]
|
||||||
"forecast"
|
O1["current"]
|
||||||
"probabilities (mu + distribution)"
|
O2["forecast"]
|
||||||
"multi_model / multi_model_daily"
|
O3["probabilities (mu + distribution)"]
|
||||||
"market_scan (P0 只读)"
|
O4["multi_model / multi_model_daily"]
|
||||||
|
O5["market_scan (P0 只读)"]
|
||||||
|
end
|
||||||
|
|
||||||
|
A --> E
|
||||||
|
A --> O
|
||||||
```
|
```
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|||||||
+32
-19
@@ -15,27 +15,40 @@ It is a decision-support layer for temperature-settlement markets:
|
|||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 2. Business Mindmap
|
## 2. Business Overview Diagram
|
||||||
|
|
||||||
```mermaid
|
```mermaid
|
||||||
mindmap
|
flowchart TD
|
||||||
root((PolyWeather Monetization))
|
A["PolyWeather Monetization"]
|
||||||
"Product"
|
|
||||||
"Telegram Signal Channel"
|
subgraph P["Product"]
|
||||||
"Web Dashboard"
|
P1["Telegram Signal Channel"]
|
||||||
"VIP Bundle"
|
P2["Web Dashboard"]
|
||||||
"Pricing"
|
P3["VIP Bundle"]
|
||||||
"Entry 1 USD"
|
end
|
||||||
"Dashboard 5 USD"
|
|
||||||
"Bundle 5.5 USD"
|
subgraph R["Pricing"]
|
||||||
"Access Control"
|
R1["Entry 1 USD"]
|
||||||
"Manual activation (P1)"
|
R2["Dashboard 5 USD"]
|
||||||
"Wallet/USDC detection (P2)"
|
R3["Bundle 5.5 USD"]
|
||||||
"Entitlement middleware"
|
end
|
||||||
"Growth"
|
|
||||||
"Accuracy reports"
|
subgraph AC["Access Control"]
|
||||||
"Retention analytics"
|
AC1["Manual activation (P1)"]
|
||||||
"User preference center"
|
AC2["Wallet/USDC detection (P2)"]
|
||||||
|
AC3["Entitlement middleware"]
|
||||||
|
end
|
||||||
|
|
||||||
|
subgraph G["Growth"]
|
||||||
|
G1["Accuracy reports"]
|
||||||
|
G2["Retention analytics"]
|
||||||
|
G3["User preference center"]
|
||||||
|
end
|
||||||
|
|
||||||
|
A --> P
|
||||||
|
A --> R
|
||||||
|
A --> AC
|
||||||
|
A --> G
|
||||||
```
|
```
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|||||||
+27
-14
@@ -7,20 +7,33 @@ Purpose: keep engineering debt explicit while shipping production features.
|
|||||||
## 1. Debt Landscape
|
## 1. Debt Landscape
|
||||||
|
|
||||||
```mermaid
|
```mermaid
|
||||||
mindmap
|
flowchart TD
|
||||||
root((Tech Debt))
|
A["Tech Debt"]
|
||||||
"Architecture"
|
|
||||||
"Monolithic bot entry"
|
subgraph AR["Architecture"]
|
||||||
"Shared runtime coupling"
|
AR1["Monolithic bot entry"]
|
||||||
"Product Infra"
|
AR2["Shared runtime coupling"]
|
||||||
"Entitlement hardening"
|
end
|
||||||
"Subscription persistence"
|
|
||||||
"Quality"
|
subgraph PI["Product Infra"]
|
||||||
"Replay harness"
|
PI1["Entitlement hardening"]
|
||||||
"Broader regression tests"
|
PI2["Subscription persistence"]
|
||||||
"Observability"
|
end
|
||||||
"Alert evidence trace"
|
|
||||||
"SLO dashboards"
|
subgraph Q["Quality"]
|
||||||
|
Q1["Replay harness"]
|
||||||
|
Q2["Broader regression tests"]
|
||||||
|
end
|
||||||
|
|
||||||
|
subgraph O["Observability"]
|
||||||
|
O1["Alert evidence trace"]
|
||||||
|
O2["SLO dashboards"]
|
||||||
|
end
|
||||||
|
|
||||||
|
A --> AR
|
||||||
|
A --> PI
|
||||||
|
A --> Q
|
||||||
|
A --> O
|
||||||
```
|
```
|
||||||
|
|
||||||
Current system health estimate: **84% stable / 16% debt**.
|
Current system health estimate: **84% stable / 16% debt**.
|
||||||
|
|||||||
+27
-14
@@ -7,20 +7,33 @@
|
|||||||
## 1. 技术债全景
|
## 1. 技术债全景
|
||||||
|
|
||||||
```mermaid
|
```mermaid
|
||||||
mindmap
|
flowchart TD
|
||||||
root((技术债))
|
A["技术债"]
|
||||||
"架构层"
|
|
||||||
"机器人入口过于集中"
|
subgraph AR["架构层"]
|
||||||
"共享运行时耦合"
|
AR1["机器人入口过于集中"]
|
||||||
"产品基础设施"
|
AR2["共享运行时耦合"]
|
||||||
"订阅权限一致性"
|
end
|
||||||
"付费用户持久化"
|
|
||||||
"质量保障"
|
subgraph PI["产品基础设施"]
|
||||||
"回放测试能力"
|
PI1["订阅权限一致性"]
|
||||||
"UI 回归覆盖不足"
|
PI2["付费用户持久化"]
|
||||||
"可观测性"
|
end
|
||||||
"告警证据链"
|
|
||||||
"SLO 看板"
|
subgraph Q["质量保障"]
|
||||||
|
Q1["回放测试能力"]
|
||||||
|
Q2["UI 回归覆盖不足"]
|
||||||
|
end
|
||||||
|
|
||||||
|
subgraph O["可观测性"]
|
||||||
|
O1["告警证据链"]
|
||||||
|
O2["SLO 看板"]
|
||||||
|
end
|
||||||
|
|
||||||
|
A --> AR
|
||||||
|
A --> PI
|
||||||
|
A --> Q
|
||||||
|
A --> O
|
||||||
```
|
```
|
||||||
|
|
||||||
当前系统健康度估计：**84% 稳定 / 16% 技术债**。
|
当前系统健康度估计：**84% 稳定 / 16% 技术债**。
|
||||||
|
|||||||
Reference in New Issue
Block a user