docs: Introduce commercialization and technical debt documentation in English and Chinese, and update README diagram formatting.

2026-03-11 11:42:16 +08:00
parent 025feaa96e
commit 35345a1b04
5 changed files with 86 additions and 86 deletions
@@ -17,29 +17,29 @@ Official dashboard: [polyweather-pro.vercel.app](https://polyweather-pro.vercel.
 ```mermaid
 mindmap
  root((PolyWeather Pro))
-    Data Layer
-      [METAR (Aviation Weather / METAR)]
-      [MGM (Turkey MGM)]
-      [Station 17130 (Ankara Center 17130)]
-      Open-Meteo
-      [weather.gov (US cities)]
-      [Polymarket (P0 Read-only)]
-    Analysis Layer
-      [DEB (Dynamic Error Balancing)]
-      [Probability Engine (mu + buckets)]
-      Trend Engine
-      Risk Profiles
-      Mispricing Radar
-    Delivery Layer
-      FastAPI
-      Next.js Dashboard
-      Telegram Bot
-      Alert Push
-    Ops Layer
-      [Docker Compose (VPS backend + bot)]
-      [Vercel (frontend)]
-      [Cache + force_refresh]
-      Speed Insights
+    "Data Layer"
+      "METAR (Aviation Weather / METAR)"
+      "MGM (Turkey MGM)"
+      "Station 17130 (Ankara Center 17130)"
+      "Open-Meteo"
+      "weather.gov (US cities)"
+      "Polymarket (P0 Read-only)"
+    "Analysis Layer"
+      "DEB (Dynamic Error Balancing)"
+      "Probability Engine (mu + buckets)"
+      "Trend Engine"
+      "Risk Profiles"
+      "Mispricing Radar"
+    "Delivery Layer"
+      "FastAPI"
+      "Next.js Dashboard"
+      "Telegram Bot"
+      "Alert Push"
+    "Ops Layer"
+      "Docker Compose (VPS backend + bot)"
+      "Vercel (frontend)"
+      "Cache + force_refresh"
+      "Speed Insights"
 ```

 ## Architecture
@@ -17,29 +17,29 @@
 ```mermaid
 mindmap
  root((PolyWeather Pro))
-    数据层
-      [METAR (Aviation Weather / METAR)]
-      [MGM (土耳其 MGM)]
-      [安卡拉主站 (17130 Center)]
-      Open-Meteo
-      [weather.gov (美国城市)]
-      [Polymarket (P0 只读)]
-    分析层
-      [DEB (动态误差平衡)]
-      [概率引擎 (mu + 桶分布)]
-      趋势引擎
-      城市风险档案
-      错价雷达
-    交付层
-      FastAPI
-      [Next.js 仪表盘]
-      [Telegram Bot]
-      预警推送
-    运维层
-      [Docker Compose (VPS)]
-      [Vercel (前端)]
-      [缓存 + force_refresh]
-      Speed Insights
+    "数据层"
+      "METAR (Aviation Weather / METAR)"
+      "MGM (土耳其 MGM)"
+      "安卡拉主站 (17130 Center)"
+      "Open-Meteo"
+      "weather.gov (美国城市)"
+      "Polymarket (P0 只读)"
+    "分析层"
+      "DEB (动态误差平衡)"
+      "概率引擎 (mu + 桶分布)"
+      "趋势引擎"
+      "城市风险档案"
+      "错价雷达"
+    "交付层"
+      "FastAPI"
+      "Next.js 仪表盘"
+      "Telegram Bot"
+      "预警推送"
+    "运维层"
+      "Docker Compose (VPS)"
+      "Vercel (前端)"
+      "缓存 + force_refresh"
+      "Speed Insights"
 ```

 ## 系统架构
@@ -20,22 +20,22 @@ It is a decision-support layer for temperature-settlement markets:
 ```mermaid
 mindmap
  root((PolyWeather Monetization))
-    Product
-      Telegram Signal Channel
-      Web Dashboard
-      VIP Bundle
-    Pricing
-      [Entry 1 USD]
-      [Dashboard 5 USD]
-      [Bundle 5.5 USD]
-    Access Control
-      [Manual activation (P1)]
-      [Wallet/USDC detection (P2)]
-      Entitlement middleware
-    Growth
-      Accuracy reports
-      Retention analytics
-      User preference center
+    "Product"
+      "Telegram Signal Channel"
+      "Web Dashboard"
+      "VIP Bundle"
+    "Pricing"
+      "Entry 1 USD"
+      "Dashboard 5 USD"
+      "Bundle 5.5 USD"
+    "Access Control"
+      "Manual activation (P1)"
+      "Wallet/USDC detection (P2)"
+      "Entitlement middleware"
+    "Growth"
+      "Accuracy reports"
+      "Retention analytics"
+      "User preference center"
 ```

 ---
@@ -9,18 +9,18 @@ Purpose: keep engineering debt explicit while shipping production features.
 ```mermaid
 mindmap
  root((Tech Debt))
-    Architecture
-      Monolithic bot entry
-      Shared runtime coupling
-    Product Infra
-      Entitlement hardening
-      Subscription persistence
-    Quality
-      Replay harness
-      Broader regression tests
-    Observability
-      Alert evidence trace
-      SLO dashboards
+    "Architecture"
+      "Monolithic bot entry"
+      "Shared runtime coupling"
+    "Product Infra"
+      "Entitlement hardening"
+      "Subscription persistence"
+    "Quality"
+      "Replay harness"
+      "Broader regression tests"
+    "Observability"
+      "Alert evidence trace"
+      "SLO dashboards"
 ```

 Current system health estimate: **84% stable / 16% debt**.
@@ -9,18 +9,18 @@
 ```mermaid
 mindmap
  root((技术债))
-    架构层
-      机器人入口过于集中
-      共享运行时耦合
-    产品基础设施
-      订阅权限一致性
-      付费用户持久化
-    质量保障
-      回放测试能力
-      UI 回归覆盖不足
-    可观测性
-      告警证据链
-      SLO 看板
+    "架构层"
+      "机器人入口过于集中"
+      "共享运行时耦合"
+    "产品基础设施"
+      "订阅权限一致性"
+      "付费用户持久化"
+    "质量保障"
+      "回放测试能力"
+      "UI 回归覆盖不足"
+    "可观测性"
+      "告警证据链"
+      "SLO 看板"
 ```

 当前系统健康度估计：**84% 稳定 / 16% 技术债**。