Allow manual payment tx submission during transient validation

- overlay_latest_amos_observation: 从 raw_observation_latest 读取韩国跑道传感器数据
- overlay_latest_mgm_observation: 读取土耳其 MGM 官方观测
- 接入 _get_city_chart_data 的 force_refresh 和缓存两条路径

.claude/settings.local.json

@@ -3,7 +3,14 @@
     "allow": [
       "Bash(npm --prefix \"/e/web/PolyWeather/frontend\" run build)",
       "mcp__Claude_Preview__preview_start",
-      "Bash(git:*)"
+      "Bash(git:*)",
+      "Bash(python -c \"from web.services.city_payloads import build_city_detail_payload; print\\('OK'\\)\")",
+      "Bash(python -m ruff check web/services/city_runtime.py web/services/city_api.py)",
+      "Bash(python -m ruff check .)",
+      "Bash(python -m pytest tests/ -q)",
+      "Bash(python -m ruff check . --fix)",
+      "Bash(ssh *)",
+      "Bash(curl *)"
     ]
   }
 }

.env.example

@@ -9,24 +9,34 @@
 ########################################
 ENV=production
 LOG_LEVEL=INFO
-POLYWEATHER_MAP_URL=https://polyweather-pro.vercel.app/
+POLYWEATHER_MAP_URL=https://polyweather.top/
 POLYWEATHER_RUNTIME_DATA_DIR=/var/lib/polyweather
 POLYWEATHER_DB_PATH=/var/lib/polyweather/polyweather.db
 OPEN_METEO_DISK_CACHE_PATH=/var/lib/polyweather/open_meteo_cache.json
+UVICORN_WORKERS=1
 # Optional: host user/group mapping for Docker on Linux.
 # Windows / macOS can usually keep the defaults.
 UID=1000
 GID=1000
 POLYWEATHER_STATE_STORAGE_MODE=sqlite
-POLYWEATHER_PROMETHEUS_PORT=9090
-POLYWEATHER_ALERTMANAGER_PORT=9093
-POLYWEATHER_ALERT_RELAY_PORT=9099
-POLYWEATHER_GRAFANA_PORT=3001
-POLYWEATHER_GRAFANA_ADMIN_USER=admin
-POLYWEATHER_GRAFANA_ADMIN_PASSWORD=polyweather
+# Realtime chart event store. Production should use Redis Stream; local/single-process
+# development can set POLYWEATHER_EVENT_STORE=sqlite.
+POLYWEATHER_EVENT_STORE=redis
+POLYWEATHER_REDIS_URL=redis://polyweather_redis:6379/0
+POLYWEATHER_REDIS_STREAM_KEY=stream:city_observation
+POLYWEATHER_REDIS_STREAM_MAXLEN=50000
+POLYWEATHER_REDIS_REQUIRED=true
+# Optional Cloudflare R2 cold archive for realtime SSE/event snapshots.
+POLYWEATHER_R2_ARCHIVE_SOURCE=redis
+POLYWEATHER_R2_ACCOUNT_ID=
+POLYWEATHER_R2_BUCKET=
+POLYWEATHER_R2_ENDPOINT_URL=
+POLYWEATHER_R2_REGION=auto
+POLYWEATHER_R2_ACCESS_KEY_ID=
+POLYWEATHER_R2_SECRET_ACCESS_KEY=
 # Backend CORS allowlist. Add your Vercel production/preview domains when
 # NEXT_PUBLIC_POLYWEATHER_API_BASE_URL points browsers directly at this backend.
-WEB_CORS_ORIGINS=http://localhost:3000,http://127.0.0.1:3000,https://polyweather-pro.vercel.app
+WEB_CORS_ORIGINS=http://localhost:3000,http://127.0.0.1:3000,https://polyweather.top,https://www.polyweather.top,https://api.polyweather.top
 
 ########################################
 # 2) Telegram bot minimal
@@ -34,21 +44,46 @@ WEB_CORS_ORIGINS=http://localhost:3000,http://127.0.0.1:3000,https://polyweather
 TELEGRAM_BOT_TOKEN=
 TELEGRAM_CHAT_ID=
 TELEGRAM_CHAT_IDS=
+POLYWEATHER_TELEGRAM_GROUP_ID=
+# Optional: restrict message-points accrual to these chat IDs.
+# Example: POLYWEATHER_BOT_POINTS_CHAT_IDS=-1003965137823
+POLYWEATHER_BOT_POINTS_CHAT_IDS=
+POLYWEATHER_GROUP_MEMBER_PRICE_USDC=5
+POLYWEATHER_PUBLIC_PRICE_USDC=10
 TELEGRAM_QUERY_TOPIC_CHAT_ID=
 TELEGRAM_QUERY_TOPIC_ID=
 TELEGRAM_QUERY_TOPIC_MAP=
 POLYWEATHER_BOT_GROUP_INVITE_URL=
+POLYWEATHER_APP_URL=https://polyweather.top
+# Global Telegram auto-push copy: both, en, or zh. Module-specific vars can override it.
+TELEGRAM_PUSH_LANGUAGE=both
+# High-frequency airport push loop. Keep workers at 1 on shared VPS.
+TELEGRAM_AIRPORT_PUSH_ENABLED=true
+TELEGRAM_AIRPORT_PUSH_INTERVAL_SEC=60
+TELEGRAM_AIRPORT_PUSH_MAX_WORKERS=1
+# Optional airport-only override.
+TELEGRAM_AIRPORT_PUSH_LANGUAGE=both
+# Docker-only safety limits for the bot service.
+POLYWEATHER_BOT_CPUS=0.75
+POLYWEATHER_BOT_MEM_LIMIT=768m
+POLYWEATHER_BOT_MEMSWAP_LIMIT=1g
+POLYWEATHER_BOT_AIRPORT_PUSH_INTERVAL_SEC=60
+POLYWEATHER_BOT_AIRPORT_PUSH_MAX_WORKERS=1
 
 ########################################
 # 3) Weather + cache
 ########################################
-OPEN_METEO_CACHE_TTL_SEC=7200
-OPEN_METEO_ENSEMBLE_CACHE_TTL_SEC=7200
-OPEN_METEO_MULTI_MODEL_CACHE_TTL_SEC=7200
+OPEN_METEO_CACHE_TTL_SEC=21600
+OPEN_METEO_ENSEMBLE_CACHE_TTL_SEC=21600
+OPEN_METEO_MULTI_MODEL_CACHE_TTL_SEC=21600
 OPEN_METEO_MULTI_MODEL_CACHE_VERSION=v2
-OPEN_METEO_RATE_LIMIT_COOLDOWN_SEC=900
+OPEN_METEO_RATE_LIMIT_COOLDOWN_SEC=3600
 OPEN_METEO_RATE_CACHE_TTL_SEC=3600
-OPEN_METEO_MIN_CALL_INTERVAL_SEC=1
+OPEN_METEO_MIN_CALL_INTERVAL_SEC=5
+POLYWEATHER_SCAN_TERMINAL_MAX_WORKERS=1
+POLYWEATHER_SCAN_TERMINAL_PAYLOAD_TTL_SEC=600
+POLYWEATHER_SCAN_TERMINAL_BUILD_TIMEOUT_SEC=45
+POLYWEATHER_CITY_DETAIL_BATCH_QUEUE_WAIT_MS=3000
 POLYWEATHER_HTTP_TIMEOUT_SEC=8
 POLYWEATHER_HTTP_RETRY_COUNT=0
 POLYWEATHER_HTTP_RETRY_BACKOFF_SEC=0.2
@@ -57,26 +92,19 @@ POLYWEATHER_METAR_TIMEOUT_SEC=4
 POLYWEATHER_METAR_CLUSTER_TIMEOUT_SEC=3.5
 METAR_CACHE_TTL_SEC=600
 JMA_AMEDAS_CACHE_TTL_SEC=120
-METEOBLUE_CACHE_TTL_SEC=7200
-# Probability engine modes:
-# - legacy: production-safe primary path.
-# - emos_shadow: user-facing probability stays legacy, EMOS is generated for comparison.
-# - emos_primary: only after offline evaluation passes and manual rollout is approved.
-POLYWEATHER_PROBABILITY_ENGINE=legacy
-POLYWEATHER_EMOS_AUTO_MIN_SAMPLES=50
-POLYWEATHER_EMOS_AUTO_MAX_DELTA_CRPS=0
-POLYWEATHER_EMOS_AUTO_MAX_DELTA_MAE=0.05
-POLYWEATHER_EMOS_AUTO_MIN_DELTA_BUCKET_HIT_RATE=-0.05
-# Optional: cap recent probability snapshots used by EMOS retraining.
-# Recommended on VPS: do not train there; pull the SQLite DB to a local machine.
-# POLYWEATHER_EMOS_TRAINING_SNAPSHOT_LIMIT=20000
-# Optional: set this to a writable runtime path if you manually deploy a
-# locally trained EMOS calibration file.
-# POLYWEATHER_PROBABILITY_CALIBRATION_FILE=/var/lib/polyweather/probability_calibration/default.json
-POLYWEATHER_LGBM_ENABLED=false
-POLYWEATHER_LGBM_MODEL_PATH=/app/artifacts/models/lgbm_daily_high.txt
-POLYWEATHER_LGBM_SCHEMA_PATH=/app/artifacts/models/lgbm_daily_high_schema.json
-POLYWEATHER_LGBM_MIN_HISTORY_POINTS=3
+
+# ── Country-specific data source URLs ──
+# These are kept in .env to avoid exposing competitive data-source discovery
+# work on the public GitHub repository. Leave empty to use built-in defaults.
+# AMSC_AWOS_BASE_URL=https://www.amsc.net.cn/gateway/api/saas/rest/amc/AwosController/getWindPlate
+# KMA_BASE_URL=https://www.weather.go.kr
+# AMOS_BASE_URL=https://global.amo.go.kr/amosobsnew/AmosRealTimeImage.do
+# JMA_AMEDAS_BASE_URL=https://www.jma.go.jp
+# MGM_BASE_URL=https://servis.mgm.gov.tr/web
+# MGM_ORIGIN_URL=https://www.mgm.gov.tr
+# FMI_BASE_URL=https://opendata.fmi.fi/wfs
+# HKO_BASE_URL=https://data.weather.gov.hk/weatherAPI/hko_data/regional-weather
+# SINGAPORE_MSS_BASE_URL=https://api.data.gov.sg/v1/environment/air-temperature
 
 ########################################
 # 4) Auth / entitlement
@@ -92,16 +120,11 @@ SUPABASE_HTTP_TIMEOUT_SEC=8
 SUPABASE_AUTH_CACHE_TTL_SEC=30
 SUPABASE_SUB_CACHE_TTL_SEC=60
 POLYWEATHER_BACKEND_ENTITLEMENT_TOKEN=
+POLYWEATHER_TELEGRAM_JOIN_INELIGIBLE_ACTION=decline
 
 ########################################
-# 5) Alerts / operations
+# 5) Operations
 ########################################
-TELEGRAM_ALERT_PUSH_ENABLED=true
-TELEGRAM_ALERT_PUSH_INTERVAL_SEC=300
-TELEGRAM_ALERT_PUSH_COOLDOWN_SEC=1800
-TELEGRAM_ALERT_MIN_TRIGGER_COUNT=2
-TELEGRAM_ALERT_MIN_SEVERITY=medium
-TELEGRAM_ALERT_CITIES=ankara,london,paris,seoul,hong kong,shanghai,singapore,tokyo,tel aviv,toronto,buenos aires,wellington,new york,chicago,dallas,miami,atlanta,seattle,lucknow,sao paulo,munich
 POLYWEATHER_MONITORING_ALERT_CHAT_IDS=
 
 ########################################
@@ -109,6 +132,10 @@ POLYWEATHER_MONITORING_ALERT_CHAT_IDS=
 ########################################
 NEXT_PUBLIC_WALLETCONNECT_PROJECT_ID=
 NEXT_PUBLIC_WALLETCONNECT_POLYGON_RPC_URL=https://polygon-bor-rpc.publicnode.com
+NEXT_PUBLIC_TURNSTILE_SITE_KEY=
+POLYWEATHER_TURNSTILE_BYPASS=false
+POLYWEATHER_TURNSTILE_ENFORCE_ACTION=false
+POLYWEATHER_TURNSTILE_REQUIRE_PAYMENT_SUBMIT=false
 # Optional: disable homepage city summary preloading. Default is enabled.
 NEXT_PUBLIC_POLYWEATHER_DISABLE_EAGER_SUMMARIES=false
 # Optional: browser-visible FastAPI base URL for Vercel deployments.
@@ -116,40 +143,21 @@ NEXT_PUBLIC_POLYWEATHER_DISABLE_EAGER_SUMMARIES=false
 # bypass Vercel Functions / Fluid Compute instead of going through Next.js API proxies.
 # Example: NEXT_PUBLIC_POLYWEATHER_API_BASE_URL=https://api.example.com
 NEXT_PUBLIC_POLYWEATHER_API_BASE_URL=
+# Set to "false" to disable app analytics event tracking (conversion funnel etc.)
+# Default: enabled. Only set this if you need to opt out.
+NEXT_PUBLIC_POLYWEATHER_APP_ANALYTICS=true
 
 ########################################
-# 7) Optional modules
+# 7) Admin / Ops
 ########################################
+# Comma-separated admin email list for /ops dashboard access
+POLYWEATHER_OPS_ADMIN_EMAILS=
+# KNMI 10-minute observation data (Amsterdam)
+KNMI_API_KEY=
 
-# Optional Groq commentary rewrite for intraday structure cards
-POLYWEATHER_GROQ_COMMENTARY_ENABLED=false
-GROQ_API_KEY=
-POLYWEATHER_GROQ_COMMENTARY_MODEL=openai/gpt-oss-20b
-POLYWEATHER_GROQ_COMMENTARY_TIMEOUT_SEC=8
-POLYWEATHER_GROQ_COMMENTARY_CACHE_TTL_SEC=1800
-
-# Optional OpenAI-compatible market scan review for Pro users
-# Temporary default provider: MiMo via https://token-plan-cn.xiaomimimo.com/v1.
-POLYWEATHER_SCAN_AI_ENABLED=false
-POLYWEATHER_SCAN_AI_API_KEY=
-POLYWEATHER_SCAN_AI_PROVIDER=mimo
-POLYWEATHER_SCAN_AI_PROVIDER_LABEL=MiMo
-POLYWEATHER_SCAN_AI_BASE_URL=https://token-plan-cn.xiaomimimo.com/v1
-POLYWEATHER_SCAN_AI_MODEL=mimo-v2.5-pro
-POLYWEATHER_SCAN_CITY_AI_MODEL=mimo-v2.5-pro
-# Backward-compatible legacy DeepSeek variables are still read if the generic
-# POLYWEATHER_SCAN_AI_* variables are unset.
-# POLYWEATHER_DEEPSEEK_API_KEY=
-# POLYWEATHER_DEEPSEEK_BASE_URL=https://api.deepseek.com
-POLYWEATHER_SCAN_AI_TIMEOUT_SEC=18
-POLYWEATHER_SCAN_CITY_AI_TIMEOUT_SEC=30
-POLYWEATHER_SCAN_CITY_AI_RETRY_ON_STREAM_PARSE_ERROR=false
-POLYWEATHER_SCAN_AI_CACHE_TTL_SEC=1800
-POLYWEATHER_SCAN_AI_MAX_ROWS=40
-POLYWEATHER_SCAN_AI_MAX_TOKENS=3200
-POLYWEATHER_SCAN_CITY_AI_MAX_TOKENS=900
-POLYWEATHER_SCAN_AI_PROXY_TIMEOUT_MS=55000
-POLYWEATHER_PREWARM_CITIES=ankara,istanbul,shanghai,beijing,shenzhen,guangzhou,wuhan,chengdu,chongqing,hong kong,taipei,singapore,tokyo,seoul,busan,london,paris,madrid
+########################################
+# 8) Optional modules
+########################################
 POLYWEATHER_CITY_SUMMARY_CACHE_TTL_SEC=1800
 POLYWEATHER_CITY_PANEL_CACHE_TTL_SEC=1800
 POLYWEATHER_CITY_NEARBY_CACHE_TTL_SEC=1800
@@ -166,6 +174,12 @@ POLYWEATHER_WEEKLY_REWARD_CHECK_INTERVAL_SEC=300
 POLYWEATHER_WEEKLY_REWARD_HTTP_TIMEOUT_SEC=10
 POLYWEATHER_WEEKLY_REWARD_ANNOUNCE_ENABLED=true
 
+# Verified-user growth milestone rewards
+POLYWEATHER_GROWTH_REWARD_ENABLED=false
+POLYWEATHER_GROWTH_REWARD_CHECK_INTERVAL_SEC=21600
+POLYWEATHER_GROWTH_REWARD_HTTP_TIMEOUT_SEC=15
+POLYWEATHER_GROWTH_REWARD_ANNOUNCE_ENABLED=true
+
 # Group message points
 POLYWEATHER_BOT_MESSAGE_POINTS=4
 POLYWEATHER_BOT_MESSAGE_DAILY_CAP=40
@@ -176,12 +190,24 @@ POLYWEATHER_BOT_DEB_QUERY_COST=1
 
 # Payments
 POLYWEATHER_PAYMENT_ENABLED=false
+# Default / legacy checkout chain. Keep Polygon as the default because the
+# deployed checkout contract currently lives there.
 POLYWEATHER_PAYMENT_CHAIN_ID=137
 POLYWEATHER_PAYMENT_RPC_URL=https://polygon-rpc.com
 POLYWEATHER_PAYMENT_RPC_URLS=https://polygon-rpc.com
+# Optional multi-chain RPC map. Required when accepting non-default chain
+# transfers such as Ethereum mainnet USDC.
+# Example:
+# POLYWEATHER_PAYMENT_RPC_URLS_BY_CHAIN_JSON={"137":["https://polygon-rpc.com"],"1":["https://ethereum-rpc.example"]}
+POLYWEATHER_PAYMENT_RPC_URLS_BY_CHAIN_JSON=
 POLYWEATHER_PAYMENT_RECEIVER_CONTRACT=
-POLYWEATHER_PAYMENT_TOKEN_ADDRESS=0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174
+POLYWEATHER_PAYMENT_DIRECT_RECEIVER_ADDRESS=
+POLYWEATHER_PAYMENT_TOKEN_ADDRESS=0x3c499c542cef5e3811e1192ce70d8cc03d5c3359
 POLYWEATHER_PAYMENT_TOKEN_DECIMALS=6
+# Multi-token / multi-chain payment routes. Token rows can include:
+# chain_id, chain_code, chain_name, receiver_contract, direct_receiver_address,
+# supports_contract_checkout, supports_direct_transfer, confirmations,
+# explorer_tx_url.
 POLYWEATHER_PAYMENT_ACCEPTED_TOKENS_JSON=
 POLYWEATHER_PAYMENT_CONFIRMATIONS=2
 POLYWEATHER_PAYMENT_INTENT_TTL_SEC=1800
@@ -193,28 +219,9 @@ POLYWEATHER_PAYMENT_TELEGRAM_NOTIFY_ENABLED=true
 POLYWEATHER_PAYMENT_POINTS_ENABLED=true
 POLYWEATHER_PAYMENT_POINTS_PER_USDC=500
 POLYWEATHER_PAYMENT_POINTS_MAX_DISCOUNT_USDC=3
-POLYWEATHER_PAYMENT_ALLOWED_PLAN_CODES=pro_monthly
+POLYWEATHER_PAYMENT_POINTS_MAX_DISCOUNT_USDC_BY_PLAN_JSON={"pro_monthly":3,"pro_quarterly":8}
+POLYWEATHER_PAYMENT_ALLOWED_PLAN_CODES=pro_monthly,pro_quarterly
 POLYWEATHER_PAYMENT_PLAN_CATALOG_JSON=
-
-# Polymarket market scan
-POLYMARKET_MARKET_SCAN_ENABLED=true
-POLYMARKET_GAMMA_URL=https://gamma-api.polymarket.com
-POLYMARKET_CLOB_URL=https://clob.polymarket.com
-POLYMARKET_CHAIN_ID=137
-POLYMARKET_HTTP_TIMEOUT_SEC=20
-POLYMARKET_MARKET_CACHE_TTL_SEC=60
-POLYMARKET_PRICE_CACHE_TTL_SEC=30
-# false = fetch CLOB book/depth for orderbook analysis; true = price-only, lighter but no book levels
-POLYMARKET_FAST_PRICE_ONLY=false
-POLYWEATHER_MARKET_SCAN_PAYLOAD_TTL_SEC=30
-POLYMARKET_WS_PRICE_ENABLED=false
-POLYMARKET_WS_MARKET_URL=wss://ws-subscriptions-clob.polymarket.com/ws/market
-POLYMARKET_WS_QUOTE_TTL_SEC=8
-POLYMARKET_WS_MAX_ASSETS=256
-POLYMARKET_WS_RECONNECT_DELAY_SEC=3
-POLYMARKET_DISCOVERY_PAGES=6
-POLYMARKET_DISCOVERY_LIMIT=200
-POLYMARKET_SIGNAL_MIN_LIQUIDITY=500
 POLYMARKET_SIGNAL_EDGE_PCT=2
 
 # Polygon watcher
@@ -232,36 +239,9 @@ POLYGON_WALLET_WATCH_POLYMARKET_ONLY=true
 POLYGON_WALLET_WATCH_INCLUDE_DEFAULT_PM_CONTRACTS=true
 POLYGON_WALLET_WATCH_POLYMARKET_CONTRACTS=
 
-# Polymarket wallet activity (retired; replaced by market monitor digests + critical alerts)
-POLYMARKET_WALLET_ACTIVITY_ENABLED=false
-POLYMARKET_WALLET_ACTIVITY_USERS=
-POLYMARKET_WALLET_ACTIVITY_CHAT_ID=
-POLYMARKET_WALLET_ACTIVITY_CHAT_IDS=
-POLYMARKET_WALLET_ACTIVITY_TOPIC_CHAT_ID=
-POLYMARKET_WALLET_ACTIVITY_TOPIC_ID=
-POLYMARKET_WALLET_ACTIVITY_USER_ALIASES=
-POLYMARKET_WALLET_ACTIVITY_DATA_API_URL=https://data-api.polymarket.com
-POLYMARKET_WALLET_ACTIVITY_INTERVAL_SEC=20
-POLYMARKET_WALLET_ACTIVITY_TIMEOUT_SEC=10
-POLYMARKET_WALLET_ACTIVITY_MIN_SIZE_ABS=0.001
-POLYMARKET_WALLET_ACTIVITY_MIN_SIZE_DELTA=0.001
-POLYMARKET_WALLET_ACTIVITY_MIN_AVG_PRICE_DELTA=0.002
-POLYMARKET_WALLET_ACTIVITY_IMMEDIATE_ON_SIZE_DELTA=true
-POLYMARKET_WALLET_ACTIVITY_IMMEDIATE_SIZE_DELTA_MIN=0.001
-POLYMARKET_WALLET_ACTIVITY_IMMEDIATE_COOLDOWN_SEC=20
-POLYMARKET_WALLET_ACTIVITY_MAX_CHANGES_PER_MSG=5
-POLYMARKET_WALLET_ACTIVITY_NOTIFY_CLOSED=false
-POLYMARKET_WALLET_ACTIVITY_BOOTSTRAP_ALERT=false
-POLYMARKET_WALLET_ACTIVITY_LINK_PREVIEW=true
-POLYMARKET_WALLET_ACTIVITY_UPDATE_DEBOUNCE_SEC=30
-POLYMARKET_WALLET_ACTIVITY_UPDATE_MAX_HOLD_SEC=120
-POLYMARKET_WALLET_ACTIVITY_AVG_PRICE_SHOW_MIN=0.01
-POLYMARKET_WALLET_ACTIVITY_AVG_PRICE_SHOW_MAX=0.99
-POLYMARKET_WALLET_ACTIVITY_MIN_POSITION_VALUE_USD=0
-POLYMARKET_WALLET_ACTIVITY_MIN_VALUE_EXEMPT_USERS=
-
 ########################################
 # 8) Optional proxies
 ########################################
 HTTPS_PROXY=
 HTTP_PROXY=
+POLYWEATHER_TELEGRAM_JOIN_INELIGIBLE_ACTION=decline

.env.secrets.example

@@ -6,6 +6,9 @@
 # Telegram
 ########################################
 TELEGRAM_BOT_TOKEN=
+POLYWEATHER_TELEGRAM_GROUP_ID=
+POLYWEATHER_GROUP_MEMBER_PRICE_USDC=10
+POLYWEATHER_PUBLIC_PRICE_USDC=10
 
 ########################################
 # Supabase
@@ -16,6 +19,12 @@ SUPABASE_SERVICE_ROLE_KEY=
 NEXT_PUBLIC_SUPABASE_URL=
 NEXT_PUBLIC_SUPABASE_ANON_KEY=
 
+########################################
+# Cloudflare Turnstile
+########################################
+NEXT_PUBLIC_TURNSTILE_SITE_KEY=
+POLYWEATHER_TURNSTILE_SECRET_KEY=
+
 ########################################
 # Entitlement / dashboard
 ########################################
@@ -31,10 +40,20 @@ METEOBLUE_API_KEY=
 # Wallet / payments
 ########################################
 NEXT_PUBLIC_WALLETCONNECT_PROJECT_ID=
+POLYWEATHER_PAYMENT_RPC_URLS_BY_CHAIN_JSON=
 POLYWEATHER_PAYMENT_RECEIVER_CONTRACT=
+POLYWEATHER_PAYMENT_DIRECT_RECEIVER_ADDRESS=
 POLYWEATHER_PAYMENT_ACCEPTED_TOKENS_JSON=
 POLYWEATHER_PAYMENT_PLAN_CATALOG_JSON=
 
+########################################
+# Cloudflare R2 archive
+########################################
+POLYWEATHER_R2_ACCOUNT_ID=
+POLYWEATHER_R2_BUCKET=
+POLYWEATHER_R2_ACCESS_KEY_ID=
+POLYWEATHER_R2_SECRET_ACCESS_KEY=
+
 ########################################
 # Optional exchange / market secrets
 ########################################

.github/workflows/ci.yml

@@ -21,7 +21,7 @@ jobs:
       - name: Install dependencies
         run: |
           python -m pip install --upgrade pip
-          pip install -r requirements.txt -r requirements-dev.txt
+          pip install --extra-index-url https://download.pytorch.org/whl/cpu -r requirements.lock -r requirements-dev.lock
 
       - name: Ruff
         run: python -m ruff check .
@@ -51,14 +51,115 @@ jobs:
       - name: Business state tests
         run: npm run test:business
 
-      - name: Build
-        run: npm run build
+  build-and-push:
+    needs: [python-quality, frontend-quality]
+    if: github.event_name == 'push' && github.ref == 'refs/heads/main'
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        image:
+          - name: backend
+            context: .
+            file: Dockerfile
+            tag: ghcr.io/yangyuan-zhen/polyweather-backend
+          - name: frontend
+            context: ./frontend
+            file: ./frontend/Dockerfile
+            tag: ghcr.io/yangyuan-zhen/polyweather-frontend
+    permissions:
+      contents: read
+      packages: write
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
 
-  docker-build:
+      - name: Login to GHCR
+        uses: docker/login-action@v3
+        with:
+          registry: ghcr.io
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Build and push image
+        env:
+          IMAGE_NAME: ${{ matrix.image.name }}
+          IMAGE_CONTEXT: ${{ matrix.image.context }}
+          IMAGE_FILE: ${{ matrix.image.file }}
+          IMAGE_TAG: ${{ matrix.image.tag }}
+          NEXT_PUBLIC_SUPABASE_URL: ${{ secrets.NEXT_PUBLIC_SUPABASE_URL }}
+          NEXT_PUBLIC_SUPABASE_ANON_KEY: ${{ secrets.NEXT_PUBLIC_SUPABASE_ANON_KEY }}
+          NEXT_PUBLIC_SITE_URL: ${{ secrets.NEXT_PUBLIC_SITE_URL || 'https://polyweather.top' }}
+          NEXT_PUBLIC_POLYWEATHER_API_BASE_URL: ${{ secrets.NEXT_PUBLIC_POLYWEATHER_API_BASE_URL || '' }}
+          NEXT_PUBLIC_WALLETCONNECT_PROJECT_ID: ${{ secrets.NEXT_PUBLIC_WALLETCONNECT_PROJECT_ID || '' }}
+          NEXT_PUBLIC_WALLETCONNECT_POLYGON_RPC_URL: ${{ secrets.NEXT_PUBLIC_WALLETCONNECT_POLYGON_RPC_URL || 'https://polygon-bor-rpc.publicnode.com' }}
+          NEXT_PUBLIC_PAYMENT_ALLOWED_HOSTS: ${{ secrets.NEXT_PUBLIC_PAYMENT_ALLOWED_HOSTS || 'polyweather.top,www.polyweather.top' }}
+          NEXT_PUBLIC_TURNSTILE_SITE_KEY: ${{ secrets.NEXT_PUBLIC_TURNSTILE_SITE_KEY || '' }}
+        run: |
+          set -euo pipefail
+
+          tags=(-t "${IMAGE_TAG}:latest" -t "${IMAGE_TAG}:${GITHUB_SHA}")
+          build_args=()
+
+          if [ "${IMAGE_NAME}" = "frontend" ]; then
+            build_args=(
+              --build-arg "NEXT_PUBLIC_SUPABASE_URL=${NEXT_PUBLIC_SUPABASE_URL}"
+              --build-arg "NEXT_PUBLIC_SUPABASE_ANON_KEY=${NEXT_PUBLIC_SUPABASE_ANON_KEY}"
+              --build-arg "NEXT_PUBLIC_SITE_URL=${NEXT_PUBLIC_SITE_URL}"
+              --build-arg "NEXT_PUBLIC_POLYWEATHER_API_BASE_URL=${NEXT_PUBLIC_POLYWEATHER_API_BASE_URL}"
+              --build-arg "NEXT_PUBLIC_POLYWEATHER_LOCAL_FULL_ACCESS=false"
+              --build-arg "NEXT_PUBLIC_WALLETCONNECT_PROJECT_ID=${NEXT_PUBLIC_WALLETCONNECT_PROJECT_ID}"
+              --build-arg "NEXT_PUBLIC_WALLETCONNECT_POLYGON_RPC_URL=${NEXT_PUBLIC_WALLETCONNECT_POLYGON_RPC_URL}"
+              --build-arg "NEXT_PUBLIC_PAYMENT_ALLOWED_HOSTS=${NEXT_PUBLIC_PAYMENT_ALLOWED_HOSTS}"
+              --build-arg "NEXT_PUBLIC_TURNSTILE_SITE_KEY=${NEXT_PUBLIC_TURNSTILE_SITE_KEY}"
+            )
+          fi
+
+          docker build -f "${IMAGE_FILE}" "${tags[@]}" "${build_args[@]}" "${IMAGE_CONTEXT}"
+          docker push "${IMAGE_TAG}:latest"
+          docker push "${IMAGE_TAG}:${GITHUB_SHA}"
+
+  cloudflare-cache-rules:
+    needs: [python-quality]
+    if: github.event_name == 'push' && github.ref == 'refs/heads/main'
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
         uses: actions/checkout@v4
 
-      - name: Build Docker image
-        run: docker build -t polyweather-ci .
+      - name: Apply Cloudflare cache rules
+        env:
+          CLOUDFLARE_API_TOKEN: ${{ secrets.CLOUDFLARE_API_TOKEN }}
+          CLOUDFLARE_ZONE_ID: ${{ secrets.CLOUDFLARE_ZONE_ID }}
+        run: |
+          if [ -z "${CLOUDFLARE_API_TOKEN}" ]; then
+            echo "CLOUDFLARE_API_TOKEN is not configured; skipping Cache Rules sync"
+            exit 0
+          fi
+          if [ -z "${CLOUDFLARE_ZONE_ID}" ]; then
+            echo "CLOUDFLARE_ZONE_ID is not configured; skipping Cache Rules sync"
+            exit 0
+          fi
+          python scripts/configure_cloudflare_free.py --apply
+
+  deploy:
+    needs: [build-and-push]
+    if: github.event_name == 'push' && github.ref == 'refs/heads/main'
+    runs-on: ubuntu-latest
+    concurrency:
+      group: polyweather-production-deploy
+      cancel-in-progress: false
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Deploy to VPS
+        env:
+          GHCR_PAT: ${{ secrets.GHCR_PAT }}
+        run: |
+          mkdir -p ~/.ssh
+          echo "${{ secrets.VPS_SSH_KEY }}" > ~/.ssh/id_rsa
+          chmod 600 ~/.ssh/id_rsa
+          scp -o StrictHostKeyChecking=accept-new deploy.sh ${{ secrets.VPS_USER }}@${{ secrets.VPS_HOST }}:/tmp/deploy.sh
+          printf '%s\n' "$GHCR_PAT" | ssh -o StrictHostKeyChecking=accept-new ${{ secrets.VPS_USER }}@${{ secrets.VPS_HOST }} "
+            bash /tmp/deploy.sh '${{ github.sha }}'
+          "

.gitignore

@@ -1,11 +1,16 @@
 # Secrets
 .env
 
+# Scratch / temp scripts
+scratch/
+
 # Data and Logs
 data/*.db
 data/*.db-*
 data/*.db.*
 data/*.json
+!data/city_thread_ids.json
+data/*backtest*.csv
 data/logs/
 data/historical/
 data/cache/
@@ -39,6 +44,11 @@ Thumbs.db
 frontend/node_modules/
 frontend/.next/
 frontend/.vercel/
+frontend/.env
+frontend/.env.local
+frontend/.env.production
+frontend/.env.*
+!frontend/.env.example
 frontend/*.tsbuildinfo
 frontend/.codex-next-dev*.log
 frontend/.codex-next-start*.log
@@ -63,3 +73,9 @@ frontend/.next-start.log
 .codex/skills/.system/**
 !.codex/prompts/
 !.codex/prompts/**
+tmp_apikey.js
+tmp_obs.js
+tmp_rctp.html
+.codex-backend-*.log
+frontend-next-*.log
+*.stackdump

.vscode/settings.json

@@ -1,5 +1,8 @@
 {
   "css.validate": false,
   "scss.validate": false,
-  "less.validate": false
+  "less.validate": false,
+  "python.analysis.extraPaths": [
+    "./"
+  ]
 }

AGENTS.md

@@ -0,0 +1,78 @@
+# PolyWeather Agent Instructions
+
+## 语言和沟通
+
+- 默认用中文回复用户。
+- 直接说明正在做什么、查到了什么、下一步是什么；不要写空泛客套话。
+- 如果用户要求“提交推送”“部署”“看日志”，必须在本地验证后再提交、推送，并检查 GitHub Actions 或线上状态。
+- 不要把多个不相关任务混在一个结论里；遇到新方向时，建议用户在同一个 Project 下开新 Thread。
+
+## 项目和线程使用
+
+- 一个 Project 对应 PolyWeather 这个共享代码库和长期方向。
+- 每个具体任务使用一条独立 Thread / Chat，例如：
+  - 落地页与产品包装
+  - 观测数据采集与 SSE patch
+  - Telegram 推送
+  - 付款与会员
+  - 部署、CI、服务器状态
+- 同一个 Project 下的 Thread 共享文件夹和 `AGENTS.md`，但上下文分开，避免旧问题影响新任务判断。
+
+## 代码工作原则
+
+- 先读现有代码和配置，再改动；优先沿用项目已有模式。
+- 使用 `rg` / `rg --files` 查找文件和文本。
+- 手动编辑文件使用 `apply_patch`。
+- 不要回滚用户或其他 agent 已经做过的无关改动。
+- 只改和当前任务直接相关的文件，避免顺手重构。
+- 新增复杂逻辑时补充聚焦测试；窄改动保持验证范围匹配风险。
+
+## 前端约定
+
+- 前端位于 `frontend/`，使用 Next.js、React、TypeScript。
+- UI 修改必须关注移动端响应式、文本不重叠、按钮和标签不溢出。
+- 图表、终端、详情面板等工作界面应保持信息密度和可扫描性，避免营销式装饰。
+- 常用验证：
+  - `cd frontend && npm run test:business`
+  - `cd frontend && npm run typecheck`
+  - 必要时启动本地预览并用浏览器检查桌面和移动视口；检查完关闭本地端口。
+
+## 后端和数据约定
+
+- Python 代码主要位于 `src/`、`web/`、`tests/`。
+- 观测数据刷新应以数据源原生频率为准，避免 Web、collector、Telegram 同时强刷同一外部源。
+- Telegram 默认只读最新缓存/DB；除非完全没有缓存，才允许兜底刷新。
+- 对外部源调用要考虑 singleflight、冷却、缓存和失败降级，避免 502/408 或 Supabase/磁盘 IO 压力。
+- 常用验证：
+  - `python -m ruff check .`
+  - `python -m pytest`
+
+## CI、提交和部署
+
+- `main` push 会触发 `.github/workflows/ci.yml`：
+  - `python-quality`
+  - `frontend-quality`
+  - `build-and-push`
+  - `deploy`
+- 提交前至少运行和改动相关的验证；推送前确认 `git status --short`。
+- 推送后检查 GitHub Actions 最新 run；如果失败，先定位失败 job 和 step，再修改。
+- 线上 smoke check 优先检查：
+  - `https://api.polyweather.top/healthz`
+  - `https://polyweather.top/`
+  - 相关页面或 API 路径
+
+## 产品方向备忘
+
+- PolyWeather 当前重点不是售卖 API。
+- 核心差异化是结算源优先、实时观测源、跑道/城市细粒度温度、SSE patch、Telegram 缓存读取和面向交易/预测市场的解释能力。
+- 公开包装、教育内容、图表变量完整度和付费分层可以加强，但不要把产品定位改成通用天气 API。
+
+## Memory 说明
+
+- `AGENTS.md` 是项目内显式规则，跟随仓库和 Project。
+- Memory 是用户账号级偏好设置，agent 不能代替用户开启。
+- 建议在 Codex / ChatGPT 设置中开启 Memory，并保存长期偏好，例如：
+  - PolyWeather 项目默认中文回复。
+  - 每个任务开独立 Thread。
+  - 修改后优先验证、提交、推送并检查部署状态。
+  - 不要主动把 PolyWeather 包装成 API 售卖产品。

CHANGELOG.md

@@ -1,6 +1,72 @@
 # Changelog
 
-## 1.6.0 - 2026-05-10
+## 1.8.1 - 2026-05-28
+
+### 文档与发布
+- README / README_ZH 改用 `frontend/public/static/web.png` 与 `frontend/public/static/tel.png` 作为产品截图，并移除旧 `docs/images` README 截图引用。
+- 同步版本源到 `1.8.1`，刷新 API、Supabase、技术债、PolygonScan 验证等文档标题版本。
+- 更新前端、实时事件、数据源、模型栈与服务文档，补齐 Redis Stream + SSE Patch、DEB hourly consensus、城市当地时间图表、legacy 高斯图表叠加、跑道/CoWIN 曲线和中英文 Telegram 推送口径。
+
+### 当前线上口径确认
+- 生产实时层为“HTTP snapshot + SSE patch + replayable event store”；前端只消费 `/api/events`，不直接连接 Redis。
+- `deb_hourly_consensus.v1` 是峰值窗口与 DEB 曲线展示的优先小时路径；DEB 不作为实测来源。
+- AMSC/AMOS 跑道曲线和香港 CoWIN 6087 参考站曲线按城市当地时间展示，结算跑道高亮，辅助跑道弱化。
+
+
+## 1.8.0 - 2026-05-27
+
+### 新增与重构
+- **终端大洲区域过滤与分组**：终端重构支持按大洲/区域过滤与分组，添加移动端大洲 Tab 与卡片流响应式布局。
+- **巨鲸盯盘面板**：对接 Polymarket Data API `/holders`，按区域展示 Polymarket 成交量最大的城市、温度合约及真实巨鲸持仓数据。
+- **气温走势图升级**：使用 Recharts 交互式图表，支持双向概率分布对比柱状图，并在图表底部渲染 Polymarket 市场点击直达链接。
+- **日内偏差动态修正**：引入实时偏差修正算法，用实况观测与多模型小时预报的偏差来动态修正 DEB 预报中枢以及 Mu 概率分布，极大提高了预报和校准的精度。
+- **多数据源气温监控图表**：引入 `LiveTemperatureThresholdChart` 组件，展示实时跑道观测、DEB 预报中枢、多模型区间及目标阈值。
+- **全站中文化与多语言 (i18n)**：全站支持中英文一键切换，硬编码字符串彻底清理并接入翻译词条。
+- **机构落地页与鉴权优化**：首页重构为专业的机构落地页，添加了基于中间件的双层终端门控（/terminal 路由和 landing page 登录态感知）。
+- **超大组件拆分与解耦**：`AccountCenter` 组件彻底重构拆分为多个细粒度 Hook（`useWalletBind`、`usePaymentFlow`、`useBilling`），主组件代码缩减 60%，提升可维护性。
+- **Telegram 高频推送与内存优化**：机场观测推送重构，限制 LRU 缓存避免内存膨胀，并针对 Bot 动作和 API 接入进行连接复用与速率限制。
+
+### 修复与优化
+- **类型异常修复**：修复在 `_in_peak_time_window` 决策卡时间窗口计算中 `last_h` 为 `None` 导致 `NoneType` 异常报错的问题。
+- **清理冗余类型转换**：移除 `src/utils/telegram_push.py` 中 8 处冗余的 `str()` 显式包装，精简 Python 代码。
+
+
+## 1.7.0 - 2026-05-23
+
+### 新增能力
+- 市场监控面板（MonitorPanel）：22 城实时温度监控，温度分辨率链（AMOS 跑道 → airport_primary → airport_current → current），按数据源新鲜度驱动刷新
+- 中国城市天气日报：AI 生成每日天气摘要，接入 CMA weather.com.cn 预报数据，推送至 Telegram 论坛群
+- 后台管理系统重写：从 1694 行单页拆分为 9 个模块（总览、会员、订阅、支付、训练、Telegram 审计、健康检查、配置、日志），含漏斗图、KPI 卡片、缓存饼图、增长趋势图
+- 跑道观测系统重构：全跑道展示、结算跑道标注、热力模型、风场分析，推送增加市场状态标签（超预期/升温中/冲顶观察/降温中）
+- 新增 6 个高频数据源：AEROWEB (Météo-France)、NCM (沙特)、IMS Lod (以色列)、AMSC AWOS (中国跑道)、MSS 1 分钟 (新加坡)、AROME HD 15 分钟 (巴黎)
+- 接入 HKO 1 分钟、流浮山 LFS 1 分钟、CWA 10 分钟 (台北松山) 实时温度
+- NOAA MADIS HFMETAR 适配新格式（netCDF stationId 替代 icaoId）+ 目录迁移适配
+- KNMI 适配新数据布局 (station,time) + 5 位 WMO 码 + S3 下载认证修复
+- 新增 GET /api/cities/model-range 端点
+- 积分转账功能：管理员手动扣除/划转用户积分
+- 支付提交前 Tx 预校验：链上验签收款地址与金额
+- CI 全流程自动化：测试通过后自动 SSH 部署到 VPS
+- 一键部署脚本：deploy.sh + deploy.ps1
+
+### 移除
+- 删除 LGBM 全部代码和模型文件，概率路径收口为 legacy 高斯分桶
+- 删除 Polymarket 价格拉取与 UI 层（MarketDecisionLine）
+- 删除 Groq、Meteoblue、NMC、俄罗斯 pogodaiklimat 数据源
+- 删除预热（prewarm）系统
+- 删除市场提醒引擎（market_alert_engine）
+- 删除 Lagos、Masroor Air Base 城市
+- 移除季付/年付计划，统一月付 10 USDC
+
+### 修复与优化
+- 修复移动端城市列表搜索无数据、Leaflet flyTo NaN 崩溃
+- 修复 MacBook Safari 布局崩溃（100vw/dvh、-webkit-backdrop-filter、grid minmax 溢出）
+- 修复温度曲线图三个渲染问题：数据点过少、张力过高、canvas CSS 拉伸
+- 修复 Open-Meteo 冷却期无限循环导致多模型数据缺失
+- 修复转化漏斗数据显示 3750%（前端重复乘以 100）
+- 多模型缓存优化 + ETag 缓存 + stale-while-revalidate
+- 性能优化：Context 重渲染、LGBM 循环移除、TTL 对齐
+- 账户页 Pro 状态偶发性丢失修复
+- 机场推送重构：观测缓存分离 + 全城市覆盖 + 四路并发
 
 - 全面修复前端 UI 设计审查 15 项问题：消除工程债务、统一 token 体系、提升可维护性
 - CSS 架构：消除 !important 滥用（134→49，仅保留 Leaflet/图表所必需项）、浅色主题重构为 `html.light` 选择器体系
@@ -54,7 +120,7 @@
 - 右侧详情面板识别稀疏 detail / 单日 forecast 中间态，并显示同步占位卡，避免用户把未补齐数据误认为完整结果
 - 概率区改为“校准模型概率”：有 LGBM 时展示 LGBM 校准概率；模型共识与市场价格降级为辅助参考
 - 模型层补齐 DWD ICON、ECMWF AIFS、ECCC GEM/GDPS/RDPS/HRDPS 等开放模型说明，并明确 AIFS 不称作“AI 预报”
-- 新增 / 补齐 Manila、Karachi、Masroor Air Base 等城市说明；机场市场以 METAR / 机场主站为结算锚点，Wunderground 仅作为历史页面或参考入口
+- 新增 / 补齐 Manila、Karachi 等城市说明；机场市场以 METAR / 机场主站为结算锚点，Wunderground 仅作为历史页面或参考入口
 - 历史对账、模型栈、LGBM、监控、前端 README 与网页 `/docs` 文档同步更新到当前产品口径
 
 ## 1.5.3 - 2026-04-10

CLAUDE.md

@@ -4,150 +4,143 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
 
 ## Project Overview
 
-PolyWeather Pro — a production weather-intelligence stack for temperature settlement markets. Aggregates observations and forecasts for 52 monitored cities globally, blends multi-model highs using DEB (Dynamic Error Balancing), generates calibrated probability buckets for settlement, maps weather to Polymarket quotes for mispricing scans, and serves both a Next.js dashboard (Vercel) and a Telegram bot.
+PolyWeather Pro — a paid institutional weather-intelligence terminal. 50 monitored cities with real-time METAR/AMOS/MADIS observations, DEB multi-model temperature blending, Mu probability calibration, and intraday bias correction. Pure meteorological decision workspace; no market/price layer. Next.js 15 + React 19 frontend (Docker / VPS, behind Cloudflare + Nginx), FastAPI backend (VPS), Telegram bot.
 
-## Environment & Preferences (ALWAYS follow)
+**Business model**: Paid-only, 29.9 USDC/month or 79.9 USDC/quarter, referral first month 20 USDC. New users get a one-time 3-day trial. Landing page is public; `/terminal` requires login + active subscription.
 
-### Working Directory
-- All commands run from the repo root: `E:/web/PolyWeather`
-- Frontend dev server: `cd frontend && npm run dev` → http://localhost:3000
-- Backend API server: `uvicorn web.app:app --reload --host 0.0.0.0 --port 8000` → http://localhost:8000
-- When I say "start the server", assume the correct working directory is `E:/web/PolyWeather`
+## Environment & Preferences
 
-### Git Conventions
-- **Commit language: Chinese (简体中文) ONLY**
-- Format: Lore Commit Protocol — intent line in Chinese, trailers in English
-- Examples: `重构城市决策卡 hero 布局` or `统一 DEB 数据源为单一计算路径`
-- **NEVER** use English for commit subject lines
-
-### Tooling
-- Package manager: **npm** (not yarn/pnpm)
+- Working directory: repo root
 - Python: `python` (not python3), venv at `venv/`
-- Lint: `ruff check .` (Python) + `npx tsc --noEmit` (TypeScript)
-- NEVER ask me about these preferences again — commit to memory
+- Frontend: `cd frontend && npm run dev` → localhost:3000
+- Backend: `uvicorn web.app:app --reload --host 0.0.0.0 --port 8000`
+- Package manager: **npm** (not yarn/pnpm)
+- **Commit language: Chinese (简体中文) ONLY**
+- **NEVER start commit messages with `@`** — Chinese directly, no prefix
+
+## Commands
+
+```bash
+# Frontend
+cd frontend
+npm run dev          # dev server :3000
+npm run build        # production build
+npm run typecheck    # tsc --noEmit
+npm run test:business  # 19 business state tests
+
+# Backend
+uvicorn web.app:app --reload --host 0.0.0.0 --port 8000
+python bot_listener.py   # Telegram bot
+
+# Python tests
+python -m pytest tests/
+python -m pytest tests/test_supabase_entitlement.py
+
+# Lint
+ruff check .
+ruff format .
+
+# Docker (VPS)
+docker compose down && docker compose up -d --build
+```
 
 ## Architecture
 
 ```
-Users (Web / Telegram) → Next.js Frontend (Vercel) → FastAPI /web/app.py
-                                                      ↓
-                                            Weather Collector (METAR, TAF, Open-Meteo, country networks)
-                                                      ↓
-                                            Analysis (DEB + Trend + Probability + Market Scan)
-                                                      ↓
-                                            Payment Layer (Intent + Event + Confirm Loop)
+Users → Cloudflare → Nginx → Docker Compose (VPS)
+                                 ├── Next.js frontend → FastAPI :8000
+                                 │     /terminal (paid gate)    Weather Collector
+                                 │     / (landing page)         Analysis (DEB + Mu)
+                                 │                               Payment Layer (USDC on Polygon)
+                                 └── Redis (SSE event store)
+         Telegram Bot → bot_listener.py
 ```
 
-- **Backend**: FastAPI on port 8000 (`web/app.py` → `web/core.py` + `web/routes.py` + `web/analysis_service.py`)
-- **Frontend**: Next.js 15 + React 19 + TypeScript + Tailwind CSS 3 on port 3000 (dev)
-- **Bot**: Telegram bot via `bot_listener.py` → `src/bot/`
-- **Shared analysis core** in `src/` is used by both web API and bot
-- **Scan Terminal**: Real-time city opportunity scanning (`web/scan_terminal_service.py` and `frontend/components/dashboard/scan-terminal/`)
-- **Dashboard**: Main dashboard with interactive map, city sidebar, detail panels, and probability views
+### Frontend Structure
 
-## Commands
+| Path | Purpose |
+|------|---------|
+| `app/page.tsx` | Landing page (`InstitutionalLandingPage`) |
+| `app/terminal/page.tsx` | Paid terminal (`ScanTerminalDashboard`) |
+| `app/account/` | Account center with payment/subscription |
+| `app/auth/` | Supabase login/signup |
+| `components/dashboard/scan-terminal/` | Terminal sub-components |
+| `components/account/` | Account + payment hooks |
+| `components/landing/` | Institutional landing page |
+| `components/subscription/` | `UnlockProOverlay` payment overlay |
+| `lib/dashboard-types.ts` | All TypeScript types |
 
-### Frontend (dev on port 3000)
-```bash
-cd frontend
-npm ci
-npm run dev        # Next.js dev server
-npm run build      # Production build
-npm run lint       # ESLint via next lint
-```
+### Terminal Component Map
 
-### Backend (dev on port 8000)
-```bash
-uvicorn web.app:app --reload --host 0.0.0.0 --port 8000
-```
+- `ScanTerminalDashboard.tsx` — entry, auth gate, `ProductAccessRequired`
+- `PolyWeatherTerminal` — main layout: sidebar + region tabs + 2-column grid
+- `CityRegionList` — city list panel (left top)
+- `CityContractDetail` — contract table panel (left bottom)
+- `LiveTemperatureThresholdChart` — multi-source overlay: obs + DEB + model curves + thresholds
+- `RealtimeScrollChart` — lightweight realtime scrolling temperature + threshold bars
+- `TrainingDashboard` — DEB + Mu accuracy charts (sidebar "训练数据" tab)
+- `continent-grouping.ts` — 7 trading regions (`TRADING_REGIONS`), city-to-region fallback (`CITY_REGION_FALLBACK`), timezone detection (`detectLocalRegion`)
 
-### Telegram Bot
-```bash
-python bot_listener.py
-# or via wrapper:
-python run.py
-```
+### Account Module
 
-### Docker (production-like stack)
-```bash
-docker compose up -d --build                    # bot + web API
-docker compose --profile workers up -d          # + prewarm worker
-docker compose --profile monitoring up -d       # + Prometheus/Grafana/Alertmanager
-```
+- `AccountCenter.tsx` (~1280 lines) — main component
+- `useAccountPayment.ts` — master payment hook, composes sub-hooks
+- `useWalletBind.ts` — EVM/WalletConnect binding
+- `usePaymentFlow.ts` — intent creation, payment, confirmation
+- `useBilling.ts` — subscription recovery, billing computation
 
-### Python tests
-```bash
-pytest tests/                           # all tests
-pytest tests/test_web_observability.py  # single test file
-```
+### Backend Key Files
 
-### Lint & Format
-```bash
-ruff check .        # Python lint (pycodestyle + Pyflakes, line-length 88)
-ruff format .       # Python format (Black-compatible, double quotes)
-```
+| Path | Purpose |
+|------|---------|
+| `web/routers/city.py` | City detail/summary/realtime-stream endpoints |
+| `web/routers/scan.py` | Scan terminal aggregation |
+| `web/services/city_payloads.py` | City detail and summary payload builders |
+| `web/scan_terminal_city_row.py` | Builds terminal rows from analysis data |
+| `src/data_collection/city_registry.py` | 50-city registry with tz_offset |
+| `src/analysis/deb_algorithm.py` | DEB prediction + Mu calibration + accuracy |
+| `web/services/analysis_utils.py` | Clock helpers, bucket labeling, time parsing |
+| `web/services/observation_freshness.py` | Source profiles and freshness computation |
+| `web/services/scan_ai_config.py` | Scan terminal and AI configuration constants |
 
-### Health & Ops checks
-```bash
-curl http://127.0.0.1:8000/healthz
-curl http://127.0.0.1:8000/api/system/status
-curl http://127.0.0.1:8000/metrics
-```
+## Auth Gating
 
-## Key Directories
+Middleware (`middleware.ts`) handles two layers:
+1. **Terminal gate** (`handleTerminalGate`): `/terminal/*` → redirect to `/auth/login` if no Supabase session
+2. **Global auth** (`handleSupabaseAuthGate`): enforced when `POLYWEATHER_AUTH_REQUIRED=true`
 
-| Directory | Purpose |
-|-----------|---------|
-| `src/data_collection/` | Weather sources (METAR, TAF, Open-Meteo, JMA, KMA, MGM, NMC, Russia stations, settlement sources), city registry (52 cities), Polymarket readonly layer |
-| `src/analysis/` | DEB algorithm, trend engine, probability calibration (EMOS/LGBM), market alert engine, settlement rounding |
-| `src/models/` | LightGBM daily-high model training and feature engineering |
-| `src/payments/` | Onchain checkout, event listener, confirm loop, contract audit |
-| `src/bot/` | Telegram bot handlers and orchestrator |
-| `src/database/` | SQLite-based runtime state, DB manager, daily/truth/training feature repositories |
-| `web/` | FastAPI app, routes (~65K), analysis service (~130K), scan terminal service (~56K), AI scan modules |
-| `frontend/app/` | Next.js App Router pages (dashboard, account, auth, docs, ops, probabilities, scan) |
-| `frontend/components/dashboard/` | Dashboard UI components (map, sidebar, detail panel, modals, charts, scan terminal). `scan-root-styles.ts` is the CSS Module barrel, combining 22 module roots into one pre-composed className |
-| `frontend/lib/` | Shared client logic: types, API client, chart utils, i18n, dashboard utils |
-| `frontend/hooks/` | React hooks: dashboard store (global state), Leaflet map, chart helper |
-| `scripts/` | Operational scripts: probability calibration training, backfills, payment reconciliation, prewarm worker |
-| `config/` | YAML config (city list, weather settings, logging) |
-| `docs/` | Bilingual product & technical docs |
-| `monitoring/` | Prometheus/Grafana/Alertmanager configs |
+Client-side gate (`ProductAccessRequired`): `/terminal` checks auth + subscription via `/api/auth/me`, shows paywall if needed.
 
-## Key Technical Details
+Local dev bypass: set `NEXT_PUBLIC_POLYWEATHER_LOCAL_FULL_ACCESS=false` to test auth locally.
 
-- **Python version**: 3.11 (target), type hints use `from __future__ import annotations` in most modules
-- **Package manager**: pip (requirements.txt) + uv cache is present but not the primary tool; no pyproject.toml build system defined
-- **Frontend package manager**: npm
-- **State storage**: SQLite primary path (set via `POLYWEATHER_STATE_STORAGE_MODE=sqlite` + `POLYWEATHER_DB_PATH`). Legacy JSON/JSONL files are migration/fallback only.
-- **Runtime data**: External dir recommended (`POLYWEATHER_RUNTIME_DATA_DIR=/var/lib/polyweather`) to avoid git conflicts
-- **Auth gating** (frontend middleware): Token-based (`POLYWEATHER_DASHBOARD_ACCESS_TOKEN`) or Supabase session-based (`POLYWEATHER_AUTH_ENABLED`). Local dev hosts bypass auth.
-- **CORS**: Allowed origins from `WEB_CORS_ORIGINS` env var (defaults: localhost:3000, polyweather-pro.vercel.app)
-- **EMOS/CRPS calibration**: Trainable but production should use `legacy` or `emos_shadow` engine; `emos_primary` only after local evaluation + manual rollout
-- **API proxy**: Frontend uses Next.js rewrites to proxy `/api/*` to the FastAPI backend; see `frontend/lib/api-proxy.ts` and `frontend/lib/backend-api.ts`
+## Polymarket Integration
 
-## Commit Convention
+**Removed.** No Polymarket price fetching, no market scan, no WS cache. Terminal operates on weather data only (Live observations + DEB predictions + model probabilities). All `polymarket_readonly.py`, `polymarket_ws_cache.py`, and market-scan API routes have been deleted.
 
-This repo uses the **Lore Commit Protocol** — structured decision records with git trailers (`Constraint:`, `Rejected:`, `Confidence:`, `Scope-risk:`, `Directive:`, `Tested:`, `Not-tested:`). Intent line first (why, not what).
+## Trading Regions
 
-- Always write git commit messages in **Chinese (简体中文)**.
+7 regions: east_asia, southeast_asia, central_asia, west_asia, europe_africa, south_america, north_america. Mappings in `continent-grouping.ts` (`CITY_REGION_FALLBACK` — all 50 cities hardcoded) and `scan_terminal_filters.py` (`market_region_from_tz_offset`). Default region auto-detected from browser timezone.
+
+## Scan Terminal Performance
+
+- **Region lazy-loading**: `region=east_asia` filters cities server-side before scanning (see `_market_region_from_tz_offset`)
+- **Weather-only**: Terminal returns 1 row per city with Live/DEB/probability data; no market contract matching
+- **DB**: SQLite WAL mode + `busy_timeout=5000` enabled in `db_manager.py` (fixes "database is locked" with parallel workers)
+- **VPS env**: `POLYWEATHER_SCAN_TERMINAL_MAX_WORKERS=2`, `POLYWEATHER_SCAN_TERMINAL_BUILD_TIMEOUT_SEC=180`
+- **Caching**: `_cache` is `LRUDict(256)` with `_CACHE_LOCK`; `_SUMMARY_CACHE` is `LRUDict(128)`; weather caches trimmed every 200 writes
+
+## Intraday Bias Correction
+
+`analysis_service.py:_analyze()` applies intraday correction after probability generation:
+- Compares current observed temp vs model hourly forecast for current hour
+- Time-of-day weight: 0.15↗0.35 pre-peak, 0.40↗0.75 during peak, 0.80 post-peak
+- Also checks if max-so-far already exceeds DEB prediction (strong upward nudge)
+- Correction capped at ±5°F / ±3°C, applied to both `deb_val` and `mu`
 
 ## Code Style
 
-- Never use Unicode escape sequences (`\uXXXX`) in source code; write characters directly in UTF-8 encoding.
-- When modifying UI components, update both **dark-mode and light-mode CSS files** in the same edit batch.
-- **CSS Variables First**: Prefer `var(--color-*)` / `var(--color-signal-*)` tokens over hardcoded hex values. The token system is defined in `globals.css` with light-theme overrides under `html.light`.
-- **Avoid `!important`**: Only use it for Leaflet map overrides (inline style conflict) and chart canvas sizing. For light-theme overrides, use `html.light .root` prefix for higher specificity.
-- **New CSS Modules**: Add the module root class to `scan-root-styles.ts` barrel file instead of importing it separately in `ScanTerminalDashboard.tsx`.
-
-## Quality Gates (MANDATORY)
-
-Before marking any task as complete, you MUST:
-
-1. **Type check** — Run `npx tsc --noEmit` (frontend) or `python -m ruff check .` (backend) on modified files
-2. **No Unicode escapes** — Verify that NO `\uXXXX` sequences were introduced; if found, revert and fix
-3. **Dual-theme CSS** — For any UI change, confirm BOTH the dark CSS module AND `ScanTerminalLightTheme.module.css` were updated
-4. **No new hardcoded palette colors** — Use `var(--color-*)` token references instead of `#4DA3FF` / `#E6EDF3` / `#9FB2C7` / `#6B7A90` hex values
-5. **Show the diff** — Output `git diff --stat` and test results before declaring success
-
-If any gate fails, fix it BEFORE reporting success.
+- No `\uXXXX` escapes — write characters directly in UTF-8
+- Use `var(--color-*)` CSS tokens, not hardcoded hex
+- Minimum font size: 10px (`text-[10px]`)
+- Avoid `!important` except Leaflet map overrides
+- Remove dead code immediately when features are removed

Dockerfile

@@ -1,26 +1,25 @@
+# syntax=docker/dockerfile:1
 FROM python:3.11-slim
 
-# 设置工作目录
 WORKDIR /app
 
-# 设置环境变量
 ENV PYTHONDONTWRITEBYTECODE=1 \
     PYTHONUNBUFFERED=1 \
     PIP_DISABLE_PIP_VERSION_CHECK=1 \
     PIP_ROOT_USER_ACTION=ignore \
     TZ=UTC
 
-# 安装系统依赖 (如果有必要的包可以取消注释)
-# RUN apt-get update && apt-get install -y --no-install-recommends gcc && rm -rf /var/lib/apt/lists/*
+RUN --mount=type=cache,target=/var/cache/apt,sharing=locked \
+    --mount=type=cache,target=/var/lib/apt,sharing=locked \
+    apt-get update && apt-get install -y --no-install-recommends \
+    gcc libhdf5-dev libnetcdf-dev && \
+    rm -rf /var/lib/apt/lists/*
 
-# 复制 requirements 文件
-COPY requirements.txt .
+COPY requirements.lock .
 
-# 安装 Python 依赖
-RUN pip install --no-cache-dir --prefer-binary -r requirements.txt
+RUN --mount=type=cache,target=/root/.cache/pip \
+    pip install --prefer-binary --extra-index-url https://download.pytorch.org/whl/cpu -r requirements.lock
 
-# 复制项目代码
 COPY . .
 
-# 启动机器人
 CMD ["python", "bot_listener.py"]

README.md

@@ -2,53 +2,58 @@
 
 Production weather-intelligence stack for temperature settlement markets.
 
-Official dashboard: [polyweather-pro.vercel.app](https://polyweather-pro.vercel.app/)
+Official dashboard: [polyweather.top](https://polyweather.top/)
 中文说明: [README_ZH.md](README_ZH.md)
 
-Public docs center: `/docs/intro` on the main site (bilingual product documentation, including intraday analysis, calibrated probability, model stack, TAF, settlement sources, history, and extension).
+Public docs center: `/docs/intro` on the main site (bilingual product documentation for the current terminal, chart reading, realtime source cadence, settlement stations, and the browser extension).
 
 ## Product Screenshots
 
-### Global Dashboard
+### Realtime Terminal
 
-![PolyWeather global dashboard](docs/images/demo_map.png)
+![PolyWeather realtime terminal](frontend/public/static/web.webp)
 
-### City Analysis (Ankara)
+### Telegram Runway Alerts
 
-![PolyWeather Ankara analysis](docs/images/demo_ankara.png)
+![PolyWeather Telegram runway alerts](frontend/public/static/tel.png)
 
 ## Star History
 
 [![Star History Chart](https://api.star-history.com/svg?repos=yangyuan-zhen/PolyWeather&type=Date)](https://star-history.com/#yangyuan-zhen/PolyWeather&Date)
 
-## Product Status (2026-04-27)
+## Product Status (2026-06-07)
 
-- Subscription live: `Pro Monthly 5 USDC`.
-- Points redemption live: `500 points = 1 USDC`, max `3 USDC` off.
-- Onchain checkout live: Polygon contract checkout (USDC / USDC.e).
+- Subscription live: `Pro Monthly 29.9 USDC / 30 days` and `Pro Quarterly 79.9 USDC / 90 days`.
+- Referral pricing live: invited users can get the first monthly Pro at `20 USDC`; inviters receive `3500` points after a valid first Pro payment, capped at 10 paid invites per month.
+- Points are redeemable for payment discounts (`500 pts = 1 USDC`, monthly max `3 USDC`, quarterly max `8 USDC`). Useful user feedback can also receive manual point rewards through ops.
+- Onchain checkout live: Polygon contract checkout (USDC / USDC.e) plus Ethereum mainnet USDC direct-transfer confirmation.
 - Auto-reconciliation live: event listener + periodic confirm loop.
-- Ops dashboard live: `/ops` for memberships, leaderboard, manual point grants, and payment incident triage.
+- Ops dashboard live: `/ops` for memberships, leaderboard, user feedback triage, manual point grants, and payment incident triage.
 - Lightweight observability live: `/healthz`, `/api/system/status`, `/metrics`.
+- Realtime terminal live: visible city charts subscribe through `/api/events?cities=...&since_revision=...`, receive `city_observation_patch.v1` SSE patches, and replay short gaps from Redis Stream in production or SQLite fallback in local/single-node mode.
+- Chart refresh is observation-driven: live patches merge into the current chart without a loading overlay; only visible charts run a 60s no-patch fallback, and returning from a background browser tab triggers a foreground catch-up refresh.
+- Temperature charts default to All Day, keep an optional Peak window derived from the DEB hourly path, and render all timestamps in the selected city's local time.
+- The chart core has been split into focused logic/canvas/state modules; Recharts now receives explicit measured dimensions to avoid 0x0 rendering and disappearing curves.
+- DEB hourly consensus (`deb_hourly_consensus.v1`) is now the preferred hourly forecast path for peak-window detection and chart overlays; DEB remains a forecast curve, never an observation source.
+- Legacy Gaussian probability stays out of the default temperature chart surface; hover tooltips show `Gaussian μ` plus the full bucket distribution by temperature range.
+- Settlement runway curves are visible by default for AMSC/AMOS cities; the configured settlement runway is highlighted and auxiliary runways are shown as secondary context.
+- Hong Kong uses CoWIN station `6087` (Po Leung Kuk Choi Kai Yau School) as the 1-minute reference-station curve, with HKO 10-minute observations kept as the official meteorological layer.
+- Telegram airport/runway pushes are bilingual by default and use settlement-endpoint runway temperatures for slope/current/summary copy.
 - Runtime state, cache, and core offline training/backfill flows now use SQLite as the primary path; legacy JSON/JSONL files remain only for migration, export, and explicit fallback input.
-- EMOS/CRPS calibration is wired and trainable, but production should stay on `legacy` or `emos_shadow`; `emos_primary` is only for candidates that pass local offline evaluation and manual rollout.
 - Intraday analysis is now positioned as a professional meteorology read: headline, confidence, base/upside/downside paths, next observation point, evidence chain, failure modes, and confirmation rules.
 - Intraday modal now blocks stale cached detail during refresh, so users do not briefly trade off old city/date data before full detail arrives.
-- City decision cards now include the AI airport read: METAR, DEB, model cluster, and the AI expected-high center are resolved before mapping the result to Polymarket temperature buckets.
-- AI airport reads now use in-page memory cache, browser `localStorage`, and backend short-TTL cache; returning from another dashboard tab restores existing stream text or final results before any new request is needed.
+- Terminal chart/detail workflow now combines settlement observations, DEB hourly consensus, model context, probability distribution tooltips, and market-bucket mapping without blocking the chart on AI text generation.
+- Terminal data uses page memory cache, browser `localStorage`, backend short-TTL cache, SSE patch replay, and foreground refresh so returning from another tab restores the latest visible chart state quickly.
 - Market bucket matching now uses the full `all_buckets` surface and strict exact / range / or-higher / or-lower direction checks, reducing bad matches to unreasonable tail buckets.
-- The card label “model-market difference” means `model probability - market-implied probability`; positive values indicate weather probability above market pricing, while negative values indicate the YES is already priced more fully.
-- Calibrated model probability is now the primary probability panel. It shows the active production probability engine; EMOS/LGBM are surfaced only when evaluated or shadowed, while model consensus and market prices remain secondary references.
+- The market-signal difference means `model probability - market-implied probability`; positive values indicate weather probability above market pricing, while negative values indicate the YES is already priced more fully.
+- Calibrated model probability is now the primary probability panel. It shows the active legacy Gaussian probability engine, while model consensus remains a secondary reference.
 - Non-Hong Kong airport cities now ingest `TAF` and parse `FM / TEMPO / BECMG / PROB30/40`.
 - Temperature chart now overlays `TAF Timing` markers near the expected peak window.
 - Trade cue now combines upper-air structure, `TAF`, market crowding, and `edge_percent`.
 - Browser extension now uses `DEB` for multi-day forecast and stays positioned as a lightweight lead-in to the main site.
-- Official nearby-network layer now covers `MGM` (Turkey), `CMA/NMC` (Mainland China), `JMA AMeDAS` (Japan), `KMA` (Korea), `HKO` (Hong Kong), and `CWA` (Taiwan).
+- Official nearby-network layer now covers `MGM` (Turkey), `CMA/NMC` (Mainland China), `JMA AMeDAS` (Japan), `AMOS` (Korea, runway-level, Seoul/Busan), `HKO` (Hong Kong), and `CWA` (Taiwan).
 - Tokyo now ingests Haneda `JMA AMeDAS` 10-minute temperature as the official enhancement layer.
-- Dashboard prewarm is now supported through a dedicated worker / cron path, with runtime status exposed in `/api/system/status` and `/ops`.
-- `/ops` now exposes cache bucket counts, summary cache hit / miss rate, and prewarm runtime heartbeat.
-- Intraday commentary can optionally use `Groq` as a bilingual rewrite layer, while rule-based commentary remains the fallback.
-- Vercel frontend guidance now includes cost controls for analytics, eager fetches, and edge-side scanner blocking.
-- Frontend design system overhauled: unified CSS token system, eliminated `!important` abuse (68→6 in light theme), consolidated breakpoints (18→10), migrated hardcoded colors to CSS variables, added ARIA attributes and focus-visible keyboard navigation. See `docs/frontend-ui-design-review.md` for the full audit trail.
+- Frontend design system overhauled: unified CSS token system, eliminated `!important` abuse (134→49 in light theme), consolidated breakpoints (18→10), migrated hardcoded colors to CSS variables, added ARIA attributes and focus-visible keyboard navigation. See `docs/frontend-ui-design-review.md` for the full audit trail.
 
 ## License & Commercial Boundary
 
@@ -62,23 +67,24 @@ See: [AGPL-3.0 & Commercial Boundary](docs/OPEN_CORE_POLICY.md)
 
 ## Core Capabilities
 
-- Aggregates observations and forecasts for 52 monitored cities.
+- Aggregates observations and forecasts for 51 monitored cities.
 - Uses DEB (Dynamic Error Balancing) to blend multi-model highs.
-- Generates settlement-oriented calibrated probability buckets (`mu` + bucket distribution), with `LGBM` metadata surfaced when the calibrated engine is active.
-- Maps weather view to Polymarket quotes for mispricing scan.
-- Adds city decision cards that combine AI airport reads, expected-high centers, full market-bucket mapping, and model-market difference in one view.
+- Builds a DEB-weighted hourly consensus path for peak-window logic and chart display.
+- Generates settlement-oriented calibrated probability buckets (`mu` + bucket distribution) via the legacy Gaussian calibration path.
+- Adds terminal chart/detail workflows that combine live observations, DEB-centered high-temperature context, market-bucket mapping, and model-market difference.
+- Shows calibrated Gaussian context in chart tooltips as `mu` plus the full temperature-range probability distribution, without reintroducing probability bands into the main temperature view.
 - Reuses one analysis core across web dashboard and Telegram bot.
 - Adds payment audit trails, replay tooling, and incident visibility in ops.
+- Adds an in-app feedback loop with chart context, user-visible feedback status, ops triage, and manual point rewards for useful reports and suggestions.
 - Adds peak-window-oriented intraday analysis with meteorology headline, path buckets, evidence chain, invalidation rules, and confirmation rules.
 - Adds airport-side `TAF` timing overlays and airport suppression/disruption interpretation for non-Hong Kong airport cities.
-- Adds official nearby-network enhancement layers for China, Japan, Korea, Hong Kong, Taiwan, and Turkey without replacing airport settlement anchors.
-- Adds optional dashboard prewarm worker so hot cities can be refreshed before user clicks.
+- Adds official nearby-network and runway-level enhancement layers for China, Japan, Korea (AMOS runway sensors for Seoul/Busan), Hong Kong, Taiwan, and Turkey without replacing airport settlement anchors.
 
 ## Reference Architecture
 
 ```mermaid
 flowchart LR
-    U["Users (Web / Telegram)"] --> FE["Next.js Frontend (Vercel)"]
+    U["Users (Web / Telegram)"] --> FE["Next.js Frontend (Docker / VPS)"]
     U --> BOT["Telegram Bot (VPS)"]
     FE --> API["FastAPI /web/app.py"]
     BOT --> API
@@ -89,22 +95,23 @@ flowchart LR
     WX --> MGM["MGM (Turkey station network)"]
     WX --> OM["Open-Meteo"]
     WX --> JMA["JMA AMeDAS (Japan)"]
-    WX --> KMA["KMA (Korea)"]
+    WX --> AMOS["AMOS runway sensors (Korea)"]
     WX --> HKO["HKO / CWA / NOAA / Official settlement sources"]
 
-    API --> ANA["DEB + Trend + Probability + Market Scan"]
-    ANA --> PAY["Payment State (Intent + Event + Confirm Loop)"]
-    ANA --> PM["Polymarket Read-only Layer"]
-    ANA --> LLM["Optional Groq Commentary Rewrite"]
-    API --> PREWARM["Dashboard Prewarm API / Worker"]
+    API --> ANA["DEB + Hourly Consensus + Probability + Market Scan"]
+    API --> SSE["SSE /api/events"]
+    WX --> SSE
+    SSE --> EVENT["Redis Stream / SQLite Event Log"]
+    ANA --> PAY["Payment State (Multi-chain Intent + Event + Confirm Loop)"]
+    ANA --> STATE["SQLite runtime state"]
 ```
 
-## Monitored Cities (52)
+## Monitored Cities (51)
 
 - Europe / Middle East / Africa: Ankara, Istanbul, Moscow, London, Paris, Munich, Milan, Warsaw, Madrid, Tel Aviv, Amsterdam, Helsinki, Lagos, Cape Town, Jeddah
 - APAC: Seoul, Busan, Hong Kong, Lau Fau Shan, Taipei, Shanghai, Beijing, Qingdao, Wuhan, Chengdu, Chongqing, Shenzhen, Guangzhou, Singapore, Tokyo, Kuala Lumpur, Jakarta, Manila, Wellington
 - Americas: Toronto, New York, Los Angeles, San Francisco, Aurora, Austin, Houston, Chicago, Dallas, Miami, Atlanta, Seattle, Mexico City, Buenos Aires, Sao Paulo, Panama City
-- South Asia: Lucknow, Karachi, Masroor Air Base
+- South Asia: Lucknow, Karachi
 
 ## Quick Start
 
@@ -124,13 +131,17 @@ npm run dev
 
 ## Recent Highlights
 
+- Gaussian probability tooltip now lists the full temperature-range distribution instead of only the highest-probability bucket, while the main chart remains focused on observations and forecasts.
+- User feedback is now a product loop: terminal submissions attach chart context, users can track status in-app, and ops can reward useful feedback with points.
 - Airport-linked contracts use the METAR / airport primary observing site as the settlement anchor. Wunderground pages are reference/history pages, not stations.
 - Taipei and Shenzhen retain their explicitly configured station history pages for reconciliation, but the docs avoid describing Wunderground itself as a physical station.
 - Hong Kong keeps `HKO` official readings in dashboard and history, without falling back to airport METAR lines.
 - Intraday analysis now separates meteorology conclusion, evidence chain, invalidation rules, confirmation rules, calibrated probability, and market reference.
 - `TAF` is used as an airport-side confirmation layer, not as the main temperature model.
-- `LGBM` can power the calibrated probability panel; model vote counts remain an explanatory consensus line, not the final probability.
+- Calibrated probability uses the legacy Gaussian path; model vote counts remain an explanatory consensus line, not the final probability.
 - Browser extension remains a lightweight monitoring + basic-bias product, while the site holds the full analysis experience.
+- Realtime terminal charts use SSE patches plus replayable event storage; full HTTP detail remains the authoritative snapshot.
+- Chart observations are shown in the city's local time, not the browser timezone.
 
 ## Runtime Data (Recommended on VPS)
 
@@ -140,20 +151,13 @@ Use external runtime storage to avoid SQLite/git conflicts:
 POLYWEATHER_RUNTIME_DATA_DIR=/var/lib/polyweather
 POLYWEATHER_DB_PATH=/var/lib/polyweather/polyweather.db
 POLYWEATHER_STATE_STORAGE_MODE=sqlite
+POLYWEATHER_EVENT_STORE=redis
+POLYWEATHER_REDIS_URL=redis://polyweather_redis:6379/0
+POLYWEATHER_REDIS_STREAM_MAXLEN=50000
+POLYWEATHER_REDIS_REQUIRED=true
 ```
 
-## EMOS Local Training
-
-Do not run full EMOS retraining on a small VPS. The VPS should collect data and load approved calibration files; training should run on a local/dev machine using a copied production SQLite database:
-
-```powershell
-scp root@38.54.27.70:/var/lib/polyweather/polyweather.db E:\web\PolyWeather\data\polyweather-prod.db
-$env:POLYWEATHER_DB_PATH="E:\web\PolyWeather\data\polyweather-prod.db"
-$env:POLYWEATHER_RUNTIME_DATA_DIR="E:\web\PolyWeather\artifacts\local_runtime"
-python scripts\auto_retrain_probability_calibration.py --verbose --snapshot-limit 50000
-```
-
-Promote a generated `default.json` only when `auto_retrain_report.json` has `ready_for_promotion=true`, and prefer `emos_shadow` before enabling `emos_primary`.
+For local development or a strict single-process fallback, keep `POLYWEATHER_EVENT_STORE=sqlite`.
 
 ## Ops Verification
 
@@ -165,24 +169,10 @@ curl http://127.0.0.1:8000/api/system/status
 curl http://127.0.0.1:8000/metrics
 ```
 
-### Dashboard prewarm worker
-
-```bash
-docker compose --profile workers up -d polyweather_prewarm
-curl http://127.0.0.1:8000/api/system/status
-```
-
-Check:
-
-- `prewarm.thread_alive`
-- `prewarm.runtime.cycle_count`
-- `cache.analysis.hit_rate`
-- `cache.open_meteo_forecast_entries`
-
 ### Frontend cache headers
 
 ```bash
-./scripts/validate_frontend_cache.sh "https://polyweather-pro.vercel.app"
+./scripts/validate_frontend_cache.sh "https://polyweather.top"
 ```
 
 ### Payment auto-reconciliation logs
@@ -197,18 +187,14 @@ docker compose logs -f polyweather | egrep "payment event loop started|payment c
 curl http://127.0.0.1:8000/api/payments/runtime
 ```
 
-### Wallet activity logs
+### Payment chains
 
-```bash
-docker compose logs -f polyweather | egrep "polymarket wallet activity watcher started|wallet activity pushed"
-```
+Production payment routes are configured by the backend. Polygon remains the default checkout-contract chain, while Ethereum mainnet USDC can be enabled as a direct-transfer route so users who pay on their wallet default network are still confirmed by `intent.chain_id`.
 
 ## Telegram Commands
 
 | Command | Purpose |
 | :-- | :-- |
-| `/city <name>` | City real-time analysis |
-| `/deb <name>` | DEB historical reconciliation |
 | `/top` | User leaderboard |
 | `/id` | Show current chat ID |
 | `/diag` | Startup diagnostics |
@@ -220,26 +206,25 @@ docker compose logs -f polyweather | egrep "polymarket wallet activity watcher s
 - Chinese API guide: [docs/API_ZH.md](docs/API_ZH.md)
 - TAF signal guide (ZH): [docs/TAF_SIGNAL_ZH.md](docs/TAF_SIGNAL_ZH.md)
 - Model stack & DEB (ZH): [docs/MODEL_STACK_AND_DEB_ZH.md](docs/MODEL_STACK_AND_DEB_ZH.md)
-- EMOS + LGBM system (ZH): [docs/EMOS_LGBM_SYSTEM_ZH.md](docs/EMOS_LGBM_SYSTEM_ZH.md)
 - Commercialization: [docs/COMMERCIALIZATION.md](docs/COMMERCIALIZATION.md)
 - AGPL-3.0 policy: [docs/OPEN_CORE_POLICY.md](docs/OPEN_CORE_POLICY.md)
 - Supabase setup (ZH): [docs/SUPABASE_SETUP_ZH.md](docs/SUPABASE_SETUP_ZH.md)
 - Configuration & secrets (ZH): [docs/CONFIGURATION_ZH.md](docs/CONFIGURATION_ZH.md)
-- LightGBM daily-high model (ZH): [docs/LGBM_DAILY_HIGH_ZH.md](docs/LGBM_DAILY_HIGH_ZH.md)
 - Frontend deployment (ZH): [docs/FRONTEND_DEPLOYMENT_ZH.md](docs/FRONTEND_DEPLOYMENT_ZH.md)
-- Tech debt (EN): [docs/TECH_DEBT.md](docs/TECH_DEBT.md)
 - Tech debt (ZH): [docs/TECH_DEBT_ZH.md](docs/TECH_DEBT_ZH.md)
+- Airport realtime sources: [docs/AIRPORT_REALTIME_SOURCES.md](docs/AIRPORT_REALTIME_SOURCES.md)
+- Airport market monitor (ZH): [docs/AIRPORT_MARKET_MONITOR_ZH.md](docs/AIRPORT_MARKET_MONITOR_ZH.md)
+- Services overview (ZH): [docs/SERVICES_ZH.md](docs/SERVICES_ZH.md)
 - Payment verification: [docs/payments/POLYGONSCAN_VERIFY.md](docs/payments/POLYGONSCAN_VERIFY.md)
 - Payment audit: [docs/payments/PAYMENT_AUDIT_ZH.md](docs/payments/PAYMENT_AUDIT_ZH.md)
 - Payment V2 upgrade: [docs/payments/PAYMENT_UPGRADE_V2_ZH.md](docs/payments/PAYMENT_UPGRADE_V2_ZH.md)
 - Ops admin guide: [docs/OPS_ADMIN_ZH.md](docs/OPS_ADMIN_ZH.md)
 - Monitoring guide (ZH): [docs/MONITORING_ZH.md](docs/MONITORING_ZH.md)
 - Deep research report: [docs/deep-research-report.md](docs/deep-research-report.md)
-- Frontend report: [FRONTEND_REDESIGN_REPORT.md](FRONTEND_REDESIGN_REPORT.md)
 - Release process: [RELEASE.md](RELEASE.md)
 - Changelog: [CHANGELOG.md](CHANGELOG.md)
 
 ## Version
 
-- Version: `v1.5.4`
-- Last Updated: `2026-04-19`
+- Version: `v1.8.1`
+- Last Updated: `2026-06-07`

README_ZH.md

@@ -2,49 +2,58 @@
 
 面向温度结算市场的生产级气象情报系统。
 
-官方看板：[polyweather-pro.vercel.app](https://polyweather-pro.vercel.app/)
+官方看板：[polyweather.top](https://polyweather.top/)
 
 ## 产品截图
 
-### 全球看板
+### 实时终端
 
-![PolyWeather 全球地图看板](docs/images/demo_map.png)
+![PolyWeather 实时终端](frontend/public/static/web.webp)
 
-### 城市分析（Ankara）
+### Telegram 跑道推送
 
-![PolyWeather Ankara 分析页](docs/images/demo_ankara.png)
+![PolyWeather Telegram 跑道推送](frontend/public/static/tel.png)
 
-## 当前产品状态（2026-04-27）
+## 当前产品状态（2026-06-07）
 
-- 已上线订阅制：`Pro 月付 5 USDC`。
-- 已上线积分抵扣：`500 积分 = 1 USDC`，最多抵扣 `3 USDC`。
-- 已上线链上支付：Polygon 合约支付（USDC / USDC.e）。
+- 已上线订阅制：`Pro 月付 29.9 USDC / 30 天`，`Pro 季度 79.9 USDC / 90 天`。
+- 积分获取已切换为邀请制度：被邀请人完成首次 Pro 付款后，邀请人获得 `3500` 积分；Telegram 群发言不再获得积分。
+- 积分可用于支付抵扣（`500 分 = 1 USDC`，月付最多抵 `3 USDC`，季度最多抵 `8 USDC`）。真实、有上下文、有价值的用户反馈也可通过运营后台人工奖励积分。
+- 邀请首月价：被邀请人首次月付 `20 USDC`；每个邀请人每月最多 10 个有效付费邀请奖励。
+- 已上线链上支付：Polygon 合约支付（USDC / USDC.e）+ Ethereum 主网 USDC 直转确认。
 - 已上线自动补单：事件监听 + 周期确认双链路。
 - 已上线支付运行态与审计接口：`/api/payments/runtime`。
-- 已上线轻量运营后台：`/ops`（会员、周榜、补分、支付异常单）。
+- 已上线轻量运营后台：`/ops`（会员、用户反馈处理、积分、补分、支付异常单）。
 - 已上线轻量可观测性：`/healthz`、`/api/system/status`、`/metrics`。
 - 已补最小外部监控栈：Prometheus + Alertmanager + Grafana + Telegram 告警 relay。
+- 实时终端已切换到可重放事件流：可见城市图表通过 `/api/events?cities=...&since_revision=...` 订阅 `city_observation_patch.v1`，生产环境使用 Redis Stream 做短窗口 replay，本地/单进程可回退 SQLite event log。
+- 图表刷新由实测事件驱动：SSE patch 直接合并到当前曲线，不弹 loading 遮罩；只有可见图表启用 60 秒无 patch 兜底，浏览器后台返回前台时会主动补齐最新 detail。
+- 城市图表默认展示“全天”，可选“高温”窗口由 DEB hourly path 推导；所有图表横轴都按城市当地时间展示，不按用户浏览器时区。
+- 核心图表组件已拆分为逻辑、状态与 canvas 渲染模块；Recharts 使用 `ResizeObserver` 后的明确宽高，规避 0x0 渲染和长时间挂页后曲线消失。
+- DEB hourly consensus（`deb_hourly_consensus.v1`）已作为峰值窗口和图表 DEB 曲线的优先小时路径；DEB 仍然是预测曲线，不作为实测来源。
+- legacy 高斯概率不再占用默认温度图主视图；hover tooltip 会展示 `Gaussian μ` 和完整温度区间概率分布。
+- AMSC/AMOS 城市的结算跑道曲线默认展示并高亮，辅助跑道作为弱化曲线保留；釜山单跑道只展示 `SR/SL` 结算跑道，不再重复显示 AMOS 聚合线。
+- 香港默认展示 CoWIN `6087`（保良局陈守仁小学）1 分钟参考站曲线，HKO 10 分钟实测保留为官方气象层。
+- Telegram 机场/跑道推送默认中英文双语，并统一使用结算端点跑道温度计算当前值、15 分钟趋势和文案。
 - 运行态状态、缓存与核心离线训练/回填链路已完成 SQLite 主路径收口；legacy JSON/JSONL 仅保留给迁移、导出与显式回退输入。
-- EMOS/CRPS 校准链路已接通，但生产主概率保持 `legacy` 或 `emos_shadow`；`emos_primary` 只在本地离线评估通过并手动灰度后启用。
 - 官方增强站网已统一接入：
   - `MGM`（土耳其）
   - `CMA/NMC`（中国内地）
   - `JMA AMeDAS`（日本）
-  - `KMA`（韩国）
+  - `AMOS`（韩国，跑道级传感器，首尔/釜山）
   - `HKO`（香港）
   - `CWA`（台湾）
 - 东京现已接入羽田 `JMA AMeDAS` 10 分钟温度作为官方增强层。
 - 已支持 Dashboard 定向预热 worker / cron 路径，运行态在 `/api/system/status` 与 `/ops` 可见。
-- `/ops` 现已展示缓存桶数量、summary cache hit/miss 与 prewarm heartbeat。
+- `/ops` 现已展示缓存桶数量、summary cache hit/miss 与运行态 heartbeat。
 - 今日日内分析已改为“专业气象判断台”：顶部先给气象主判断、置信度、基准/上修/下修路径、下一观测点，再展示证据链、失效条件、确认条件和模型层。
 - 日内分析弹窗在 full detail / market detail 同步完成前会锁住旧内容并显示刷新状态，避免用户短暂看到上一轮缓存数据后误判。
-- 城市决策卡已接入 AI 机场报文解读：先用 METAR、DEB、多模型集群和 AI 最高温中枢判断天气路径，再映射到 Polymarket 温度桶。
-- AI 机场报文解读现在同时使用页面内存缓存、浏览器 `localStorage` 和后端短 TTL 缓存；从其他选项卡切回决策卡时会优先恢复已有流式内容或最终结果。
+- 终端图表/详情工作流已改为结构化实况 + DEB hourly consensus + 多模型集群 + 概率分布 tooltip + 市场温度桶，不再让图表等待 AI 文案生成。
+- 终端数据同时使用页面内存缓存、浏览器 `localStorage`、后端短 TTL 缓存、SSE patch replay 和前台恢复刷新；从其他选项卡切回时会优先恢复最新可见图表状态。
 - 市场温度桶匹配已改为完整 `all_buckets` 映射，按 exact / range / or higher / or lower 方向严格匹配，避免把天气中枢错配到不合理尾部桶。
-- 决策卡中的“模型-市场差”口径为 `模型概率 - 市场隐含概率`，正值表示天气概率高于市场报价，负值表示市场已经更充分计价。
-- 概率区已改为“校准模型概率”；默认展示生产概率引擎输出，EMOS/LGBM 只在通过评估或作为 shadow 时进入解释层。
-- 今日日内结构解读已支持可选 `Groq` 改写层，失败时自动回退规则文案。
-- 前端部署文档已补充 Vercel 节流建议，包括 analytics 关闭、eager fetch 开关与扫描流量防火墙规则。
+- 市场信号中的“模型-市场差”口径为 `模型概率 - 市场隐含概率`，正值表示天气概率高于市场报价，负值表示市场已经更充分计价。
+- 概率区已改为“校准模型概率”；默认展示 legacy 高斯概率引擎输出，模型共识作为辅助参考。
+- 今日日内结构解读以规则与结构化信号为主，AI 文案只作为可降级辅助层，不替代实测、DEB、TAF 或结算逻辑。
 - 前端设计系统全面重构：统一 CSS token 体系、消除 !important 滥用（134→49）、合并断点（18→10）、数百处硬编码颜色迁移至 CSS 变量、添加 ARIA 无障碍属性和键盘导航。完整审查记录见 `docs/frontend-ui-design-review.md`。
 
 ## 许可证与商用边界（重要）
@@ -59,21 +68,22 @@
 
 ## 核心能力
 
-- 聚合 52 个监控城市的实测与预报数据。
+- 聚合 51 个监控城市的实测与预报数据。
 - DEB（Dynamic Error Balancing）融合多模型最高温。
-- 输出结算导向校准概率分布（`mu` + 温度桶），并在 LGBM 生效时展示校准引擎元数据。
-- 将模型观点映射到 Polymarket 行情，做错价扫描。
-- 地图城市决策卡把 AI 机场报文解读、最高温中枢、完整市场温度桶和模型-市场差放在同一张卡中展示。
+- 构建 DEB 加权小时共识曲线，用于峰值窗口判断和图表默认 DEB 展示。
+- 输出结算导向校准概率分布（`mu` + 温度桶），通过 legacy 高斯校准路径。
+- 天气决策台把结构化实况、DEB 高温路径、完整市场温度桶和模型-市场差放进图表/详情工作流。
+- 图表 tooltip 展示校准高斯上下文：`mu` 加完整温度区间概率分布，不把概率温度带重新放回主图。
 - Web 仪表盘与 Telegram Bot 复用同一分析内核。
 - 支付链路具备事件重放、SQLite 审计事件与 RPC 容灾能力。
-- 官方增强层支持按国家 provider 统一接入，但不替代机场主站、METAR 或明确官方结算站。
-- 支持后台预热热点城市，降低用户点击城市后的冷启动成本。
+- 已上线站内反馈闭环：提交反馈时自动附带图表上下文，用户可查看处理状态，运营后台可为有价值反馈人工奖励积分。
+- 官方增强层与跑道级传感器支持按国家 provider 统一接入（含韩国 AMOS 首尔/釜山跑道实测），不替代机场主站、METAR 或明确官方结算站。
 
 ## 参考架构
 
 ```mermaid
 flowchart LR
-    U["用户（Web / Telegram）"] --> FE["Next.js 前端（Vercel）"]
+    U["用户（Web / Telegram）"] --> FE["Next.js 前端（Docker / VPS）"]
     U --> BOT["Telegram Bot（VPS）"]
     FE --> API["FastAPI /web/app.py"]
     BOT --> API
@@ -82,25 +92,24 @@ flowchart LR
     WX --> METAR["Aviation Weather（METAR）"]
     WX --> MGM["MGM（土耳其站网）"]
     WX --> JMA["JMA AMeDAS（日本）"]
-    WX --> KMA["KMA（韩国）"]
+    WX --> AMOS["AMOS 跑道传感器（韩国）"]
     WX --> OM["Open-Meteo"]
     WX --> HKO["HKO / CWA / NOAA 等官方结算源"]
 
-    API --> ANA["DEB + 趋势 + 概率 + 市场扫描"]
+    API --> ANA["DEB + 小时共识 + 概率 + 市场扫描"]
+    API --> SSE["SSE /api/events"]
+    WX --> SSE
+    SSE --> EVENT["Redis Stream / SQLite Event Log"]
     ANA --> PAY["支付状态（Intent + Event + Confirm Loop）"]
-    ANA --> PM["Polymarket 只读层"]
-    API --> OBS["healthz / system status / metrics"]
-    API --> PREWARM["Dashboard 预热接口 / Worker"]
-    ANA --> LLM["可选 Groq 文案改写层"]
     ANA --> STATE["SQLite runtime state<br/>legacy files only for migration/export fallback"]
 ```
 
-## 监控城市（52）
+## 监控城市（51）
 
 - 欧洲/中东/非洲：Ankara、Istanbul、Moscow、London、Paris、Munich、Milan、Warsaw、Madrid、Tel Aviv、Amsterdam、Helsinki、Lagos、Cape Town、Jeddah
 - 亚太：Seoul、Busan、Hong Kong、Lau Fau Shan、Taipei、Shanghai、Beijing、Wuhan、Chengdu、Chongqing、Shenzhen、Guangzhou、Singapore、Tokyo、Kuala Lumpur、Jakarta、Manila、Wellington
 - 美洲：Toronto、New York、Los Angeles、San Francisco、Aurora、Austin、Houston、Chicago、Dallas、Miami、Atlanta、Seattle、Mexico City、Buenos Aires、Sao Paulo、Panama City
-- 南亚：Lucknow、Karachi、Masroor Air Base
+- 南亚：Lucknow、Karachi
 
 ## 快速启动
 
@@ -118,6 +127,11 @@ npm ci
 npm run dev
 ```
 
+## 近期更新
+
+- 高斯概率 tooltip 已改为展示完整温度区间概率分布，不再只显示最高概率的单个区间；主图继续聚焦实测和预测曲线。
+- 用户反馈已形成产品闭环：终端提交会自动附带图表上下文，用户可在站内查看处理状态，运营侧可为真实、有建设性的反馈发放积分奖励。
+
 ## 运行数据目录（VPS 推荐）
 
 建议将运行态数据放到仓库外（避免 `git pull` 被 SQLite 卡住）：
@@ -126,25 +140,13 @@ npm run dev
 POLYWEATHER_RUNTIME_DATA_DIR=/var/lib/polyweather
 POLYWEATHER_DB_PATH=/var/lib/polyweather/polyweather.db
 POLYWEATHER_STATE_STORAGE_MODE=sqlite
+POLYWEATHER_EVENT_STORE=redis
+POLYWEATHER_REDIS_URL=redis://polyweather_redis:6379/0
+POLYWEATHER_REDIS_STREAM_MAXLEN=50000
+POLYWEATHER_REDIS_REQUIRED=true
 ```
 
-## EMOS 本地训练流程
-
-低配 VPS 只负责采集、服务和加载已通过评估的参数，不建议在 VPS 上跑 EMOS 全量训练。训练前先从 VPS 拉 SQLite 副本到本地：
-
-```powershell
-scp root@38.54.27.70:/var/lib/polyweather/polyweather.db E:\web\PolyWeather\data\polyweather-prod.db
-```
-
-本地训练：
-
-```powershell
-$env:POLYWEATHER_DB_PATH="E:\web\PolyWeather\data\polyweather-prod.db"
-$env:POLYWEATHER_RUNTIME_DATA_DIR="E:\web\PolyWeather\artifacts\local_runtime"
-python scripts\auto_retrain_probability_calibration.py --verbose --snapshot-limit 50000
-```
-
-只有 `auto_retrain_report.json` 中 `ready_for_promotion=true` 时，才允许把候选 `default.json` 传回 VPS，并优先以 `emos_shadow` 观察。
+本地开发或严格单进程兜底可使用 `POLYWEATHER_EVENT_STORE=sqlite`。
 
 ## 运维验收
 
@@ -156,24 +158,10 @@ curl http://127.0.0.1:8000/api/system/status
 curl http://127.0.0.1:8000/metrics
 ```
 
-### Dashboard 预热 Worker
+### 外部监控栈
 
 ```bash
-docker compose --profile workers up -d polyweather_prewarm
-curl http://127.0.0.1:8000/api/system/status
-```
-
-重点关注：
-
-- `prewarm.thread_alive`
-- `prewarm.runtime.cycle_count`
-- `prewarm.runtime.last_summary_ok`
-- `cache.analysis.hit_rate`
-
-### 前端缓存头
-
-```bash
-./scripts/validate_frontend_cache.sh "https://polyweather-pro.vercel.app"
+./scripts/validate_frontend_cache.sh "https://polyweather.top"
 ```
 
 ### 支付自动补单日志
@@ -206,25 +194,17 @@ curl http://127.0.0.1:8000/api/payments/runtime
 
 ### 运营后台
 
-- 前端入口：`https://polyweather-pro.vercel.app/ops`
+- 前端入口：`https://polyweather.top/ops`
 - 后端需配置：
 
 ```env
 POLYWEATHER_OPS_ADMIN_EMAILS=yhrsc30@gmail.com
 ```
 
-### 钱包异动监听日志
-
-```bash
-docker compose logs -f polyweather | egrep "polymarket wallet activity watcher started|wallet activity pushed"
-```
-
 ## Telegram 指令
 
 | 指令 | 用途 |
 | :-- | :-- |
-| `/city <name>` | 城市实时分析 |
-| `/deb <name>` | DEB 历史对账 |
 | `/top` | 用户积分排行 |
 | `/id` | 查看聊天 Chat ID |
 | `/diag` | Bot 启动诊断 |
@@ -238,25 +218,22 @@ docker compose logs -f polyweather | egrep "polymarket wallet activity watcher s
 - AGPL-3.0 边界：[docs/OPEN_CORE_POLICY.md](docs/OPEN_CORE_POLICY.md)
 - Supabase 接入：[docs/SUPABASE_SETUP_ZH.md](docs/SUPABASE_SETUP_ZH.md)
 - 配置与密钥管理：[docs/CONFIGURATION_ZH.md](docs/CONFIGURATION_ZH.md)
-- 前端部署（Vercel）：[docs/FRONTEND_DEPLOYMENT_ZH.md](docs/FRONTEND_DEPLOYMENT_ZH.md)
-- EMOS 训练报告：[docs/EMOS_TRAINING_REPORT_ZH.md](docs/EMOS_TRAINING_REPORT_ZH.md)
-- 概率快照归档：[docs/PROBABILITY_SNAPSHOT_ARCHIVE_ZH.md](docs/PROBABILITY_SNAPSHOT_ARCHIVE_ZH.md)
-- 技术债（中文镜像）：[docs/TECH_DEBT_ZH.md](docs/TECH_DEBT_ZH.md)
-- 技术债（主文档）：[docs/TECH_DEBT.md](docs/TECH_DEBT.md)
+- 前端部署（Docker / VPS）：[docs/FRONTEND_DEPLOYMENT_ZH.md](docs/FRONTEND_DEPLOYMENT_ZH.md)
+- 技术债：[docs/TECH_DEBT_ZH.md](docs/TECH_DEBT_ZH.md)
+- 机场实时数据源：[docs/AIRPORT_REALTIME_SOURCES.md](docs/AIRPORT_REALTIME_SOURCES.md)
+- 机场市场监控（中文）：[docs/AIRPORT_MARKET_MONITOR_ZH.md](docs/AIRPORT_MARKET_MONITOR_ZH.md)
+- 外部服务总览：[docs/SERVICES_ZH.md](docs/SERVICES_ZH.md)
 - 支付合约验证：[docs/payments/POLYGONSCAN_VERIFY.md](docs/payments/POLYGONSCAN_VERIFY.md)
 - 支付审计说明：[docs/payments/PAYMENT_AUDIT_ZH.md](docs/payments/PAYMENT_AUDIT_ZH.md)
 - 支付 V2 升级方案：[docs/payments/PAYMENT_UPGRADE_V2_ZH.md](docs/payments/PAYMENT_UPGRADE_V2_ZH.md)
 - 运营后台说明：[docs/OPS_ADMIN_ZH.md](docs/OPS_ADMIN_ZH.md)
 - 外部监控说明：[docs/MONITORING_ZH.md](docs/MONITORING_ZH.md)
-- 模型栈与 DEB：[docs/MODEL_STACK_AND_DEB_ZH.md](docs/MODEL_STACK_AND_DEB_ZH.md)
-- LightGBM 日最高温模型：[docs/LGBM_DAILY_HIGH_ZH.md](docs/LGBM_DAILY_HIGH_ZH.md)
-- EMOS + LGBM 系统：[docs/EMOS_LGBM_SYSTEM_ZH.md](docs/EMOS_LGBM_SYSTEM_ZH.md)
+- DEB 模型家族去重规则：[docs/MODEL_STACK_AND_DEB_ZH.md](docs/MODEL_STACK_AND_DEB_ZH.md)
 - 深度评估报告：[docs/deep-research-report.md](docs/deep-research-report.md)
-- 前端报告：[FRONTEND_REDESIGN_REPORT.md](FRONTEND_REDESIGN_REPORT.md)
 - 发布流程：[RELEASE.md](RELEASE.md)
 - 变更记录：[CHANGELOG.md](CHANGELOG.md)
 
 ## 当前版本
 
-- 版本：`v1.5.4`
-- 文档最后更新：`2026-04-19`
+- 版本：`v1.8.1`
+- 文档最后更新：`2026-06-07`

RELEASE.md

@@ -12,9 +12,9 @@
 
 示例：
 
-- `1.4.0 -> 1.4.1`：告警逻辑修正、缓存修正、文档修正
-- `1.4.0 -> 1.5.0`：新增支付能力、新增页面、新增 API
-- `1.4.0 -> 2.0.0`：接口重构或数据结构不兼容
+- `1.7.0 -> 1.7.1`：告警逻辑修正、缓存修正、文档修正
+- `1.7.0 -> 1.8.0`：新增能力、接口扩展、向后兼容的功能迭代
+- `1.7.0 -> 2.0.0`：不兼容变更、核心架构升级
 
 ## 日常升版步骤
 
@@ -29,7 +29,7 @@ python scripts/bump_version.py patch
 ```bash
 python scripts/bump_version.py minor
 python scripts/bump_version.py major
-python scripts/bump_version.py 1.5.0
+python scripts/bump_version.py 1.8.0
 ```
 
 ### 2. 检查同步结果
@@ -68,15 +68,15 @@ python -m pytest
 
 ```bash
 git add .
-git commit -m "release: v1.4.1"
-git tag v1.4.1
+git commit -m "release: v1.7.1"
+git tag v1.7.1
 ```
 
 ### 6. 推送
 
 ```bash
 git push
-git push origin v1.4.1
+git push origin v1.7.1
 ```
 
 ## 当前约束

VERSION

@@ -1 +1 @@
-1.5.5
+1.8.1

artifacts/models/lgbm_daily_high_schema.json

@@ -1,66 +0,0 @@
-{
-  "model_type": "LightGBMRegressor",
-  "target": "actual_high",
-  "horizon": "D0",
-  "feature_names": [
-    "actual_high_lag_1",
-    "actual_high_lag_2",
-    "actual_high_lag_3",
-    "actual_high_lag_7",
-    "actual_high_mean_7",
-    "actual_high_mean_14",
-    "actual_high_trend_3",
-    "open_meteo",
-    "ecmwf",
-    "gfs",
-    "gem",
-    "jma",
-    "icon",
-    "mgm",
-    "nws",
-    "deb_prediction",
-    "model_median",
-    "model_spread",
-    "current_temp",
-    "max_so_far",
-    "humidity",
-    "wind_speed_kt",
-    "visibility_mi",
-    "local_hour",
-    "month",
-    "weekday",
-    "peak_status_code"
-  ],
-  "base_model_columns": [
-    "open_meteo",
-    "ecmwf",
-    "gfs",
-    "gem",
-    "jma",
-    "icon",
-    "mgm",
-    "nws"
-  ],
-  "model_path": "artifacts\\models\\lgbm_daily_high.txt",
-  "sample_count": 1247,
-  "train_count": 998,
-  "validation_count": 249,
-  "metrics": {
-    "validation": {
-      "sample_count": 249,
-      "lgbm_mae": 2.626,
-      "deb_mae": 2.745,
-      "best_single_mae": 1.733,
-      "median_mae": 2.866
-    },
-    "full_sample": {
-      "sample_count": 1247,
-      "lgbm_mae": 0.953,
-      "deb_mae": 1.872,
-      "best_single_mae": 1.052,
-      "median_mae": 1.952
-    }
-  },
-  "generated_at": "2026-05-06T10:45:04.319587Z",
-  "trained_at": "2026-05-06T10:45:04.319587Z"
-}

artifacts/probability_calibration/default.json

@@ -1,361 +0,0 @@
-{
-  "version": "emos-auto-20260421122743",
-  "trained_at": "2026-04-21T12:28:05.031165+00:00",
-  "global": {
-    "mu": {
-      "intercept": 0.34330438,
-      "raw_mu_coef": 0.48749629,
-      "deb_coef": 0.45733479,
-      "ens_median_coef": 0.05955297,
-      "max_so_far_gap_coef": -0.104935
-    },
-    "sigma": {
-      "intercept": -0.62765582,
-      "raw_sigma_coef": 0.38492261,
-      "spread_coef": 0.29095921,
-      "peak_flag_coef": 0.33966327,
-      "max_so_far_gap_coef": 0.08357376
-    }
-  },
-  "sigma_constraints": {
-    "min_ratio": 0.85,
-    "max_ratio": 1.35,
-    "absolute_min": 0.25,
-    "absolute_max": 3.0
-  },
-  "selection_guardrails": {
-    "max_mae_increase": 0.02,
-    "max_bucket_hit_drop": 0.01,
-    "max_bucket_brier_increase": 0.05
-  },
-  "blending": {
-    "alpha_mu": 0.25,
-    "alpha_sigma": 1.0
-  },
-  "cities": {
-    "istanbul": {
-      "samples": 20,
-      "mu_bias": -0.438949,
-      "sigma_scale": 0.553793,
-      "confidence": 1.0
-    },
-    "buenos aires": {
-      "samples": 22,
-      "mu_bias": -1.044971,
-      "sigma_scale": 1.389753,
-      "confidence": 1.0
-    },
-    "ankara": {
-      "samples": 23,
-      "mu_bias": 0.067406,
-      "sigma_scale": 1.270298,
-      "confidence": 1.0
-    },
-    "london": {
-      "samples": 22,
-      "mu_bias": -0.010833,
-      "sigma_scale": 2.0,
-      "confidence": 1.0
-    },
-    "paris": {
-      "samples": 22,
-      "mu_bias": -0.21677,
-      "sigma_scale": 1.095669,
-      "confidence": 1.0
-    },
-    "new york": {
-      "samples": 21,
-      "mu_bias": 1.072189,
-      "sigma_scale": 2.0,
-      "confidence": 1.0
-    },
-    "lagos": {
-      "samples": 10,
-      "mu_bias": -0.092732,
-      "sigma_scale": 1.558646,
-      "confidence": 1.0
-    },
-    "madrid": {
-      "samples": 22,
-      "mu_bias": -0.627862,
-      "sigma_scale": 1.761239,
-      "confidence": 1.0
-    },
-    "toronto": {
-      "samples": 22,
-      "mu_bias": -0.424101,
-      "sigma_scale": 1.326675,
-      "confidence": 1.0
-    },
-    "wellington": {
-      "samples": 22,
-      "mu_bias": -0.347796,
-      "sigma_scale": 0.893459,
-      "confidence": 1.0
-    },
-    "los angeles": {
-      "samples": 20,
-      "mu_bias": -0.659983,
-      "sigma_scale": 2.0,
-      "confidence": 1.0
-    },
-    "san francisco": {
-      "samples": 20,
-      "mu_bias": 0.941818,
-      "sigma_scale": 1.979403,
-      "confidence": 1.0
-    },
-    "aurora": {
-      "samples": 20,
-      "mu_bias": 2.040009,
-      "sigma_scale": 0.982492,
-      "confidence": 1.0
-    },
-    "austin": {
-      "samples": 20,
-      "mu_bias": 0.990023,
-      "sigma_scale": 2.0,
-      "confidence": 1.0
-    },
-    "houston": {
-      "samples": 20,
-      "mu_bias": 0.188787,
-      "sigma_scale": 1.819594,
-      "confidence": 1.0
-    },
-    "chicago": {
-      "samples": 21,
-      "mu_bias": 2.285098,
-      "sigma_scale": 2.0,
-      "confidence": 1.0
-    },
-    "dallas": {
-      "samples": 21,
-      "mu_bias": 0.258095,
-      "sigma_scale": 2.0,
-      "confidence": 1.0
-    },
-    "atlanta": {
-      "samples": 22,
-      "mu_bias": -2.093105,
-      "sigma_scale": 2.0,
-      "confidence": 1.0
-    },
-    "seattle": {
-      "samples": 21,
-      "mu_bias": -0.982188,
-      "sigma_scale": 1.695172,
-      "confidence": 1.0
-    },
-    "sao paulo": {
-      "samples": 22,
-      "mu_bias": -0.786242,
-      "sigma_scale": 1.427037,
-      "confidence": 1.0
-    },
-    "munich": {
-      "samples": 22,
-      "mu_bias": 0.096559,
-      "sigma_scale": 2.0,
-      "confidence": 1.0
-    },
-    "milan": {
-      "samples": 23,
-      "mu_bias": -0.045038,
-      "sigma_scale": 1.626331,
-      "confidence": 1.0
-    },
-    "warsaw": {
-      "samples": 23,
-      "mu_bias": -0.50853,
-      "sigma_scale": 1.239146,
-      "confidence": 1.0
-    },
-    "helsinki": {
-      "samples": 17,
-      "mu_bias": 0.442247,
-      "sigma_scale": 2.0,
-      "confidence": 1.0
-    },
-    "amsterdam": {
-      "samples": 17,
-      "mu_bias": 0.129889,
-      "sigma_scale": 2.0,
-      "confidence": 1.0
-    },
-    "panama city": {
-      "samples": 17,
-      "mu_bias": -0.040792,
-      "sigma_scale": 1.393259,
-      "confidence": 1.0
-    },
-    "cape town": {
-      "samples": 10,
-      "mu_bias": 0.507293,
-      "sigma_scale": 1.420004,
-      "confidence": 1.0
-    },
-    "miami": {
-      "samples": 22,
-      "mu_bias": -2.736316,
-      "sigma_scale": 2.0,
-      "confidence": 1.0
-    },
-    "manila": {
-      "samples": 5,
-      "mu_bias": 1.772229,
-      "sigma_scale": 2.0,
-      "confidence": 0.625
-    },
-    "singapore": {
-      "samples": 22,
-      "mu_bias": 0.289639,
-      "sigma_scale": 1.124006,
-      "confidence": 1.0
-    },
-    "tokyo": {
-      "samples": 22,
-      "mu_bias": -0.332129,
-      "sigma_scale": 0.729483,
-      "confidence": 1.0
-    },
-    "seoul": {
-      "samples": 22,
-      "mu_bias": 1.6533,
-      "sigma_scale": 0.82648,
-      "confidence": 1.0
-    },
-    "busan": {
-      "samples": 16,
-      "mu_bias": 0.343239,
-      "sigma_scale": 1.886868,
-      "confidence": 1.0
-    },
-    "mexico city": {
-      "samples": 20,
-      "mu_bias": 0.087122,
-      "sigma_scale": 1.108884,
-      "confidence": 1.0
-    },
-    "shanghai": {
-      "samples": 23,
-      "mu_bias": 0.348022,
-      "sigma_scale": 0.810527,
-      "confidence": 1.0
-    },
-    "beijing": {
-      "samples": 20,
-      "mu_bias": -0.288176,
-      "sigma_scale": 0.952972,
-      "confidence": 1.0
-    },
-    "shenzhen": {
-      "samples": 21,
-      "mu_bias": -0.006114,
-      "sigma_scale": 0.728494,
-      "confidence": 1.0
-    },
-    "wuhan": {
-      "samples": 20,
-      "mu_bias": -0.771154,
-      "sigma_scale": 1.30329,
-      "confidence": 1.0
-    },
-    "chengdu": {
-      "samples": 20,
-      "mu_bias": 0.445906,
-      "sigma_scale": 0.796989,
-      "confidence": 1.0
-    },
-    "chongqing": {
-      "samples": 20,
-      "mu_bias": -0.021301,
-      "sigma_scale": 1.106566,
-      "confidence": 1.0
-    },
-    "hong kong": {
-      "samples": 24,
-      "mu_bias": 0.37527,
-      "sigma_scale": 0.517756,
-      "confidence": 1.0
-    },
-    "taipei": {
-      "samples": 23,
-      "mu_bias": 0.600671,
-      "sigma_scale": 0.5,
-      "confidence": 1.0
-    },
-    "guangzhou": {
-      "samples": 6,
-      "mu_bias": 0.7082,
-      "sigma_scale": 1.975103,
-      "confidence": 0.75
-    },
-    "lau fau shan": {
-      "samples": 19,
-      "mu_bias": 0.41371,
-      "sigma_scale": 0.656578,
-      "confidence": 1.0
-    },
-    "kuala lumpur": {
-      "samples": 16,
-      "mu_bias": 0.499197,
-      "sigma_scale": 1.361171,
-      "confidence": 1.0
-    },
-    "jakarta": {
-      "samples": 16,
-      "mu_bias": 0.293537,
-      "sigma_scale": 0.751498,
-      "confidence": 1.0
-    },
-    "lucknow": {
-      "samples": 22,
-      "mu_bias": -1.593437,
-      "sigma_scale": 2.0,
-      "confidence": 1.0
-    },
-    "karachi": {
-      "samples": 5,
-      "mu_bias": -0.035595,
-      "sigma_scale": 0.588612,
-      "confidence": 0.625
-    },
-    "jeddah": {
-      "samples": 10,
-      "mu_bias": 0.516879,
-      "sigma_scale": 2.0,
-      "confidence": 1.0
-    },
-    "moscow": {
-      "samples": 20,
-      "mu_bias": -0.609602,
-      "sigma_scale": 0.783723,
-      "confidence": 1.0
-    },
-    "tel aviv": {
-      "samples": 22,
-      "mu_bias": 0.436837,
-      "sigma_scale": 1.46524,
-      "confidence": 1.0
-    }
-  },
-  "metrics": {
-    "sample_count": 978,
-    "mean_crps": 1.330733,
-    "legacy_mean_crps": 1.376936,
-    "legacy_mean_mae": 1.589438,
-    "legacy_bucket_hit_rate": 0.43865,
-    "legacy_bucket_brier": 0.824571,
-    "selected_mean_crps": 1.311763,
-    "selected_mean_mae": 1.553658,
-    "selected_bucket_hit_rate": 0.432515,
-    "selected_bucket_brier": 0.789817,
-    "selected_score": 2.910718,
-    "legacy_score": 2.996333,
-    "filled_actual_from_history": 0,
-    "settlement_history_city_count": 30,
-    "legacy_archive_samples": 54
-  },
-  "source": "artifacts\\local_runtime\\probability_calibration\\candidates\\emos-auto-20260421122743\\default.json"
-}

artifacts/probability_calibration/evaluation_report.json

@@ -1,293 +0,0 @@
-{
-  "summary": {
-    "sample_count": 74,
-    "filled_actual_from_history": 0,
-    "legacy": {
-      "mean_crps": 3.474108,
-      "mean_mae": 3.679324,
-      "bucket_hit_rate": 0.5
-    },
-    "emos": {
-      "mean_crps": 3.33124,
-      "mean_mae": 3.622584,
-      "bucket_hit_rate": 0.5
-    },
-    "delta": {
-      "crps": -0.142868,
-      "mae": -0.056741,
-      "bucket_hit_rate": 0.0
-    }
-  },
-  "by_city": {
-    "ankara": {
-      "samples": 6,
-      "legacy_mean_crps": 1.365135,
-      "emos_mean_crps": 1.392829,
-      "legacy_mean_mae": 1.466667,
-      "emos_mean_mae": 1.444819,
-      "legacy_bucket_hit_rate": 0.666667,
-      "emos_bucket_hit_rate": 0.666667
-    },
-    "atlanta": {
-      "samples": 2,
-      "legacy_mean_crps": 30.449382,
-      "emos_mean_crps": 29.886236,
-      "legacy_mean_mae": 32.015,
-      "emos_mean_mae": 31.322804,
-      "legacy_bucket_hit_rate": 0.0,
-      "emos_bucket_hit_rate": 0.0
-    },
-    "buenos aires": {
-      "samples": 2,
-      "legacy_mean_crps": 9.113412,
-      "emos_mean_crps": 8.463522,
-      "legacy_mean_mae": 10.27,
-      "emos_mean_mae": 10.024533,
-      "legacy_bucket_hit_rate": 0.0,
-      "emos_bucket_hit_rate": 0.0
-    },
-    "busan": {
-      "samples": 3,
-      "legacy_mean_crps": 0.276202,
-      "emos_mean_crps": 0.326485,
-      "legacy_mean_mae": 0.3,
-      "emos_mean_mae": 0.239636,
-      "legacy_bucket_hit_rate": 1.0,
-      "emos_bucket_hit_rate": 1.0
-    },
-    "chengdu": {
-      "samples": 1,
-      "legacy_mean_crps": 0.306469,
-      "emos_mean_crps": 0.378812,
-      "legacy_mean_mae": 0.3,
-      "emos_mean_mae": 0.153224,
-      "legacy_bucket_hit_rate": 1.0,
-      "emos_bucket_hit_rate": 1.0
-    },
-    "chicago": {
-      "samples": 1,
-      "legacy_mean_crps": 1.250268,
-      "emos_mean_crps": 0.714669,
-      "legacy_mean_mae": 0.0,
-      "emos_mean_mae": 0.319756,
-      "legacy_bucket_hit_rate": 1.0,
-      "emos_bucket_hit_rate": 1.0
-    },
-    "dallas": {
-      "samples": 1,
-      "legacy_mean_crps": 2.173363,
-      "emos_mean_crps": 0.840297,
-      "legacy_mean_mae": 0.0,
-      "emos_mean_mae": 1.028146,
-      "legacy_bucket_hit_rate": 1.0,
-      "emos_bucket_hit_rate": 0.0
-    },
-    "hong kong": {
-      "samples": 7,
-      "legacy_mean_crps": 0.706099,
-      "emos_mean_crps": 0.731926,
-      "legacy_mean_mae": 0.657143,
-      "emos_mean_mae": 0.669911,
-      "legacy_bucket_hit_rate": 0.714286,
-      "emos_bucket_hit_rate": 0.571429
-    },
-    "istanbul": {
-      "samples": 3,
-      "legacy_mean_crps": 1.264103,
-      "emos_mean_crps": 1.214967,
-      "legacy_mean_mae": 1.5,
-      "emos_mean_mae": 1.469837,
-      "legacy_bucket_hit_rate": 0.333333,
-      "emos_bucket_hit_rate": 0.666667
-    },
-    "london": {
-      "samples": 2,
-      "legacy_mean_crps": 3.885033,
-      "emos_mean_crps": 3.799841,
-      "legacy_mean_mae": 4.135,
-      "emos_mean_mae": 4.027503,
-      "legacy_bucket_hit_rate": 0.0,
-      "emos_bucket_hit_rate": 0.5
-    },
-    "lucknow": {
-      "samples": 2,
-      "legacy_mean_crps": 2.487193,
-      "emos_mean_crps": 2.107441,
-      "legacy_mean_mae": 3.205,
-      "emos_mean_mae": 2.876943,
-      "legacy_bucket_hit_rate": 0.0,
-      "emos_bucket_hit_rate": 0.0
-    },
-    "madrid": {
-      "samples": 2,
-      "legacy_mean_crps": 6.27726,
-      "emos_mean_crps": 5.810228,
-      "legacy_mean_mae": 7.33,
-      "emos_mean_mae": 7.195133,
-      "legacy_bucket_hit_rate": 0.0,
-      "emos_bucket_hit_rate": 0.0
-    },
-    "miami": {
-      "samples": 2,
-      "legacy_mean_crps": 28.637631,
-      "emos_mean_crps": 27.592664,
-      "legacy_mean_mae": 30.175,
-      "emos_mean_mae": 29.284979,
-      "legacy_bucket_hit_rate": 0.0,
-      "emos_bucket_hit_rate": 0.0
-    },
-    "milan": {
-      "samples": 3,
-      "legacy_mean_crps": 4.401392,
-      "emos_mean_crps": 3.782613,
-      "legacy_mean_mae": 4.06,
-      "emos_mean_mae": 3.989808,
-      "legacy_bucket_hit_rate": 0.666667,
-      "emos_bucket_hit_rate": 0.666667
-    },
-    "munich": {
-      "samples": 2,
-      "legacy_mean_crps": 3.145192,
-      "emos_mean_crps": 2.990712,
-      "legacy_mean_mae": 3.64,
-      "emos_mean_mae": 3.61502,
-      "legacy_bucket_hit_rate": 0.0,
-      "emos_bucket_hit_rate": 0.0
-    },
-    "new york": {
-      "samples": 1,
-      "legacy_mean_crps": 3.692845,
-      "emos_mean_crps": 3.021798,
-      "legacy_mean_mae": 4.94,
-      "emos_mean_mae": 4.54437,
-      "legacy_bucket_hit_rate": 0.0,
-      "emos_bucket_hit_rate": 0.0
-    },
-    "paris": {
-      "samples": 2,
-      "legacy_mean_crps": 4.013782,
-      "emos_mean_crps": 3.915303,
-      "legacy_mean_mae": 4.265,
-      "emos_mean_mae": 4.179694,
-      "legacy_bucket_hit_rate": 0.5,
-      "emos_bucket_hit_rate": 0.5
-    },
-    "sao paulo": {
-      "samples": 2,
-      "legacy_mean_crps": 5.540967,
-      "emos_mean_crps": 5.018605,
-      "legacy_mean_mae": 6.57,
-      "emos_mean_mae": 6.314389,
-      "legacy_bucket_hit_rate": 0.0,
-      "emos_bucket_hit_rate": 0.0
-    },
-    "seattle": {
-      "samples": 1,
-      "legacy_mean_crps": 0.315488,
-      "emos_mean_crps": 0.524119,
-      "legacy_mean_mae": 0.0,
-      "emos_mean_mae": 0.673609,
-      "legacy_bucket_hit_rate": 1.0,
-      "emos_bucket_hit_rate": 0.0
-    },
-    "seoul": {
-      "samples": 3,
-      "legacy_mean_crps": 0.508331,
-      "emos_mean_crps": 0.520762,
-      "legacy_mean_mae": 0.2,
-      "emos_mean_mae": 0.247862,
-      "legacy_bucket_hit_rate": 1.0,
-      "emos_bucket_hit_rate": 1.0
-    },
-    "shanghai": {
-      "samples": 3,
-      "legacy_mean_crps": 0.299116,
-      "emos_mean_crps": 0.402453,
-      "legacy_mean_mae": 0.1,
-      "emos_mean_mae": 0.189437,
-      "legacy_bucket_hit_rate": 1.0,
-      "emos_bucket_hit_rate": 1.0
-    },
-    "shenzhen": {
-      "samples": 1,
-      "legacy_mean_crps": 1.198351,
-      "emos_mean_crps": 1.490963,
-      "legacy_mean_mae": 1.3,
-      "emos_mean_mae": 1.628189,
-      "legacy_bucket_hit_rate": 0.0,
-      "emos_bucket_hit_rate": 0.0
-    },
-    "singapore": {
-      "samples": 2,
-      "legacy_mean_crps": 0.281993,
-      "emos_mean_crps": 0.370374,
-      "legacy_mean_mae": 0.15,
-      "emos_mean_mae": 0.118005,
-      "legacy_bucket_hit_rate": 1.0,
-      "emos_bucket_hit_rate": 1.0
-    },
-    "taipei": {
-      "samples": 5,
-      "legacy_mean_crps": 0.950739,
-      "emos_mean_crps": 1.042332,
-      "legacy_mean_mae": 0.94,
-      "emos_mean_mae": 0.951241,
-      "legacy_bucket_hit_rate": 0.6,
-      "emos_bucket_hit_rate": 0.6
-    },
-    "tel aviv": {
-      "samples": 2,
-      "legacy_mean_crps": 0.446758,
-      "emos_mean_crps": 0.578691,
-      "legacy_mean_mae": 0.3,
-      "emos_mean_mae": 0.116966,
-      "legacy_bucket_hit_rate": 1.0,
-      "emos_bucket_hit_rate": 1.0
-    },
-    "tokyo": {
-      "samples": 5,
-      "legacy_mean_crps": 0.879366,
-      "emos_mean_crps": 0.876608,
-      "legacy_mean_mae": 1.022,
-      "emos_mean_mae": 1.008317,
-      "legacy_bucket_hit_rate": 0.2,
-      "emos_bucket_hit_rate": 0.4
-    },
-    "toronto": {
-      "samples": 2,
-      "legacy_mean_crps": 5.497916,
-      "emos_mean_crps": 5.268783,
-      "legacy_mean_mae": 6.33,
-      "emos_mean_mae": 6.388522,
-      "legacy_bucket_hit_rate": 0.0,
-      "emos_bucket_hit_rate": 0.0
-    },
-    "warsaw": {
-      "samples": 3,
-      "legacy_mean_crps": 1.618875,
-      "emos_mean_crps": 1.524219,
-      "legacy_mean_mae": 2.056667,
-      "emos_mean_mae": 2.006524,
-      "legacy_bucket_hit_rate": 0.333333,
-      "emos_bucket_hit_rate": 0.333333
-    },
-    "wellington": {
-      "samples": 2,
-      "legacy_mean_crps": 0.364919,
-      "emos_mean_crps": 0.484124,
-      "legacy_mean_mae": 0.15,
-      "emos_mean_mae": 0.123335,
-      "legacy_bucket_hit_rate": 1.0,
-      "emos_bucket_hit_rate": 1.0
-    },
-    "wuhan": {
-      "samples": 1,
-      "legacy_mean_crps": 0.476225,
-      "emos_mean_crps": 0.578405,
-      "legacy_mean_mae": 0.8,
-      "emos_mean_mae": 0.962852,
-      "legacy_bucket_hit_rate": 0.0,
-      "emos_bucket_hit_rate": 0.0
-    }
-  }
-}

artifacts/probability_calibration/rollout_report.json

@@ -1,74 +0,0 @@
-{
-  "evaluation_report_path": "E:\\web\\PolyWeather\\artifacts\\probability_calibration\\evaluation_report.json",
-  "shadow_report_path": "E:\\web\\PolyWeather\\artifacts\\probability_calibration\\shadow_report.json",
-  "evaluation_report_exists": true,
-  "shadow_report_exists": true,
-  "decision": {
-    "decision": "hold",
-    "ready_for_primary": false,
-    "summary": "当前指标不足以切换 emos_primary，应继续保持 shadow。",
-    "thresholds": {
-      "evaluation_min_samples": 80,
-      "shadow_min_samples": 50,
-      "max_delta_mae": 0.05,
-      "min_delta_crps": -0.02,
-      "min_delta_bucket_hit_rate": 0.0,
-      "max_delta_bucket_brier_promote": 0.02,
-      "max_delta_bucket_brier_observe": 0.15
-    },
-    "evaluation": {
-      "sample_count": 54,
-      "delta_crps": -0.086732,
-      "delta_mae": 0.0,
-      "delta_bucket_hit_rate": 0.0
-    },
-    "shadow": {
-      "sample_count": 48,
-      "delta_mae": 0.0,
-      "delta_bucket_hit_rate": 0.041666,
-      "delta_bucket_brier": 0.123252
-    },
-    "blocking_reasons": [
-      "离线评估样本不足：54 < 80",
-      "shadow 样本不足：48 < 50",
-      "shadow bucket brier 退化超限：delta=0.123252"
-    ],
-    "worst_shadow_regressions": [
-      {
-        "city": "dallas",
-        "samples": 1,
-        "delta_mae": 0.0,
-        "delta_bucket_hit_rate": 0.0,
-        "delta_bucket_brier": 0.792585
-      },
-      {
-        "city": "chicago",
-        "samples": 1,
-        "delta_mae": 0.0,
-        "delta_bucket_hit_rate": 0.0,
-        "delta_bucket_brier": 0.791878
-      },
-      {
-        "city": "seattle",
-        "samples": 1,
-        "delta_mae": 0.0,
-        "delta_bucket_hit_rate": 0.0,
-        "delta_bucket_brier": 0.61609
-      },
-      {
-        "city": "wellington",
-        "samples": 2,
-        "delta_mae": 0.0,
-        "delta_bucket_hit_rate": 0.0,
-        "delta_bucket_brier": 0.509203
-      },
-      {
-        "city": "tel aviv",
-        "samples": 2,
-        "delta_mae": 0.0,
-        "delta_bucket_hit_rate": 0.0,
-        "delta_bucket_brier": 0.439879
-      }
-    ]
-  }
-}

artifacts/probability_calibration/shadow_report.json

@@ -1,933 +0,0 @@
-{
-  "generated_at": "2026-04-02T16:23:24.376528Z",
-  "summary": {
-    "samples": 48,
-    "legacy_mean_mae": 3.04125,
-    "shadow_mean_mae": 3.04125,
-    "legacy_bucket_hit_rate": 0.5,
-    "shadow_bucket_hit_rate": 0.5,
-    "legacy_bucket_brier": 0.68666,
-    "shadow_bucket_brier": 0.814079,
-    "delta_mae": 0.0,
-    "delta_bucket_hit_rate": 0.0,
-    "delta_bucket_brier": 0.127419
-  },
-  "by_city": {
-    "ankara": {
-      "samples": 2,
-      "legacy_mean_mae": 0.1,
-      "shadow_mean_mae": 0.1,
-      "legacy_bucket_hit_rate": 1.0,
-      "shadow_bucket_hit_rate": 1.0,
-      "legacy_bucket_brier": 0.494847,
-      "shadow_bucket_brier": 0.654648,
-      "delta_mae": 0.0,
-      "delta_bucket_hit_rate": 0.0,
-      "delta_bucket_brier": 0.159801
-    },
-    "atlanta": {
-      "samples": 1,
-      "legacy_mean_mae": 17.06,
-      "shadow_mean_mae": 17.06,
-      "legacy_bucket_hit_rate": 0.0,
-      "shadow_bucket_hit_rate": 0.0,
-      "legacy_bucket_brier": 1.029097,
-      "shadow_bucket_brier": 1.064101,
-      "delta_mae": 0.0,
-      "delta_bucket_hit_rate": 0.0,
-      "delta_bucket_brier": 0.035004
-    },
-    "buenos aires": {
-      "samples": 2,
-      "legacy_mean_mae": 10.27,
-      "shadow_mean_mae": 10.27,
-      "legacy_bucket_hit_rate": 0.0,
-      "shadow_bucket_hit_rate": 0.0,
-      "legacy_bucket_brier": 1.117726,
-      "shadow_bucket_brier": 1.116732,
-      "delta_mae": 0.0,
-      "delta_bucket_hit_rate": 0.0,
-      "delta_bucket_brier": -0.000994
-    },
-    "chicago": {
-      "samples": 1,
-      "legacy_mean_mae": 0.0,
-      "shadow_mean_mae": 0.0,
-      "legacy_bucket_hit_rate": 1.0,
-      "shadow_bucket_hit_rate": 1.0,
-      "legacy_bucket_brier": 0.0,
-      "shadow_bucket_brier": 0.791878,
-      "delta_mae": 0.0,
-      "delta_bucket_hit_rate": 0.0,
-      "delta_bucket_brier": 0.791878
-    },
-    "dallas": {
-      "samples": 1,
-      "legacy_mean_mae": 0.0,
-      "shadow_mean_mae": 0.0,
-      "legacy_bucket_hit_rate": 1.0,
-      "shadow_bucket_hit_rate": 1.0,
-      "legacy_bucket_brier": 0.0,
-      "shadow_bucket_brier": 0.792585,
-      "delta_mae": 0.0,
-      "delta_bucket_hit_rate": 0.0,
-      "delta_bucket_brier": 0.792585
-    },
-    "hong kong": {
-      "samples": 3,
-      "legacy_mean_mae": 0.1,
-      "shadow_mean_mae": 0.1,
-      "legacy_bucket_hit_rate": 0.333333,
-      "shadow_bucket_hit_rate": 0.666667,
-      "legacy_bucket_brier": 0.882203,
-      "shadow_bucket_brier": 0.437187,
-      "delta_mae": 0.0,
-      "delta_bucket_hit_rate": 0.333334,
-      "delta_bucket_brier": -0.445016
-    },
-    "london": {
-      "samples": 2,
-      "legacy_mean_mae": 4.135,
-      "shadow_mean_mae": 4.135,
-      "legacy_bucket_hit_rate": 0.0,
-      "shadow_bucket_hit_rate": 0.0,
-      "legacy_bucket_brier": 0.929652,
-      "shadow_bucket_brier": 1.039551,
-      "delta_mae": 0.0,
-      "delta_bucket_hit_rate": 0.0,
-      "delta_bucket_brier": 0.109899
-    },
-    "lucknow": {
-      "samples": 2,
-      "legacy_mean_mae": 3.205,
-      "shadow_mean_mae": 3.205,
-      "legacy_bucket_hit_rate": 0.0,
-      "shadow_bucket_hit_rate": 0.0,
-      "legacy_bucket_brier": 1.673607,
-      "shadow_bucket_brier": 0.96272,
-      "delta_mae": 0.0,
-      "delta_bucket_hit_rate": 0.0,
-      "delta_bucket_brier": -0.710887
-    },
-    "madrid": {
-      "samples": 2,
-      "legacy_mean_mae": 7.33,
-      "shadow_mean_mae": 7.33,
-      "legacy_bucket_hit_rate": 0.0,
-      "shadow_bucket_hit_rate": 0.0,
-      "legacy_bucket_brier": 1.148213,
-      "shadow_bucket_brier": 1.133888,
-      "delta_mae": 0.0,
-      "delta_bucket_hit_rate": 0.0,
-      "delta_bucket_brier": -0.014325
-    },
-    "miami": {
-      "samples": 1,
-      "legacy_mean_mae": 11.04,
-      "shadow_mean_mae": 11.04,
-      "legacy_bucket_hit_rate": 0.0,
-      "shadow_bucket_hit_rate": 0.0,
-      "legacy_bucket_brier": 1.182605,
-      "shadow_bucket_brier": 1.067257,
-      "delta_mae": 0.0,
-      "delta_bucket_hit_rate": 0.0,
-      "delta_bucket_brier": -0.115348
-    },
-    "milan": {
-      "samples": 3,
-      "legacy_mean_mae": 4.06,
-      "shadow_mean_mae": 4.06,
-      "legacy_bucket_hit_rate": 0.666667,
-      "shadow_bucket_hit_rate": 0.666667,
-      "legacy_bucket_brier": 0.587548,
-      "shadow_bucket_brier": 0.78616,
-      "delta_mae": 0.0,
-      "delta_bucket_hit_rate": 0.0,
-      "delta_bucket_brier": 0.198612
-    },
-    "munich": {
-      "samples": 2,
-      "legacy_mean_mae": 3.64,
-      "shadow_mean_mae": 3.64,
-      "legacy_bucket_hit_rate": 0.0,
-      "shadow_bucket_hit_rate": 0.0,
-      "legacy_bucket_brier": 0.918378,
-      "shadow_bucket_brier": 0.945234,
-      "delta_mae": 0.0,
-      "delta_bucket_hit_rate": 0.0,
-      "delta_bucket_brier": 0.026856
-    },
-    "new york": {
-      "samples": 1,
-      "legacy_mean_mae": 4.94,
-      "shadow_mean_mae": 4.94,
-      "legacy_bucket_hit_rate": 0.0,
-      "shadow_bucket_hit_rate": 0.0,
-      "legacy_bucket_brier": 1.111711,
-      "shadow_bucket_brier": 1.099556,
-      "delta_mae": 0.0,
-      "delta_bucket_hit_rate": 0.0,
-      "delta_bucket_brier": -0.012155
-    },
-    "paris": {
-      "samples": 2,
-      "legacy_mean_mae": 4.265,
-      "shadow_mean_mae": 4.265,
-      "legacy_bucket_hit_rate": 0.5,
-      "shadow_bucket_hit_rate": 0.5,
-      "legacy_bucket_brier": 0.90186,
-      "shadow_bucket_brier": 0.9967,
-      "delta_mae": 0.0,
-      "delta_bucket_hit_rate": 0.0,
-      "delta_bucket_brier": 0.09484
-    },
-    "sao paulo": {
-      "samples": 2,
-      "legacy_mean_mae": 6.57,
-      "shadow_mean_mae": 6.57,
-      "legacy_bucket_hit_rate": 0.0,
-      "shadow_bucket_hit_rate": 0.0,
-      "legacy_bucket_brier": 1.263988,
-      "shadow_bucket_brier": 1.159352,
-      "delta_mae": 0.0,
-      "delta_bucket_hit_rate": 0.0,
-      "delta_bucket_brier": -0.104636
-    },
-    "seattle": {
-      "samples": 1,
-      "legacy_mean_mae": 0.0,
-      "shadow_mean_mae": 0.0,
-      "legacy_bucket_hit_rate": 1.0,
-      "shadow_bucket_hit_rate": 1.0,
-      "legacy_bucket_brier": 0.0,
-      "shadow_bucket_brier": 0.61609,
-      "delta_mae": 0.0,
-      "delta_bucket_hit_rate": 0.0,
-      "delta_bucket_brier": 0.61609
-    },
-    "seoul": {
-      "samples": 2,
-      "legacy_mean_mae": 0.15,
-      "shadow_mean_mae": 0.15,
-      "legacy_bucket_hit_rate": 1.0,
-      "shadow_bucket_hit_rate": 1.0,
-      "legacy_bucket_brier": 0.258977,
-      "shadow_bucket_brier": 0.548485,
-      "delta_mae": 0.0,
-      "delta_bucket_hit_rate": 0.0,
-      "delta_bucket_brier": 0.289508
-    },
-    "shanghai": {
-      "samples": 2,
-      "legacy_mean_mae": 0.15,
-      "shadow_mean_mae": 0.15,
-      "legacy_bucket_hit_rate": 1.0,
-      "shadow_bucket_hit_rate": 1.0,
-      "legacy_bucket_brier": 0.1156,
-      "shadow_bucket_brier": 0.501323,
-      "delta_mae": 0.0,
-      "delta_bucket_hit_rate": 0.0,
-      "delta_bucket_brier": 0.385723
-    },
-    "singapore": {
-      "samples": 2,
-      "legacy_mean_mae": 0.15,
-      "shadow_mean_mae": 0.15,
-      "legacy_bucket_hit_rate": 1.0,
-      "shadow_bucket_hit_rate": 1.0,
-      "legacy_bucket_brier": 0.306527,
-      "shadow_bucket_brier": 0.553647,
-      "delta_mae": 0.0,
-      "delta_bucket_hit_rate": 0.0,
-      "delta_bucket_brier": 0.24712
-    },
-    "taipei": {
-      "samples": 3,
-      "legacy_mean_mae": 0.1,
-      "shadow_mean_mae": 0.1,
-      "legacy_bucket_hit_rate": 1.0,
-      "shadow_bucket_hit_rate": 0.333333,
-      "legacy_bucket_brier": 0.195261,
-      "shadow_bucket_brier": 0.684998,
-      "delta_mae": 0.0,
-      "delta_bucket_hit_rate": -0.666667,
-      "delta_bucket_brier": 0.489737
-    },
-    "tel aviv": {
-      "samples": 2,
-      "legacy_mean_mae": 0.3,
-      "shadow_mean_mae": 0.3,
-      "legacy_bucket_hit_rate": 1.0,
-      "shadow_bucket_hit_rate": 1.0,
-      "legacy_bucket_brier": 0.257895,
-      "shadow_bucket_brier": 0.697774,
-      "delta_mae": 0.0,
-      "delta_bucket_hit_rate": 0.0,
-      "delta_bucket_brier": 0.439879
-    },
-    "tokyo": {
-      "samples": 2,
-      "legacy_mean_mae": 0.25,
-      "shadow_mean_mae": 0.25,
-      "legacy_bucket_hit_rate": 0.5,
-      "shadow_bucket_hit_rate": 1.0,
-      "legacy_bucket_brier": 0.284759,
-      "shadow_bucket_brier": 0.69701,
-      "delta_mae": 0.0,
-      "delta_bucket_hit_rate": 0.5,
-      "delta_bucket_brier": 0.412251
-    },
-    "toronto": {
-      "samples": 2,
-      "legacy_mean_mae": 6.33,
-      "shadow_mean_mae": 6.33,
-      "legacy_bucket_hit_rate": 0.0,
-      "shadow_bucket_hit_rate": 0.0,
-      "legacy_bucket_brier": 1.256736,
-      "shadow_bucket_brier": 1.221422,
-      "delta_mae": 0.0,
-      "delta_bucket_hit_rate": 0.0,
-      "delta_bucket_brier": -0.035314
-    },
-    "warsaw": {
-      "samples": 3,
-      "legacy_mean_mae": 2.056667,
-      "shadow_mean_mae": 2.056667,
-      "legacy_bucket_hit_rate": 0.333333,
-      "shadow_bucket_hit_rate": 0.333333,
-      "legacy_bucket_brier": 0.86425,
-      "shadow_bucket_brier": 0.750985,
-      "delta_mae": 0.0,
-      "delta_bucket_hit_rate": 0.0,
-      "delta_bucket_brier": -0.113265
-    },
-    "wellington": {
-      "samples": 2,
-      "legacy_mean_mae": 0.15,
-      "shadow_mean_mae": 0.15,
-      "legacy_bucket_hit_rate": 1.0,
-      "shadow_bucket_hit_rate": 1.0,
-      "legacy_bucket_brier": 0.095481,
-      "shadow_bucket_brier": 0.604684,
-      "delta_mae": 0.0,
-      "delta_bucket_hit_rate": 0.0,
-      "delta_bucket_brier": 0.509203
-    }
-  },
-  "by_date": {
-    "2026-03-17": {
-      "samples": 4,
-      "legacy_mean_mae": 0.15,
-      "shadow_mean_mae": 0.15,
-      "legacy_bucket_hit_rate": 1.0,
-      "shadow_bucket_hit_rate": 0.5,
-      "legacy_bucket_brier": 0.101543,
-      "shadow_bucket_brier": 0.6636,
-      "delta_mae": 0.0,
-      "delta_bucket_hit_rate": -0.5,
-      "delta_bucket_brier": 0.562057
-    },
-    "2026-03-18": {
-      "samples": 25,
-      "legacy_mean_mae": 2.5476,
-      "shadow_mean_mae": 2.5476,
-      "legacy_bucket_hit_rate": 0.52,
-      "shadow_bucket_hit_rate": 0.56,
-      "legacy_bucket_brier": 0.657516,
-      "shadow_bucket_brier": 0.74574,
-      "delta_mae": 0.0,
-      "delta_bucket_hit_rate": 0.04,
-      "delta_bucket_brier": 0.088224
-    },
-    "2026-03-19": {
-      "samples": 19,
-      "legacy_mean_mae": 4.299474,
-      "shadow_mean_mae": 4.299474,
-      "legacy_bucket_hit_rate": 0.368421,
-      "shadow_bucket_hit_rate": 0.421053,
-      "legacy_bucket_brier": 0.848191,
-      "shadow_bucket_brier": 0.935678,
-      "delta_mae": 0.0,
-      "delta_bucket_hit_rate": 0.052632,
-      "delta_bucket_brier": 0.087487
-    }
-  },
-  "recent_observations": [
-    {
-      "city": "wellington",
-      "date": "2026-03-19",
-      "actual_high": 18.0,
-      "actual_bucket": 18,
-      "legacy_mu": 18.3,
-      "shadow_mu": 18.3,
-      "legacy_top_bucket": 18,
-      "shadow_top_bucket": 18,
-      "calibration_version": "emos-20260320130245",
-      "calibration_mode": "emos_shadow"
-    },
-    {
-      "city": "warsaw",
-      "date": "2026-03-19",
-      "actual_high": 7.0,
-      "actual_bucket": 7,
-      "legacy_mu": 12.03,
-      "shadow_mu": 12.03,
-      "legacy_top_bucket": 12,
-      "shadow_top_bucket": 12,
-      "calibration_version": "emos-20260320130245",
-      "calibration_mode": "emos_shadow"
-    },
-    {
-      "city": "toronto",
-      "date": "2026-03-19",
-      "actual_high": -2.0,
-      "actual_bucket": -2,
-      "legacy_mu": 5.67,
-      "shadow_mu": 5.67,
-      "legacy_top_bucket": 6,
-      "shadow_top_bucket": 6,
-      "calibration_version": "emos-20260320130245",
-      "calibration_mode": "emos_shadow"
-    },
-    {
-      "city": "tokyo",
-      "date": "2026-03-19",
-      "actual_high": 16.0,
-      "actual_bucket": 16,
-      "legacy_mu": 16.5,
-      "shadow_mu": 16.5,
-      "legacy_top_bucket": 17,
-      "shadow_top_bucket": 16,
-      "calibration_version": "emos-20260320130245",
-      "calibration_mode": "emos_shadow"
-    },
-    {
-      "city": "tel aviv",
-      "date": "2026-03-19",
-      "actual_high": 21.0,
-      "actual_bucket": 21,
-      "legacy_mu": 21.3,
-      "shadow_mu": 21.3,
-      "legacy_top_bucket": 21,
-      "shadow_top_bucket": 21,
-      "calibration_version": "emos-20260320130245",
-      "calibration_mode": "emos_shadow"
-    },
-    {
-      "city": "taipei",
-      "date": "2026-03-19",
-      "actual_high": 22.0,
-      "actual_bucket": 22,
-      "legacy_mu": 21.7,
-      "shadow_mu": 21.7,
-      "legacy_top_bucket": 22,
-      "shadow_top_bucket": 21,
-      "calibration_version": "emos-20260320130245",
-      "calibration_mode": "emos_shadow"
-    },
-    {
-      "city": "singapore",
-      "date": "2026-03-19",
-      "actual_high": 32.0,
-      "actual_bucket": 32,
-      "legacy_mu": 32.3,
-      "shadow_mu": 32.3,
-      "legacy_top_bucket": 32,
-      "shadow_top_bucket": 32,
-      "calibration_version": "emos-20260320130245",
-      "calibration_mode": "emos_shadow"
-    },
-    {
-      "city": "shanghai",
-      "date": "2026-03-19",
-      "actual_high": 12.0,
-      "actual_bucket": 12,
-      "legacy_mu": 12.3,
-      "shadow_mu": 12.3,
-      "legacy_top_bucket": 12,
-      "shadow_top_bucket": 12,
-      "calibration_version": "emos-20260320130245",
-      "calibration_mode": "emos_shadow"
-    },
-    {
-      "city": "seoul",
-      "date": "2026-03-19",
-      "actual_high": 10.0,
-      "actual_bucket": 10,
-      "legacy_mu": 10.3,
-      "shadow_mu": 10.3,
-      "legacy_top_bucket": 10,
-      "shadow_top_bucket": 10,
-      "calibration_version": "emos-20260320130245",
-      "calibration_mode": "emos_shadow"
-    },
-    {
-      "city": "sao paulo",
-      "date": "2026-03-19",
-      "actual_high": 21.0,
-      "actual_bucket": 21,
-      "legacy_mu": 26.5,
-      "shadow_mu": 26.5,
-      "legacy_top_bucket": 26,
-      "shadow_top_bucket": 26,
-      "calibration_version": "emos-20260320130245",
-      "calibration_mode": "emos_shadow"
-    },
-    {
-      "city": "paris",
-      "date": "2026-03-19",
-      "actual_high": 8.0,
-      "actual_bucket": 8,
-      "legacy_mu": 16.06,
-      "shadow_mu": 16.06,
-      "legacy_top_bucket": 16,
-      "shadow_top_bucket": 16,
-      "calibration_version": "emos-20260320130245",
-      "calibration_mode": "emos_shadow"
-    },
-    {
-      "city": "munich",
-      "date": "2026-03-19",
-      "actual_high": 5.0,
-      "actual_bucket": 5,
-      "legacy_mu": 11.62,
-      "shadow_mu": 11.62,
-      "legacy_top_bucket": 12,
-      "shadow_top_bucket": 12,
-      "calibration_version": "emos-20260320130245",
-      "calibration_mode": "emos_shadow"
-    },
-    {
-      "city": "milan",
-      "date": "2026-03-19",
-      "actual_high": 5.0,
-      "actual_bucket": 5,
-      "legacy_mu": 16.58,
-      "shadow_mu": 16.58,
-      "legacy_top_bucket": 17,
-      "shadow_top_bucket": 17,
-      "calibration_version": "emos-20260320130245",
-      "calibration_mode": "emos_shadow"
-    },
-    {
-      "city": "madrid",
-      "date": "2026-03-19",
-      "actual_high": 8.0,
-      "actual_bucket": 8,
-      "legacy_mu": 18.23,
-      "shadow_mu": 18.23,
-      "legacy_top_bucket": 18,
-      "shadow_top_bucket": 18,
-      "calibration_version": "emos-20260320130245",
-      "calibration_mode": "emos_shadow"
-    },
-    {
-      "city": "lucknow",
-      "date": "2026-03-19",
-      "actual_high": 30.0,
-      "actual_bucket": 30,
-      "legacy_mu": 35.3,
-      "shadow_mu": 35.3,
-      "legacy_top_bucket": 35,
-      "shadow_top_bucket": 35,
-      "calibration_version": "emos-20260320130245",
-      "calibration_mode": "emos_shadow"
-    },
-    {
-      "city": "london",
-      "date": "2026-03-19",
-      "actual_high": 8.0,
-      "actual_bucket": 8,
-      "legacy_mu": 15.71,
-      "shadow_mu": 15.71,
-      "legacy_top_bucket": 16,
-      "shadow_top_bucket": 16,
-      "calibration_version": "emos-20260320130245",
-      "calibration_mode": "emos_shadow"
-    },
-    {
-      "city": "hong kong",
-      "date": "2026-03-19",
-      "actual_high": 27.3,
-      "actual_bucket": 27,
-      "legacy_mu": 27.6,
-      "shadow_mu": 27.6,
-      "legacy_top_bucket": 28,
-      "shadow_top_bucket": 27,
-      "calibration_version": "emos-20260320130245",
-      "calibration_mode": "emos_shadow"
-    },
-    {
-      "city": "buenos aires",
-      "date": "2026-03-19",
-      "actual_high": 16.0,
-      "actual_bucket": 16,
-      "legacy_mu": 27.39,
-      "shadow_mu": 27.39,
-      "legacy_top_bucket": 27,
-      "shadow_top_bucket": 27,
-      "calibration_version": "emos-20260320130245",
-      "calibration_mode": "emos_shadow"
-    },
-    {
-      "city": "ankara",
-      "date": "2026-03-19",
-      "actual_high": 11.0,
-      "actual_bucket": 11,
-      "legacy_mu": 11.0,
-      "shadow_mu": 11.0,
-      "legacy_top_bucket": 11,
-      "shadow_top_bucket": 11,
-      "calibration_version": "emos-20260320130245",
-      "calibration_mode": "emos_shadow"
-    },
-    {
-      "city": "wellington",
-      "date": "2026-03-18",
-      "actual_high": 21.0,
-      "actual_bucket": 21,
-      "legacy_mu": 21.0,
-      "shadow_mu": 21.0,
-      "legacy_top_bucket": 21,
-      "shadow_top_bucket": 21,
-      "calibration_version": "emos-20260320130245",
-      "calibration_mode": "emos_shadow"
-    },
-    {
-      "city": "warsaw",
-      "date": "2026-03-18",
-      "actual_high": 13.0,
-      "actual_bucket": 13,
-      "legacy_mu": 13.84,
-      "shadow_mu": 13.84,
-      "legacy_top_bucket": 14,
-      "shadow_top_bucket": 14,
-      "calibration_version": "emos-20260320130245",
-      "calibration_mode": "emos_shadow"
-    },
-    {
-      "city": "toronto",
-      "date": "2026-03-18",
-      "actual_high": -6.0,
-      "actual_bucket": -6,
-      "legacy_mu": -1.01,
-      "shadow_mu": -1.01,
-      "legacy_top_bucket": -1,
-      "shadow_top_bucket": -1,
-      "calibration_version": "emos-20260320130245",
-      "calibration_mode": "emos_shadow"
-    },
-    {
-      "city": "tokyo",
-      "date": "2026-03-18",
-      "actual_high": 17.0,
-      "actual_bucket": 17,
-      "legacy_mu": 17.0,
-      "shadow_mu": 17.0,
-      "legacy_top_bucket": 17,
-      "shadow_top_bucket": 17,
-      "calibration_version": "emos-20260320130245",
-      "calibration_mode": "emos_shadow"
-    },
-    {
-      "city": "tel aviv",
-      "date": "2026-03-18",
-      "actual_high": 30.0,
-      "actual_bucket": 30,
-      "legacy_mu": 30.3,
-      "shadow_mu": 30.3,
-      "legacy_top_bucket": 30,
-      "shadow_top_bucket": 30,
-      "calibration_version": "emos-20260320130245",
-      "calibration_mode": "emos_shadow"
-    },
-    {
-      "city": "taipei",
-      "date": "2026-03-18",
-      "actual_high": 29.0,
-      "actual_bucket": 29,
-      "legacy_mu": 29.0,
-      "shadow_mu": 29.0,
-      "legacy_top_bucket": 29,
-      "shadow_top_bucket": 29,
-      "calibration_version": "emos-20260320130245",
-      "calibration_mode": "emos_shadow"
-    },
-    {
-      "city": "singapore",
-      "date": "2026-03-18",
-      "actual_high": 32.0,
-      "actual_bucket": 32,
-      "legacy_mu": 32.0,
-      "shadow_mu": 32.0,
-      "legacy_top_bucket": 32,
-      "shadow_top_bucket": 32,
-      "calibration_version": "emos-20260320130245",
-      "calibration_mode": "emos_shadow"
-    },
-    {
-      "city": "shanghai",
-      "date": "2026-03-18",
-      "actual_high": 13.0,
-      "actual_bucket": 13,
-      "legacy_mu": 13.0,
-      "shadow_mu": 13.0,
-      "legacy_top_bucket": 13,
-      "shadow_top_bucket": 13,
-      "calibration_version": "emos-20260320130245",
-      "calibration_mode": "emos_shadow"
-    },
-    {
-      "city": "seoul",
-      "date": "2026-03-18",
-      "actual_high": 8.0,
-      "actual_bucket": 8,
-      "legacy_mu": 8.0,
-      "shadow_mu": 8.0,
-      "legacy_top_bucket": 8,
-      "shadow_top_bucket": 8,
-      "calibration_version": "emos-20260320130245",
-      "calibration_mode": "emos_shadow"
-    },
-    {
-      "city": "seattle",
-      "date": "2026-03-18",
-      "actual_high": 55.9,
-      "actual_bucket": 56,
-      "legacy_mu": 55.9,
-      "shadow_mu": 55.9,
-      "legacy_top_bucket": 56,
-      "shadow_top_bucket": 56,
-      "calibration_version": "emos-20260320130245",
-      "calibration_mode": "emos_shadow"
-    },
-    {
-      "city": "sao paulo",
-      "date": "2026-03-18",
-      "actual_high": 22.0,
-      "actual_bucket": 22,
-      "legacy_mu": 29.64,
-      "shadow_mu": 29.64,
-      "legacy_top_bucket": 30,
-      "shadow_top_bucket": 30,
-      "calibration_version": "emos-20260320130245",
-      "calibration_mode": "emos_shadow"
-    },
-    {
-      "city": "paris",
-      "date": "2026-03-18",
-      "actual_high": 14.0,
-      "actual_bucket": 14,
-      "legacy_mu": 14.47,
-      "shadow_mu": 14.47,
-      "legacy_top_bucket": 14,
-      "shadow_top_bucket": 14,
-      "calibration_version": "emos-20260320130245",
-      "calibration_mode": "emos_shadow"
-    },
-    {
-      "city": "new york",
-      "date": "2026-03-18",
-      "actual_high": 32.0,
-      "actual_bucket": 32,
-      "legacy_mu": 36.94,
-      "shadow_mu": 36.94,
-      "legacy_top_bucket": 37,
-      "shadow_top_bucket": 37,
-      "calibration_version": "emos-20260320130245",
-      "calibration_mode": "emos_shadow"
-    },
-    {
-      "city": "munich",
-      "date": "2026-03-18",
-      "actual_high": 10.0,
-      "actual_bucket": 10,
-      "legacy_mu": 10.66,
-      "shadow_mu": 10.66,
-      "legacy_top_bucket": 11,
-      "shadow_top_bucket": 11,
-      "calibration_version": "emos-20260320130245",
-      "calibration_mode": "emos_shadow"
-    },
-    {
-      "city": "milan",
-      "date": "2026-03-18",
-      "actual_high": 14.0,
-      "actual_bucket": 14,
-      "legacy_mu": 14.3,
-      "shadow_mu": 14.3,
-      "legacy_top_bucket": 14,
-      "shadow_top_bucket": 14,
-      "calibration_version": "emos-20260320130245",
-      "calibration_mode": "emos_shadow"
-    },
-    {
-      "city": "miami",
-      "date": "2026-03-18",
-      "actual_high": 59.0,
-      "actual_bucket": 59,
-      "legacy_mu": 70.04,
-      "shadow_mu": 70.04,
-      "legacy_top_bucket": 70,
-      "shadow_top_bucket": 70,
-      "calibration_version": "emos-20260320130245",
-      "calibration_mode": "emos_shadow"
-    },
-    {
-      "city": "madrid",
-      "date": "2026-03-18",
-      "actual_high": 14.0,
-      "actual_bucket": 14,
-      "legacy_mu": 18.43,
-      "shadow_mu": 18.43,
-      "legacy_top_bucket": 18,
-      "shadow_top_bucket": 18,
-      "calibration_version": "emos-20260320130245",
-      "calibration_mode": "emos_shadow"
-    },
-    {
-      "city": "lucknow",
-      "date": "2026-03-18",
-      "actual_high": 34.0,
-      "actual_bucket": 34,
-      "legacy_mu": 35.11,
-      "shadow_mu": 35.11,
-      "legacy_top_bucket": 35,
-      "shadow_top_bucket": 35,
-      "calibration_version": "emos-20260320130245",
-      "calibration_mode": "emos_shadow"
-    },
-    {
-      "city": "london",
-      "date": "2026-03-18",
-      "actual_high": 16.0,
-      "actual_bucket": 16,
-      "legacy_mu": 16.56,
-      "shadow_mu": 16.56,
-      "legacy_top_bucket": 17,
-      "shadow_top_bucket": 17,
-      "calibration_version": "emos-20260320130245",
-      "calibration_mode": "emos_shadow"
-    },
-    {
-      "city": "hong kong",
-      "date": "2026-03-18",
-      "actual_high": 27.8,
-      "actual_bucket": 27,
-      "legacy_mu": 27.8,
-      "shadow_mu": 27.8,
-      "legacy_top_bucket": 28,
-      "shadow_top_bucket": 27,
-      "calibration_version": "emos-20260320130245",
-      "calibration_mode": "emos_shadow"
-    },
-    {
-      "city": "dallas",
-      "date": "2026-03-18",
-      "actual_high": 73.9,
-      "actual_bucket": 74,
-      "legacy_mu": 73.9,
-      "shadow_mu": 73.9,
-      "legacy_top_bucket": 74,
-      "shadow_top_bucket": 74,
-      "calibration_version": "emos-20260320130245",
-      "calibration_mode": "emos_shadow"
-    },
-    {
-      "city": "chicago",
-      "date": "2026-03-18",
-      "actual_high": 46.0,
-      "actual_bucket": 46,
-      "legacy_mu": 46.0,
-      "shadow_mu": 46.0,
-      "legacy_top_bucket": 46,
-      "shadow_top_bucket": 46,
-      "calibration_version": "emos-20260320130245",
-      "calibration_mode": "emos_shadow"
-    },
-    {
-      "city": "buenos aires",
-      "date": "2026-03-18",
-      "actual_high": 17.0,
-      "actual_bucket": 17,
-      "legacy_mu": 26.15,
-      "shadow_mu": 26.15,
-      "legacy_top_bucket": 26,
-      "shadow_top_bucket": 26,
-      "calibration_version": "emos-20260320130245",
-      "calibration_mode": "emos_shadow"
-    },
-    {
-      "city": "atlanta",
-      "date": "2026-03-18",
-      "actual_high": 37.0,
-      "actual_bucket": 37,
-      "legacy_mu": 54.06,
-      "shadow_mu": 54.06,
-      "legacy_top_bucket": 54,
-      "shadow_top_bucket": 54,
-      "calibration_version": "emos-20260320130245",
-      "calibration_mode": "emos_shadow"
-    },
-    {
-      "city": "ankara",
-      "date": "2026-03-18",
-      "actual_high": 15.0,
-      "actual_bucket": 15,
-      "legacy_mu": 15.2,
-      "shadow_mu": 15.2,
-      "legacy_top_bucket": 15,
-      "shadow_top_bucket": 15,
-      "calibration_version": "emos-20260320130245",
-      "calibration_mode": "emos_shadow"
-    },
-    {
-      "city": "warsaw",
-      "date": "2026-03-17",
-      "actual_high": 11.0,
-      "actual_bucket": 11,
-      "legacy_mu": 11.3,
-      "shadow_mu": 11.3,
-      "legacy_top_bucket": 11,
-      "shadow_top_bucket": 11,
-      "calibration_version": "emos-20260320130245",
-      "calibration_mode": "emos_shadow"
-    },
-    {
-      "city": "taipei",
-      "date": "2026-03-17",
-      "actual_high": 26.7,
-      "actual_bucket": 27,
-      "legacy_mu": 26.7,
-      "shadow_mu": 26.7,
-      "legacy_top_bucket": 27,
-      "shadow_top_bucket": 26,
-      "calibration_version": "emos-20260320130245",
-      "calibration_mode": "emos_shadow"
-    },
-    {
-      "city": "milan",
-      "date": "2026-03-17",
-      "actual_high": 17.0,
-      "actual_bucket": 17,
-      "legacy_mu": 17.3,
-      "shadow_mu": 17.3,
-      "legacy_top_bucket": 17,
-      "shadow_top_bucket": 17,
-      "calibration_version": "emos-20260320130245",
-      "calibration_mode": "emos_shadow"
-    },
-    {
-      "city": "hong kong",
-      "date": "2026-03-17",
-      "actual_high": 24.0,
-      "actual_bucket": 24,
-      "legacy_mu": 24.0,
-      "shadow_mu": 24.0,
-      "legacy_top_bucket": 24,
-      "shadow_top_bucket": 23,
-      "calibration_version": "emos-20260320130245",
-      "calibration_mode": "emos_shadow"
-    }
-  ]
-}

artifacts/probability_calibration/training_samples.json

@@ -1,981 +0,0 @@
-{
-  "sample_count": 54,
-  "snapshot_sample_count": 1,
-  "daily_record_sample_count": 53,
-  "filled_actual_from_history": 2,
-  "samples": [
-    {
-      "city": "shenzhen",
-      "date": "2026-03-25",
-      "timestamp": "2026-03-25T08:57:11.783182+00:00",
-      "actual_high": 28.0,
-      "raw_mu": 26.7,
-      "raw_sigma": 0.18016764322916676,
-      "deb_prediction": 28.1,
-      "ens_median": 31.4,
-      "ensemble_spread": 0.5078125000000002,
-      "max_so_far_gap": 1.4000000000000021,
-      "peak_flag": 1.0,
-      "sample_source": "snapshot",
-      "settlement_source": null,
-      "settlement_station_code": null,
-      "truth_version": null,
-      "truth_updated_by": null,
-      "truth_updated_at": null
-    },
-    {
-      "city": "ankara",
-      "date": "2026-03-18",
-      "actual_high": 15.0,
-      "raw_mu": 15.2,
-      "raw_sigma": 1.2000000000000002,
-      "deb_prediction": 15.4,
-      "ens_median": 15.8,
-      "ensemble_spread": 1.2000000000000002,
-      "max_so_far_gap": null,
-      "peak_flag": 0.0,
-      "sample_source": "daily_record",
-      "settlement_source": null,
-      "settlement_station_code": null,
-      "truth_version": null,
-      "truth_updated_by": null,
-      "truth_updated_at": null
-    },
-    {
-      "city": "ankara",
-      "date": "2026-03-19",
-      "actual_high": 11.0,
-      "raw_mu": 11.0,
-      "raw_sigma": 2.05,
-      "deb_prediction": 9.8,
-      "ens_median": 10.1,
-      "ensemble_spread": 2.05,
-      "max_so_far_gap": null,
-      "peak_flag": 0.0,
-      "sample_source": "daily_record",
-      "settlement_source": null,
-      "settlement_station_code": null,
-      "truth_version": null,
-      "truth_updated_by": null,
-      "truth_updated_at": null
-    },
-    {
-      "city": "ankara",
-      "date": "2026-03-29",
-      "actual_high": 10.0,
-      "raw_mu": 10.0,
-      "raw_sigma": 0.9000000000000004,
-      "deb_prediction": 9.7,
-      "ens_median": 10.0,
-      "ensemble_spread": 0.9000000000000004,
-      "max_so_far_gap": null,
-      "peak_flag": 0.0,
-      "sample_source": "daily_record",
-      "settlement_source": null,
-      "settlement_station_code": null,
-      "truth_version": null,
-      "truth_updated_by": null,
-      "truth_updated_at": null
-    },
-    {
-      "city": "atlanta",
-      "date": "2026-03-18",
-      "actual_high": 37.0,
-      "raw_mu": 54.06,
-      "raw_sigma": 4.0,
-      "deb_prediction": 52.5,
-      "ens_median": 52.2,
-      "ensemble_spread": 4.0,
-      "max_so_far_gap": null,
-      "peak_flag": 0.0,
-      "sample_source": "daily_record",
-      "settlement_source": null,
-      "settlement_station_code": null,
-      "truth_version": null,
-      "truth_updated_by": null,
-      "truth_updated_at": null
-    },
-    {
-      "city": "atlanta",
-      "date": "2026-03-19",
-      "actual_high": 18.6,
-      "raw_mu": 65.57,
-      "raw_sigma": 1.5500000000000007,
-      "deb_prediction": 65.7,
-      "ens_median": 65.9,
-      "ensemble_spread": 1.5500000000000007,
-      "max_so_far_gap": null,
-      "peak_flag": 0.0,
-      "sample_source": "daily_record",
-      "settlement_source": null,
-      "settlement_station_code": null,
-      "truth_version": null,
-      "truth_updated_by": null,
-      "truth_updated_at": null
-    },
-    {
-      "city": "buenos aires",
-      "date": "2026-03-18",
-      "actual_high": 17.0,
-      "raw_mu": 26.15,
-      "raw_sigma": 2.0,
-      "deb_prediction": 26.4,
-      "ens_median": 26.0,
-      "ensemble_spread": 2.0,
-      "max_so_far_gap": null,
-      "peak_flag": 0.0,
-      "sample_source": "daily_record",
-      "settlement_source": null,
-      "settlement_station_code": null,
-      "truth_version": null,
-      "truth_updated_by": null,
-      "truth_updated_at": null
-    },
-    {
-      "city": "buenos aires",
-      "date": "2026-03-19",
-      "actual_high": 16.0,
-      "raw_mu": 27.39,
-      "raw_sigma": 2.0999999999999996,
-      "deb_prediction": 26.8,
-      "ens_median": 27.9,
-      "ensemble_spread": 2.0999999999999996,
-      "max_so_far_gap": null,
-      "peak_flag": 0.0,
-      "sample_source": "daily_record",
-      "settlement_source": null,
-      "settlement_station_code": null,
-      "truth_version": null,
-      "truth_updated_by": null,
-      "truth_updated_at": null
-    },
-    {
-      "city": "chicago",
-      "date": "2026-03-18",
-      "actual_high": 46.0,
-      "raw_mu": 46.0,
-      "raw_sigma": 5.350000000000001,
-      "deb_prediction": 42.7,
-      "ens_median": 44.2,
-      "ensemble_spread": 5.350000000000001,
-      "max_so_far_gap": null,
-      "peak_flag": 0.0,
-      "sample_source": "daily_record",
-      "settlement_source": null,
-      "settlement_station_code": null,
-      "truth_version": null,
-      "truth_updated_by": null,
-      "truth_updated_at": null
-    },
-    {
-      "city": "dallas",
-      "date": "2026-03-18",
-      "actual_high": 73.9,
-      "raw_mu": 73.9,
-      "raw_sigma": 9.299999999999997,
-      "deb_prediction": 75.2,
-      "ens_median": 74.4,
-      "ensemble_spread": 9.299999999999997,
-      "max_so_far_gap": null,
-      "peak_flag": 0.0,
-      "sample_source": "daily_record",
-      "settlement_source": null,
-      "settlement_station_code": null,
-      "truth_version": null,
-      "truth_updated_by": null,
-      "truth_updated_at": null
-    },
-    {
-      "city": "hong kong",
-      "date": "2026-03-17",
-      "actual_high": 24.0,
-      "raw_mu": 24.0,
-      "raw_sigma": 1.9000000000000004,
-      "deb_prediction": 23.1,
-      "ens_median": 23.1,
-      "ensemble_spread": 1.9000000000000004,
-      "max_so_far_gap": null,
-      "peak_flag": 0.0,
-      "sample_source": "daily_record",
-      "settlement_source": null,
-      "settlement_station_code": null,
-      "truth_version": null,
-      "truth_updated_by": null,
-      "truth_updated_at": null
-    },
-    {
-      "city": "hong kong",
-      "date": "2026-03-18",
-      "actual_high": 27.8,
-      "raw_mu": 27.8,
-      "raw_sigma": 0.6,
-      "deb_prediction": 24.5,
-      "ens_median": 24.9,
-      "ensemble_spread": 0.6,
-      "max_so_far_gap": null,
-      "peak_flag": 0.0,
-      "sample_source": "daily_record",
-      "settlement_source": null,
-      "settlement_station_code": null,
-      "truth_version": null,
-      "truth_updated_by": null,
-      "truth_updated_at": null
-    },
-    {
-      "city": "hong kong",
-      "date": "2026-03-19",
-      "actual_high": 27.3,
-      "raw_mu": 27.6,
-      "raw_sigma": 0.6,
-      "deb_prediction": 24.9,
-      "ens_median": 25.0,
-      "ensemble_spread": 0.6,
-      "max_so_far_gap": null,
-      "peak_flag": 0.0,
-      "sample_source": "daily_record",
-      "settlement_source": null,
-      "settlement_station_code": null,
-      "truth_version": null,
-      "truth_updated_by": null,
-      "truth_updated_at": null
-    },
-    {
-      "city": "hong kong",
-      "date": "2026-03-23",
-      "actual_high": 27.4,
-      "raw_mu": 27.4,
-      "raw_sigma": 1.6999999999999993,
-      "deb_prediction": 25.2,
-      "ens_median": 25.1,
-      "ensemble_spread": 1.6999999999999993,
-      "max_so_far_gap": null,
-      "peak_flag": 0.0,
-      "sample_source": "daily_record",
-      "settlement_source": null,
-      "settlement_station_code": null,
-      "truth_version": null,
-      "truth_updated_by": null,
-      "truth_updated_at": null
-    },
-    {
-      "city": "london",
-      "date": "2026-03-18",
-      "actual_high": 16.0,
-      "raw_mu": 16.56,
-      "raw_sigma": 1.299999999999999,
-      "deb_prediction": 16.5,
-      "ens_median": 16.8,
-      "ensemble_spread": 1.299999999999999,
-      "max_so_far_gap": null,
-      "peak_flag": 0.0,
-      "sample_source": "daily_record",
-      "settlement_source": null,
-      "settlement_station_code": null,
-      "truth_version": null,
-      "truth_updated_by": null,
-      "truth_updated_at": null
-    },
-    {
-      "city": "london",
-      "date": "2026-03-19",
-      "actual_high": 8.0,
-      "raw_mu": 15.71,
-      "raw_sigma": 0.6,
-      "deb_prediction": 15.9,
-      "ens_median": 15.8,
-      "ensemble_spread": 0.6,
-      "max_so_far_gap": null,
-      "peak_flag": 0.0,
-      "sample_source": "daily_record",
-      "settlement_source": null,
-      "settlement_station_code": null,
-      "truth_version": null,
-      "truth_updated_by": null,
-      "truth_updated_at": null
-    },
-    {
-      "city": "lucknow",
-      "date": "2026-03-18",
-      "actual_high": 34.0,
-      "raw_mu": 35.11,
-      "raw_sigma": 1.3000000000000007,
-      "deb_prediction": 34.3,
-      "ens_median": 34.6,
-      "ensemble_spread": 1.3000000000000007,
-      "max_so_far_gap": null,
-      "peak_flag": 0.0,
-      "sample_source": "daily_record",
-      "settlement_source": null,
-      "settlement_station_code": null,
-      "truth_version": null,
-      "truth_updated_by": null,
-      "truth_updated_at": null
-    },
-    {
-      "city": "lucknow",
-      "date": "2026-03-19",
-      "actual_high": 30.0,
-      "raw_mu": 35.3,
-      "raw_sigma": 1.75,
-      "deb_prediction": 34.5,
-      "ens_median": 34.7,
-      "ensemble_spread": 1.75,
-      "max_so_far_gap": null,
-      "peak_flag": 0.0,
-      "sample_source": "daily_record",
-      "settlement_source": null,
-      "settlement_station_code": null,
-      "truth_version": null,
-      "truth_updated_by": null,
-      "truth_updated_at": null
-    },
-    {
-      "city": "madrid",
-      "date": "2026-03-18",
-      "actual_high": 14.0,
-      "raw_mu": 18.43,
-      "raw_sigma": 1.8499999999999996,
-      "deb_prediction": 18.3,
-      "ens_median": 18.7,
-      "ensemble_spread": 1.8499999999999996,
-      "max_so_far_gap": null,
-      "peak_flag": 0.0,
-      "sample_source": "daily_record",
-      "settlement_source": null,
-      "settlement_station_code": null,
-      "truth_version": null,
-      "truth_updated_by": null,
-      "truth_updated_at": null
-    },
-    {
-      "city": "madrid",
-      "date": "2026-03-19",
-      "actual_high": 8.0,
-      "raw_mu": 18.23,
-      "raw_sigma": 1.8999999999999995,
-      "deb_prediction": 18.4,
-      "ens_median": 18.8,
-      "ensemble_spread": 1.8999999999999995,
-      "max_so_far_gap": null,
-      "peak_flag": 0.0,
-      "sample_source": "daily_record",
-      "settlement_source": null,
-      "settlement_station_code": null,
-      "truth_version": null,
-      "truth_updated_by": null,
-      "truth_updated_at": null
-    },
-    {
-      "city": "miami",
-      "date": "2026-03-18",
-      "actual_high": 59.0,
-      "raw_mu": 70.04,
-      "raw_sigma": 2.8999999999999986,
-      "deb_prediction": 69.1,
-      "ens_median": 70.4,
-      "ensemble_spread": 2.8999999999999986,
-      "max_so_far_gap": null,
-      "peak_flag": 0.0,
-      "sample_source": "daily_record",
-      "settlement_source": null,
-      "settlement_station_code": null,
-      "truth_version": null,
-      "truth_updated_by": null,
-      "truth_updated_at": null
-    },
-    {
-      "city": "miami",
-      "date": "2026-03-19",
-      "actual_high": 24.6,
-      "raw_mu": 73.91,
-      "raw_sigma": 2.5500000000000043,
-      "deb_prediction": 74.2,
-      "ens_median": 74.0,
-      "ensemble_spread": 2.5500000000000043,
-      "max_so_far_gap": null,
-      "peak_flag": 0.0,
-      "sample_source": "daily_record",
-      "settlement_source": null,
-      "settlement_station_code": null,
-      "truth_version": null,
-      "truth_updated_by": null,
-      "truth_updated_at": null
-    },
-    {
-      "city": "milan",
-      "date": "2026-03-17",
-      "actual_high": 17.0,
-      "raw_mu": 17.3,
-      "raw_sigma": 9.1,
-      "deb_prediction": 12.5,
-      "ens_median": 15.1,
-      "ensemble_spread": 9.1,
-      "max_so_far_gap": null,
-      "peak_flag": 0.0,
-      "sample_source": "daily_record",
-      "settlement_source": null,
-      "settlement_station_code": null,
-      "truth_version": null,
-      "truth_updated_by": null,
-      "truth_updated_at": null
-    },
-    {
-      "city": "milan",
-      "date": "2026-03-18",
-      "actual_high": 14.0,
-      "raw_mu": 14.3,
-      "raw_sigma": 0.6,
-      "deb_prediction": 13.7,
-      "ens_median": 13.8,
-      "ensemble_spread": 0.6,
-      "max_so_far_gap": null,
-      "peak_flag": 0.0,
-      "sample_source": "daily_record",
-      "settlement_source": null,
-      "settlement_station_code": null,
-      "truth_version": null,
-      "truth_updated_by": null,
-      "truth_updated_at": null
-    },
-    {
-      "city": "milan",
-      "date": "2026-03-19",
-      "actual_high": 5.0,
-      "raw_mu": 16.58,
-      "raw_sigma": 1.25,
-      "deb_prediction": 16.9,
-      "ens_median": 17.0,
-      "ensemble_spread": 1.25,
-      "max_so_far_gap": null,
-      "peak_flag": 0.0,
-      "sample_source": "daily_record",
-      "settlement_source": null,
-      "settlement_station_code": null,
-      "truth_version": null,
-      "truth_updated_by": null,
-      "truth_updated_at": null
-    },
-    {
-      "city": "munich",
-      "date": "2026-03-18",
-      "actual_high": 10.0,
-      "raw_mu": 10.66,
-      "raw_sigma": 0.6,
-      "deb_prediction": 10.6,
-      "ens_median": 10.6,
-      "ensemble_spread": 0.6,
-      "max_so_far_gap": null,
-      "peak_flag": 0.0,
-      "sample_source": "daily_record",
-      "settlement_source": null,
-      "settlement_station_code": null,
-      "truth_version": null,
-      "truth_updated_by": null,
-      "truth_updated_at": null
-    },
-    {
-      "city": "munich",
-      "date": "2026-03-19",
-      "actual_high": 5.0,
-      "raw_mu": 11.62,
-      "raw_sigma": 1.3000000000000007,
-      "deb_prediction": 11.5,
-      "ens_median": 11.8,
-      "ensemble_spread": 1.3000000000000007,
-      "max_so_far_gap": null,
-      "peak_flag": 0.0,
-      "sample_source": "daily_record",
-      "settlement_source": null,
-      "settlement_station_code": null,
-      "truth_version": null,
-      "truth_updated_by": null,
-      "truth_updated_at": null
-    },
-    {
-      "city": "new york",
-      "date": "2026-03-18",
-      "actual_high": 32.0,
-      "raw_mu": 36.94,
-      "raw_sigma": 2.25,
-      "deb_prediction": 36.8,
-      "ens_median": 37.0,
-      "ensemble_spread": 2.25,
-      "max_so_far_gap": null,
-      "peak_flag": 0.0,
-      "sample_source": "daily_record",
-      "settlement_source": null,
-      "settlement_station_code": null,
-      "truth_version": null,
-      "truth_updated_by": null,
-      "truth_updated_at": null
-    },
-    {
-      "city": "paris",
-      "date": "2026-03-18",
-      "actual_high": 14.0,
-      "raw_mu": 14.47,
-      "raw_sigma": 0.9000000000000004,
-      "deb_prediction": 14.2,
-      "ens_median": 14.8,
-      "ensemble_spread": 0.9000000000000004,
-      "max_so_far_gap": null,
-      "peak_flag": 0.0,
-      "sample_source": "daily_record",
-      "settlement_source": null,
-      "settlement_station_code": null,
-      "truth_version": null,
-      "truth_updated_by": null,
-      "truth_updated_at": null
-    },
-    {
-      "city": "paris",
-      "date": "2026-03-19",
-      "actual_high": 8.0,
-      "raw_mu": 16.06,
-      "raw_sigma": 0.6,
-      "deb_prediction": 16.2,
-      "ens_median": 16.3,
-      "ensemble_spread": 0.6,
-      "max_so_far_gap": null,
-      "peak_flag": 0.0,
-      "sample_source": "daily_record",
-      "settlement_source": null,
-      "settlement_station_code": null,
-      "truth_version": null,
-      "truth_updated_by": null,
-      "truth_updated_at": null
-    },
-    {
-      "city": "sao paulo",
-      "date": "2026-03-18",
-      "actual_high": 22.0,
-      "raw_mu": 29.64,
-      "raw_sigma": 2.450000000000001,
-      "deb_prediction": 30.0,
-      "ens_median": 29.4,
-      "ensemble_spread": 2.450000000000001,
-      "max_so_far_gap": null,
-      "peak_flag": 0.0,
-      "sample_source": "daily_record",
-      "settlement_source": null,
-      "settlement_station_code": null,
-      "truth_version": null,
-      "truth_updated_by": null,
-      "truth_updated_at": null
-    },
-    {
-      "city": "sao paulo",
-      "date": "2026-03-19",
-      "actual_high": 21.0,
-      "raw_mu": 26.5,
-      "raw_sigma": 1.200000000000001,
-      "deb_prediction": 25.5,
-      "ens_median": 26.5,
-      "ensemble_spread": 1.200000000000001,
-      "max_so_far_gap": null,
-      "peak_flag": 0.0,
-      "sample_source": "daily_record",
-      "settlement_source": null,
-      "settlement_station_code": null,
-      "truth_version": null,
-      "truth_updated_by": null,
-      "truth_updated_at": null
-    },
-    {
-      "city": "seattle",
-      "date": "2026-03-18",
-      "actual_high": 55.9,
-      "raw_mu": 55.9,
-      "raw_sigma": 1.3500000000000014,
-      "deb_prediction": 55.8,
-      "ens_median": 55.9,
-      "ensemble_spread": 1.3500000000000014,
-      "max_so_far_gap": null,
-      "peak_flag": 0.0,
-      "sample_source": "daily_record",
-      "settlement_source": null,
-      "settlement_station_code": null,
-      "truth_version": null,
-      "truth_updated_by": null,
-      "truth_updated_at": null
-    },
-    {
-      "city": "seoul",
-      "date": "2026-03-18",
-      "actual_high": 8.0,
-      "raw_mu": 8.0,
-      "raw_sigma": 0.7999999999999998,
-      "deb_prediction": 7.4,
-      "ens_median": 7.4,
-      "ensemble_spread": 0.7999999999999998,
-      "max_so_far_gap": null,
-      "peak_flag": 0.0,
-      "sample_source": "daily_record",
-      "settlement_source": null,
-      "settlement_station_code": null,
-      "truth_version": null,
-      "truth_updated_by": null,
-      "truth_updated_at": null
-    },
-    {
-      "city": "seoul",
-      "date": "2026-03-19",
-      "actual_high": 10.0,
-      "raw_mu": 10.3,
-      "raw_sigma": 1.7999999999999998,
-      "deb_prediction": 7.6,
-      "ens_median": 6.3,
-      "ensemble_spread": 1.7999999999999998,
-      "max_so_far_gap": null,
-      "peak_flag": 0.0,
-      "sample_source": "daily_record",
-      "settlement_source": null,
-      "settlement_station_code": null,
-      "truth_version": null,
-      "truth_updated_by": null,
-      "truth_updated_at": null
-    },
-    {
-      "city": "shanghai",
-      "date": "2026-03-18",
-      "actual_high": 13.0,
-      "raw_mu": 13.0,
-      "raw_sigma": 1.1500000000000004,
-      "deb_prediction": 13.2,
-      "ens_median": 13.0,
-      "ensemble_spread": 1.1500000000000004,
-      "max_so_far_gap": null,
-      "peak_flag": 0.0,
-      "sample_source": "daily_record",
-      "settlement_source": null,
-      "settlement_station_code": null,
-      "truth_version": null,
-      "truth_updated_by": null,
-      "truth_updated_at": null
-    },
-    {
-      "city": "shanghai",
-      "date": "2026-03-19",
-      "actual_high": 12.0,
-      "raw_mu": 12.3,
-      "raw_sigma": 0.7999999999999998,
-      "deb_prediction": 10.7,
-      "ens_median": 11.2,
-      "ensemble_spread": 0.7999999999999998,
-      "max_so_far_gap": null,
-      "peak_flag": 0.0,
-      "sample_source": "daily_record",
-      "settlement_source": null,
-      "settlement_station_code": null,
-      "truth_version": null,
-      "truth_updated_by": null,
-      "truth_updated_at": null
-    },
-    {
-      "city": "shanghai",
-      "date": "2026-03-29",
-      "actual_high": 18.0,
-      "raw_mu": 18.0,
-      "raw_sigma": 1.6999999999999993,
-      "deb_prediction": 18.4,
-      "ens_median": 17.6,
-      "ensemble_spread": 1.6999999999999993,
-      "max_so_far_gap": null,
-      "peak_flag": 0.0,
-      "sample_source": "daily_record",
-      "settlement_source": null,
-      "settlement_station_code": null,
-      "truth_version": null,
-      "truth_updated_by": null,
-      "truth_updated_at": null
-    },
-    {
-      "city": "singapore",
-      "date": "2026-03-18",
-      "actual_high": 32.0,
-      "raw_mu": 32.0,
-      "raw_sigma": 0.9500000000000011,
-      "deb_prediction": 30.2,
-      "ens_median": 30.1,
-      "ensemble_spread": 0.9500000000000011,
-      "max_so_far_gap": null,
-      "peak_flag": 0.0,
-      "sample_source": "daily_record",
-      "settlement_source": null,
-      "settlement_station_code": null,
-      "truth_version": null,
-      "truth_updated_by": null,
-      "truth_updated_at": null
-    },
-    {
-      "city": "singapore",
-      "date": "2026-03-19",
-      "actual_high": 32.0,
-      "raw_mu": 32.3,
-      "raw_sigma": 1.3499999999999996,
-      "deb_prediction": 31.5,
-      "ens_median": 32.1,
-      "ensemble_spread": 1.3499999999999996,
-      "max_so_far_gap": null,
-      "peak_flag": 0.0,
-      "sample_source": "daily_record",
-      "settlement_source": null,
-      "settlement_station_code": null,
-      "truth_version": null,
-      "truth_updated_by": null,
-      "truth_updated_at": null
-    },
-    {
-      "city": "taipei",
-      "date": "2026-03-17",
-      "actual_high": 26.7,
-      "raw_mu": 26.7,
-      "raw_sigma": 2.25,
-      "deb_prediction": 24.9,
-      "ens_median": 25.4,
-      "ensemble_spread": 2.25,
-      "max_so_far_gap": null,
-      "peak_flag": 0.0,
-      "sample_source": "daily_record",
-      "settlement_source": null,
-      "settlement_station_code": null,
-      "truth_version": null,
-      "truth_updated_by": null,
-      "truth_updated_at": null
-    },
-    {
-      "city": "taipei",
-      "date": "2026-03-18",
-      "actual_high": 29.0,
-      "raw_mu": 29.0,
-      "raw_sigma": 1.0500000000000007,
-      "deb_prediction": 27.2,
-      "ens_median": 27.5,
-      "ensemble_spread": 1.0500000000000007,
-      "max_so_far_gap": null,
-      "peak_flag": 0.0,
-      "sample_source": "daily_record",
-      "settlement_source": null,
-      "settlement_station_code": null,
-      "truth_version": null,
-      "truth_updated_by": null,
-      "truth_updated_at": null
-    },
-    {
-      "city": "taipei",
-      "date": "2026-03-19",
-      "actual_high": 22.0,
-      "raw_mu": 21.7,
-      "raw_sigma": 1.1500000000000004,
-      "deb_prediction": 21.5,
-      "ens_median": 21.3,
-      "ensemble_spread": 1.1500000000000004,
-      "max_so_far_gap": null,
-      "peak_flag": 0.0,
-      "sample_source": "daily_record",
-      "settlement_source": null,
-      "settlement_station_code": null,
-      "truth_version": null,
-      "truth_updated_by": null,
-      "truth_updated_at": null
-    },
-    {
-      "city": "tel aviv",
-      "date": "2026-03-18",
-      "actual_high": 30.0,
-      "raw_mu": 30.3,
-      "raw_sigma": 2.1500000000000004,
-      "deb_prediction": 29.0,
-      "ens_median": 28.9,
-      "ensemble_spread": 2.1500000000000004,
-      "max_so_far_gap": null,
-      "peak_flag": 0.0,
-      "sample_source": "daily_record",
-      "settlement_source": null,
-      "settlement_station_code": null,
-      "truth_version": null,
-      "truth_updated_by": null,
-      "truth_updated_at": null
-    },
-    {
-      "city": "tel aviv",
-      "date": "2026-03-19",
-      "actual_high": 21.0,
-      "raw_mu": 21.3,
-      "raw_sigma": 1.5,
-      "deb_prediction": 20.7,
-      "ens_median": 21.1,
-      "ensemble_spread": 1.5,
-      "max_so_far_gap": null,
-      "peak_flag": 0.0,
-      "sample_source": "daily_record",
-      "settlement_source": null,
-      "settlement_station_code": null,
-      "truth_version": null,
-      "truth_updated_by": null,
-      "truth_updated_at": null
-    },
-    {
-      "city": "tokyo",
-      "date": "2026-03-18",
-      "actual_high": 17.0,
-      "raw_mu": 17.0,
-      "raw_sigma": 1.5499999999999998,
-      "deb_prediction": 15.4,
-      "ens_median": 15.8,
-      "ensemble_spread": 1.5499999999999998,
-      "max_so_far_gap": null,
-      "peak_flag": 0.0,
-      "sample_source": "daily_record",
-      "settlement_source": null,
-      "settlement_station_code": null,
-      "truth_version": null,
-      "truth_updated_by": null,
-      "truth_updated_at": null
-    },
-    {
-      "city": "tokyo",
-      "date": "2026-03-19",
-      "actual_high": 16.0,
-      "raw_mu": 16.5,
-      "raw_sigma": 2.0999999999999996,
-      "deb_prediction": 17.8,
-      "ens_median": 18.5,
-      "ensemble_spread": 2.0999999999999996,
-      "max_so_far_gap": null,
-      "peak_flag": 0.0,
-      "sample_source": "daily_record",
-      "settlement_source": null,
-      "settlement_station_code": null,
-      "truth_version": null,
-      "truth_updated_by": null,
-      "truth_updated_at": null
-    },
-    {
-      "city": "toronto",
-      "date": "2026-03-18",
-      "actual_high": -6.0,
-      "raw_mu": -1.01,
-      "raw_sigma": 0.8,
-      "deb_prediction": -0.6,
-      "ens_median": -1.1,
-      "ensemble_spread": 0.8,
-      "max_so_far_gap": null,
-      "peak_flag": 0.0,
-      "sample_source": "daily_record",
-      "settlement_source": null,
-      "settlement_station_code": null,
-      "truth_version": null,
-      "truth_updated_by": null,
-      "truth_updated_at": null
-    },
-    {
-      "city": "toronto",
-      "date": "2026-03-19",
-      "actual_high": -2.0,
-      "raw_mu": 5.67,
-      "raw_sigma": 2.1500000000000004,
-      "deb_prediction": 6.4,
-      "ens_median": 6.3,
-      "ensemble_spread": 2.1500000000000004,
-      "max_so_far_gap": null,
-      "peak_flag": 0.0,
-      "sample_source": "daily_record",
-      "settlement_source": null,
-      "settlement_station_code": null,
-      "truth_version": null,
-      "truth_updated_by": null,
-      "truth_updated_at": null
-    },
-    {
-      "city": "warsaw",
-      "date": "2026-03-17",
-      "actual_high": 11.0,
-      "raw_mu": 11.3,
-      "raw_sigma": 0.6499999999999995,
-      "deb_prediction": 10.4,
-      "ens_median": 10.5,
-      "ensemble_spread": 0.6499999999999995,
-      "max_so_far_gap": null,
-      "peak_flag": 0.0,
-      "sample_source": "daily_record",
-      "settlement_source": null,
-      "settlement_station_code": null,
-      "truth_version": null,
-      "truth_updated_by": null,
-      "truth_updated_at": null
-    },
-    {
-      "city": "warsaw",
-      "date": "2026-03-18",
-      "actual_high": 13.0,
-      "raw_mu": 13.84,
-      "raw_sigma": 1.4000000000000004,
-      "deb_prediction": 13.6,
-      "ens_median": 14.2,
-      "ensemble_spread": 1.4000000000000004,
-      "max_so_far_gap": null,
-      "peak_flag": 0.0,
-      "sample_source": "daily_record",
-      "settlement_source": null,
-      "settlement_station_code": null,
-      "truth_version": null,
-      "truth_updated_by": null,
-      "truth_updated_at": null
-    },
-    {
-      "city": "warsaw",
-      "date": "2026-03-19",
-      "actual_high": 7.0,
-      "raw_mu": 12.03,
-      "raw_sigma": 1.5999999999999996,
-      "deb_prediction": 11.8,
-      "ens_median": 12.3,
-      "ensemble_spread": 1.5999999999999996,
-      "max_so_far_gap": null,
-      "peak_flag": 0.0,
-      "sample_source": "daily_record",
-      "settlement_source": null,
-      "settlement_station_code": null,
-      "truth_version": null,
-      "truth_updated_by": null,
-      "truth_updated_at": null
-    },
-    {
-      "city": "wellington",
-      "date": "2026-03-18",
-      "actual_high": 21.0,
-      "raw_mu": 21.0,
-      "raw_sigma": 0.9500000000000011,
-      "deb_prediction": 19.2,
-      "ens_median": 19.1,
-      "ensemble_spread": 0.9500000000000011,
-      "max_so_far_gap": null,
-      "peak_flag": 0.0,
-      "sample_source": "daily_record",
-      "settlement_source": null,
-      "settlement_station_code": null,
-      "truth_version": null,
-      "truth_updated_by": null,
-      "truth_updated_at": null
-    },
-    {
-      "city": "wellington",
-      "date": "2026-03-19",
-      "actual_high": 18.0,
-      "raw_mu": 18.3,
-      "raw_sigma": 2.0999999999999996,
-      "deb_prediction": 17.9,
-      "ens_median": 17.1,
-      "ensemble_spread": 2.0999999999999996,
-      "max_so_far_gap": null,
-      "peak_flag": 0.0,
-      "sample_source": "daily_record",
-      "settlement_source": null,
-      "settlement_station_code": null,
-      "truth_version": null,
-      "truth_updated_by": null,
-      "truth_updated_at": null
-    }
-  ]
-}

config/config.yaml

@@ -19,8 +19,8 @@ cities:
 - id: new_york
   city: New York
   country: USA
-  latitude: 40.7128
-  longitude: -74.006
+  latitude: 40.7769
+  longitude: -73.874
 - id: chicago
   city: Chicago
   country: USA

data/city_thread_ids.json

@@ -0,0 +1,33 @@
+{
+  "amsterdam": 116398,
+  "ankara": 116394,
+  "atlanta": 13115,
+  "austin": 13120,
+  "beijing": 116383,
+  "busan": 116381,
+  "chengdu": 116388,
+  "chicago": 13113,
+  "chongqing": 116389,
+  "dallas": 13119,
+  "denver": 13114,
+  "guangzhou": 116385,
+  "helsinki": 116397,
+  "hong kong": 116391,
+  "houston": 13118,
+  "istanbul": 116395,
+  "los angeles": 13112,
+  "miami": 13116,
+  "new york": 13111,
+  "paris": 116399,
+  "qingdao": 116387,
+  "san francisco": 13117,
+  "seattle": 13122,
+  "seoul": 116380,
+  "shanghai": 116384,
+  "shenzhen": 116386,
+  "singapore": 116393,
+  "taipei": 116392,
+  "tel aviv": 116396,
+  "tokyo": 116382,
+  "wuhan": 116390
+}

deploy.ps1

@@ -0,0 +1,10 @@
+$VPS = "root@172.245.214.111"
+$PROJECT = "/root/PolyWeather"
+
+Write-Host "🚀 Deploying to $VPS..." -ForegroundColor Cyan
+
+ssh $VPS "cd $PROJECT && git pull && docker compose up -d --build"
+
+Write-Host "✅ Deploy complete. Checking health..." -ForegroundColor Green
+Start-Sleep 8
+ssh $VPS "curl -s http://localhost:8000/healthz"

deploy.sh

@@ -0,0 +1,395 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+NEW_TAG="${1:-latest}"
+TAG_FILE="/var/lib/polyweather/.current_tag"
+COMPOSE_DIR="/root/PolyWeather"
+LOCK_FILE="${POLYWEATHER_DEPLOY_LOCK_FILE:-/var/lock/polyweather-deploy.lock}"
+
+GHCR_PAT=""
+if ! IFS= read -r GHCR_PAT && [ -z "$GHCR_PAT" ]; then
+    echo "❌ GHCR token must be provided on stdin"
+    exit 1
+fi
+if [ -z "$GHCR_PAT" ]; then
+    echo "❌ GHCR token must be provided on stdin"
+    exit 1
+fi
+
+mkdir -p "$(dirname "$LOCK_FILE")"
+exec 9>"$LOCK_FILE"
+if ! flock -n 9; then
+    echo "❌ Another PolyWeather deploy is already running"
+    exit 1
+fi
+
+printf '%s' "$GHCR_PAT" | docker login ghcr.io -u yangyuan-zhen --password-stdin
+unset GHCR_PAT
+
+cd "$COMPOSE_DIR"
+git fetch origin main && git reset --hard origin/main
+
+sync_city_thread_ids() {
+    local runtime_dir="${POLYWEATHER_RUNTIME_DATA_DIR:-/var/lib/polyweather}"
+    local repo_file="$COMPOSE_DIR/data/city_thread_ids.json"
+    local target_file="$runtime_dir/city_thread_ids.json"
+
+    if [ ! -f "$repo_file" ]; then
+        echo "No repository city_thread_ids.json to sync"
+        return 0
+    fi
+
+    mkdir -p "$runtime_dir"
+    REPO_CITY_THREAD_IDS_FILE="$repo_file" TARGET_CITY_THREAD_IDS_FILE="$target_file" python3 - <<'PY'
+import json
+import os
+import time
+
+repo_file = os.environ["REPO_CITY_THREAD_IDS_FILE"]
+target_file = os.environ["TARGET_CITY_THREAD_IDS_FILE"]
+
+with open(repo_file, "r", encoding="utf-8") as f:
+    repo_data = json.load(f)
+if not isinstance(repo_data, dict):
+    raise SystemExit("repository city_thread_ids.json must contain an object")
+
+target_data = {}
+if os.path.isfile(target_file) and os.path.getsize(target_file) > 0:
+    try:
+        with open(target_file, "r", encoding="utf-8") as f:
+            loaded = json.load(f)
+        if isinstance(loaded, dict):
+            target_data = loaded
+        else:
+            raise ValueError("target file is not an object")
+    except Exception as exc:
+        backup = f"{target_file}.invalid.{int(time.time())}"
+        os.replace(target_file, backup)
+        print(f"Backed up invalid city_thread_ids.json to {backup}: {exc}")
+
+merged = dict(repo_data)
+merged.update(target_data)
+
+if merged != target_data:
+    tmp_file = f"{target_file}.tmp"
+    with open(tmp_file, "w", encoding="utf-8") as f:
+        json.dump(merged, f, ensure_ascii=False, indent=2, sort_keys=True)
+        f.write("\n")
+    os.replace(tmp_file, target_file)
+    print(f"Synced city_thread_ids.json: {len(target_data)} -> {len(merged)} cities")
+else:
+    print(f"city_thread_ids.json already up to date: {len(target_data)} cities")
+PY
+}
+
+sync_city_thread_ids
+
+PREVIOUS_TAG=""
+if [ -f "$TAG_FILE" ]; then
+    PREVIOUS_TAG=$(cat "$TAG_FILE")
+    echo "Previous tag: $PREVIOUS_TAG"
+fi
+
+rollback_to_previous() {
+    if [ -n "$PREVIOUS_TAG" ]; then
+        echo "Rolling back to $PREVIOUS_TAG..."
+        export IMAGE_TAG="$PREVIOUS_TAG"
+        docker compose pull
+        compose_up_retry "rollback" -d
+        echo "✅ Rolled back to $PREVIOUS_TAG"
+    else
+        echo "⚠️  No previous tag to rollback to"
+    fi
+}
+
+compose_up_retry() {
+    local name="$1"
+    shift
+    local output=""
+
+    for attempt in $(seq 1 6); do
+        if output=$(docker compose up "$@" 2>&1); then
+            echo "$output"
+            return 0
+        fi
+
+        echo "$output"
+        if echo "$output" | grep -qi "removal of container .* is already in progress"; then
+            echo "Container removal is still in progress during ${name}; retry ${attempt}/6..."
+            sleep 5
+            continue
+        fi
+
+        return 1
+    done
+
+    echo "❌ docker compose up failed for ${name} after retries"
+    return 1
+}
+
+read_env_file_value() {
+    local key="$1"
+    if [ ! -f ".env" ]; then
+        return 0
+    fi
+    awk -F= -v key="$key" '
+        $0 ~ "^[[:space:]]*" key "[[:space:]]*=" {
+            value=$0
+            sub("^[^=]*=", "", value)
+            gsub("^[[:space:]]+|[[:space:]]+$", "", value)
+            gsub(/^["'"'"']|["'"'"']$/, "", value)
+            print value
+        }
+    ' .env | tail -n 1
+}
+
+resolve_env_value() {
+    local primary_key="$1"
+    local fallback_key="${2:-}"
+    local value="${!primary_key:-}"
+
+    if [ -z "$value" ]; then
+        value="$(read_env_file_value "$primary_key")"
+    fi
+    if [ -z "$value" ] && [ -n "$fallback_key" ]; then
+        value="${!fallback_key:-}"
+        if [ -z "$value" ]; then
+            value="$(read_env_file_value "$fallback_key")"
+        fi
+    fi
+
+    printf '%s' "$value"
+}
+
+export IMAGE_TAG="$NEW_TAG"
+export POLYWEATHER_API_BASE_URL="${POLYWEATHER_FRONTEND_INTERNAL_API_BASE_URL:-http://polyweather_web:8000}"
+resolved_supabase_url="$(resolve_env_value "SUPABASE_URL" "NEXT_PUBLIC_SUPABASE_URL")"
+resolved_supabase_anon_key="$(resolve_env_value "SUPABASE_ANON_KEY" "NEXT_PUBLIC_SUPABASE_ANON_KEY")"
+if [ -n "$resolved_supabase_url" ]; then
+    export SUPABASE_URL="$resolved_supabase_url"
+else
+    unset SUPABASE_URL
+fi
+if [ -n "$resolved_supabase_anon_key" ]; then
+    export SUPABASE_ANON_KEY="$resolved_supabase_anon_key"
+else
+    unset SUPABASE_ANON_KEY
+fi
+pull_ok=0
+for pull_attempt in $(seq 1 6); do
+    docker compose pull && pull_ok=1 && break
+    echo "Image pull failed or tag not ready, retry ${pull_attempt}/6..."
+    sleep 10
+done
+if [ "$pull_ok" != "1" ]; then
+    echo "❌ Image pull failed after retries"
+    exit 1
+fi
+
+smoke_check() {
+    local name="$1"
+    local url="$2"
+    local timeout="$3"
+    local attempts="${4:-6}"
+    local delay="${5:-5}"
+    local output=""
+
+    for i in $(seq 1 "$attempts"); do
+        if output=$(curl -fsS -w "http=%{http_code} time=%{time_total}" -o /dev/null --max-time "$timeout" "$url" 2>&1); then
+            echo "✅ $name ($output)"
+            return 0
+        fi
+        if [ "$i" != "$attempts" ]; then
+            echo "   $name retry $i/$attempts... ($output)"
+            sleep "$delay"
+        fi
+    done
+
+    echo "❌ $name ($output)"
+    return 1
+}
+
+wait_for_local_service() {
+    local name="$1"
+    local url="$2"
+    local timeout="${3:-5}"
+    local attempts="${4:-30}"
+    local delay="${5:-2}"
+
+    for i in $(seq 1 "$attempts"); do
+        if curl -fsSo /dev/null --max-time "$timeout" "$url"; then
+            echo "✅ $name ready after attempt $i/$attempts"
+            return 0
+        fi
+        if [ "$i" != "$attempts" ]; then
+            echo "   $name warming $i/$attempts..."
+            sleep "$delay"
+        fi
+    done
+
+    echo "❌ $name did not become ready"
+    return 1
+}
+
+warm_public_route() {
+    local name="$1"
+    local url="$2"
+    local timeout="${3:-15}"
+    local attempts="${4:-3}"
+    local delay="${5:-2}"
+
+    for i in $(seq 1 "$attempts"); do
+        if curl -fsSo /dev/null --max-time "$timeout" "$url"; then
+            echo "✅ warmed $name"
+            return 0
+        fi
+        if [ "$i" != "$attempts" ]; then
+            echo "   warm $name retry $i/$attempts..."
+            sleep "$delay"
+        fi
+    done
+
+    echo "⚠️  warm $name failed"
+    return 0
+}
+
+wait_for_scan_terminal_snapshot() {
+    local name="$1"
+    local url="$2"
+    local timeout="${3:-35}"
+    local attempts="${4:-8}"
+    local delay="${5:-5}"
+    local output=""
+    local body=""
+    local compact=""
+    local http_status=""
+    local status=""
+
+    for i in $(seq 1 "$attempts"); do
+        if output=$(curl -sS -w "\nhttp=%{http_code}" --max-time "$timeout" "$url" 2>&1); then
+            http_status="$(printf '%s\n' "$output" | sed -n 's/^http=//p' | tail -n 1)"
+            body="$(printf '%s\n' "$output" | sed '$d')"
+            if [ "$http_status" = "401" ]; then
+                echo "✅ $name protected after attempt $i/$attempts (http=401)"
+                return 0
+            fi
+            compact="$(printf '%s' "$body" | tr -d '\n\r\t ')"
+            if printf '%s' "$compact" | grep -q '"status":"ready"'; then
+                echo "✅ $name ready after attempt $i/$attempts"
+                return 0
+            fi
+            status="$(printf '%s' "$compact" | sed -n 's/.*"status":"\([^"]*\)".*/\1/p' | head -n 1)"
+            echo "   $name not ready attempt $i/$attempts http=${http_status:-unknown} status=${status:-unknown}"
+        else
+            echo "   $name request failed attempt $i/$attempts ($output)"
+        fi
+        if [ "$i" != "$attempts" ]; then
+            sleep "$delay"
+        fi
+    done
+
+    echo "❌ $name did not return status=ready or http=401"
+    return 1
+}
+
+validate_frontend_api_base_url() {
+    local api_base="${POLYWEATHER_API_BASE_URL:-}"
+    if [ -z "$api_base" ]; then
+        api_base="$(read_env_file_value "POLYWEATHER_API_BASE_URL")"
+    fi
+    local normalized
+    normalized="$(printf '%s' "$api_base" | tr '[:upper:]' '[:lower:]' | sed 's/[[:space:]]//g; s#/*$##')"
+    case "$normalized" in
+        http://polyweather.top|https://polyweather.top|http://www.polyweather.top|https://www.polyweather.top)
+            echo "❌ POLYWEATHER_API_BASE_URL must not point at the frontend site: $api_base"
+            echo "   Use the internal backend URL http://polyweather_web:8000 or the backend API host https://api.polyweather.top."
+            exit 1
+            ;;
+    esac
+}
+
+PUBLIC_SMOKE_RECHECK_DELAY_SEC="${POLYWEATHER_PUBLIC_SMOKE_RECHECK_DELAY_SEC:-20}"
+
+run_public_smoke_checks() {
+    local phase="${1:-initial}"
+    local failed=0
+
+    if [ "$phase" = "recheck" ]; then
+        smoke_check "healthz recheck" "https://api.polyweather.top/healthz" 20 6 10 || failed=1
+        smoke_check "frontend cities recheck" "https://polyweather.top/api/cities" 30 8 10 || failed=1
+        smoke_check "frontend recheck" "https://www.polyweather.top/" 20 6 10 || failed=1
+    else
+        smoke_check "healthz" "https://api.polyweather.top/healthz" 15 3 5 || failed=1
+        smoke_check "frontend cities" "https://polyweather.top/api/cities" 20 5 5 || failed=1
+        smoke_check "frontend" "https://www.polyweather.top/" 15 3 5 || failed=1
+    fi
+
+    return "$failed"
+}
+
+validate_frontend_api_base_url
+
+echo "Updating Redis dependency..."
+compose_up_retry "redis" -d polyweather_redis
+
+echo "Updating backend services..."
+compose_up_retry "backend services" -d --no-deps polyweather_web polyweather
+
+echo "Waiting for backend..."
+wait_for_local_service "backend healthz" "http://127.0.0.1:8000/healthz" 5 30 5 || FAILED_BACKEND=1
+FAILED_BACKEND="${FAILED_BACKEND:-0}"
+if [ "$FAILED_BACKEND" = "1" ]; then
+    echo "❌ Backend did not become healthy"
+    rollback_to_previous
+    exit 1
+fi
+
+echo "Updating observation collector..."
+compose_up_retry "observation collector" -d --no-deps polyweather_collector
+
+echo "Updating cache warmer..."
+compose_up_retry "cache warmer" -d --no-deps polyweather_warmer
+
+echo "Updating training settlement worker..."
+compose_up_retry "training settlement" -d --no-deps polyweather_training_settlement
+
+echo "Updating frontend..."
+compose_up_retry "frontend" -d --no-deps polyweather_frontend
+
+echo "Waiting for frontend..."
+wait_for_local_service "frontend root" "http://127.0.0.1:3001/" 5 40 2 || FAILED_FRONTEND=1
+wait_for_local_service "frontend terminal" "http://127.0.0.1:3001/terminal" 10 20 2 || FAILED_FRONTEND=1
+wait_for_scan_terminal_snapshot "scan terminal snapshot" "http://127.0.0.1:3001/api/scan/terminal" 35 8 5 || FAILED_FRONTEND=1
+FAILED_FRONTEND="${FAILED_FRONTEND:-0}"
+if [ "$FAILED_FRONTEND" = "1" ]; then
+    echo "❌ Frontend did not become healthy"
+    rollback_to_previous
+    exit 1
+fi
+
+warm_public_route "terminal" "https://polyweather.top/terminal" 20 4 3
+warm_public_route "scan terminal" "https://polyweather.top/api/scan/terminal" 35 3 2
+warm_public_route "auth snapshot" "https://polyweather.top/api/auth/me?prefer_snapshot=1" 10 3 2
+warm_public_route "local cities recent stats" "http://127.0.0.1:8000/api/cities?refresh_deb_recent=1" 15 2 2
+warm_public_route "cities" "https://polyweather.top/api/cities" 20 3 2
+
+FAILED=0
+run_public_smoke_checks || FAILED=1
+
+if [ "$FAILED" = "1" ]; then
+    echo "⚠️  Initial public smoke failed; retrying before rollback..."
+    sleep "$PUBLIC_SMOKE_RECHECK_DELAY_SEC"
+    FAILED=0
+    run_public_smoke_checks "recheck" || FAILED=1
+fi
+
+if [ "$FAILED" = "1" ]; then
+    echo "❌ Smoke tests failed. Rolling back..."
+    rollback_to_previous
+    exit 1
+fi
+
+mkdir -p "$(dirname "$TAG_FILE")"
+echo "$NEW_TAG" > "$TAG_FILE"
+docker image prune -af
+echo "✅ Deployed $NEW_TAG"

deploy/nginx/polyweather.conf

@@ -0,0 +1,66 @@
+server {
+    listen 443 ssl http2;
+    server_name polyweather.top www.polyweather.top;
+
+    # Supabase auth can set multiple chunked session cookies during OAuth
+    # callback. Nginx defaults are too small and can raise:
+    # "upstream sent too big header while reading response header from upstream".
+    proxy_buffer_size 16k;
+    proxy_buffers 8 16k;
+    proxy_busy_buffers_size 32k;
+
+    location /api/events {
+        proxy_pass http://127.0.0.1:8000;
+        proxy_http_version 1.1;
+        proxy_buffering off;
+        proxy_cache off;
+        proxy_read_timeout 86400s;
+        proxy_set_header Connection '';
+        proxy_set_header Host $host;
+        proxy_set_header X-Real-IP $remote_addr;
+        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+        proxy_set_header X-Forwarded-Proto $scheme;
+    }
+
+    location / {
+        proxy_pass http://127.0.0.1:3001;
+        proxy_http_version 1.1;
+        proxy_set_header Host $host;
+        proxy_set_header X-Real-IP $remote_addr;
+        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+        proxy_set_header X-Forwarded-Proto $scheme;
+        proxy_set_header Upgrade $http_upgrade;
+        proxy_set_header Connection "upgrade";
+    }
+}
+
+server {
+    listen 443 ssl http2;
+    server_name api.polyweather.top;
+
+    proxy_buffer_size 16k;
+    proxy_buffers 8 16k;
+    proxy_busy_buffers_size 32k;
+
+    location /api/events {
+        proxy_pass http://127.0.0.1:8000;
+        proxy_http_version 1.1;
+        proxy_buffering off;
+        proxy_cache off;
+        proxy_read_timeout 86400s;
+        proxy_set_header Connection '';
+        proxy_set_header Host $host;
+        proxy_set_header X-Real-IP $remote_addr;
+        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+        proxy_set_header X-Forwarded-Proto $scheme;
+    }
+
+    location / {
+        proxy_pass http://127.0.0.1:8000;
+        proxy_http_version 1.1;
+        proxy_set_header Host $host;
+        proxy_set_header X-Real-IP $remote_addr;
+        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+        proxy_set_header X-Forwarded-Proto $scheme;
+    }
+}

docker-compose.yml

@@ -1,112 +1,303 @@
-x-polyweather-base: &polyweather-base
-  build: .
-  image: polyweather-app:latest
-  env_file:
-    - .env
-
 services:
+  polyweather_redis:
+    image: redis:7-alpine
+    container_name: polyweather_redis
+    command: redis-server --appendonly yes --maxmemory ${POLYWEATHER_REDIS_MAXMEMORY:-512mb} --maxmemory-policy noeviction
+    restart: unless-stopped
+    healthcheck:
+      interval: 10s
+      retries: 5
+      test:
+      - CMD
+      - redis-cli
+      - ping
+      timeout: 5s
+    volumes:
+    - polyweather_redis_data:/data
   polyweather:
-    <<: *polyweather-base
     container_name: polyweather_bot
-    restart: unless-stopped
-    volumes:
-      # Persist runtime data outside git workspace.
-      # Host path defaults to /var/lib/polyweather and can be overridden in .env.
-      - ${POLYWEATHER_RUNTIME_DATA_DIR:-/var/lib/polyweather}:/var/lib/polyweather
-      # Keep /app/data compatibility for existing cache/state defaults.
-      - ${POLYWEATHER_RUNTIME_DATA_DIR:-/var/lib/polyweather}:/app/data
-      - ./bot.log:/app/bot.log # 挂载日志文件
-    # UID/GID are mainly useful on Linux hosts to avoid root-owned output files.
-    # Windows / macOS can usually keep the fallback values.
-    user: "${UID:-1000}:${GID:-1000}"
-
-  polyweather_web:
-    <<: *polyweather-base
-    container_name: polyweather_web
-    restart: unless-stopped
-    command: python web/app.py
-    volumes:
-      # Web service shares the same runtime data directory as bot/state tasks.
-      - ${POLYWEATHER_RUNTIME_DATA_DIR:-/var/lib/polyweather}:/var/lib/polyweather
-      - ${POLYWEATHER_RUNTIME_DATA_DIR:-/var/lib/polyweather}:/app/data
-    ports:
-      - "8000:8000"
-    # UID/GID are mainly useful on Linux hosts to avoid root-owned output files.
-    user: "${UID:-1000}:${GID:-1000}"
-
-  polyweather_prewarm:
-    <<: *polyweather-base
-    container_name: polyweather_prewarm
-    restart: unless-stopped
-    profiles: ["workers"]
-    command: python scripts/prewarm_dashboard_worker.py --include-detail --include-market
-    volumes:
-      - ${POLYWEATHER_RUNTIME_DATA_DIR:-/var/lib/polyweather}:/var/lib/polyweather
-      - ${POLYWEATHER_RUNTIME_DATA_DIR:-/var/lib/polyweather}:/app/data
-    user: "${UID:-1000}:${GID:-1000}"
-
-  polyweather_prometheus:
-    image: prom/prometheus:v3.4.1
-    container_name: polyweather_prometheus
-    restart: unless-stopped
-    profiles: ["monitoring"]
     depends_on:
-      - polyweather_web
-    command:
-      - "--config.file=/etc/prometheus/prometheus.yml"
-      - "--storage.tsdb.path=/prometheus"
-      - "--storage.tsdb.retention.time=15d"
-      - "--web.enable-lifecycle"
-    volumes:
-      - ./monitoring/prometheus/prometheus.yml:/etc/prometheus/prometheus.yml:ro
-      - ./monitoring/prometheus/alerts.yml:/etc/prometheus/alerts.yml:ro
-      - ${POLYWEATHER_RUNTIME_DATA_DIR:-/var/lib/polyweather}/monitoring/prometheus:/prometheus
-    ports:
-      - "${POLYWEATHER_PROMETHEUS_PORT:-9090}:9090"
-
-  polyweather_alertmanager:
-    image: prom/alertmanager:v0.28.1
-    container_name: polyweather_alertmanager
-    restart: unless-stopped
-    profiles: ["monitoring"]
-    depends_on:
-      - polyweather_alert_relay
-    command:
-      - "--config.file=/etc/alertmanager/alertmanager.yml"
-      - "--storage.path=/alertmanager"
-    volumes:
-      - ./monitoring/alertmanager/alertmanager.yml:/etc/alertmanager/alertmanager.yml:ro
-      - ${POLYWEATHER_RUNTIME_DATA_DIR:-/var/lib/polyweather}/monitoring/alertmanager:/alertmanager
-    ports:
-      - "${POLYWEATHER_ALERTMANAGER_PORT:-9093}:9093"
-
-  polyweather_alert_relay:
-    <<: *polyweather-base
-    container_name: polyweather_alert_relay
-    restart: unless-stopped
-    profiles: ["monitoring"]
-    command: python scripts/alertmanager_telegram_relay.py
-    volumes:
-      - ${POLYWEATHER_RUNTIME_DATA_DIR:-/var/lib/polyweather}:/var/lib/polyweather
-      - ${POLYWEATHER_RUNTIME_DATA_DIR:-/var/lib/polyweather}:/app/data
-    ports:
-      - "${POLYWEATHER_ALERT_RELAY_PORT:-9099}:9099"
-    user: "${UID:-1000}:${GID:-1000}"
-
-  polyweather_grafana:
-    image: grafana/grafana-oss:12.0.2
-    container_name: polyweather_grafana
-    restart: unless-stopped
-    profiles: ["monitoring"]
-    depends_on:
-      - polyweather_prometheus
+      polyweather_redis:
+        condition: service_healthy
+    logging:
+      driver: "json-file"
+      options:
+        max-size: "50m"
+        max-file: "3"
+    cpus: ${POLYWEATHER_BOT_CPUS:-0.75}
+    env_file: &id001
+    - .env
     environment:
-      GF_SECURITY_ADMIN_USER: ${POLYWEATHER_GRAFANA_ADMIN_USER:-admin}
-      GF_SECURITY_ADMIN_PASSWORD: ${POLYWEATHER_GRAFANA_ADMIN_PASSWORD:-polyweather}
-      GF_USERS_ALLOW_SIGN_UP: "false"
+      POLYWEATHER_REDIS_URL: ${POLYWEATHER_REDIS_URL:-redis://polyweather_redis:6379/0}
+      POLYWEATHER_COLLECTOR_PATCH_ENDPOINT: ''
+      POLYWEATHER_OBSERVATION_COLLECTOR_ENABLED: 'false'
+      POLYWEATHER_SCAN_TERMINAL_PREWARM_ENABLED: 'false'
+      POLYWEATHER_SERVICE_ROLE: bot
+      TELEGRAM_AIRPORT_PUSH_INTERVAL_SEC: ${POLYWEATHER_BOT_AIRPORT_PUSH_INTERVAL_SEC:-60}
+      TELEGRAM_AIRPORT_PUSH_MAX_WORKERS: ${POLYWEATHER_BOT_AIRPORT_PUSH_MAX_WORKERS:-1}
+    healthcheck:
+      interval: 60s
+      retries: 3
+      test:
+      - CMD
+      - python
+      - -c
+      - import sqlite3; c=sqlite3.connect('/var/lib/polyweather/polyweather.db');
+        c.execute('SELECT 1'); c.close()
+      timeout: 10s
+    image: ghcr.io/yangyuan-zhen/polyweather-backend:${IMAGE_TAG:-latest}
+    mem_limit: ${POLYWEATHER_BOT_MEM_LIMIT:-768m}
+    memswap_limit: ${POLYWEATHER_BOT_MEMSWAP_LIMIT:-1g}
+    pids_limit: 256
+    restart: unless-stopped
+    user: ${UID:-1000}:${GID:-1000}
     volumes:
-      - ./monitoring/grafana/provisioning:/etc/grafana/provisioning:ro
-      - ./monitoring/grafana/dashboards:/var/lib/grafana/dashboards:ro
-      - ${POLYWEATHER_RUNTIME_DATA_DIR:-/var/lib/polyweather}/monitoring/grafana:/var/lib/grafana
+    - ${POLYWEATHER_RUNTIME_DATA_DIR:-/var/lib/polyweather}:/var/lib/polyweather
+    - ${POLYWEATHER_RUNTIME_DATA_DIR:-/var/lib/polyweather}:/app/data
+    - ./bot.log:/app/bot.log
+  polyweather_frontend:
+    logging:
+      driver: "json-file"
+      options:
+        max-size: "50m"
+        max-file: "3"
+    container_name: polyweather_frontend
+    environment:
+      NEXT_PUBLIC_POLYWEATHER_API_BASE_URL: ${NEXT_PUBLIC_POLYWEATHER_API_BASE_URL:-}
+      NEXT_PUBLIC_POLYWEATHER_LOCAL_FULL_ACCESS: 'false'
+      NEXT_PUBLIC_PAYMENT_ALLOWED_HOSTS: ${NEXT_PUBLIC_PAYMENT_ALLOWED_HOSTS:-polyweather.top,www.polyweather.top}
+      NEXT_PUBLIC_SITE_URL: ${NEXT_PUBLIC_SITE_URL:-https://polyweather.top}
+      NEXT_PUBLIC_SUPABASE_ANON_KEY: ${NEXT_PUBLIC_SUPABASE_ANON_KEY}
+      NEXT_PUBLIC_SUPABASE_URL: ${NEXT_PUBLIC_SUPABASE_URL}
+      NEXT_PUBLIC_TURNSTILE_SITE_KEY: ${NEXT_PUBLIC_TURNSTILE_SITE_KEY:-}
+      NEXT_PUBLIC_WALLETCONNECT_POLYGON_RPC_URL: ${NEXT_PUBLIC_WALLETCONNECT_POLYGON_RPC_URL:-https://polygon-bor-rpc.publicnode.com}
+      NEXT_PUBLIC_WALLETCONNECT_PROJECT_ID: ${NEXT_PUBLIC_WALLETCONNECT_PROJECT_ID:-}
+      POLYWEATHER_BACKEND_ENTITLEMENT_TOKEN: ${POLYWEATHER_BACKEND_ENTITLEMENT_TOKEN}
+      POLYWEATHER_API_BASE_URL: http://polyweather_web:8000
+      POLYWEATHER_AUTH_ENABLED: ${POLYWEATHER_AUTH_ENABLED:-true}
+      POLYWEATHER_AUTH_REQUIRED: ${POLYWEATHER_AUTH_REQUIRED:-true}
+      POLYWEATHER_OPS_ADMIN_EMAILS: ${POLYWEATHER_OPS_ADMIN_EMAILS:-}
+      POLYWEATHER_TURNSTILE_BYPASS: ${POLYWEATHER_TURNSTILE_BYPASS:-false}
+      POLYWEATHER_TURNSTILE_ENFORCE_ACTION: ${POLYWEATHER_TURNSTILE_ENFORCE_ACTION:-false}
+      POLYWEATHER_TURNSTILE_REQUIRE_PAYMENT_SUBMIT: ${POLYWEATHER_TURNSTILE_REQUIRE_PAYMENT_SUBMIT:-false}
+      POLYWEATHER_TURNSTILE_SECRET_KEY: ${POLYWEATHER_TURNSTILE_SECRET_KEY:-}
+    healthcheck:
+      interval: 30s
+      retries: 3
+      test:
+      - CMD-SHELL
+      - wget -qO- http://$(hostname):3000
+      timeout: 5s
+    image: ghcr.io/yangyuan-zhen/polyweather-frontend:${IMAGE_TAG:-latest}
     ports:
-      - "${POLYWEATHER_GRAFANA_PORT:-3001}:3000"
+    - "127.0.0.1:3001:3000"
+    restart: unless-stopped
+  polyweather_web:
+    command: python web/app.py
+    depends_on:
+      polyweather_redis:
+        condition: service_healthy
+    logging:
+      driver: "json-file"
+      options:
+        max-size: "50m"
+        max-file: "3"
+    container_name: polyweather_web
+    env_file: *id001
+    environment:
+      POLYWEATHER_REDIS_URL: ${POLYWEATHER_REDIS_URL:-redis://polyweather_redis:6379/0}
+      POLYWEATHER_R2_ACCESS_KEY_ID: ${POLYWEATHER_R2_ACCESS_KEY_ID:-}
+      POLYWEATHER_R2_ACCOUNT_ID: ${POLYWEATHER_R2_ACCOUNT_ID:-}
+      POLYWEATHER_R2_ARCHIVE_SOURCE: ${POLYWEATHER_R2_ARCHIVE_SOURCE:-redis}
+      POLYWEATHER_R2_BUCKET: ${POLYWEATHER_R2_BUCKET:-}
+      POLYWEATHER_R2_ENDPOINT_URL: ${POLYWEATHER_R2_ENDPOINT_URL:-}
+      POLYWEATHER_R2_REGION: ${POLYWEATHER_R2_REGION:-auto}
+      POLYWEATHER_R2_SECRET_ACCESS_KEY: ${POLYWEATHER_R2_SECRET_ACCESS_KEY:-}
+      POLYWEATHER_EVENT_STORE: ${POLYWEATHER_EVENT_STORE:-redis}
+      POLYWEATHER_REDIS_REQUIRED: ${POLYWEATHER_REDIS_REQUIRED:-true}
+      POLYWEATHER_REDIS_STREAM_MAXLEN: ${POLYWEATHER_REDIS_STREAM_MAXLEN:-100000}
+      POLYWEATHER_SCAN_TERMINAL_REDIS_CACHE_ENABLED: ${POLYWEATHER_SCAN_TERMINAL_REDIS_CACHE_ENABLED:-true}
+      POLYWEATHER_COLLECTOR_PATCH_ENDPOINT: ''
+      POLYWEATHER_CITY_DETAIL_BATCH_CONCURRENCY: ${POLYWEATHER_CITY_DETAIL_BATCH_CONCURRENCY:-3}
+      POLYWEATHER_CITY_DETAIL_BATCH_GLOBAL_CONCURRENCY: ${POLYWEATHER_CITY_DETAIL_BATCH_GLOBAL_CONCURRENCY:-3}
+      POLYWEATHER_CITY_DETAIL_BATCH_QUEUE_WAIT_MS: ${POLYWEATHER_CITY_DETAIL_BATCH_QUEUE_WAIT_MS:-3000}
+      POLYWEATHER_CITY_DETAIL_BATCH_PARTIAL_TIMEOUT_MS: ${POLYWEATHER_CITY_DETAIL_BATCH_PARTIAL_TIMEOUT_MS:-8000}
+      POLYWEATHER_OBSERVATION_COLLECTOR_AMOS_SEC: ${POLYWEATHER_OBSERVATION_COLLECTOR_AMOS_SEC:-60}
+      POLYWEATHER_OBSERVATION_COLLECTOR_AMSC_SEC: ${POLYWEATHER_OBSERVATION_COLLECTOR_AMSC_SEC:-60}
+      POLYWEATHER_OBSERVATION_COLLECTOR_COWIN_SEC: ${POLYWEATHER_OBSERVATION_COLLECTOR_COWIN_SEC:-60}
+      POLYWEATHER_OBSERVATION_COLLECTOR_ENABLED: 'false'
+      POLYWEATHER_OBSERVATION_COLLECTOR_HKO_SEC: ${POLYWEATHER_OBSERVATION_COLLECTOR_HKO_SEC:-600}
+      POLYWEATHER_OBSERVATION_COLLECTOR_INITIAL_DELAY_SEC: ${POLYWEATHER_OBSERVATION_COLLECTOR_INITIAL_DELAY_SEC:-5}
+      POLYWEATHER_OBSERVATION_COLLECTOR_MADIS_SEC: ${POLYWEATHER_OBSERVATION_COLLECTOR_MADIS_SEC:-300}
+      POLYWEATHER_OBSERVATION_COLLECTOR_TICK_SEC: ${POLYWEATHER_OBSERVATION_COLLECTOR_TICK_SEC:-30}
+      POLYWEATHER_SCAN_TERMINAL_BUILD_TIMEOUT_SEC: '30'
+      POLYWEATHER_SCAN_TERMINAL_MAX_WORKERS: ${POLYWEATHER_SCAN_TERMINAL_MAX_WORKERS:-4}
+      POLYWEATHER_SCAN_TERMINAL_PREWARM_ENABLED: ${POLYWEATHER_SCAN_TERMINAL_PREWARM_ENABLED:-false}
+      POLYWEATHER_BACKEND_ENTITLEMENT_TOKEN: ${POLYWEATHER_BACKEND_ENTITLEMENT_TOKEN}
+      POLYWEATHER_SERVICE_ROLE: web
+      SUPABASE_ANON_KEY: ${SUPABASE_ANON_KEY}
+      SUPABASE_SERVICE_ROLE_KEY: ${SUPABASE_SERVICE_ROLE_KEY}
+      SUPABASE_URL: ${SUPABASE_URL}
+      UVICORN_WORKERS: ${UVICORN_WORKERS:-2}
+    healthcheck:
+      interval: 30s
+      retries: 3
+      test:
+      - CMD
+      - python
+      - -c
+      - from urllib.request import urlopen; urlopen('http://localhost:8000/healthz')
+      timeout: 5s
+    image: ghcr.io/yangyuan-zhen/polyweather-backend:${IMAGE_TAG:-latest}
+    ports:
+    - "127.0.0.1:8000:8000"
+    restart: unless-stopped
+    ulimits:
+      nofile:
+        soft: 65535
+        hard: 65535
+    user: ${UID:-1000}:${GID:-1000}
+    volumes:
+    - ${POLYWEATHER_RUNTIME_DATA_DIR:-/var/lib/polyweather}:/var/lib/polyweather
+    - ${POLYWEATHER_RUNTIME_DATA_DIR:-/var/lib/polyweather}:/app/data
+  polyweather_collector:
+    command: python -m web.observation_collector_worker
+    container_name: polyweather_collector
+    depends_on:
+      polyweather_redis:
+        condition: service_healthy
+      polyweather_web:
+        condition: service_started
+    logging:
+      driver: "json-file"
+      options:
+        max-size: "50m"
+        max-file: "3"
+    cpus: ${POLYWEATHER_COLLECTOR_CPUS:-0.75}
+    env_file: *id001
+    environment:
+      POLYWEATHER_COLLECTOR_PATCH_ENDPOINT: ${POLYWEATHER_COLLECTOR_PATCH_ENDPOINT:-http://polyweather_web:8000/api/internal/collector-patch}
+      POLYWEATHER_OBSERVATION_COLLECTOR_AMOS_SEC: ${POLYWEATHER_OBSERVATION_COLLECTOR_AMOS_SEC:-60}
+      POLYWEATHER_OBSERVATION_COLLECTOR_AMSC_SEC: ${POLYWEATHER_OBSERVATION_COLLECTOR_AMSC_SEC:-60}
+      POLYWEATHER_OBSERVATION_COLLECTOR_COWIN_SEC: ${POLYWEATHER_OBSERVATION_COLLECTOR_COWIN_SEC:-60}
+      POLYWEATHER_OBSERVATION_COLLECTOR_ENABLED: 'true'
+      POLYWEATHER_OBSERVATION_COLLECTOR_HKO_SEC: ${POLYWEATHER_OBSERVATION_COLLECTOR_HKO_SEC:-600}
+      POLYWEATHER_OBSERVATION_COLLECTOR_INITIAL_DELAY_SEC: ${POLYWEATHER_OBSERVATION_COLLECTOR_INITIAL_DELAY_SEC:-15}
+      POLYWEATHER_OBSERVATION_COLLECTOR_MADIS_SEC: ${POLYWEATHER_OBSERVATION_COLLECTOR_MADIS_SEC:-300}
+      POLYWEATHER_OBSERVATION_COLLECTOR_TICK_SEC: ${POLYWEATHER_OBSERVATION_COLLECTOR_TICK_SEC:-30}
+      POLYWEATHER_OBSERVATION_COLLECTOR_CACHE_REFRESH_WORKERS: ${POLYWEATHER_OBSERVATION_COLLECTOR_CACHE_REFRESH_WORKERS:-2}
+      POLYWEATHER_REDIS_URL: ${POLYWEATHER_REDIS_URL:-redis://polyweather_redis:6379/0}
+      POLYWEATHER_SCAN_TERMINAL_PREWARM_ENABLED: 'false'
+      POLYWEATHER_SERVICE_ROLE: collector
+    healthcheck:
+      interval: 60s
+      retries: 3
+      test:
+      - CMD
+      - python
+      - -c
+      - import sqlite3; c=sqlite3.connect('/var/lib/polyweather/polyweather.db');
+        c.execute('SELECT 1'); c.close()
+      timeout: 10s
+    image: ghcr.io/yangyuan-zhen/polyweather-backend:${IMAGE_TAG:-latest}
+    mem_limit: ${POLYWEATHER_COLLECTOR_MEM_LIMIT:-768m}
+    memswap_limit: ${POLYWEATHER_COLLECTOR_MEMSWAP_LIMIT:-1g}
+    pids_limit: 256
+    restart: unless-stopped
+    user: ${UID:-1000}:${GID:-1000}
+    volumes:
+    - ${POLYWEATHER_RUNTIME_DATA_DIR:-/var/lib/polyweather}:/var/lib/polyweather
+    - ${POLYWEATHER_RUNTIME_DATA_DIR:-/var/lib/polyweather}:/app/data
+  polyweather_warmer:
+    command: python -m web.cache_warmer_worker
+    container_name: polyweather_warmer
+    depends_on:
+      polyweather_redis:
+        condition: service_healthy
+      polyweather_web:
+        condition: service_started
+    logging:
+      driver: "json-file"
+      options:
+        max-size: "50m"
+        max-file: "3"
+    cpus: ${POLYWEATHER_WARMER_CPUS:-0.75}
+    env_file: *id001
+    environment:
+      POLYWEATHER_EVENT_STORE: ${POLYWEATHER_EVENT_STORE:-redis}
+      POLYWEATHER_OBSERVATION_COLLECTOR_ENABLED: 'false'
+      POLYWEATHER_REDIS_URL: ${POLYWEATHER_REDIS_URL:-redis://polyweather_redis:6379/0}
+      POLYWEATHER_SCAN_TERMINAL_PREWARM_ENABLED: 'false'
+      POLYWEATHER_SERVICE_ROLE: warmer
+      POLYWEATHER_WARMER_CITY_BATCH_SIZE: ${POLYWEATHER_WARMER_CITY_BATCH_SIZE:-16}
+      POLYWEATHER_WARMER_CITY_INTERVAL_SEC: ${POLYWEATHER_WARMER_CITY_INTERVAL_SEC:-30}
+      POLYWEATHER_WARMER_ENABLED: ${POLYWEATHER_WARMER_ENABLED:-true}
+      POLYWEATHER_WARMER_SCAN_INTERVAL_SEC: ${POLYWEATHER_WARMER_SCAN_INTERVAL_SEC:-120}
+      POLYWEATHER_WARMER_TICK_SEC: ${POLYWEATHER_WARMER_TICK_SEC:-30}
+    healthcheck:
+      interval: 60s
+      retries: 3
+      test:
+      - CMD
+      - python
+      - -c
+      - import sqlite3; c=sqlite3.connect('/var/lib/polyweather/polyweather.db');
+        c.execute('SELECT 1'); c.close()
+      timeout: 10s
+    image: ghcr.io/yangyuan-zhen/polyweather-backend:${IMAGE_TAG:-latest}
+    mem_limit: ${POLYWEATHER_WARMER_MEM_LIMIT:-768m}
+    memswap_limit: ${POLYWEATHER_WARMER_MEMSWAP_LIMIT:-1g}
+    pids_limit: 256
+    restart: unless-stopped
+    user: ${UID:-1000}:${GID:-1000}
+    volumes:
+    - ${POLYWEATHER_RUNTIME_DATA_DIR:-/var/lib/polyweather}:/var/lib/polyweather
+    - ${POLYWEATHER_RUNTIME_DATA_DIR:-/var/lib/polyweather}:/app/data
+  polyweather_training_settlement:
+    command: python -m web.training_settlement_worker
+    container_name: polyweather_training_settlement
+    depends_on:
+      polyweather_redis:
+        condition: service_healthy
+      polyweather_web:
+        condition: service_started
+    logging:
+      driver: "json-file"
+      options:
+        max-size: "50m"
+        max-file: "3"
+    cpus: ${POLYWEATHER_TRAINING_SETTLEMENT_CPUS:-0.50}
+    env_file: *id001
+    environment:
+      POLYWEATHER_EVENT_STORE: ${POLYWEATHER_EVENT_STORE:-redis}
+      POLYWEATHER_OBSERVATION_COLLECTOR_ENABLED: 'false'
+      POLYWEATHER_REDIS_URL: ${POLYWEATHER_REDIS_URL:-redis://polyweather_redis:6379/0}
+      POLYWEATHER_SCAN_TERMINAL_PREWARM_ENABLED: 'false'
+      POLYWEATHER_SERVICE_ROLE: training_settlement
+      POLYWEATHER_TRAINING_SETTLEMENT_INITIAL_DELAY_SEC: ${POLYWEATHER_TRAINING_SETTLEMENT_INITIAL_DELAY_SEC:-60}
+      POLYWEATHER_TRAINING_SETTLEMENT_INTERVAL_SEC: ${POLYWEATHER_TRAINING_SETTLEMENT_INTERVAL_SEC:-21600}
+      POLYWEATHER_TRAINING_SETTLEMENT_LOOKBACK_DAYS: ${POLYWEATHER_TRAINING_SETTLEMENT_LOOKBACK_DAYS:-10}
+    healthcheck:
+      interval: 60s
+      retries: 3
+      test:
+      - CMD
+      - python
+      - -c
+      - import sqlite3; c=sqlite3.connect('/var/lib/polyweather/polyweather.db');
+        c.execute('SELECT 1'); c.close()
+      timeout: 10s
+    image: ghcr.io/yangyuan-zhen/polyweather-backend:${IMAGE_TAG:-latest}
+    mem_limit: ${POLYWEATHER_TRAINING_SETTLEMENT_MEM_LIMIT:-768m}
+    memswap_limit: ${POLYWEATHER_TRAINING_SETTLEMENT_MEMSWAP_LIMIT:-1g}
+    pids_limit: 256
+    restart: unless-stopped
+    user: ${UID:-1000}:${GID:-1000}
+    volumes:
+    - ${POLYWEATHER_RUNTIME_DATA_DIR:-/var/lib/polyweather}:/var/lib/polyweather
+    - ${POLYWEATHER_RUNTIME_DATA_DIR:-/var/lib/polyweather}:/app/data
+x-polyweather-base:
+  env_file: *id001
+  image: ghcr.io/yangyuan-zhen/polyweather-backend:${IMAGE_TAG:-latest}
+volumes:
+  polyweather_redis_data:

docs/AIRPORT_MARKET_MONITOR_ZH.md

@@ -0,0 +1,135 @@
+# 机场高频数据接入市场监控频道方案
+
+## 背景
+
+### 现有数据
+
+| 城市 | 站点 | ICAO/站点 | 数据类型 | 数据源 | 刷新频率 |
+|------|------|-----------|---------|--------|---------|
+| 首尔 | 仁川国际 | RKSI | 跑道对温度（2 对） | AMOS | 1 分钟 |
+| 釜山 | 金海国际 | RKPK | 跑道对温度（1 对） | AMOS | 1 分钟 |
+| 东京 | 羽田 | RJTT | 机场站点实时温度 | JMA AMeDAS | 10 分钟 |
+| 安卡拉 | Esenboğa | 17128 | 机场站点实时温度 | MGM | 不定，约 5-15 分钟 |
+
+### 现有 Telegram 推送系统
+
+- **循环**: `start_trade_alert_push_loop`，默认每 30 分钟跑一轮
+- **覆盖城市**: `TELEGRAM_ALERT_CITIES`（默认全部 51 城）
+- **3 条规则**: Ankara Center DEB 命中、预报突破、暖平流
+- **门禁**: 严重度/触发数/冷却期 多层过滤
+- **消息**: 中英双语，包含触发类型、实况温度
+
+### 问题
+
+四座机场城市的实时数据已就绪，但现有推送系统 30 分钟一轮对所有城市一视同仁。1-10 分钟级高频数据在接近交易高峰期时，温度变化可能比 30 分钟窗口更快，需要更灵敏的监控。
+
+---
+
+## 方案设计
+
+### 核心思路
+
+在现有 30 分钟主循环之上叠加高频通道，对四座机场城市用 10 分钟间隔独立检测温度急变。温度波动达到阈值时推送告警，包含当前温度 + DEB 预测最高温。不做市场分析、不输出 AI 建议、不约定时快照。
+
+### 1. 高频机场城市快速通道
+
+在现有 30 分钟主循环之外，为 `{seoul, busan, tokyo, ankara}` 单独跑一个 10 分钟间隔的子循环，每个城市独立检测温度急变。
+
+**配置（写死在代码中）**:
+```python
+HIGH_FREQ_AIRPORT_CITIES = {"seoul", "busan", "tokyo", "ankara"}
+HIGH_FREQ_PUSH_INTERVAL_SEC = 600        # 10 分钟
+HIGH_FREQ_MOMENTUM_THRESHOLD_C = 0.5     # 比默认 0.8°C 更灵敏
+HIGH_FREQ_COOLDOWN_SEC = 7200            # 同一城市冷却 2 小时
+```
+
+**逻辑**:
+- 主循环 30 分钟照常跑全部城市（不变）
+- 每 10 分钟对四座机场城市各检查一次温度急变
+- 高频轮次仅检查 `airport_rapid_temp_change` 一条规则
+- 各城市独立冷却，触发后 2 小时内同一城市不再重复推送
+- **最高温已锁定则跳过**：当日最高已过且持续下降，不再推送
+
+### 2. 机场观测积累与趋势检测
+
+**新增数据库表**: `airport_obs_log`
+```sql
+CREATE TABLE IF NOT EXISTS airport_obs_log (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    icao TEXT NOT NULL,
+    city TEXT NOT NULL,
+    temp_c REAL,
+    wind_kt REAL,
+    pressure_hpa REAL,
+    obs_time TEXT NOT NULL,
+    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
+);
+CREATE INDEX IF NOT EXISTS idx_airport_obs_log_icao_time
+    ON airport_obs_log(icao, created_at DESC);
+```
+
+**写入**: 在 AMOS/JMA/MGM 成功获取数据后自动调用 `append_airport_obs()` 写入。自动清理 2 小时前的旧数据。
+
+**读取**: `get_airport_obs_recent(icao, minutes=30)` 返回最近 N 分钟观测列表，用于计算温度变化斜率。
+
+### 3. 温度突变即时告警
+
+基于积累的观测日志，新增告警规则 `airport_rapid_temp_change`。每条告警 per-city 独立推送。
+
+| 参数 | 值 | 说明 |
+|------|-----|------|
+| 滑动窗口 | 20 分钟 | 取最近 20 分钟内的观测 |
+| 最少样本 | 3 条 | 确保有足够数据点 |
+| 触发阈值 | > 0.5°C/10min | 比默认 0.8°C/30min 更灵敏 |
+| 冷却期 | 2 小时 | 同城市两次推送最小间隔 |
+| 锁定跳过 | 最高温已锁定 | 当日最高已过且持续下降，不推送 |
+
+**告警消息示例**:
+
+首尔/釜山（跑道对温度）：
+```
+🚨 首尔/仁川 温度急变
+
+15L/33R 14.6°C
+15R/33L 15.2°C
+DEB 预测最高 18.2°C
+```
+
+东京/安卡拉（站点实时温度）：
+```
+🚨 东京/羽田 温度急变
+
+当前 24.1°C
+DEB 预测最高 26.5°C
+```
+
+---
+
+## 改动文件清单
+
+| 优先级 | 文件 | 改动 |
+|--------|------|------|
+| 1 | `src/database/db_manager.py` | 新增 `airport_obs_log` 表、`append_airport_obs()`、`get_airport_obs_recent()` |
+| 2 | `src/data_collection/weather_sources.py` | AMOS/JMA/MGM 成功后调用 `append_airport_obs()` 写日志 |
+| 3 | `src/analysis/market_alert_engine.py` | 新增 `airport_rapid_temp_change` 规则 |
+| 4 | `src/utils/telegram_push.py` | 10 分钟高频子循环、温度急变告警推送、最高温锁定跳过 |
+| 5 | `src/bot/runtime_coordinator.py` | 注册机场高频推送循环 |
+
+---
+
+## 实施顺序
+
+1. **Phase 1 — DB 层**: `airport_obs_log` 表 + 读写方法
+2. **Phase 2 — 采集层**: AMOS/JMA/MGM 成功后自动写日志，部署观察 1-2 天确认数据积累正常
+3. **Phase 3 — 告警引擎**: `airport_rapid_temp_change` 规则 + 单元测试
+4. **Phase 4 — 推送层**: 高频快速通道，直接推送市场监控频道
+5. **Phase 5 — 调参**: 观察 3-7 天调整阈值
+
+---
+
+## 风险与注意事项
+
+- **AMOS/JMA/MGM 站点可用性**: 各数据源可能偶发性不可用，需容错处理
+- **告警频率控制**: 高频循环可能产生过多告警，需要严格的冷却期和去重机制
+- **数据库体积**: `airport_obs_log` 每 1-10 分钟写入 4 条记录，2 小时约 48-480 条，自动清理后体积可控
+- **安卡拉 MGM 刷新频率**: `servis.mgm.gov.tr` 实测更新间隔 5-15 分钟不等，非固定周期

docs/AIRPORT_REALTIME_SOURCES.md

@@ -0,0 +1,132 @@
+# 机场高频实时数据源
+
+最后更新：`2026-05-28`
+
+## 已接入城市
+
+| 城市 | 机场 | ICAO/站点 | 数据源 | 频率 | 类型 | 费用 |
+|------|------|-----------|--------|------|------|------|
+| 首尔 | 仁川国际 | RKSI | AMOS (`global.amo.go.kr`) | 1 分钟 | 跑道对温度（2对） | 免费 |
+| 釜山 | 金海国际 | RKPK | AMOS (`global.amo.go.kr`) | 1 分钟 | 跑道对温度（1对） | 免费 |
+| 香港 | CoWIN 6087 | 6087 | CoWIN (`cowin.hku.hk`) | 1 分钟 | 参考站温度（保良局陈守仁小学） | 免费 |
+| 香港 | HKO | HKO | HKO 官方 CSV (`data.weather.gov.hk`) | 10 分钟 | 官方气象站温度 | 免费 |
+| 台北 | 松山/中央气象署 | 466920 | CWA 开放数据 | 10 分钟 | 官方站点温度 | 免费 |
+| 北京 | 首都机场 | ZBAA | AMSC AWOS | 3 分钟 | 跑道端点气温 | 免费 |
+| 上海 | 浦东机场 | ZSPD | AMSC AWOS | 3 分钟 | 跑道端点气温 | 免费 |
+| 广州 | 白云机场 | ZGGG | AMSC AWOS | 3 分钟 | 跑道端点气温 | 免费 |
+| 成都 | 双流机场 | ZUUU | AMSC AWOS | 3 分钟 | 跑道端点气温 | 免费 |
+| 重庆 | 江北机场 | ZUCK | AMSC AWOS | 3 分钟 | 跑道端点气温 | 免费 |
+| 武汉 | 天河机场 | ZHHH | AMSC AWOS | 3 分钟 | 跑道端点气温 | 免费 |
+| 青岛 | 胶东机场 | ZSQD | AMSC AWOS | 3 分钟 | 跑道端点气温 | 免费 |
+| 东京 | 羽田 | RJTT | JMA AMeDAS (`jma.go.jp`) | 10 分钟 | 机场站点实时温度 | 免费 |
+| 安卡拉 | Esenboğa | 17128 | MGM (`servis.mgm.gov.tr`) | 5-15 分钟 | 机场站点实时温度 | 免费 |
+| 伊斯坦布尔 | 伊斯坦布尔机场 | 17058 | MGM (`servis.mgm.gov.tr`) | 5-15 分钟 | 机场站点实时温度 | 免费 |
+| 赫尔辛基 | Vantaa | EFHK | FMI (`opendata.fmi.fi`) | 10 分钟 | 机场站点实时温度 | 免费 |
+| 阿姆斯特丹 | Schiphol | EHAM | KNMI (`dataplatform.knmi.nl`) | 10 分钟 | 机场站点实时温度 | 免费（需注册） |
+| 巴黎 | Le Bourget | LFPB | AROME HD (`api.open-meteo.com`) | 15 分钟 | 模型预报（非实测） | 免费 |
+| 新加坡 | Changi | WSSS | Singapore MSS (`api.data.gov.sg`) | 1 分钟 | 机场站点实时温度 (S24 站) | 免费 |
+| 纽约 | LaGuardia | KLGA | NOAA MADIS HFMETAR | 5 分钟 | 机场站点实时温度 | 免费 |
+| 洛杉矶 | LAX | KLAX | NOAA MADIS HFMETAR | 5 分钟 | 机场站点实时温度 | 免费 |
+| 芝加哥 | O'Hare | KORD | NOAA MADIS HFMETAR | 5 分钟 | 机场站点实时温度 | 免费 |
+| 丹佛 | Buckley | KBKF | NOAA MADIS HFMETAR | 5 分钟 | 机场站点实时温度 | 免费 |
+| 亚特兰大 | Hartsfield | KATL | NOAA MADIS HFMETAR | 5 分钟 | 机场站点实时温度 | 免费 |
+| 迈阿密 | MIA | KMIA | NOAA MADIS HFMETAR | 5 分钟 | 机场站点实时温度 | 免费 |
+| 旧金山 | SFO | KSFO | NOAA MADIS HFMETAR | 5 分钟 | 机场站点实时温度 | 免费 |
+| 休斯顿 | Hobby | KHOU | NOAA MADIS HFMETAR | 5 分钟 | 机场站点实时温度 | 免费 |
+| 达拉斯 | Love Field | KDAL | NOAA MADIS HFMETAR | 5 分钟 | 机场站点实时温度 | 免费 |
+| 奥斯汀 | Bergstrom | KAUS | NOAA MADIS HFMETAR | 5 分钟 | 机场站点实时温度 | 免费 |
+| 西雅图 | SeaTac | KSEA | NOAA MADIS HFMETAR | 5 分钟 | 机场站点实时温度 | 免费 |
+
+> **Singapore MSS**: 新加坡气象局（MSS）通过 data.gov.sg 开放数据平台提供全国 15 个站点
+> 的干球温度（1 分钟均值），更新频率 ~1 分钟。选取 S24 Upper Changi Road North 站
+> 作为樟宜机场 (WSSS) 的实时温度锚点。数据公开免费，无需 API 密钥。
+> 后端通过 `singapore_mss_sources.py` 拉取并注入 `airport_primary`。
+
+> **NOAA MADIS HFMETAR**: 美国 11 个城市的机场高频实时数据通过 NOAA MADIS 公共档案获取。
+> 数据源为 NetCDF 格式（`madis-data.ncep.noaa.gov/madisPublic1/data/LDAD/hfmetar/`），
+> 每 5 分钟全量更新一次，温度保留一位小数。匿名公开访问，无需 API 密钥。
+> 后端通过 `weather_sources.py` 拉取并注入 `airport_primary`，前端市场监控通过
+> `resolveMonitorTemperature` 优先读取 `airport_primary.temp` 获得小数精度温度。
+
+> **CoWIN 6087**: 香港图表默认参考站为 HKU CoWIN `6087`（保良局陈守仁小学）。
+> 该源提供约 1 分钟温度序列，作为 PM 最高温市场的高频参考曲线；HKO 10 分钟数据
+> 仍作为官方气象层保留。后端通过 `cowin_sources.py` 拉取并写入 `cowin_obs`。
+
+> **AMSC AWOS**: 中国内地跑道城市读取 AMSC `getWindPlate` 中的 `TDZ_TEMP` /
+> `MID_TEMP` / `END_TEMP`。这些字段是跑道观测位置气温，不是道面温度。
+> 结算跑道展示使用配置的结算端点；辅助跑道只作为背景曲线。
+
+## 独立观测采集器
+
+- Web/API 进程启动 `observation-collector` 后台线程，按源频率独立采集，不依赖 Telegram 推送循环
+- 默认频率：AMOS 60s、AMSC AWOS 180s、MADIS HFMETAR 300s、CoWIN 60s、HKO 600s
+- 每次采集复用 `weather_sources.py` 现有 `_attach_*` 写入逻辑，负责写 `airport_obs_log` / `runway_obs_log` / 今日观测缓存，并通过 `/api/internal/collector-patch` 写 Redis Stream 或 SQLite event log 后广播 SSE
+- 采集成功后刷新对应城市 `panel` cache；前端继续使用 HTTP snapshot + SSE patch，不需要依赖 Telegram 触发更新
+- `observation_source_gate.py` 对 AMSC、AMOS、MADIS、HKO、CoWIN 做 per-source/per-city singleflight 和 SQLite cooldown，防止 Web 请求、collector 和兜底分析同时打同一个外部源
+
+## Telegram 推送机制
+
+- 每城按原生频率独立推送，不捆绑
+- 首尔/釜山 60s，中国 AMSC 城市 180s，其余 600s
+- 循环轮询 60s 以匹配最快频率
+- Telegram 推送优先读取网站侧 `full`/`panel` 城市缓存；缓存缺失时只做非强制 `panel` 分析兜底，不触发 `force_refresh_observations_only`
+- 仅当当前温度距 DEB 预测最高 ≤3°C 时推送
+- 确认过峰值后自动停止
+
+## 前端实时同步与 SSE Patch / Redis Stream 机制
+
+为了向用户提供接近行情盘的实况响应并降低服务器负载，系统使用 **HTTP snapshot + Server-Sent Events (SSE) Patch + 可重放事件日志** 架构。生产环境推荐 Redis Stream；本地或单进程可回退 SQLite event log。
+
+### 1. 数据推送链路 (Data Pipeline)
+1. **Observation Collector 采集端触发**：`web.observation_collector_service` 按源频率调用采集层；在 `weather_sources.py` 中，当高频实况源（如 AMOS, AMSC, CoWIN, HKO, MADIS 等）采集到温度更新或观测时间变更时，会调用 `_emit_temperature_patch_if_changed` 过滤重复值，并异步向 `/api/internal/collector-patch` 发送 POST 报文。
+2. **标准化事件**：`realtime_patch_schema.py` 将旧 `city_patch` 或新 payload 统一成 `city_observation_patch.v1`。
+3. **事件存储**：生产环境写入 Redis Stream（`stream:city_observation`）并生成全局递增 `revision`；SQLite `observation_patch_events` 保留为本地/兜底 replay。
+4. **FastAPI SSE 广播**：FastAPI 后端的 `sse_router.py` 根据城市订阅集合向匹配连接推送 patch；断线重连时按 `since_revision` replay。
+5. **BFF 代理流**：浏览器前端通过 BFF 建立与 `/api/events` 的持久连接，从而无需固定整图轮询。
+
+### 2. 前端消费与刷新规则 (Frontend Freshness Rules)
+- **扫描列表免轮询更新**：`use-scan-terminal-query.ts` 通过 `useSsePatchVersion` 钩子订阅全局 SSE 版本。当有任何城市产生更新时，列表将触发按需重绘，之前固定的 5 分钟 `setInterval` 定时轮询已被彻底禁用。
+- **详情图表增量合并**：`LiveTemperatureThresholdChart.tsx` 使用 `useLatestPatch(city)` 钩子订阅当前选中城市的增量 Patch。当收到 Patch 时，前端会将最新温度与时间戳以增量形式直接合并（Merge）入本地的 `hourly` 状态中，避免重新加载完整的 City Detail JSON。
+- **双重降级兜底 (Safe Fallback Guard)**：
+  - **无 Patch 轮询兜底**：为了防止 SSE 连接断开或长时间无 patch 导致界面卡死，所有**可见图表**（即 active 槽位、compact 栅格槽位或 maximized 视图）会启动一个 60 秒的检测定时器。
+  - **触发条件**：若当前可见城市在连续 **2 分钟** 内没有收到任何 SSE patch，前端将自动发起主动请求：
+    1. 调用轻量级的 `/api/city/{city}/summary` 快速拉取最新实况温度。
+    2. 调用 `fetchHourlyForecastForCity(city, { ignoreCache: true })` 强刷完整的城市详情数据，确保数据一致性。
+- **按需加载与 Stagger 优化**：在加载城市详情时，前端会优先加载 Active 状态的图表，而处于 Background/非活动状态的图表则通过 staggered timer (按槽位索引延迟 300ms~1500ms) 异步获取，以分流请求峰值。
+- **前台恢复补齐**：浏览器标签页长时间在后台时，回来后会主动强刷可见图表 full detail，避免 SSE 被浏览器挂起后曲线落后。
+- **当地时间**：patch 中保留 `city_timezone` / `observed_at_utc`，前端按城市当地时间绘制横轴。
+
+## 消息模板
+
+```
+Seoul / Incheon 16:03
+
+15L/33R 14.6°C
+15R/33L 15.2°C
+今日DEB预报最高：18.2°C
+今日实测最高：16.5°C（15:30）
+```
+
+## 环境变量
+
+| 变量 | 说明 | 默认值 |
+|------|------|--------|
+| `TELEGRAM_PUSH_LANGUAGE` | Telegram 自动推送的全局语言，可选 `both`/`en`/`zh` | `both` |
+| `TELEGRAM_AIRPORT_PUSH_ENABLED` | 启用机场推送 | `true` |
+| `TELEGRAM_AIRPORT_PUSH_INTERVAL_SEC` | 循环轮询间隔 | `60` |
+| `TELEGRAM_AIRPORT_PUSH_LANGUAGE` | 机场推送语言覆盖，可选 `both`/`en`/`zh` | `both` |
+| `KNMI_API_KEY` | KNMI API 密钥（阿姆斯特丹必填） | — |
+| `POLYWEATHER_EVENT_STORE` | 实时事件存储，可选 `redis`/`sqlite` | `sqlite` |
+| `POLYWEATHER_REDIS_URL` | Redis Stream 连接地址 | `redis://127.0.0.1:6379/0` |
+| `POLYWEATHER_REDIS_STREAM_KEY` | Redis Stream key | `stream:city_observation` |
+| `POLYWEATHER_REDIS_STREAM_MAXLEN` | Redis Stream 保留长度 | `50000` |
+| `POLYWEATHER_REDIS_REQUIRED` | Redis 不可用时是否启动失败 | `true` |
+
+## 未接入城市
+
+| 城市 | 原因 |
+|------|------|
+| 马德里/Barajas | AEMET 注册页面失效 |
+| 伦敦/Heathrow | Met Office 仅 1 小时更新 |
+| 慕尼黑 | DWD 延迟 ~1 小时 |
+| 米兰/华沙/莫斯科 | 无已知实时源 |

docs/API_ZH.md

@@ -1,13 +1,13 @@
-# PolyWeather API 文档（v1.5.4）
+# PolyWeather API 文档（v1.8.1）
 
-最后更新：`2026-04-27`
+最后更新：`2026-05-28`
 
 本文档描述当前对外可用 API 口径（`web/app.py` + `web/routes.py` + `frontend/app/api/*`）。
 
 ## 1. 基础信息
 
 - 后端直连：`http://127.0.0.1:8000`
-- 前端 BFF：`https://polyweather-pro.vercel.app/api/*`
+- 前端 BFF：`https://polyweather.top/api/*`
 - 返回格式：`application/json`
 
 ## 2. 请求链路
@@ -17,7 +17,9 @@ flowchart LR
     FE["Browser / Dashboard"] --> BFF["Next.js Route Handlers (/api/*)"]
     BFF --> API["FastAPI (/web/app.py + /web/routes.py)"]
     API --> WX["Weather Collector"]
-    API --> ANA["DEB + Trend + Probability + Market Scan"]
+    API --> ANA["DEB + Hourly Consensus + Probability + Market Scan"]
+    API --> SSE["Realtime SSE (/api/events)"]
+    SSE --> EVENT["Redis Stream / SQLite Event Log"]
     API --> PAY["Payment Intent + Event + Confirm Loops"]
     API --> OBS["healthz / system status / metrics"]
 ```
@@ -31,8 +33,27 @@ flowchart LR
 | `/api/city/{name}/summary` | GET | 轻量摘要 |
 | `/api/city/{name}/detail` | GET | 聚合详情（含 market_scan） |
 | `/api/history/{name}` | GET | 历史对账 |
-| `/api/scan/terminal/ai-city` | POST | 城市决策卡 AI 解读（非流式 JSON） |
-| `/api/scan/terminal/ai-city/stream` | POST | 城市决策卡 AI 解读（SSE 流式） |
+| `/api/events` | GET | SSE 实时观测事件流 |
+| `/api/internal/collector-patch` | POST | 采集器内部写入实时观测 patch |
+
+### `GET /api/events`
+
+浏览器实时图表入口，使用 `text/event-stream`。
+
+参数：
+
+- `cities=shanghai,hong kong`：可选，逗号分隔城市列表；为空表示订阅全部城市。
+- `since_revision=<int>`：可选，断线重连后从指定 revision 之后 replay。
+- `replay_limit=<int>`：可选，默认 `500`，后端会做上限保护。
+
+事件：
+
+- `connected`：连接建立，包含当前 `latest_revision`。
+- `city_observation_patch.v1`：标准实时观测 patch，包含城市、序列、温度、观测 UTC 时间、城市时区、revision。
+- `resync_required`：replay 窗口不足或事件存储不可用，前端应回到 HTTP snapshot 重建画面。
+- `heartbeat`：保活。
+
+生产环境推荐 `POLYWEATHER_EVENT_STORE=redis`，以 Redis Stream 保存短窗口事件并支持多 worker fanout；本地或单进程可使用 SQLite event log。
 
 ### `GET /api/city/{name}/detail`
 
@@ -53,6 +74,7 @@ flowchart LR
 - `probabilities.engine / calibration_mode / calibration_version`
 - `probabilities.raw_mu / raw_sigma / calibrated_mu / calibrated_sigma`
 - `probabilities.shadow_distribution`
+- `deb.hourly_consensus / deb.hourly_path.base_source`
 - `intraday_meteorology.headline / confidence`
 - `intraday_meteorology.base_case_bucket / upside_bucket / downside_bucket`
 - `intraday_meteorology.next_observation_time`
@@ -61,40 +83,6 @@ flowchart LR
 - `vertical_profile_signal.heating_setup / suppression_risk / trigger_risk / mixing_strength`
 - `taf.signal.peak_window / suppression_level / disruption_level / markers`
 
-### `POST /api/scan/terminal/ai-city/stream`
-
-城市决策卡使用该接口生成“AI 机场报文解读”。前端默认请求 SSE 流，流式展示机场报文解读片段，最终以 `final` 事件返回完整 payload。
-
-请求体：
-
-```json
-{
-  "city": "Buenos Aires",
-  "force_refresh": false,
-  "locale": "zh-CN"
-}
-```
-
-SSE 事件：
-
-- `progress`：阶段性状态，例如开始调用 AI、切换非流式重试。
-- `preview`：可显示的预览文本。
-- `delta`：模型流式文本增量，前端会从中提取机场报文解读片段。
-- `final`：完整 `AiCityForecastPayload`。
-
-重点字段：
-
-- `status`：通常为 `ready`；超时或降级时会带 `reason / reason_zh / reason_en`。
-- `cached`：是否命中后端 AI 缓存。
-- `degraded`：是否为降级结果。前端不会把 degraded 结果写入长期 localStorage，但会保留页面内存态，避免切换选项卡后空白。
-- `city_forecast.predicted_max`：AI 给出的预计最高温中枢候选。
-- `city_forecast.range_low / range_high`：AI 给出的天气区间。
-- `city_forecast.final_judgment_zh / final_judgment_en`：最终判断。
-- `city_forecast.metar_read_zh / metar_read_en`：机场报文解读。
-- `city_forecast.reasoning_zh / reasoning_en`：把 METAR、DEB、多模型集群与日内风险合并后的推理。
-- `city_forecast.model_cluster_note_zh / model_cluster_note_en`：模型集群说明。
-- `city_forecast.risks_zh / risks_en`：后续上修或下修触发条件。
-
 ### 城市决策卡市场层口径
 
 - 前端会请求完整 `market_scan` / `all_buckets`，而不是只取 lite 结果。
@@ -126,18 +114,30 @@ SSE 事件：
 
 #### 2. `probabilities`
 
-概率层现在按“校准模型概率”对外解释，而不是直接把模型票数或市场价格当成概率。
+概率层基于 legacy 高斯分桶，以 DEB 融合预测 `mu` 和 ensemble spread `sigma` 生成 1°C 粒度概率分布。前端图表将 legacy 高斯展示为水平概率温度带和 `mu` 参考线，不把概率分布渲染成时间序列曲线。
 
-新增 / 重点字段：
+概率字段：
 
-- `engine`：概率引擎名称，例如 `lgbm_calibrated`、`emos`、`legacy`
-- `calibration_mode`：校准运行模式
-- `calibration_version`：校准产物版本
-- `raw_mu` / `raw_sigma`：原始分布参数
-- `calibrated_mu` / `calibrated_sigma`：校准后分布参数
-- `shadow_distribution`：shadow / 对照分布，供回归与灰度验证
+- `engine`：固定为 `legacy`
+- `mu`：DEB 融合预测中心值
+- `distribution`：当天合约桶概率分布
+- `distribution_all`：包含外围桶的完整分布
 
-当前前端展示 `probabilities.engine` 对应的生产概率分布；`EMOS` / `LGBM` 只有在评估通过、显式启用或 shadow 对照时才进入展示/解释层。模型共识与市场价格只作为辅助参考，不再作为主结论。
+#### 2.1 `deb.hourly_consensus`
+
+DEB hourly consensus 是当前图表与峰值窗口的优先小时路径。
+
+重点字段：
+
+- `version`：当前为 `deb_hourly_consensus.v1`
+- `base_source`：`multi_model_hourly_deb_weights`
+- `times` / `temps`：城市当地日的小时路径
+- `model_weights`：DEB 权重折叠后的模型权重
+
+说明：
+
+- 该路径是预测曲线，不是实测来源。
+- 图表默认展示全天；“高温”视图仅根据该路径推导 peak-centric 窗口。
 
 #### 3. `detail_depth`
 
@@ -206,7 +206,7 @@ SSE 事件：
 
 - 多数机场市场以 `METAR` / 机场主站实况为结算锚点。
 - `Wunderground` 是历史页面或参考入口，不应在产品文案里被描述成“站”。
-- `MGM / NMC / JMA / KMA / HKO / CWA` 等官方站网属于增强层或明确官方站点层；只有合约规则明确指定时，才作为最终结算站点。
+- `MGM / NMC / JMA / AMOS / HKO / CWA` 等官方站网属于增强层或明确官方站点层；只有合约规则明确指定时，才作为最终结算站点。
 
 ## 4. 鉴权与账户接口
 
@@ -238,6 +238,13 @@ SSE 事件：
 
 ### 支付状态建议
 
+`POST /api/payments/intents` 支持的关键字段：
+
+- `plan_code`：套餐，例如 `pro_monthly`
+- `payment_mode`：`wallet` 或 `direct`
+- `chain_id`：可选；多链支付时前端传用户选择的链，例如 Polygon `137` 或 Ethereum `1`
+- `token_address`：可选；指定该链上的 USDC / USDC.e 合约地址
+
 前端流程建议：
 
 1. `POST /intents`
@@ -295,6 +302,8 @@ SSE 事件：
 - `summary?force_refresh=true`：`Cache-Control: no-store`
 - 详情接口与支付接口：`no-store`
 - `METAR` / `TAF` / settlement current 由后端各自维护短 TTL 缓存
+- 实时事件层：`POLYWEATHER_EVENT_STORE=redis` 时使用 Redis Stream；未启用 Redis 时使用 SQLite `observation_patch_events` 作为 replay fallback
+- 前端终端图表：HTTP detail 仍是完整 snapshot，SSE patch 只做增量观测追加；长连接断开或后台恢复时前端会按 `since_revision` replay 或强刷 detail
 - 前端打开今日日内分析时，如果 full detail 或 market scan 正在同步，会先显示刷新锁，不展示可交互的旧内容
 - 城市决策卡 AI 解读前端缓存键为 `city + local_date + locale + METAR signature`；signature 优先使用原始 METAR，缺失时回退到报文时间、观测时间和温度
 - 城市决策卡 AI 解读使用两层前端缓存：页面内存缓存保存 loading / 流式进度 / 最终 payload，`localStorage` 保存最终成功 payload，默认 TTL 1 小时

docs/CITY_DATA_SOURCES.md

@@ -0,0 +1,168 @@
+# 城市实时数据源总览
+
+> 最后更新: 2026-05-28 | 51 城市
+
+## 数据源分级
+
+### Tier 1 — ≤1 分钟高频
+
+| 城市 | 来源 | 频率 | 备注 |
+|------|------|------|------|
+| seoul | AMOS 跑道传感器 (RKSI) | ~1 min | global.amo.go.kr, 站号 113 |
+| busan | AMOS 跑道传感器 (RKPK) | ~1 min | global.amo.go.kr, 站号 153 |
+| hong kong | CoWIN 6087 | ~1 min | cowin.hku.hk, 保良局陳守仁小學，前端图表默认展示 |
+| hong kong | HKO 官方 CSV | ~10 min | data.weather.gov.hk（文件名虽含 1min，实际 10min 一报） |
+| singapore | MSS 官方 API | ~1 min | api.data.gov.sg, 站号 S24 |
+| beijing | AMSC AWOS (ZBAA) | 3 min | 中国 |
+| shanghai | AMSC AWOS (ZSPD) | 3 min | 中国 |
+| guangzhou | AMSC AWOS (ZGGG) | 3 min | 中国 |
+| chengdu | AMSC AWOS (ZUUU) | 3 min | 中国 |
+| chongqing | AMSC AWOS (ZUCK) | 3 min | 中国 |
+| wuhan | AMSC AWOS (ZHHH) | 3 min | 中国 |
+| qingdao | AMSC AWOS (ZSQD) | 3 min | 中国 |
+
+### Tier 2 — 5 分钟高频 (MADIS)
+
+| 城市 | 来源 | 频率 | 备注 |
+|------|------|------|------|
+| new york | MADIS HFMETAR (KLGA) | 5 min | madis-data.ncep.noaa.gov |
+| los angeles | MADIS HFMETAR (KLAX) | 5 min | |
+| san francisco | MADIS HFMETAR (KSFO) | 5 min | |
+| denver | MADIS HFMETAR (KBKF) | 5 min | |
+| austin | MADIS HFMETAR (KAUS) | 5 min | |
+| houston | MADIS HFMETAR (KHOU) | 5 min | |
+| chicago | MADIS HFMETAR (KORD) | 5 min | |
+| dallas | MADIS HFMETAR (KDAL) | 5 min | |
+| miami | MADIS HFMETAR (KMIA) | 5 min | |
+| atlanta | MADIS HFMETAR (KATL) | 5 min | |
+| seattle | MADIS HFMETAR (KSEA) | 5 min | |
+
+### Tier 3 — 准实时国家级站网
+
+| 城市 | 来源 | 频率 | 国家/地区 |
+|------|------|------|------|
+| tokyo | JMA AMeDAS (44166) | 10 min | 日本 |
+| ankara | MGM (17128) | 5-15 min | 土耳其 |
+| istanbul | MGM (17058) | 5-15 min | 土耳其 |
+| helsinki | FMI 开放数据 | 10 min | 芬兰 |
+| amsterdam | KNMI 数据平台 | 10 min | 荷兰 |
+| shenzhen | HKO 官方 CSV (LFS) | ~10 min | 香港天文台流浮山自动站 |
+| taipei | CWA 开放数据 (466920) | ~10 min | 台湾 |
+| tel aviv | IMS Lod (225) | 实时 | 以色列 |
+| paris | AEROWEB 实况 / AROME HD | 实时/15min | 法国 (AROME是15分钟临近预报) |
+
+### Tier 4 — 仅 METAR（10 分钟缓存）
+
+| 城市 | ICAO | 备注 |
+|------|------|------|
+| london | EGLC | Met Office 仅 1 小时更新 |
+| jeddah | OEJN | NCM 数据源目前不可用 |
+| moscow | UUWW | 仅 UUWW METAR 单站 |
+| shenzhen | ZGSZ | 已接入 HKO 流浮山 10 分钟数据，见 Tier 3 |
+| munich | EDDM | DWD 延迟约 1 小时 |
+| milan | LIMC | 无已知实时源 |
+| warsaw | EPWA | 含 IMGW 附近站 |
+| madrid | LEMD | AEMET 注册已失效 |
+| toronto | CYYZ | |
+| mexico city | MMMX | |
+| buenos aires | SAEZ | |
+| sao paulo | SBGR | |
+| panama city | MPMG | |
+| kuala lumpur | WMKK | |
+| jakarta | WIHH | |
+| manila | RPLL | |
+| karachi | OPKC | |
+| lucknow | VILK | |
+| wellington | NZWN | |
+| cape town | FACT | |
+
+## 高频推送覆盖
+
+31 个城市在 `HIGH_FREQ_AIRPORT_CITIES`（Telegram 推送循环）:
+所有 Tier 1-3 城市 + shenzhen
+
+19 个城市在 `HIGH_FREQ_AIRPORT_ANALYSIS_CITIES`（日内分析）:
+seoul, busan, hong kong, lau fau shan, singapore, beijing, shanghai,
+guangzhou, chengdu, chongqing, wuhan, qingdao, shenzhen, tokyo,
+ankara, istanbul, helsinki, amsterdam, paris
+
+## 温度观测优先级链
+
+`country_networks.py:_airport_primary_from_raw()` 按以下顺序解析:
+
+1. MADIS HFMETAR（美国 11 城）
+2. AMOS 跑道传感器（首尔/釜山）
+3. MGM current（安卡拉/伊斯坦布尔）
+4. JMA AMeDAS current（东京）
+5. FMI current（赫尔辛基）
+6. KNMI current（阿姆斯特丹）
+7. CoWIN 6087（香港 1min 参考站）
+8. AEROWEB current（巴黎）
+9. IMS current（特拉维夫）
+10. NCM current（吉达）
+11. Singapore MSS current（新加坡）
+12. 纯 METAR（默认兜底）
+
+## 对日内偏差修正的影响
+
+- **Tier 1 城市**（1 分钟级）：修正权重可以更激进，数据噪声低
+- **Tier 2 城市**（5 分钟级）：修正效果良好，MADIS 更新稳定
+- **Tier 3 城市**（10-15 分钟级）：修正可用但滞后较大
+- **Tier 4 城市**（仅 METAR）：修正效果有限，不建议依赖
+
+
+## 实时事件与图表刷新逻辑
+
+当前终端图表不是固定整图轮询，而是：
+
+1. 首屏 / 切换城市时拉取 `/api/city/{city}/detail` 作为完整 snapshot。
+2. 可见图表连接 `/api/events?cities=...&since_revision=...&replay_limit=500`。
+3. 采集器产出 `city_observation_patch.v1` 后写入 Redis Stream（生产）或 SQLite event log（本地/兜底），再通过 SSE 推给浏览器。
+4. 前端把 patch 追加到已有实测序列，不显示 loading 遮罩；只有可见图表 2 分钟无 patch 时才启动 60 秒兜底刷新。
+5. 浏览器从后台切回前台时，前端会立即补一次 full detail，防止长时间挂页后图表落后。
+
+频率取决于源头：
+
+- AMOS / CoWIN / MSS：源头约 1 分钟，图表按 1 分钟粒度追加。
+- AMSC：中国跑道观测城市按 3 分钟采集，不再强制 60 秒刷新。
+- MADIS：源头约 5 分钟。
+- HKO / CWA / JMA / FMI / KNMI：源头约 10 分钟。
+- METAR-only 城市：按 METAR 可用频率和缓存 TTL，不伪装成 1 分钟实测。
+
+所有图表横轴和 tooltip 时间均按城市当地时间展示，不按用户浏览器时区。
+
+## 关于网站终端图表的数据曲线展示逻辑
+
+### 1. 实测数据（默认全开，突出核心）
+
+- **跑道全量展示**：北京、上海、广州、成都、重庆、武汉、青岛、首尔、釜山等城市的跑道实测数据，默认全量开启，无需手动勾选。
+- **结算跑道高亮**：系统内置了各大机场的官方结算跑道映射。命中的跑道将被**重点强调**（加粗的青色实线 #009688，线宽 2.8），并标记为“[跑道号] 结算跑道”。具体的跑道映射如下：
+  - 北京：19/01
+  - 上海：17L/35R
+  - 广州：02L/20R
+  - 成都：02L/20R
+  - 重庆：20R/02L
+  - 武汉：04/22
+  - 青岛：16/34
+  - 首尔：15R/33L
+  - 釜山：SR/SL
+- **辅助跑道弱化**：同一机场下的其他非结算跑道，也会同时展示，但采用较细的虚线（线宽 1.2）以作陪衬区分。
+- **单跑道机场去重**：釜山只有 `SR/SL` 跑道曲线时，不再额外展示 AMOS 聚合线，避免两条线语义重复。
+- **香港参考曲线**：Hong Kong 默认展示 CoWIN `6087`（保良局陈守仁小学）1 分钟参考站曲线；HKO 10 分钟实测作为官方气象层保留。
+- **其他实测展示**：所有城市的 METAR 报文曲线、官方气象站实测（如 Shenzhen / Lau Fau Shan 的 HKO 自动站、Taipei 的 CWA）均默认展示。
+
+### 2. 核心预测数据（默认展示）
+
+- **DEB 模型融合**：作为平台核心的智能融合预测曲线，默认始终展示给用户。DEB 是预测，不参与“实测接近峰值”的视觉预警计算。
+- **DEB hourly consensus**：图表优先使用 `deb_hourly_consensus.v1` 的小时路径展示 DEB 曲线和推导“高温”窗口；如果缺失才回退旧的 hourly + DEB offset 路径。
+
+### 3. 多模型原始数据（默认隐藏，按需自选）
+
+- **保持整洁**：为了防止图表线缆过于杂乱，各大原始模型（ECMWF, GFS, ICON, GEM 等）的数据曲线在初次加载时**默认隐藏**。
+- **特例**：仅针对巴黎（Paris），由于其 AROME HD 是高精度的 15 分钟级临近预报，极具参考价值，因此默认开启。
+- **自由交互**：用户可通过图表底部的图例交互按钮，随时自由勾选、叠加或隐藏任意所需的数据曲线。
+
+### 4. 高斯概率图层
+
+- legacy 高斯概率不会作为时间序列曲线展示。
+- 图表上只渲染概率温度带和 `mu` 参考线，帮助用户判断当前实测距概率中心和高概率区域的关系。

docs/CLOUDFLARE_FREE_CACHE_ZH.md

@@ -0,0 +1,205 @@
+# Cloudflare 免费版缓存配置
+
+目标：让 Cloudflare 承担公开页面、公开 API 和静态资源的重复读取，降低 VPS CPU、Next.js worker 和后端 detail-batch 压力，同时避免缓存账户、支付、反馈和实时连接。
+
+代码已通过 `Cache-Control` 与 `Cloudflare-CDN-Cache-Control` 声明 TTL。由于免费版会严格遵守源站的 `max-age=0`，稳定公开路径的 Cache Rules 额外按状态码覆盖 Edge TTL；可能返回 partial、stale 或 failed 的接口继续尊重源站缓存头。不要给所有 `/api/*` 统一启用 Cache Everything。
+
+缓存规则只允许作用于前端域名 `polyweather.top`。`api.polyweather.top` 是带服务令牌和会员校验的后端源站，必须绕过 Cloudflare 缓存，避免缓存命中绕过后端权限检查。
+
+## 已接入的免费能力
+
+- Cache Rules：仓库脚本 `scripts/configure_cloudflare_free.py` 同步公开缓存规则，`scripts/validate_frontend_cache.sh` 可检查 `CF-Cache-Status`。
+- Turnstile：登录/注册经 Supabase Auth captcha token；反馈提交和支付创建订单在 Next API Route 校验后再转发给后端。
+- R2：`scripts/archive_realtime_events_to_r2.py` 可把 Redis/SQLite 中的 SSE 事件按天归档为 JSONL，上传到 Cloudflare R2。
+
+暂不建议把 Tunnel 作为本轮替代 Nginx：当前 Nginx 还承担 TLS、回源隔离和本地 compose 端口映射，Tunnel 需要单独灰度和回滚方案。
+
+## 基础设置
+
+- `Caching > Configuration > Browser Cache TTL`：Respect Existing Headers
+- `Caching > Configuration > Development Mode`：Off
+- `Caching > Configuration > Always Online`：On
+- `Caching > Tiered Cache`：Smart Tiered Cache，若当前免费套餐控制台提供则开启
+- `Speed > Optimization > Content Optimization > Brotli`：On
+- `Speed > Optimization > Content Optimization > Early Hints`：On
+- `Network > HTTP/3 (with QUIC)`：On
+- `Network > WebSockets`：On
+- 确保 `api.polyweather.top` 与 `polyweather.top` 代理状态为 Proxied
+
+## Cache Rules
+
+按以下顺序创建。Cloudflare 同一阶段最后匹配的规则生效，因此绕过规则必须放在公开缓存规则之后。免费版规则数量有限，因此使用路径集合合并表达式。
+
+也可以使用仓库内脚本自动创建或更新规则。脚本会保留非 PolyWeather 规则，并把绕过规则放在最后。
+
+Cloudflare 新版 Token UI 中，文档里的 Cache Rules 权限通常显示为：
+
+- 权限策略资源：`指定域名` -> `polyweather.top`
+- `Cache & Performance` -> `Cache Settings` -> `Edit`
+
+为了避免 Token 还需要列出 Zone，请同时在 GitHub Secrets 配置 `CLOUDFLARE_ZONE_ID`。Zone ID 在 Cloudflare 进入 `polyweather.top` 后，右侧 API 区域或 Overview 页面可以复制。
+
+GitHub Actions 需要两个仓库 Secret：
+
+- `CLOUDFLARE_API_TOKEN`
+- `CLOUDFLARE_ZONE_ID`
+
+```powershell
+$env:CLOUDFLARE_API_TOKEN="<具有 Cache Settings Edit 权限的 token>"
+$env:CLOUDFLARE_ZONE_ID="<polyweather.top 的 Zone ID>"
+python scripts/configure_cloudflare_free.py
+python scripts/configure_cloudflare_free.py --apply
+```
+
+第一条命令只输出计划；只有带 `--apply` 才会修改 Cloudflare。
+
+部署流水线也会执行同一脚本。给 GitHub 仓库增加 `CLOUDFLARE_API_TOKEN` 和 `CLOUDFLARE_ZONE_ID` 两个 Secret 后，后续每次成功部署都会同步 Cache Rules；未配置时流水线会明确跳过，不影响主站部署。
+
+### 1. 缓存公开内容
+
+脚本会创建 5 条互不重叠的公开缓存规则。动作均为 Eligible for cache：
+
+- 静态资源：2xx Edge TTL 覆盖为 1 年。
+- 首页和公开文档页：2xx Edge TTL 覆盖为 10 分钟。
+- `/api/cities`：2xx Edge TTL 覆盖为 5 分钟。
+- 城市详情与 detail-batch：尊重源站成功、partial、stale 和错误缓存策略。
+- `/api/scan/terminal` 与 `/api/system/status`：尊重源站成功、busy、failed 和错误缓存策略。
+
+所有公开缓存规则都显式设置 Browser TTL 为 Respect origin，避免 Cloudflare 免费版默认 Browser Cache TTL 把 HTML 或数据接口改成 4 小时本地缓存。
+
+### 2. 最后绕过后端域名、动态和敏感请求
+
+动作：Bypass cache
+
+表达式：
+
+```text
+http.host eq "api.polyweather.top"
+or (http.request.method ne "GET" and http.request.method ne "HEAD")
+or starts_with(http.request.uri.path, "/api/auth/")
+or starts_with(http.request.uri.path, "/api/feedback")
+or starts_with(http.request.uri.path, "/api/events")
+or starts_with(http.request.uri.path, "/api/internal/")
+or starts_with(http.request.uri.path, "/api/ops/")
+or starts_with(http.request.uri.path, "/api/payments/")
+or starts_with(http.request.uri.path, "/account")
+or starts_with(http.request.uri.path, "/auth")
+or starts_with(http.request.uri.path, "/ops")
+or starts_with(http.request.uri.path, "/terminal")
+or http.request.uri.query contains "force_refresh=true"
+```
+
+若 Dashboard 支持请求头或 Cookie 条件，再加入：
+
+```text
+or any(http.request.headers["authorization"][*] ne "")
+or http.cookie contains "sb-"
+```
+
+## 缓存 TTL
+
+### 静态资源
+
+动作：Eligible for cache；2xx Edge TTL 覆盖为一年。
+
+表达式：
+
+```text
+http.host eq "polyweather.top"
+and (
+  starts_with(http.request.uri.path, "/_next/static/")
+  or lower(http.request.uri.path.extension) in {
+    "js" "css" "woff" "woff2" "png" "jpg" "jpeg" "webp" "avif" "svg" "ico"
+  }
+)
+```
+
+源站仍声明一年 immutable，Cloudflare Edge TTL 同样固定为一年。
+
+### 公开页面
+
+动作：Eligible for cache；2xx Edge TTL 覆盖为 10 分钟。
+
+表达式：
+
+```text
+http.host eq "polyweather.top"
+and (
+  http.request.uri.path eq "/"
+  or starts_with(http.request.uri.path, "/docs/")
+  or starts_with(http.request.uri.path, "/modern/")
+  or starts_with(http.request.uri.path, "/probabilities/")
+  or starts_with(http.request.uri.path, "/subscription-help/")
+)
+```
+
+源站 TTL：10 分钟，过期后允许后台刷新 1 小时。
+
+### 公开数据接口
+
+动作：Eligible for cache；城市列表的 2xx Edge TTL 覆盖为 5 分钟，详情、扫描和系统状态尊重源站缓存头。
+
+表达式：
+
+```text
+http.host eq "polyweather.top"
+and (
+  http.request.uri.path eq "/api/cities"
+  or http.request.uri.path eq "/api/cities/detail-batch"
+  or starts_with(http.request.uri.path, "/api/city/")
+  or http.request.uri.path eq "/api/scan/terminal"
+  or http.request.uri.path eq "/api/system/status"
+)
+```
+
+接口 TTL：
+
+- `/api/cities`：5 分钟，过期后可复用 1 小时。
+- 城市详情与 detail-batch：60 秒，过期后可复用 5 分钟。
+- `/api/scan/terminal`：5 分钟，过期后可复用 15 分钟。
+- partial、busy、timeout、stale、force refresh 和错误响应：源站为 `no-store`，详情和扫描规则不会覆盖；force refresh 由最后一条绕过规则排除。
+
+## 验证
+
+每次规则变更后连续请求同一 URL，检查响应头：
+
+```powershell
+curl.exe -sS -D - -o NUL "https://polyweather.top/api/cities"
+curl.exe -sS -D - -o NUL "https://polyweather.top/api/scan/terminal?limit=1"
+```
+
+正常命中应看到 `CF-Cache-Status: HIT` 和递增的 `Age`。首次请求通常是 `MISS`；动态或明确 `no-store` 的请求应保持 `DYNAMIC` 或 `BYPASS`。
+
+也可以用脚本：
+
+```bash
+scripts/validate_frontend_cache.sh https://polyweather.top
+REQUIRE_CF_CACHE=true scripts/validate_frontend_cache.sh https://polyweather.top
+```
+
+第二条会把缺失 `CF-Cache-Status` 或持续 `MISS` 作为失败处理，适合 Cache Rules 同步后的线上检查。
+
+## Turnstile
+
+Cloudflare 控制台创建 Turnstile site 后，配置：
+
+- GitHub Secrets：`NEXT_PUBLIC_TURNSTILE_SITE_KEY`
+- VPS / Docker `.env`：`NEXT_PUBLIC_TURNSTILE_SITE_KEY`
+- VPS / Docker `.env`：`POLYWEATHER_TURNSTILE_SECRET_KEY`
+
+`NEXT_PUBLIC_TURNSTILE_SITE_KEY` 属于前端构建期变量，改动后必须重新构建前端镜像。`POLYWEATHER_TURNSTILE_SECRET_KEY` 只在服务端使用，不要提交仓库。
+
+## R2 事件归档
+
+R2 用于冷归档，不替代 Redis Stream / SQLite 的热路径。推荐先用 dry-run 看事件量：
+
+```bash
+python scripts/archive_realtime_events_to_r2.py --source redis --date 2026-06-16 --dry-run
+python scripts/archive_realtime_events_to_r2.py --source redis --date 2026-06-16
+```
+
+对象 key 形如：
+
+```text
+sse-events/2026/06/16/city_observation_patch.redis.jsonl
+```

docs/COMMERCIALIZATION.md

@@ -1,6 +1,6 @@
 # 商业化说明（Production）
 
-最后更新：`2026-04-18`
+最后更新：`2026-05-30`
 
 ## 1. 定位
 
@@ -8,8 +8,8 @@ PolyWeather 是面向温度结算场景的气象决策层，不是通用天气
 
 核心价值：
 
-- 观测优先（METAR / 机场主站 / 明确官方站点；MGM、NMC、JMA、KMA 等作为增强层）
-- 结算导向（DEB + 校准概率桶）
+- 观测优先（METAR / 机场主站 / 明确官方站点；MGM、JMA、AMOS、AMSC、CoWIN、CWA 等作为增强层）
+- 结算导向（DEB hourly consensus + 校准概率桶）
 - 气象判断优先（证据链、失效条件、下一观测点）
 - 市场映射（行情对照 + 错价雷达），但不把交易建议放在第一层产品承诺
 
@@ -18,12 +18,17 @@ PolyWeather 是面向温度结算场景的气象决策层，不是通用天气
 | 能力 | 状态 | 备注 |
 | :-- | :-- | :-- |
 | 登录注册（Google + 邮箱） | 已上线 | Supabase 鉴权 |
-| 订阅套餐（Pro 月付） | 已上线 | `5 USDC / 30天` |
-| 积分抵扣 | 已上线 | `500分=1U`，最多 `3U` |
+| 订阅套餐（Pro 月付 / 季度） | 已上线 | `29.9 USDC / 30天`；`79.9 USDC / 90天` |
+| 邀请积分 | 已上线 | 被邀请人首月 `20U`；邀请人每个有效付费邀请 `+3500` 积分 |
+| 用户增长奖励 | 已上线 | 按已验证用户里程碑，为当前有效且有 confirmed 入账记录的付费会员延长 Pro |
+| 积分抵扣 | 已上线 | `500分=1U`，最多 `3U`；邀请首月价不叠加积分抵扣 |
 | 合约支付 | 已上线 | Polygon，USDC + USDC.e |
-| 支付自动确认 | 已上线 | Event Loop + Confirm Loop |
+| 多链直转支付 | 已上线 | Ethereum 主网 USDC 直转确认 |
+| 支付自动确认 | 已上线 | Event Loop + Confirm Loop，按 intent.chain_id 查链 |
 | 钱包绑定 | 已上线 | 浏览器钱包 + WalletConnect |
 | 私有频道推送 | 已上线 | 可拆分业务频道 |
+| 实时终端 | 已上线 | SSE Patch + Redis Stream replay |
+| Telegram 双语推送 | 已上线 | 中英文一起推送，结算跑道端点口径 |
 
 ## 3. 权限模型（当前）
 
@@ -32,15 +37,19 @@ PolyWeather 是面向温度结算场景的气象决策层，不是通用天气
 - Pro 用户：
   - 今日日内深度分析（含高温时段）
   - 专业气象结论条、证据链、失效条件、确认条件
-  - LGBM / EMOS 等校准概率层
+  - 概率分布层（基于 DEB 融合 + 高斯分桶）
+  - 实时终端多城市图表（跑道/官方站点/DEB/概率带）
   - 历史对账 + 未来日期分析
-  - 全平台智能气象推送
+  - Telegram 缓存推送与业务频道通知
 
 ## 4. 收费与积分规则（默认）
 
-- 套餐：`pro_monthly`（5 USDC / 30 天）
-- 抵扣：500 积分抵 1 USDC，最高抵 3 USDC
-- 实付下限：2 USDC（当积分满额时）
+- 套餐：`pro_monthly`（29.9 USDC / 30 天）、`pro_quarterly`（79.9 USDC / 90 天）
+- 邀请首月：被邀请人首次月付 20 USDC
+- 邀请奖励：邀请人 +3500 积分，每月最多 10 个有效付费邀请
+- 用户增长奖励：600 已验证用户 `+1天`、750 `+2天`、1000 `+3天`，此后每增长 100 人 `+3天`
+- 抵扣：500 积分抵 1 USDC；月付最高抵 3 USDC，季度最高抵 8 USDC
+- 积分来源：仅通过有效付费邀请和后台人工补发，不再通过 Telegram 群发言发放
 
 > 说明：具体运营策略可按阶段调整，生产参数建议放私有仓库。
 
@@ -62,6 +71,7 @@ PolyWeather 是面向温度结算场景的气象决策层，不是通用天气
 5. 安全边界：敏感配置不进仓库。
 6. 数据口径：机场市场按 METAR / 机场主站解释；Wunderground 只可描述为历史页面或参考入口，不描述成“站”。
 7. 加载口径：日内分析和右侧详情在 full detail 未补齐前必须显示同步状态，不能把旧缓存伪装成完整付费内容。
+8. 实时口径：终端图表应优先保留已有曲线并无痛合并 patch，不用 loading 遮罩覆盖已可用数据。
 
 ## 7. 后续路线
 

docs/CONFIGURATION_ZH.md

@@ -1,5 +1,7 @@
 # 配置与密钥管理（中文）
 
+最后更新：`2026-05-28`
+
 ## 1. 目标
 
 PolyWeather 的环境变量很多，但不是所有变量都属于同一层级。
@@ -15,7 +17,7 @@ PolyWeather 的环境变量很多，但不是所有变量都属于同一层级
 3. 平台侧真实密钥  
    放在：
    - VPS / Docker `.env`
-   - Vercel Environment Variables
+   - GitHub Secrets（构建期 `NEXT_PUBLIC_*` 通过 build-arg 注入前端镜像）
    - GitHub Secrets（如需要）
 
 ## 2. 为什么要拆
@@ -64,7 +66,7 @@ PolyWeather 的环境变量很多，但不是所有变量都属于同一层级
 
 用途：
 
-- 前端本地开发与 Vercel 环境变量模板
+- 前端本地开发与容器运行时环境变量模板
 
 ## 4. 配置分级
 
@@ -79,6 +81,7 @@ PolyWeather 的环境变量很多，但不是所有变量都属于同一层级
 - `POLYWEATHER_RUNTIME_DATA_DIR`
 - `POLYWEATHER_DB_PATH`
 - `POLYWEATHER_STATE_STORAGE_MODE`
+- `POLYWEATHER_EVENT_STORE`
 
 前端：
 
@@ -104,14 +107,16 @@ PolyWeather 的环境变量很多，但不是所有变量都属于同一层级
 - `POLYWEATHER_AUTH_REQUIRE_SUBSCRIPTION`
 - `POLYWEATHER_OPS_ADMIN_EMAILS`
 - `POLYWEATHER_STATE_STORAGE_MODE`
+- `POLYWEATHER_EVENT_STORE`
+- `POLYWEATHER_REDIS_REQUIRED`
 - `POLYWEATHER_PAYMENT_ENABLED`
-- `POLYMARKET_MARKET_SCAN_ENABLED`
+- `POLYWEATHER_PAYMENT_RPC_URLS_BY_CHAIN_JSON`
 - `POLYGON_WALLET_WATCH_ENABLED`
+- `POLYWEATHER_TURNSTILE_BYPASS`
+- `POLYWEATHER_TURNSTILE_ENFORCE_ACTION`
+- `POLYWEATHER_TURNSTILE_REQUIRE_PAYMENT_SUBMIT`
 - `TELEGRAM_ALERT_PUSH_ENABLED`
 - `TELEGRAM_MARKET_FOCUS_DIGEST_ENABLED`
-- `POLYMARKET_WALLET_ACTIVITY_ENABLED`（已退役，建议保持 `false`）
-- `POLYWEATHER_DASHBOARD_PREWARM_ENABLED`
-- `POLYWEATHER_GROQ_COMMENTARY_ENABLED`
 
 ### 4.3 L3：运行调优项
 
@@ -130,30 +135,17 @@ PolyWeather 的环境变量很多，但不是所有变量都属于同一层级
 - `TELEGRAM_MARKET_FOCUS_DIGEST_INTERVAL_SEC`
 - `TELEGRAM_MARKET_FOCUS_DIGEST_TOP_N`
 - `POLYWEATHER_PAYMENT_RPC_URLS`
+- `POLYWEATHER_PAYMENT_RPC_URLS_BY_CHAIN_JSON`
 - `TAF_CACHE_TTL_SEC`
-- `POLYWEATHER_PREWARM_INTERVAL_SEC`
-- `POLYWEATHER_PREWARM_JITTER_SEC`
-- `POLYWEATHER_PREWARM_CITIES`
-- `POLYWEATHER_PREWARM_INCLUDE_DETAIL`
-- `POLYWEATHER_PREWARM_INCLUDE_MARKET`
-- `POLYWEATHER_PREWARM_FORCE_REFRESH`
-- `POLYWEATHER_GROQ_COMMENTARY_MODEL`
-- `POLYWEATHER_GROQ_COMMENTARY_TIMEOUT_SEC`
-- `POLYWEATHER_GROQ_COMMENTARY_CACHE_TTL_SEC`
+- `POLYWEATHER_REDIS_URL`
+- `POLYWEATHER_REDIS_STREAM_KEY`
+- `POLYWEATHER_REDIS_STREAM_MAXLEN`
 
 策略：
 
 - 先用默认值
 - 出现性能或运维问题时再调
 
-当前默认预热名单优先覆盖：
-
-- 亚洲：Shanghai、Beijing、Shenzhen、Wuhan、Chengdu、Chongqing、Hong Kong、Taipei、Singapore、Tokyo、Seoul、Busan
-- 中东：Ankara、Istanbul
-- 欧洲：London、Paris、Madrid
-
-默认不再包含美国城市；如果线上 `.env` 已手动设置 `POLYWEATHER_PREWARM_CITIES`，则会以你的显式配置为准。
-
 ### 4.4 L4：敏感项
 
 这些变量不应写进公开文档截图，也不应提交到仓库。
@@ -164,10 +156,10 @@ PolyWeather 的环境变量很多，但不是所有变量都属于同一层级
 - `SUPABASE_SERVICE_ROLE_KEY`
 - `POLYWEATHER_BACKEND_ENTITLEMENT_TOKEN`
 - `POLYWEATHER_DASHBOARD_ACCESS_TOKEN`
-- `METEOBLUE_API_KEY`
 - `NEXT_PUBLIC_WALLETCONNECT_PROJECT_ID`
-- `POLYMARKET_SECRET_KEY`
-- `GROQ_API_KEY`
+- `POLYWEATHER_TURNSTILE_SECRET_KEY`
+- `POLYWEATHER_R2_ACCESS_KEY_ID`
+- `POLYWEATHER_R2_SECRET_ACCESS_KEY`
 
 ## 5. 推荐部署矩阵
 
@@ -179,20 +171,28 @@ PolyWeather 的环境变量很多，但不是所有变量都属于同一层级
 - 所有 secrets
 - Bot / 支付 / watcher 配置
 
-### 5.2 Vercel（前端）
+### 5.2 前端容器（Docker Compose）
 
-建议只放前端真正需要的变量：
+前端与后端一起以 Docker Compose 部署，环境变量分两类来源：
 
-- `POLYWEATHER_API_BASE_URL`
-- `NEXT_PUBLIC_SUPABASE_URL`
-- `NEXT_PUBLIC_SUPABASE_ANON_KEY`
+**运行时变量**（`.env` 或 compose `environment` 块）：
+
+- `POLYWEATHER_API_BASE_URL`（容器内使用 `http://polyweather_web:8000`）
 - `POLYWEATHER_AUTH_ENABLED`
 - `POLYWEATHER_AUTH_REQUIRED`
 - `POLYWEATHER_OPS_ADMIN_EMAILS`
 - `POLYWEATHER_DASHBOARD_ACCESS_TOKEN`
 - `POLYWEATHER_BACKEND_ENTITLEMENT_TOKEN`
+
+**构建期变量**（GitHub Secrets → CI `build-and-push` → `frontend/Dockerfile` 的 `ARG`，改了必须重新构建镜像）：
+
+- `NEXT_PUBLIC_SUPABASE_URL`
+- `NEXT_PUBLIC_SUPABASE_ANON_KEY`
+- `NEXT_PUBLIC_SITE_URL`
 - `NEXT_PUBLIC_WALLETCONNECT_PROJECT_ID`
 - `NEXT_PUBLIC_WALLETCONNECT_POLYGON_RPC_URL`
+- `NEXT_PUBLIC_PAYMENT_ALLOWED_HOSTS`
+- `NEXT_PUBLIC_TURNSTILE_SITE_KEY`
 - `NEXT_PUBLIC_POLYWEATHER_APP_ANALYTICS`
 - `NEXT_PUBLIC_POLYWEATHER_WEB_VITALS`
 - `NEXT_PUBLIC_POLYWEATHER_EAGER_CITY_SUMMARIES`
@@ -202,19 +202,43 @@ PolyWeather 的环境变量很多，但不是所有变量都属于同一层级
 - `/ops` 现在是前后端双层限制：
   - 前端页面入口读取 `POLYWEATHER_OPS_ADMIN_EMAILS`
   - 后端写接口同样读取 `POLYWEATHER_OPS_ADMIN_EMAILS`
-- 因此，Vercel 和 VPS / Docker 两侧都应配置相同的管理员邮箱白名单。
+- 因此，前端容器和后端容器两侧都应配置相同的管理员邮箱白名单。
 
-不要把后端专用密钥全搬进 Vercel。
+不要把后端专用密钥全搬进前端容器。
 
 ### 5.3 GitHub Actions
 
-当前 CI 不需要大规模 secrets。
+当前 CI 已配置自动部署，需要的 secrets 见 `.github/workflows/ci.yml`：
 
-如果未来要做自动部署，再考虑：
+- `VPS_SSH_KEY` / `VPS_HOST` / `VPS_USER` / `GHCR_PAT`（SSH 部署到 VPS）
+- `CLOUDFLARE_API_TOKEN` / `CLOUDFLARE_ZONE_ID`（同步 Cloudflare Cache Rules）
+- `NEXT_PUBLIC_TURNSTILE_SITE_KEY`（构建期注入前端镜像）
+- 前端构建期 `NEXT_PUBLIC_*`（注入前端镜像）
 
-- `VERCEL_TOKEN`
-- `VERCEL_ORG_ID`
-- `VERCEL_PROJECT_ID`
+### 5.4 Cloudflare 免费能力
+
+Turnstile：
+
+- `NEXT_PUBLIC_TURNSTILE_SITE_KEY` 是浏览器可见的 site key，属于前端构建期变量；改动后需要重新构建前端镜像。
+- `POLYWEATHER_TURNSTILE_SECRET_KEY` 只放 VPS / Docker `.env`，用于 Next API Route 服务端校验。
+- `POLYWEATHER_TURNSTILE_BYPASS=true` 可在排障时临时关闭校验。
+- 支付 tx 提交默认不强制二次 Turnstile，因为 Cloudflare token 是一次性校验；订单创建已做校验。只有确认 UX 能支持二次挑战时，才设置 `POLYWEATHER_TURNSTILE_REQUIRE_PAYMENT_SUBMIT=true`。
+
+R2：
+
+- `POLYWEATHER_R2_ACCOUNT_ID`
+- `POLYWEATHER_R2_BUCKET`
+- `POLYWEATHER_R2_ACCESS_KEY_ID`
+- `POLYWEATHER_R2_SECRET_ACCESS_KEY`
+- `POLYWEATHER_R2_REGION=auto`
+- `POLYWEATHER_R2_ARCHIVE_SOURCE=redis`
+
+归档脚本只读 Redis Stream 或 SQLite，不删除热路径数据：
+
+```bash
+python scripts/archive_realtime_events_to_r2.py --date 2026-06-16 --dry-run
+python scripts/archive_realtime_events_to_r2.py --date 2026-06-16
+```
 
 ## 6. 最小部署示例
 
@@ -239,6 +263,10 @@ TELEGRAM_CHAT_ID=...
 POLYWEATHER_RUNTIME_DATA_DIR=/var/lib/polyweather
 POLYWEATHER_DB_PATH=/var/lib/polyweather/polyweather.db
 POLYWEATHER_STATE_STORAGE_MODE=sqlite
+POLYWEATHER_EVENT_STORE=redis
+POLYWEATHER_REDIS_URL=redis://polyweather_redis:6379/0
+POLYWEATHER_REDIS_STREAM_MAXLEN=50000
+POLYWEATHER_REDIS_REQUIRED=true
 UID=1000
 GID=1000
 POLYWEATHER_AUTH_ENABLED=true
@@ -259,24 +287,7 @@ TELEGRAM_ALERT_MISPRICING_INTERVAL_SEC=7200
 TELEGRAM_MARKET_FOCUS_DIGEST_ENABLED=true
 TELEGRAM_MARKET_FOCUS_DIGEST_INTERVAL_SEC=1800
 TELEGRAM_MARKET_FOCUS_DIGEST_TOP_N=5
-POLYMARKET_WALLET_ACTIVITY_ENABLED=false
-POLYWEATHER_DASHBOARD_PREWARM_ENABLED=true
-POLYWEATHER_PREWARM_INTERVAL_SEC=300
-POLYWEATHER_PREWARM_JITTER_SEC=20
-POLYWEATHER_PREWARM_INCLUDE_DETAIL=true
-POLYWEATHER_PREWARM_INCLUDE_MARKET=true
 POLYWEATHER_BACKEND_URL=http://polyweather_web:8000
-POLYWEATHER_GROQ_COMMENTARY_ENABLED=false
-POLYWEATHER_GROQ_COMMENTARY_MODEL=openai/gpt-oss-20b
-POLYWEATHER_GROQ_COMMENTARY_TIMEOUT_SEC=8
-POLYWEATHER_GROQ_COMMENTARY_CACHE_TTL_SEC=1800
-POLYWEATHER_SCAN_AI_ENABLED=false
-POLYWEATHER_SCAN_AI_API_KEY=...
-POLYWEATHER_SCAN_AI_PROVIDER=mimo
-POLYWEATHER_SCAN_AI_PROVIDER_LABEL=MiMo
-POLYWEATHER_SCAN_AI_BASE_URL=https://token-plan-cn.xiaomimimo.com/v1
-POLYWEATHER_SCAN_AI_MODEL=mimo-v2.5-pro
-POLYWEATHER_SCAN_CITY_AI_MODEL=mimo-v2.5-pro
 ```
 
 说明：
@@ -286,51 +297,46 @@ POLYWEATHER_SCAN_CITY_AI_MODEL=mimo-v2.5-pro
 - `POLYWEATHER_RUNTIME_DATA_DIR` 建议放在仓库外，例如 `/var/lib/polyweather`。
 - `docker-compose.yml` 会把这个目录同时挂载到容器内的 `/var/lib/polyweather` 和 `/app/data`，兼容现有缓存与 SQLite 路径。
 - `POLYWEATHER_STATE_STORAGE_MODE` 当前线上推荐直接使用 `sqlite`。
-- `POLYWEATHER_PAYMENT_RPC_URLS` 支持逗号分隔多个 RPC；如果暂时只用单 RPC，也可以继续只配 `POLYWEATHER_PAYMENT_RPC_URL`。
+- `POLYWEATHER_EVENT_STORE=redis` 表示实时观测 patch 使用 Redis Stream 做短窗口 replay 和多 worker fanout；本地或单进程可改为 `sqlite`。
+- `POLYWEATHER_REDIS_REQUIRED=true` 表示 Redis 不可用时后端启动失败，避免生产环境广播不可 replay 的实时事件；开发环境可设为 `false` 允许回退 SQLite。
+- `POLYWEATHER_PAYMENT_RPC_URLS` 支持默认链的逗号分隔多个 RPC；如果暂时只用单 RPC，也可以继续只配 `POLYWEATHER_PAYMENT_RPC_URL`。
+- `POLYWEATHER_PAYMENT_RPC_URLS_BY_CHAIN_JSON` 用于多链支付，例如同时支持 Polygon 和 Ethereum 主网 USDC。
 - 机器人市场监控包含 `关键提醒` 与 `关注清单`：关键提醒逐城判断并受冷却控制，关注清单每轮先扫描完整城市列表，再按全局 Top N 推送；同一轮已经触发关键提醒的城市不会重复出现在关注清单里。
-- `POLYWEATHER_SCAN_AI_*` 走 OpenAI-compatible `/chat/completions`；当前临时默认 MiMo，可用 `POLYWEATHER_SCAN_AI_BASE_URL` 与 `POLYWEATHER_SCAN_AI_MODEL` 随时切回其他兼容 provider。
 - `TELEGRAM_MARKET_FOCUS_DIGEST_INTERVAL_SEC` 表示主动推送间隔，默认 `1800` 秒（30 分钟）。
-- `POLYMARKET_WALLET_ACTIVITY_ENABLED` 已退役，保留为 `false` 即可，不建议再启用钱包异动监听。
-- `POLYWEATHER_DASHBOARD_PREWARM_ENABLED=true` 时，建议同时启用独立 worker 或 bot 内嵌预热线程。
-- `POLYWEATHER_BACKEND_URL` 仅在独立 `polyweather_prewarm` worker 容器中使用，建议设为 `http://polyweather_web:8000`，不要写 `127.0.0.1`。
-- `POLYWEATHER_GROQ_COMMENTARY_ENABLED=false` 表示默认仍走规则文案；只有在确实配置了 `GROQ_API_KEY` 时才建议开启。
-
-### 6.3 Dashboard 预热 worker 推荐变量
-
-```env
-POLYWEATHER_DASHBOARD_PREWARM_ENABLED=true
-POLYWEATHER_PREWARM_INTERVAL_SEC=300
-POLYWEATHER_PREWARM_JITTER_SEC=20
-POLYWEATHER_PREWARM_CITIES=ankara,istanbul,shanghai,beijing,shenzhen,wuhan,chengdu,chongqing,hong kong,taipei,singapore,tokyo,seoul,busan,london,paris,madrid
-POLYWEATHER_PREWARM_INCLUDE_DETAIL=true
-POLYWEATHER_PREWARM_INCLUDE_MARKET=true
-POLYWEATHER_PREWARM_FORCE_REFRESH=false
-POLYWEATHER_BACKEND_URL=http://polyweather_web:8000
-```
-
-说明：
-
-- 这组变量用于后台定向预热热点城市，避免用户点击城市时才冷启动拉 detail。
-- 如果使用独立 `polyweather_prewarm` 容器，`POLYWEATHER_BACKEND_URL` 必须指向容器网络中的 `polyweather_web`。
-
-### 6.4 Groq 解读增强层
-
-```env
-POLYWEATHER_GROQ_COMMENTARY_ENABLED=true
-GROQ_API_KEY=...
-POLYWEATHER_GROQ_COMMENTARY_MODEL=openai/gpt-oss-20b
-POLYWEATHER_GROQ_COMMENTARY_TIMEOUT_SEC=8
-POLYWEATHER_GROQ_COMMENTARY_CACHE_TTL_SEC=1800
-```
 
 说明：
 
 - 这层只负责把结构化信号改写成短摘要，不替代真实模型、机场锚点和结算逻辑。
-- Groq 调用失败时，系统会自动回退到规则文案。
+
+### 6.3 支付多链配置示例
+
+当前生产推荐：
+
+- 默认链：Polygon `chain_id=137`，继续承载 checkout 合约支付。
+- 补充链：Ethereum Mainnet `chain_id=1`，正式支持 USDC 直转确认。
+- 前端创建支付 intent 时会提交用户选择的 `chain_id`；后端确认时按 intent 的链和 token 查询对应 RPC。
+
+```env
+POLYWEATHER_PAYMENT_ENABLED=true
+POLYWEATHER_PAYMENT_CHAIN_ID=137
+POLYWEATHER_PAYMENT_RPC_URL=https://polygon-rpc.com
+POLYWEATHER_PAYMENT_RPC_URLS=https://polygon-rpc.com,https://polygon-bor-rpc.publicnode.com
+POLYWEATHER_PAYMENT_RPC_URLS_BY_CHAIN_JSON={"137":["https://polygon-rpc.com","https://polygon-bor-rpc.publicnode.com"],"1":["https://ethereum-rpc.example"]}
+POLYWEATHER_PAYMENT_RECEIVER_CONTRACT=0x<polygon_checkout_contract>
+POLYWEATHER_PAYMENT_DIRECT_RECEIVER_ADDRESS=0x<treasury_or_receiver_wallet>
+POLYWEATHER_PAYMENT_ACCEPTED_TOKENS_JSON=[{"code":"usdc_polygon","symbol":"USDC","name":"USDC on Polygon","chain_id":137,"chain_code":"polygon","chain_name":"Polygon","address":"0x3c499c542cef5e3811e1192ce70d8cc03d5c3359","decimals":6,"receiver_contract":"0x<polygon_checkout_contract>","direct_receiver_address":"0x<treasury_or_receiver_wallet>","is_default":true},{"code":"usdc_ethereum","symbol":"USDC","name":"USDC on Ethereum","chain_id":1,"chain_code":"ethereum","chain_name":"Ethereum Mainnet","address":"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48","decimals":6,"direct_receiver_address":"0x<treasury_or_receiver_wallet>","supports_contract_checkout":false,"supports_direct_transfer":true,"explorer_tx_url":"https://etherscan.io/tx/{tx_hash}"}]
+```
+
+注意：
+
+- `POLYWEATHER_PAYMENT_CHAIN_ID` 只是默认链，不代表只支持这一条链。
+- `POLYWEATHER_PAYMENT_ACCEPTED_TOKENS_JSON` 里每个 token 必须有明确 `chain_id`。
+- Ethereum 行如果没有部署 checkout 合约，必须设置 `supports_contract_checkout=false`，前端会显示手动转账并阻止钱包合约支付。
+- 私有 RPC URL 带 API key 时应放入真实 `.env` 或密钥管理，不要提交。
 
 ### 6.5 机器人市场监控建议配置
 
-这套配置用于替代旧的钱包异动监听，围绕市场本身做两类推送：
+这套配置围绕市场本身做两类推送：
 
 - `关键提醒`：实时错价/触发条件满足时发送
 - `关注清单`：按亚洲时区定时推送当日重点市场摘要
@@ -348,7 +354,6 @@ TELEGRAM_ALERT_MISPRICING_INTERVAL_SEC=7200
 TELEGRAM_MARKET_FOCUS_DIGEST_ENABLED=true
 TELEGRAM_MARKET_FOCUS_DIGEST_INTERVAL_SEC=1800
 TELEGRAM_MARKET_FOCUS_DIGEST_TOP_N=5
-POLYMARKET_WALLET_ACTIVITY_ENABLED=false
 ```
 
 说明：
@@ -356,7 +361,6 @@ POLYMARKET_WALLET_ACTIVITY_ENABLED=false
 - `TELEGRAM_ALERT_MISPRICING_ONLY=true` 表示关键提醒优先围绕错价/市场触发，不把机器人做成泛通知器。
 - `TELEGRAM_MARKET_FOCUS_DIGEST_INTERVAL_SEC=1800` 表示频道每 30 分钟主动推送一轮全局机会清单；每轮会先扫描完整 `TELEGRAM_ALERT_CITIES`，再选 Top N。
 - `TELEGRAM_MARKET_FOCUS_DIGEST_TOP_N=5` 建议先保持较小，避免机器人一次推太多城市。
-- `POLYMARKET_WALLET_ACTIVITY_ENABLED=false` 表示停用旧的钱包异动监听，统一收敛到市场监控。
 
 ## 7. 当前建议的运维规则
 

docs/EMOS_LGBM_SYSTEM_ZH.md

@@ -1,685 +0,0 @@
-# EMOS + LGBM 系统说明（中文）
-
-最后更新：`2026-04-19`
-
-本文档用于完整说明 PolyWeather 当前的两条统计/机器学习链路：
-
-- `EMOS`：概率后处理与校准链路
-- `LGBM`：日最高温点预测辅助模型
-
-重点不只是“模型怎么训练”，还包括：
-
-- 这些模型依赖什么历史数据
-- 真值和训练特征现在如何长期保存
-- 为什么过去样本一直不够
-- 当前线上到底运行在哪个模式
-- 现在能做什么，不能做什么
-
-本文档基于仓库当前实现与最近一轮重建结果，适合作为：
-
-- 项目内部模型说明
-- 运维与数据治理说明
-- 未来继续扩展 EMOS/LGBM 的基线文档
-
----
-
-## 1. 总览
-
-PolyWeather 当前不是“用一个模型替代所有东西”，而是多层结构：
-
-1. 多源天气采集层
-2. `DEB` 业务主预测层
-3. `LGBM` 轻量点预测辅助层
-4. `EMOS` 概率校准层
-5. 市场概率/桶命中评估层
-
-可以简化理解为：
-
-```text
-天气源 / 观测 / 历史真值
-        ↓
-   DEB 主预测
-        ↓
-   LGBM 辅助点预测
-        ↓
-EMOS 对概率分布做后处理
-        ↓
-市场概率 / shadow / rollout 门禁
-```
-
-其中：
-
-- `DEB` 仍然是当前业务主路径
-- `LGBM` 是辅助预测源，不是主路径
-- `EMOS` 是概率后处理，不是基础天气模型
-
----
-
-## 2. 两条链路各自负责什么
-
-### 2.1 EMOS 负责什么
-
-`EMOS` 的全称通常指 Ensemble Model Output Statistics。
-
-在本项目里，它的角色不是重新预测温度，而是：
-
-- 把已有的预测结果做概率后处理
-- 让输出分布更“可校准”
-- 让桶概率和市场评估更稳定
-
-EMOS 关注的是：
-
-- `raw_mu`
-- `raw_sigma`
-- `deb_prediction`
-- `ens_median`
-- `ensemble_spread`
-- `max_so_far_gap`
-- `peak_flag`
-- 最终真实 `actual_high`
-
-它最终输出的是一套“经过校准的概率分布”，而不是单一温度值。
-
-所以 EMOS 的核心衡量指标不是单纯 MAE，而更看重：
-
-- `CRPS`
-- `bucket_hit_rate`
-- `bucket_brier`
-
-### 2.2 LGBM 负责什么
-
-`LGBM` 是一个轻量级的回归模型，用来预测：
-
-- `actual_high`（日最高温）
-
-它吃的是：
-
-- 历史真值 lag 特征
-- 多模型 forecast
-- `deb_prediction`
-- 当前观测特征
-- 时间特征
-
-它输出的是：
-
-- 一个点预测 `actual_high`
-
-然后这个点预测可以作为：
-
-- 额外 forecast 源
-- 供 DEB / 运营 / 研究参考
-
-所以它和 EMOS 的区别非常重要：
-
-- `LGBM`：做点预测
-- `EMOS`：做概率校准
-
----
-
-## 3. 当前代码结构
-
-### 3.1 EMOS 相关
-
-核心文件：
-
-- [probability_calibration.py](/E:/web/PolyWeather/src/analysis/probability_calibration.py)
-- [probability_rollout.py](/E:/web/PolyWeather/src/analysis/probability_rollout.py)
-- [fit_probability_calibration.py](/E:/web/PolyWeather/scripts/fit_probability_calibration.py)
-- [evaluate_probability_calibration.py](/E:/web/PolyWeather/scripts/evaluate_probability_calibration.py)
-- [build_probability_shadow_report.py](/E:/web/PolyWeather/scripts/build_probability_shadow_report.py)
-- [judge_probability_rollout.py](/E:/web/PolyWeather/scripts/judge_probability_rollout.py)
-
-核心产物：
-
-- [default.json](/E:/web/PolyWeather/artifacts/probability_calibration/default.json)
-- [evaluation_report.json](/E:/web/PolyWeather/artifacts/probability_calibration/evaluation_report.json)
-- [shadow_report.json](/E:/web/PolyWeather/artifacts/probability_calibration/shadow_report.json)
-- [rollout_report.json](/E:/web/PolyWeather/artifacts/probability_calibration/rollout_report.json)
-- [training_samples.json](/E:/web/PolyWeather/artifacts/probability_calibration/training_samples.json)
-
-### 3.2 LGBM 相关
-
-核心文件：
-
-- [lgbm_daily_high.py](/E:/web/PolyWeather/src/models/lgbm_daily_high.py)
-- [lgbm_features.py](/E:/web/PolyWeather/src/models/lgbm_features.py)
-- [train_lgbm_daily_high.py](/E:/web/PolyWeather/scripts/train_lgbm_daily_high.py)
-- [report_lgbm_daily_high.py](/E:/web/PolyWeather/scripts/report_lgbm_daily_high.py)
-
-核心产物：
-
-- [lgbm_daily_high.txt](/E:/web/PolyWeather/artifacts/models/lgbm_daily_high.txt)
-- [lgbm_daily_high_schema.json](/E:/web/PolyWeather/artifacts/models/lgbm_daily_high_schema.json)
-
----
-
-## 4. 为什么之前样本总是上不去
-
-这件事是理解当前状态的关键。
-
-过去项目里有一个结构性问题：
-
-- `daily_records_store` 同时承担了
-  - 运行态缓存
-  - 历史训练数据来源
-
-但运行态层会把 `daily_records` 硬裁成最近 14 天。
-
-这意味着：
-
-- 对线上运行来说没问题
-- 对训练来说，历史监督样本会不断被删掉
-
-结果就是：
-
-- 城市越来越多
-- 训练历史反而越来越稀
-- `LGBM` 很容易只有二十几条样本
-- `EMOS` 也只能靠有限 snapshot/daily_record 拼起来
-
-这不是“模型太差”，而是“数据主存设计不对”。
-
----
-
-## 5. 这次历史真值治理做了什么
-
-现在已经把“运行态缓存”和“长期训练主存”拆开了。
-
-### 5.1 `daily_records_store`
-
-继续保留，但只作为：
-
-- 最近 14 天运行态缓存
-
-它不再承担长期训练历史职责。
-
-### 5.2 `truth_records_store`
-
-新增永久真值表，作为长期训练真值主存。
-
-当前核心字段包括：
-
-- `city`
-- `target_date`
-- `actual_high`
-- `settlement_source`
-- `settlement_station_code`
-- `settlement_station_label`
-- `truth_version`
-- `updated_by`
-- `updated_at`
-- `source_payload_json`
-- `is_final`
-
-这张表的意义是：
-
-- 长期保存监督真值
-- 不再被 14 天缓存裁剪
-- 真值来源变得可追溯
-
-### 5.3 `truth_revisions_store`
-
-新增真值修订审计表。
-
-它记录：
-
-- 老值是什么
-- 新值是什么
-- 来源怎么变了
-- 谁改的
-- 为什么改
-- 什么时候改
-
-所以现在回填不会再是“静默覆盖”。
-
-### 5.4 `training_feature_records_store`
-
-新增长期训练特征表。
-
-它长期留存：
-
-- forecasts
-- deb_prediction
-- mu
-- probability_features
-- prob_snapshot
-- shadow_prob_snapshot
-- calibration 摘要
-
-它的作用是：
-
-- 从现在开始，不再继续丢失历史训练特征
-- 让未来 EMOS/LGBM 样本自然累积
-
----
-
-## 6. 训练数据现在怎么来
-
-### 6.1 EMOS 训练样本
-
-EMOS 训练不只是需要真值，还要有“当时那一刻的预测快照”。
-
-所以一条 EMOS 样本，本质上需要两部分：
-
-1. 历史预测特征
-2. 对应日期最终真值
-
-当前导出的 EMOS 样本里，核心字段包括：
-
-- `city`
-- `date`
-- `actual_high`
-- `raw_mu`
-- `raw_sigma`
-- `deb_prediction`
-- `ens_median`
-- `ensemble_spread`
-- `max_so_far_gap`
-- `peak_flag`
-- `sample_source`
-- `settlement_source`
-- `settlement_station_code`
-- `truth_version`
-- `truth_updated_by`
-- `truth_updated_at`
-
-也就是说，EMOS 训练样本现在已经带了真值 provenance。
-
-### 6.2 LGBM 训练样本
-
-LGBM 训练样本会优先从：
-
-1. 永久真值表取监督目标
-2. 长期训练特征表取历史特征
-3. 再回退到必要的运行态/快照补充
-
-当前 LGBM 样本会用到：
-
-- 历史 `actual_high` lag
-- 历史均值/趋势
-- 多模型 forecast
-- `deb_prediction`
-- 当前观测
-- 时间特征
-
----
-
-## 7. Wunderground 历史回填为什么重要
-
-这次治理里一个重点是：
-
-- `Taipei`
-- `Shenzhen`
-
-这两个城市配置了 `Wunderground` 历史页面作为历史观测取数入口。
-
-这里要注意产品文案口径：
-
-- `Wunderground` 不是物理观测站
-- 它只是历史页面 / 数据入口
-- 机场类市场仍应以 METAR / 机场主站作为结算锚点
-- 明确官方站点市场才以规则指定的官方站点作为最终结算锚点
-
-之前的问题是：
-
-- 城市注册表已经写成 `wunderground`
-- 但历史回填链路还没有真正支持按指定历史日期抓 WU 历史页
-
-所以过去它们的 `actual_high` 可能：
-
-- 没有被正确回填
-- 或者被错误来源污染
-
-现在已经补了正式历史回填函数：
-
-- [wunderground_sources.py](/E:/web/PolyWeather/src/data_collection/wunderground_sources.py)
-
-它会：
-
-1. 按 `city + target_date` 拼出对应历史页
-2. 解析该日观测序列
-3. 取当日最高温
-4. 按市场规则做整度结算
-5. 写入永久真值表
-6. 记录来源与审计信息
-
-这一步对 `Taipei/Shenzhen` 尤其关键，因为它们的历史页面取数和普通 METAR bootstrap 不同。
-
----
-
-## 8. 当前线上/离线运行模式
-
-### 8.1 概率引擎模式
-
-当前生产主概率应保持：
-
-- `legacy`
-
-如果需要观察 EMOS 对照，可切：
-
-- `emos_shadow`
-
-而不是：
-
-- `emos_primary`
-
-原因不是工程没接好，而是主概率发布必须由离线评估结果决定。VPS 轻量训练候选未通过门禁；本地训练候选虽通过门禁，但仍建议先 shadow 观察，再人工决定是否切主。
-
-### 8.2 LGBM 角色
-
-当前 `LGBM` 仍然只能算：
-
-- 辅助预测源
-- 研究/观测链路
-- 校准概率层的一个可用引擎输入
-
-不适合替代 `DEB` 主路径。
-
-前端展示上，`LGBM 校准概率` 代表概率层已使用 LGBM 上下文生成桶分布；它不是把模型四舍五入票数直接当成概率。模型共识仍只是解释层，市场价格也只作为参考层。
-
----
-
-## 9. 当前最新状态
-
-以下状态来自最近一轮恢复、回填和重训产物。
-
-### 9.1 永久真值
-
-当前永久真值表已恢复到长期历史：
-
-- `truth_records_store`
-  - 最早：`2023-01-01`
-  - 最晚：`2026-04-02`
-  - 行数：约 `35138`
-  - 城市数：`30`
-
-运行态缓存仍然只有近 14 天：
-
-- `daily_records_store`
-  - 仍然是近两周范围
-
-这说明：
-
-- 长期真值主存已经从运行态缓存里分离出来了
-
-### 9.2 真值修订
-
-当前已有 revision 审计记录：
-
-- `truth_revisions_store`
-  - 行数：`2`
-
-这说明审计链路已经在工作。
-
-### 9.3 Wunderground 回填
-
-`Taipei` 与 `Shenzhen` 已按 WU 历史页完成回填。
-
-当前这两城已经补到：
-
-- `2026-04-02`
-
-### 9.4 长期训练特征
-
-当前 `training_feature_records_store` 已经接通，但历史上真正留存下来的特征仍然很少。
-
-这意味着：
-
-- 从现在开始不会继续丢
-- 但过去没留下的那部分特征，不会凭空恢复
-
-这也是为什么：
-
-- 真值恢复了
-- `EMOS` 样本量却没有同步大幅增长
-
----
-
-## 10. 当前 EMOS 结果怎么理解
-
-最近两轮评估给出了更清晰的结论。
-
-VPS 轻量训练候选：
-
-- 版本：`emos-auto-20260418204203`
-- `sample_count = 791`
-- `delta_crps = +0.004652`
-- `delta_mae = +0.102623`
-- `delta_bucket_hit_rate = -0.137800`
-- 结论：`hold`
-
-本地训练候选：
-
-- 版本：`emos-auto-20260418212046`
-- `sample_count = 847`
-- `delta_crps = -0.036170`
-- `delta_mae = -0.007896`
-- `delta_bucket_hit_rate = -0.009445`
-- 结论：`promote`
-
-这说明：
-
-- EMOS 工程链路有效，本地用更多 snapshot 训练时可以超过 legacy 的 CRPS/MAE。
-- 低配 VPS 不适合做主训练环境。
-- 通过门禁不等于立即默认主用，仍应先 `emos_shadow` 观察。
-
-当前生产策略仍然是：
-
-- 用户主概率默认 `legacy`
-- EMOS 通过本地训练产生候选
-- 通过门禁后先以 `emos_shadow` 灰度
-- 连续稳定后才考虑 `emos_primary`
-
-这不是“EMOS 无效”，而是：
-
-- 它还没有稳定到能切主路径
-
-### 10.1 当前阻塞点
-
-主要阻塞仍然是：
-
-- 有效样本仍然不大，城市级样本分布不均
-- 桶概率容易受结算边界影响
-- 需要避免 VPS 训练消耗线上资源
-- `emos_primary` 发布需要明确人工门禁
-
-也就是说，当前 EMOS 状态可以总结成：
-
-- 工程链路完整
-- 数据治理大幅改善
-- 本地训练可通过门禁
-- 生产主用仍需 shadow 观察与人工发布
-
----
-
-## 11. 当前 LGBM 结果怎么理解
-
-最近一轮 LGBM 训练后，样本数已经从以前更少的状态提升到：
-
-- `sample_count = 54`
-- `train_count = 42`
-- `validation_count = 12`
-
-验证集指标大致为：
-
-- `lgbm_mae = 1.349`
-- `deb_mae = 0.875`
-
-这说明：
-
-- LGBM 比以前样本更充足了
-- 但在验证集上仍然不如 DEB
-
-所以当前它的定位仍然应该是：
-
-- 辅助参考
-- 不替代 DEB
-
----
-
-## 12. 为什么现在 EMOS 没有像 LGBM 那样明显涨样本
-
-这点很容易误解。
-
-答案不是“恢复失败”，而是两条链路对数据要求不一样。
-
-### 12.1 LGBM
-
-LGBM 更依赖：
-
-- 长期真值
-- 基础 forecast 特征
-
-这部分通过：
-
-- `truth_records_store`
-- `training_feature_records_store`
-
-已经改善很多。
-
-### 12.2 EMOS
-
-EMOS 更依赖：
-
-- 某一时刻的概率快照/分布特征
-
-如果过去那些 snapshot 没有长期保存下来，那么即使今天把真值补齐了：
-
-- 也无法凭空重建完整 EMOS 样本
-
-所以当前现实是：
-
-- 真值问题已经大幅改善
-- 未来特征不会再继续丢
-- 但过去缺失的 EMOS 快照历史仍然限制样本增长
-
----
-
-## 13. 当前最重要的工程判断
-
-### 13.1 已经完成的
-
-这些现在可以认为已经完成：
-
-- 真值主存从运行态缓存里拆出
-- 真值 provenance 落库
-- revision 审计表落地
-- Wunderground 历史回填接通
-- `Taipei/Shenzhen` 真值口径修正
-- 长期训练特征表接通
-- `/ops` 已能可视化 truth / feature / EMOS / LGBM 覆盖情况
-
-### 13.2 还没完成的
-
-这些仍然是后续重点：
-
-- EMOS 样本继续自然积累
-- shadow bucket brier 稳定下来
-- LGBM 验证效果超过 DEB
-- 让更多城市开始持续积累训练特征
-
----
-
-## 14. 运维怎么看当前状态
-
-现在最直接的入口是：
-
-- `/ops`
-
-这页已经能看到：
-
-- 历史真值主表统计
-- 真值来源分布
-- 真值修订数量
-- 长期训练特征统计
-- `Taipei/Shenzhen` 的 WU 回填状态
-- 城市覆盖缺口
-- 模型城市覆盖
-- 城市覆盖矩阵
-
-因此，运维现在可以快速回答：
-
-- 哪些城市真值已经长期化
-- 哪些城市还没有特征积累
-- 哪些城市已经能支撑 EMOS/LGBM
-- 哪些城市目前仍然只能主要依赖 DEB
-
----
-
-## 15. 推荐工作流
-
-### 15.1 日常
-
-1. 查看 `/ops`
-2. 看 `truth / feature / EMOS / LGBM` 覆盖有没有继续增长
-3. 看 `Taipei/Shenzhen` 的 WU 行数是否继续更新
-4. 看本地 EMOS 候选是否通过门禁
-5. 看 VPS 是否只加载已批准参数，不在低配机器上训练
-
-### 15.2 周期性重训
-
-建议在本地开发机执行，不建议在低配 VPS 上执行：
-
-```powershell
-scp root@38.54.27.70:/var/lib/polyweather/polyweather.db E:\web\PolyWeather\data\polyweather-prod.db
-$env:POLYWEATHER_DB_PATH="E:\web\PolyWeather\data\polyweather-prod.db"
-$env:POLYWEATHER_RUNTIME_DATA_DIR="E:\web\PolyWeather\artifacts\local_runtime"
-python scripts\auto_retrain_probability_calibration.py --verbose --snapshot-limit 50000
-```
-
-只有 `auto_retrain_report.json` 里 `ready_for_promotion=true` 时，才允许把候选 `default.json` 传回 VPS。
-
-### 15.3 真值恢复/补数
-
-当有新的历史真值补数或回填需要时：
-
-```bash
-./venv/Scripts/python.exe scripts/restore_training_truth_history.py
-./venv/Scripts/python.exe scripts/restore_training_feature_history.py
-./venv/Scripts/python.exe scripts/backfill_recent_daily_actuals_from_metar.py --cities taipei shenzhen --lookback-days 14
-```
-
-说明：
-
-- 脚本名里虽然还保留 `from_metar`
-- 但当前实现已经会按 `settlement_source` 自动分发
-- `wunderground` 会走 WU 历史回填分支
-
----
-
-## 16. 当前最务实的结论
-
-如果只用一句话概括当前状态：
-
-**EMOS 和 LGBM 的工程基础已经补齐，但生产主概率仍必须由评估门禁控制；当前最正确的策略是继续以 `DEB/legacy` 为主路径，在本地训练 EMOS 候选，VPS 只加载已批准参数。**
-
-更具体一点：
-
-- `EMOS`
-  - 已接好
-  - 可训练
-  - 可评估
-  - 可 shadow
-  - 通过门禁后可灰度
-  - 不应在低配 VPS 上自动训练或自动主用
-
-- `LGBM`
-  - 已接好
-  - 样本比以前更多
-  - 但验证集还不如 DEB
-  - 目前只能做辅助参考
-
-- 数据层
-  - 这次治理的真正价值，是防止未来继续丢历史
-  - 这对两条模型链路都比继续“微调参数”更关键
-
----
-
-## 17. 相关文档
-
-若需要看更细分的历史说明，可继续参考：
-
-- [EMOS_TRAINING_REPORT_ZH.md](/E:/web/PolyWeather/docs/EMOS_TRAINING_REPORT_ZH.md)
-- [LGBM_DAILY_HIGH_ZH.md](/E:/web/PolyWeather/docs/LGBM_DAILY_HIGH_ZH.md)
-- [PROBABILITY_SNAPSHOT_ARCHIVE_ZH.md](/E:/web/PolyWeather/docs/PROBABILITY_SNAPSHOT_ARCHIVE_ZH.md)
-- [deep-research-report.md](/E:/web/PolyWeather/docs/deep-research-report.md)

docs/EMOS_TRAINING_REPORT_ZH.md

@@ -1,263 +0,0 @@
-# EMOS 训练与发布报告（2026-04-19）
-
-## 1. 当前结论
-
-- `EMOS` 工程链路已经接通：可以训练、评估、生成候选参数，并在前端以校准概率层展示。
-- 生产主概率当前不应默认使用 `emos_primary`。默认建议为 `legacy`；需要观察时使用 `emos_shadow`。
-- `emos_primary` 只允许在本地离线训练通过门禁、人工复核后手动灰度。
-- 低配 VPS（例如 1 vCPU / 2GB RAM）不适合做 EMOS 全量训练；VPS 只负责采集、服务和加载已批准的参数文件。
-- `LGBM` 当前仍不建议作为主路径，继续保持 `POLYWEATHER_LGBM_ENABLED=false`。
-
-## 2. 最近两次训练结果
-
-### 2.1 VPS 轻量训练：不通过
-
-VPS 使用最近 `5000` 条 snapshot 训练的候选：
-
-- 版本：`emos-auto-20260418204203`
-- 样本数：`791`
-- 结论：`hold`
-
-| 指标 | 变化 |
-| :-- | --: |
-| `delta_crps` | `+0.004652` |
-| `delta_mae` | `+0.102623` |
-| `delta_bucket_hit_rate` | `-0.137800` |
-
-解读：CRPS、MAE、桶命中全部弱于 legacy，因此不能晋级。
-
-### 2.2 本地训练：通过门禁，但仍需灰度
-
-本地电脑使用生产 SQLite 副本与最近 `50000` 条 snapshot 训练的候选：
-
-- 版本：`emos-auto-20260418212046`
-- 样本数：`847`
-- 结论：`promote`
-
-| 指标 | 变化 |
-| :-- | --: |
-| `delta_crps` | `-0.036170` |
-| `delta_mae` | `-0.007896` |
-| `delta_bucket_hit_rate` | `-0.009445` |
-
-解读：
-
-- CRPS 与 MAE 有改善，候选通过当前门禁。
-- 桶命中率轻微下降，虽然在门禁允许范围内，但仍建议先以 `emos_shadow` 观察，再决定是否切 `emos_primary`。
-
-## 3. 生产运行策略
-
-推荐生产 `.env`：
-
-```env
-POLYWEATHER_PROBABILITY_ENGINE=legacy
-POLYWEATHER_PROBABILITY_CALIBRATION_FILE=/var/lib/polyweather/probability_calibration/default.json
-```
-
-观察 EMOS 时：
-
-```env
-POLYWEATHER_PROBABILITY_ENGINE=emos_shadow
-POLYWEATHER_PROBABILITY_CALIBRATION_FILE=/var/lib/polyweather/probability_calibration/default.json
-```
-
-只有在候选连续通过评估、前端展示稳定、业务侧确认后，才切：
-
-```env
-POLYWEATHER_PROBABILITY_ENGINE=emos_primary
-POLYWEATHER_PROBABILITY_CALIBRATION_FILE=/var/lib/polyweather/probability_calibration/default.json
-```
-
-验证线上加载状态：
-
-```bash
-docker compose exec -T polyweather_web python - <<'PY'
-from src.analysis.probability_calibration import load_calibration, resolve_probability_engine_mode
-cal = load_calibration()
-print("engine_mode =", resolve_probability_engine_mode())
-print("loaded_version =", cal.get("version"))
-print("sample_count =", (cal.get("metrics") or {}).get("sample_count"))
-print("has_global =", bool(cal.get("global")))
-PY
-```
-
-## 4. 本地训练 SOP
-
-### 4.1 拉取生产 SQLite 副本
-
-推荐先在 VPS 上用 SQLite 在线备份生成快照：
-
-```bash
-sqlite3 /var/lib/polyweather/polyweather.db ".backup '/var/lib/polyweather/polyweather-train-copy.db'"
-```
-
-本地 PowerShell 拉取：
-
-```powershell
-cd E:\web\PolyWeather
-scp root@38.54.27.70:/var/lib/polyweather/polyweather-train-copy.db E:\web\PolyWeather\data\polyweather-prod.db
-```
-
-如果生产库写入压力很低，也可以直接拉主库副本：
-
-```powershell
-scp root@38.54.27.70:/var/lib/polyweather/polyweather.db E:\web\PolyWeather\data\polyweather-prod.db
-```
-
-### 4.2 本地训练
-
-```powershell
-cd E:\web\PolyWeather
-$env:POLYWEATHER_DB_PATH="E:\web\PolyWeather\data\polyweather-prod.db"
-$env:POLYWEATHER_RUNTIME_DATA_DIR="E:\web\PolyWeather\artifacts\local_runtime"
-python scripts\auto_retrain_probability_calibration.py --verbose --snapshot-limit 50000
-```
-
-如果本地机器仍然较慢，可先降到：
-
-```powershell
-python scripts\auto_retrain_probability_calibration.py --verbose --snapshot-limit 20000
-```
-
-训练报告：
-
-```powershell
-Get-Content E:\web\PolyWeather\artifacts\local_runtime\probability_calibration\auto_retrain_report.json
-```
-
-候选目录：
-
-```text
-E:\web\PolyWeather\artifacts\local_runtime\probability_calibration\candidates\<version>\
-```
-
-### 4.3 晋级判断
-
-只有报告满足以下条件时，候选才可进入部署流程：
-
-```json
-"ready_for_promotion": true
-```
-
-同时人工检查：
-
-- `delta_crps <= 0`
-- `delta_mae <= 0.05`
-- `delta_bucket_hit_rate >= -0.05`
-- 城市级结果没有出现关键城市大幅退化
-- 前端概率分布没有明显过度摊平或异常偏桶
-
-## 5. 部署通过的候选
-
-把本地候选上传到 VPS：
-
-```powershell
-scp E:\web\PolyWeather\artifacts\local_runtime\probability_calibration\candidates\<version>\default.json root@38.54.27.70:/var/lib/polyweather/probability_calibration/default.json
-```
-
-VPS 上优先设置为 `emos_shadow`：
-
-```env
-POLYWEATHER_PROBABILITY_ENGINE=emos_shadow
-POLYWEATHER_PROBABILITY_CALIBRATION_FILE=/var/lib/polyweather/probability_calibration/default.json
-```
-
-重启：
-
-```bash
-cd /root/PolyWeather
-docker compose up -d polyweather_web
-```
-
-观察稳定后再考虑 `emos_primary`。
-
-## 6. VPS 定时训练策略
-
-当前策略：**不在 VPS 上做 EMOS 定时训练**。
-
-原因：
-
-- 生产 SQLite 的 `probability_training_snapshots_store` 会持续增长。
-- 低配 VPS 全量扫描会造成 CPU/IO 飙升，严重时影响 SSH 和线上服务。
-- VPS 训练用较小 `--snapshot-limit` 虽然安全，但训练效果可能弱于本地。
-
-如果曾经加过 cron，应删除：
-
-```bash
-crontab -l | grep -v 'auto_retrain_probability_calibration.py' | crontab -
-```
-
-确认：
-
-```bash
-crontab -l
-```
-
-## 7. 自动重训脚本说明
-
-脚本：
-
-```text
-python scripts\auto_retrain_probability_calibration.py
-```
-
-默认行为：
-
-- 生成新的 EMOS candidate。
-- 对 candidate 跑离线评估。
-- 写入候选目录和门禁报告。
-- 不覆盖线上 `default.json`。
-
-重要参数：
-
-- `--verbose`：输出训练/评估进度。
-- `--snapshot-limit N`：只使用最近 N 条 snapshot。
-- `--promote-if-passed`：门禁通过后覆盖目标参数文件。
-- `--run-tests`：晋级前跑测试。
-
-当前不建议在 VPS 使用 `--promote-if-passed`。本地训练通过后，仍优先人工上传并使用 `emos_shadow`。
-
-## 8. 门禁阈值
-
-默认阈值：
-
-- `POLYWEATHER_EMOS_AUTO_MIN_SAMPLES=50`
-- `POLYWEATHER_EMOS_AUTO_MAX_DELTA_CRPS=0`
-- `POLYWEATHER_EMOS_AUTO_MAX_DELTA_MAE=0.05`
-- `POLYWEATHER_EMOS_AUTO_MIN_DELTA_BUCKET_HIT_RATE=-0.05`
-
-解释：
-
-- `CRPS` 不允许比 legacy 更差。
-- `MAE` 最多允许轻微退化 `0.05`。
-- `bucket_hit_rate` 是业务参考指标，但对结算边界敏感，不单独作为唯一判断。
-
-## 9. 前端说明
-
-今日日内分析中的概率区展示的是当前生产概率引擎输出：
-
-- `legacy`：展示现有动态概率。
-- `emos_shadow`：用户主概率仍为 legacy，EMOS 仅用于对照和评估。
-- `emos_primary`：用户主概率使用 EMOS 校准分布。
-
-对外文案应避免暗示“EMOS 一定更准”。推荐解释为：
-
-> EMOS 是 PolyWeather 基于 DEB 路径、多模型集合、METAR 实测进度和历史误差结构生成的统计校准概率，不是外部天气模型，也不是直接 API 结果。
-
-## 10. 已验证
-
-本地训练链路已验证：
-
-```text
-python scripts\auto_retrain_probability_calibration.py --verbose --snapshot-limit 50000
-```
-
-测试链路已验证：
-
-```text
-python -m pytest tests\test_auto_retrain_probability_calibration.py tests\test_probability_calibration.py tests\test_probability_rollout.py
-```
-
-当前工程结论：
-
-**EMOS 可以继续本地训练与 shadow 观察，但生产主概率不应因为“机制接好”而默认切到 `emos_primary`。**

docs/FRONTEND_DEPLOYMENT_ZH.md

@@ -1,57 +1,97 @@
-# 前端部署配置（Vercel）
+# 前端部署配置（Docker / VPS）
 
-本文只覆盖 `frontend` 目录对应的 Next.js 前端部署。
+最后更新：`2026-06-14`
+
+本文只覆盖 `frontend` 目录对应的 Next.js 前端部署。前端当前不再使用 Vercel，统一与后端一起以 Docker Compose 形式部署在同一台 VPS 上，前面挂 Cloudflare + Nginx。
 
 ## 一、部署目标
 
-推荐方案：
+当前方案：
 
-1. GitHub Actions 负责 `CI`
-2. Vercel 负责前端 `CD`
-3. FastAPI 后端单独部署在 VPS / Docker 主机
+1. GitHub Actions 负责 `CI`（`python-quality` + `frontend-quality`）
+2. `build-and-push` job 把前端构建为 Docker 镜像 `ghcr.io/yangyuan-zhen/polyweather-frontend`
+3. `deploy` job 通过 SSH 把 `deploy.sh` 推到 VPS，由 VPS 拉取新镜像并滚动更新
 
 前端本身不直接访问天气源，而是通过 Next Route Handlers 转发到后端：
 
-1. 浏览器 -> Vercel 上的 Next.js 前端
-2. Next `/api/*` -> `POLYWEATHER_API_BASE_URL`
-3. FastAPI 后端 -> 分析 / 支付 / 鉴权服务
+1. 浏览器 → Cloudflare → Nginx → 前端容器（Next.js standalone）
+2. Next `/api/*` → `POLYWEATHER_API_BASE_URL`（容器内默认 `http://polyweather_web:8000`）
+3. FastAPI 后端 → 分析 / 支付 / 鉴权服务
 
-## 二、Vercel 项目设置
+实时图表同样走 Next Route Handler：
 
-在 Vercel 导入 GitHub 仓库后，使用下面的设置：
+1. 浏览器 `EventSource` → `/api/events?cities=...&since_revision=...`
+2. Next 转发到 FastAPI `/api/events`
+3. FastAPI 从 Redis Stream / SQLite event log replay 后进入 live SSE
 
-- Framework Preset: `Next.js`
-- Root Directory: `frontend`
-- Build Command: `npm run build`
-- Install Command: `npm ci`
+## 二、镜像与构建
 
-如果仓库已经连接过 Vercel，通常只需要确认 `Root Directory` 仍然是 `frontend`。
+前端镜像定义在 `frontend/Dockerfile`，三阶段构建：
 
-## 三、最小必填环境变量
+- `deps`：`npm ci` 安装依赖
+- `builder`：通过 `ARG` 注入 `NEXT_PUBLIC_*` 变量后执行 `npm run build`，产出 standalone 产物
+- `runner`：只拷贝 `.next/standalone`、`.next/static`、`public`，以 `node server.js` 启动
 
-只部署天气看板和基础登录时，先填下面 4 项：
+`NEXT_PUBLIC_*` 变量是在 **构建期** 注入的（见 `frontend/Dockerfile` 的 `ARG` 块），CI 在 `.github/workflows/ci.yml` 的 `build-and-push` job 里从 GitHub Secrets 读取并作为 `--build-arg` 传入。修改这类变量必须重新构建镜像，仅改运行时环境无效。
 
-```env
-POLYWEATHER_API_BASE_URL=https://<your-fastapi-host>
-NEXT_PUBLIC_SUPABASE_URL=https://<your-project>.supabase.co
-NEXT_PUBLIC_SUPABASE_ANON_KEY=<your-anon-key>
-POLYWEATHER_AUTH_ENABLED=true
+## 三、Compose 服务
+
+前端在 `docker-compose.yml` 中对应 `polyweather_frontend` 服务：
+
+- 镜像：`ghcr.io/yangyuan-zhen/polyweather-frontend:${IMAGE_TAG:-latest}`
+- 容器内监听 `:3000`，映射到宿主 `127.0.0.1:3001`
+- 健康检查：`wget -qO- http://$(hostname):3000`
+- 运行时环境变量（非 `NEXT_PUBLIC_*` 的那部分）通过 compose `environment` 注入，例如：
+  - `POLYWEATHER_API_BASE_URL=http://polyweather_web:8000`（容器内走后端服务名）
+  - `POLYWEATHER_AUTH_ENABLED` / `POLYWEATHER_AUTH_REQUIRED`
+  - `POLYWEATHER_BACKEND_ENTITLEMENT_TOKEN`
+  - `POLYWEATHER_OPS_ADMIN_EMAILS`
+
+`POLYWEATHER_API_BASE_URL` **禁止** 指向前端站点自身（`polyweather.top`），否则会形成回环。`deploy.sh` 里的 `validate_frontend_api_base_url` 会在部署前拦截。容器内应使用 `http://polyweather_web:8000`。
+
+## 四、部署流程（`deploy.sh`）
+
+生产部署由 GitHub Actions 在 `main` push 时触发，关键步骤：
+
+1. SSH 登录 VPS，用 GHCR PAT 登录镜像仓库
+2. `git fetch origin main && git reset --hard origin/main` 同步仓库（含 `docker-compose.yml`）
+3. 同步 `data/city_thread_ids.json` 到运行态目录
+4. `docker compose pull` 拉取新镜像（带重试）
+5. 按顺序滚动更新：`redis` → `web` + `bot` → `collector` → `warmer` → `frontend`
+6. 每步后做本地健康检查；前端额外等待 `/terminal` 和 `/api/scan/terminal` 就绪
+7. 公网 smoke check：`https://api.polyweather.top/healthz`、`https://polyweather.top/api/cities`、`https://www.polyweather.top/`
+8. 任意一步失败自动回滚到上一个镜像 tag（记录在 `/var/lib/polyweather/.current_tag`）
+
+部署失败时优先看 `deploy.sh` 输出里哪一步打了 `❌`，并检查 `docker compose logs polyweather_frontend`。
+
+## 五、最小必填配置
+
+只部署天气看板和基础登录时，至少需要：
+
+构建期（CI Secrets，对应 `frontend/Dockerfile` 的 `ARG`）：
+
+```
+NEXT_PUBLIC_SUPABASE_URL
+NEXT_PUBLIC_SUPABASE_ANON_KEY
+NEXT_PUBLIC_SITE_URL=https://polyweather.top
 ```
 
-建议显式补：
+运行期（`.env` 或 compose `environment`）：
 
 ```env
+POLYWEATHER_API_BASE_URL=http://polyweather_web:8000
+POLYWEATHER_AUTH_ENABLED=true
 POLYWEATHER_AUTH_REQUIRED=true
+POLYWEATHER_BACKEND_ENTITLEMENT_TOKEN=<与后端共享>
 ```
 
 说明：
 
-- `POLYWEATHER_API_BASE_URL`：前端所有 `/api/*` Route Handler 转发时依赖它，没填会直接返回 500。
-- `NEXT_PUBLIC_SUPABASE_URL` / `NEXT_PUBLIC_SUPABASE_ANON_KEY`：Supabase 客户端依赖它们。
-- `POLYWEATHER_AUTH_ENABLED`：关闭时，前端不会启用登录能力。
-- `POLYWEATHER_AUTH_REQUIRED`：控制 middleware 是否强制登录。
+- `POLYWEATHER_API_BASE_URL`：前端所有 `/api/*` Route Handler 转发时依赖它，没填或填错会直接返回 500。
+- `NEXT_PUBLIC_SUPABASE_URL` / `NEXT_PUBLIC_SUPABASE_ANON_KEY`：Supabase 客户端依赖它们，构建期注入。
+- `POLYWEATHER_AUTH_ENABLED` / `POLYWEATHER_AUTH_REQUIRED`：控制 middleware 是否强制登录。
 
-## 四、按功能启用的可选环境变量
+## 六、按功能启用的可选环境变量
 
 ### 1. 分享式看板
 
@@ -61,119 +101,65 @@ POLYWEATHER_DASHBOARD_ACCESS_TOKEN=
 
 设置后，可通过 `/?access_token=<token>` 打开带令牌的看板入口。
 
-### 2. 前后端 entitlement 校验
+### 2. 钱包支付（构建期）
 
-```env
-POLYWEATHER_BACKEND_ENTITLEMENT_TOKEN=
 ```
-
-仅当后端开启 entitlement / 订阅校验时需要。
-
-### 3. 钱包支付
-
-```env
 NEXT_PUBLIC_WALLETCONNECT_PROJECT_ID=
 NEXT_PUBLIC_WALLETCONNECT_POLYGON_RPC_URL=https://polygon-bor-rpc.publicnode.com
+NEXT_PUBLIC_PAYMENT_ALLOWED_HOSTS=polyweather.top,www.polyweather.top
 ```
 
 如果不启用钱包支付，可以留空。
 
-### 4. `/ops` 管理员页面守卫
+### 3. `/ops` 管理员页面守卫
 
 ```env
 POLYWEATHER_OPS_ADMIN_EMAILS=yhrsc30@gmail.com
 ```
 
-说明：
+`/ops` 页面入口会读取管理员邮箱白名单，前端和后端容器都应配置相同的值。
 
-- `/ops` 现在不是只有后端接口限制，前端页面入口也会读取管理员邮箱白名单。
-- 因此前端部署到 Vercel 时，也应配置 `POLYWEATHER_OPS_ADMIN_EMAILS`。
+### 4. Telegram 入口（构建期）
 
-### 5. Telegram 入口
-
-```env
+```
 NEXT_PUBLIC_TELEGRAM_GROUP_URL=https://t.me/<your_group>
-NEXT_PUBLIC_TELEGRAM_BOT_URL=https://t.me/WeatherQuant_bot
+NEXT_PUBLIC_TELEGRAM_BOT_URL=https://t.me/polyyuanbot
+NEXT_PUBLIC_TELEGRAM_LOGIN_BOT_USERNAME=polyyuanbot
 ```
 
 只影响按钮跳转，不影响核心页面加载。
 
-### 6. 前端观测与预热开关（推荐默认关闭）
+### 5. 前端观测与预热开关（推荐默认关闭）
 
-```env
+```
 NEXT_PUBLIC_POLYWEATHER_APP_ANALYTICS=false
 NEXT_PUBLIC_POLYWEATHER_WEB_VITALS=false
 NEXT_PUBLIC_POLYWEATHER_EAGER_CITY_SUMMARIES=false
 ```
 
-说明：
+## 七、支付配置与旧镜像治理
 
-- `NEXT_PUBLIC_POLYWEATHER_APP_ANALYTICS=false`：关闭前端自建埋点。
-- `NEXT_PUBLIC_POLYWEATHER_WEB_VITALS=false`：关闭前端 Web Vitals 上报。
-- `NEXT_PUBLIC_POLYWEATHER_EAGER_CITY_SUMMARIES=false`：关闭首页全量城市 summary 预热，避免白白消耗 Vercel function / edge 成本。
-
-## 五、支付配置与旧部署治理
-
-支付区现在有一层额外防护：
+支付区有一层额外防护：
 
 1. 用户点击支付前，前端会重新请求 `/api/payments/config`
 2. 若发现 `receiver_contract` 与页面旧状态不一致，会自动切换到最新地址
 3. 若后端返回的 `tx_payload.to` 与最新 `receiver_contract` 不一致，会直接阻断支付
+4. 多链支付时，前端会展示后端返回的网络列表，并把用户选择的 `chain_id` 传给后端创建 intent
+5. Ethereum 主网 USDC 当前走手动直转确认，前端不会把它当成 Polygon checkout 合约支付
 
-这层防护的目的，是降低以下事故概率：
+这层防护降低以下事故概率：
 
 - 用户使用长期未刷新的旧标签页
-- 命中旧 deployment URL
 - 页面本地状态残留旧收款地址
+- 用户在钱包默认网络（例如 Ethereum）付款，但系统按 Polygon intent 查账
 
-如果你变更过支付收款地址，建议同步执行：
+如果变更过支付收款地址，由于前端镜像是构建期注入地址，需要触发一次 `main` push（或重新运行 deploy workflow）来发布新镜像；浏览器侧靠 `/api/payments/config` 的运行时校验兜底，无需等待所有用户刷新。
 
-1. 在 Vercel 对当前 production 做一次 redeploy
-2. 删除明显过期、可能还带旧支付配置的旧 deployment
-3. 在 `Settings -> Security -> Deployment Retention Policy` 中收紧旧部署保留周期
+## 八、不要放进前端容器的变量
 
-## 六、推荐的三套配置口径
+这些属于后端私密配置，不应该放到前端服务：
 
-### 1. 公开游客模式
-
-```env
-POLYWEATHER_API_BASE_URL=https://api.example.com
-POLYWEATHER_AUTH_ENABLED=false
-POLYWEATHER_AUTH_REQUIRED=false
-```
-
-适合公开演示站。
-
-### 2. 正常登录模式
-
-```env
-POLYWEATHER_API_BASE_URL=https://api.example.com
-NEXT_PUBLIC_SUPABASE_URL=https://<project>.supabase.co
-NEXT_PUBLIC_SUPABASE_ANON_KEY=<anon-key>
-POLYWEATHER_AUTH_ENABLED=true
-POLYWEATHER_AUTH_REQUIRED=true
-```
-
-适合正式前端站点。
-
-### 3. 登录 + entitlement 联动
-
-```env
-POLYWEATHER_API_BASE_URL=https://api.example.com
-NEXT_PUBLIC_SUPABASE_URL=https://<project>.supabase.co
-NEXT_PUBLIC_SUPABASE_ANON_KEY=<anon-key>
-POLYWEATHER_AUTH_ENABLED=true
-POLYWEATHER_AUTH_REQUIRED=true
-POLYWEATHER_BACKEND_ENTITLEMENT_TOKEN=<shared-token>
-```
-
-适合前后端都启用了会员/订阅保护的生产环境。
-
-## 七、不要放进 Vercel 的变量
-
-这些属于后端私密配置，不应该放到前端项目：
-
-- `SUPABASE_SERVICE_ROLE_KEY`
+- `SUPABASE_SERVICE_ROLE_KEY`（除非前端 Route Handler 明确需要，且仅以非 `NEXT_PUBLIC_` 形式注入容器）
 - `TELEGRAM_BOT_TOKEN`
 - `POLYWEATHER_BACKEND_ENTITLEMENT_TOKEN` 以外的后端 secret
 - 支付签名私钥 / 交易私钥 / 任何 bot 凭据
@@ -183,73 +169,55 @@ POLYWEATHER_BACKEND_ENTITLEMENT_TOKEN=<shared-token>
 - `NEXT_PUBLIC_*` 会暴露给浏览器
 - 只有明确允许前端公开使用的值，才应加 `NEXT_PUBLIC_`
 
-## 八、上线前检查
+## 九、上线前检查
 
-Vercel 部署前至少确认：
+部署前至少确认：
 
-1. `POLYWEATHER_API_BASE_URL` 指向可访问的后端生产地址
-2. `frontend/.env.example` 和 Vercel Project Settings 中的实际值一致
+1. `POLYWEATHER_API_BASE_URL` 指向容器内后端服务名 `http://polyweather_web:8000`，**不是** `polyweather.top`
+2. CI Secrets 中的 `NEXT_PUBLIC_*` 值与预期一致（构建期注入，改了要重新构建镜像）
 3. GitHub Actions 中 `frontend-quality` 已通过
 4. 如果启用鉴权，Supabase redirect URL 已包含前端域名
 5. `GET /api/payments/config` 返回的是当前最新地址，而不是旧收款合约
-6. 如果启用了 `/ops`，确认 `POLYWEATHER_OPS_ADMIN_EMAILS` 已在 Vercel 与后端同时配置
+6. 如果启用了 `/ops`，确认 `POLYWEATHER_OPS_ADMIN_EMAILS` 已在前端与后端容器同时配置
+7. 确认 `/api/events` 没有被 Cloudflare / Nginx 缓存或压缩成普通 JSON；它必须保持 `text/event-stream`
 
-## 九、常见问题
+## 十、常见问题
 
 ### 1. 页面打开后 API 全部 500
 
-先检查：
+先检查容器内 `POLYWEATHER_API_BASE_URL` 是否指向 `http://polyweather_web:8000`，以及 `polyweather_web` 容器是否健康。
 
-```env
-POLYWEATHER_API_BASE_URL
-```
-
-这是最常见原因。
-
-### 2. Vercel 构建通过，但登录失败
+### 2. 构建通过，但登录失败
 
 先检查：
 
-- `NEXT_PUBLIC_SUPABASE_URL`
-- `NEXT_PUBLIC_SUPABASE_ANON_KEY`
-- Supabase 项目里的站点 URL / redirect URL
+- 构建期注入的 `NEXT_PUBLIC_SUPABASE_URL` / `NEXT_PUBLIC_SUPABASE_ANON_KEY`
+- Supabase 项目里的站点 URL / redirect URL 是否包含前端域名
 
 ### 3. 钱包入口显示未配置
 
-先检查：
+检查构建期 `NEXT_PUBLIC_WALLETCONNECT_PROJECT_ID` 是否注入（前端镜像需要重新构建）。
 
-```env
-NEXT_PUBLIC_WALLETCONNECT_PROJECT_ID
-```
+### 4. 改了 `NEXT_PUBLIC_*` 但线上没生效
 
-这是钱包连接的必需项。
+这类变量是构建期注入的。仅改 CI Secrets 不会更新已部署镜像，需要重新触发 `build-and-push` + `deploy`（即一次 `main` push，或手动重跑 deploy workflow）。
 
-## 十、Vercel 成本与节流建议
+## 十一、成本与节流建议
 
-### 1. 建议先关闭的项目级能力
+### 1. Cloudflare 缓存规则
 
-- `Web Analytics`
-- `Speed Insights`
+前端通过 `next.config.mjs` 的 `headers()` 为静态资源（`_next/static`、图片、字体）设置 `Cache-Control: public, max-age=31536000, immutable`，并为公共页面设置 `s-maxage=600, stale-while-revalidate=3600`。CI 的 `cloudflare-cache-rules` job 会同步 Cloudflare Cache Rules（见 `scripts/configure_cloudflare_free.py`）。
 
-它们对排查前端体验有价值，但在 Hobby / 低预算阶段会额外消耗数据点和边缘资源。
+### 2. Cloudflare WAF 规则
 
-### 2. 建议加的 Firewall 自定义规则
-
-如果你的 Next.js 项目根本不提供 WordPress / PHP 路径，建议在 Vercel Firewall 里先 `Log` 再 `Deny` 这条规则：
+如果发现大量 WordPress / PHP 扫描流量命中 Next.js（实际并不提供这些路径），建议在 Cloudflare WAF 中先 `Log` 再 `Deny` 这条规则：
 
 ```regex
 (^/(wp-admin|wp-includes|wp-content|wp-login|wordpress|xmlrpc\.php))|\.php($|\?)
 ```
 
-目的：
+目的：在边缘层提前拦截扫描流量，避免无效请求继续触发 Nginx、Next.js middleware 与 route handler。
 
-- 在边缘层提前拦截 WordPress / PHP 扫描流量
-- 避免无效请求继续触发 middleware 与 route handler
+### 3. SSE 路径不要进缓存
 
-### 3. 建议的上线前检查
-
-除了功能本身，额外确认：
-
-1. `Web Analytics` 和 `Speed Insights` 是否真的关闭
-2. `NEXT_PUBLIC_POLYWEATHER_APP_ANALYTICS` / `NEXT_PUBLIC_POLYWEATHER_WEB_VITALS` / `NEXT_PUBLIC_POLYWEATHER_EAGER_CITY_SUMMARIES` 是否保持关闭
-3. Firewall 自定义规则是否已从 `Log` 切到 `Deny`
+`/api/events` 必须保持 `text/event-stream`，Cloudflare 和 Nginx 都不应缓存或压缩它。检查 Nginx 配置（`deploy/nginx/polyweather.conf`）中对 `/api/events` 的 `proxy_buffering off`。

docs/LGBM_DAILY_HIGH_ZH.md

@@ -1,325 +0,0 @@
-# LightGBM 日最高温模型（中文）
-
-最后更新：`2026-04-18`
-
-## 1. 目标
-
-这套 `LightGBM` 模型是给 PolyWeather 增加一个轻量级的统计学习预测源。
-
-它的定位不是替代：
-
-- `DEB`
-- `EMOS`
-- `ECMWF / GFS / GEM / JMA / ICON / Open-Meteo / MGM / NWS`
-
-而是作为一个新的点预测源：
-
-`现有模型 + 观测特征 -> LGBM -> 并入 current_forecasts -> DEB -> EMOS`
-
-第一版只做：
-
-- `D0` 当日最高温预测
-
-不做：
-
-- `D1-D3`
-- 小时级曲线
-- 原始独立概率分布
-- 独立结算源
-
-注意：前端出现的“LGBM 校准概率”不是把 LGBM 模型票数直接当成概率，而是概率层基于 LGBM / DEB / 观测上下文输出的校准分布。模型共识只保留为解释性参考。
-
-## 2. 适用场景
-
-这条链路是为低资源 VPS 准备的。
-
-当前项目线上环境只有 `2GB RAM` 时，不适合引入 `TimesFM` 这类大模型，但适合用 `LightGBM` 做轻量推理。
-
-当前方案是：
-
-1. 训练离线完成
-2. 训练产物直接提交到仓库
-3. VPS 线上只加载模型文件并推理
-4. VPS 不训练，不起额外服务
-
-## 3. 文件结构
-
-核心文件如下：
-
-- 运行时推理：
-  - [src/models/lgbm_daily_high.py](/E:/web/PolyWeather/src/models/lgbm_daily_high.py)
-- 特征构建：
-  - [src/models/lgbm_features.py](/E:/web/PolyWeather/src/models/lgbm_features.py)
-- 训练脚本：
-  - [scripts/train_lgbm_daily_high.py](/E:/web/PolyWeather/scripts/train_lgbm_daily_high.py)
-- 训练报告脚本：
-  - [scripts/report_lgbm_daily_high.py](/E:/web/PolyWeather/scripts/report_lgbm_daily_high.py)
-- 模型文件：
-  - [artifacts/models/lgbm_daily_high.txt](/E:/web/PolyWeather/artifacts/models/lgbm_daily_high.txt)
-- 模型 schema / 指标：
-  - [artifacts/models/lgbm_daily_high_schema.json](/E:/web/PolyWeather/artifacts/models/lgbm_daily_high_schema.json)
-
-接入链路位置：
-
-- Web API 聚合：
-  - [web/analysis_service.py](/E:/web/PolyWeather/web/analysis_service.py)
-- 共享趋势引擎：
-  - [src/analysis/trend_engine.py](/E:/web/PolyWeather/src/analysis/trend_engine.py)
-
-## 4. 特征说明
-
-第一版特征固定为以下几组。
-
-### 4.1 历史日高温特征
-
-- `actual_high_lag_1`
-- `actual_high_lag_2`
-- `actual_high_lag_3`
-- `actual_high_lag_7`
-- `actual_high_mean_7`
-- `actual_high_mean_14`
-- `actual_high_trend_3`
-
-### 4.2 当天模型特征
-
-- `Open-Meteo`
-- `ECMWF`
-- `GFS`
-- `GEM`
-- `JMA`
-- `ICON`
-- `MGM`
-- `NWS`
-- `deb_prediction`
-- `model_median`
-- `model_spread`
-
-### 4.3 当前观测特征
-
-- `current_temp`
-- `max_so_far`
-- `humidity`
-- `wind_speed_kt`
-- `visibility_mi`
-
-### 4.4 时间与状态特征
-
-- `local_hour`
-- `month`
-- `weekday`
-- `peak_status_code`
-
-其中：
-
-- `before = 0`
-- `in_window = 1`
-- `past = 2`
-
-## 5. 训练数据来源
-
-训练数据主要来自两份运行时历史文件：
-
-- [data/daily_records.json](/E:/web/PolyWeather/data/daily_records.json)
-- [data/probability_training_snapshots.jsonl](/E:/web/PolyWeather/data/probability_training_snapshots.jsonl)
-
-作用分工：
-
-- `daily_records.json`
-  - 提供 `actual_high`
-  - 提供当天各模型 forecast
-  - 提供历史 `deb_prediction`
-
-- `probability_training_snapshots.jsonl`
-  - 提供 `max_so_far`
-  - 提供 `peak_status`
-  - 提供观测特征快照
-
-为后续重训，概率快照归档现在还会额外写入：
-
-- `current_temp`
-- `humidity`
-- `wind_speed_kt`
-- `visibility_mi`
-- `local_hour`
-
-对应代码：
-
-- [src/analysis/probability_snapshot_archive.py](/E:/web/PolyWeather/src/analysis/probability_snapshot_archive.py)
-
-## 6. 训练流程
-
-训练脚本：
-
-```bash
-./venv/Scripts/python.exe scripts/train_lgbm_daily_high.py
-```
-
-训练流程如下：
-
-1. 从历史文件构造监督样本
-2. 目标值固定为 `actual_high`
-3. 按日期做简单的时间顺序切分
-4. 最后约 20% 做验证集
-5. 先训练并评估验证集
-6. 再用全量样本训练最终模型
-7. 输出模型文件和 schema 文件
-
-输出产物：
-
-- [artifacts/models/lgbm_daily_high.txt](/E:/web/PolyWeather/artifacts/models/lgbm_daily_high.txt)
-- [artifacts/models/lgbm_daily_high_schema.json](/E:/web/PolyWeather/artifacts/models/lgbm_daily_high_schema.json)
-
-## 7. 如何看训练结果
-
-查看训练报告：
-
-```bash
-./venv/Scripts/python.exe scripts/report_lgbm_daily_high.py
-```
-
-这个脚本会读取 schema，并打印：
-
-- `Sample Count`
-- `Train Count`
-- `Valid Count`
-- `LGBM MAE`
-- `DEB MAE`
-- `Best Single MAE`
-- `Median MAE`
-- `Winner`
-
-当前这版训练结果是：
-
-- `sample_count = 29`
-- `validation_count = 12`
-- `validation.lgbm_mae = 2.975`
-- `validation.deb_mae = 2.267`
-- `validation.best_single_mae = 1.167`
-
-这说明：
-
-- 当前 `LGBM` 链路已经可用
-- 但现阶段验证集表现还没有超过 `DEB`
-- 所以默认配置仍建议保持关闭
-
-## 8. 线上运行逻辑
-
-运行时推理逻辑不是“直接替代 DEB”，而是：
-
-1. 先收集现有模型 forecast
-2. 先算一版基线 `DEB`
-3. 把这版 `DEB` 当作 `LGBM` 的一个输入特征
-4. 输出 `LGBM` 点预测
-5. 把 `LGBM` 注入 `current_forecasts`
-6. 重新计算最终 `DEB`
-
-这样做的原因是：
-
-- `LGBM` 需要吃到 `deb_prediction` 特征
-- 但最终 `DEB` 又要把 `LGBM` 当成一个新的输入模型
-
-## 8.1 前端概率展示口径
-
-当前网页的概率区按以下顺序解释：
-
-1. 如果后端 `probabilities.engine` 表示 LGBM 校准概率可用，则标题显示为 `LGBM 校准概率`。
-2. 如果 LGBM 不可用，但 EMOS / legacy 概率可用，则显示为 `校准模型概率`。
-3. 模型舍入票数只保留为“模型共识参考”，用于说明哪些模型四舍五入后落在同一温度档，不作为最终命中概率。
-4. 市场价格只保留为“市场参考”，不和校准概率混成同一结论。
-
-这能避免用户把 `4/8 模型支持 82°F` 误读成 `82°F 有 50% 概率`。模型共识是解释层，概率引擎才是结论层。
-
-## 9. 环境变量
-
-示例配置见：
-
-- [.env.example](/E:/web/PolyWeather/.env.example)
-
-相关变量：
-
-```env
-POLYWEATHER_LGBM_ENABLED=false
-POLYWEATHER_LGBM_MODEL_PATH=/app/artifacts/models/lgbm_daily_high.txt
-POLYWEATHER_LGBM_SCHEMA_PATH=/app/artifacts/models/lgbm_daily_high_schema.json
-POLYWEATHER_LGBM_MIN_HISTORY_POINTS=3
-```
-
-说明：
-
-- `POLYWEATHER_LGBM_ENABLED`
-  - 是否启用运行时推理
-- `POLYWEATHER_LGBM_MODEL_PATH`
-  - 模型文件路径
-- `POLYWEATHER_LGBM_SCHEMA_PATH`
-  - schema 文件路径
-- `POLYWEATHER_LGBM_MIN_HISTORY_POINTS`
-  - 某城市最低历史样本门槛
-
-默认是 `3`，原因不是最理想，而是当前整体样本仍然偏少。
-
-如果门槛设太高，很多城市现在根本不会触发 `LGBM`。
-
-## 10. VPS 部署建议
-
-如果你的 VPS 只有 `2GB RAM`：
-
-- 可以跑这套 `LightGBM`
-- 不要在 VPS 上训练
-- 不要起额外模型服务
-
-推荐方式：
-
-1. 在本地或开发环境训练
-2. 提交模型产物
-3. VPS 拉代码
-4. 开启 `POLYWEATHER_LGBM_ENABLED=true`
-5. 重启主服务
-
-不推荐：
-
-- 在 VPS 上跑训练脚本
-- 把 `LightGBM` 当成长任务服务单独部署
-- 同时引入大模型推理
-
-## 11. 当前结论
-
-这条链路已经完成了：
-
-- 离线训练
-- 模型产物固化
-- 运行时懒加载
-- Web / 共享分析链路注入
-- 前端模型类型兼容
-
-但当前样本量仍偏少，所以建议运营策略是：
-
-1. 先继续积累历史 `actual_high`
-2. 继续积累概率快照观测字段
-3. 定期重训
-4. 只有当验证集 `MAE` 持续接近或优于 `DEB` 时，再考虑默认线上开启
-
-## 12. 常用命令
-
-### 训练
-
-```bash
-./venv/Scripts/python.exe scripts/train_lgbm_daily_high.py
-```
-
-### 查看训练报告
-
-```bash
-./venv/Scripts/python.exe scripts/report_lgbm_daily_high.py
-```
-
-### 本地测试
-
-```bash
-./venv/Scripts/python.exe -m pytest tests/test_lgbm_features.py tests/test_lgbm_daily_high.py
-```
-
-### 编译检查
-
-```bash
-./venv/Scripts/python.exe -m compileall src web scripts tests
-```

docs/MODEL_STACK_AND_DEB_ZH.md

@@ -2,7 +2,7 @@
 
 本文档记录 PolyWeather 当前开放模型接入、区域覆盖差异，以及 DEB 在新增模型后的计权规则。
 
-最后更新：`2026-04-18`
+最后更新：`2026-05-28`
 
 ## 1. 接入方式
 
@@ -99,7 +99,7 @@ Web API 会把这部分元数据挂到：
 - RDPS
 - HRDPS
 
-亚洲城市更依赖本地观测增强层，例如 JMA、KMA、NMC、HKO、CWA、METAR、TAF。
+亚洲城市更依赖本地观测增强层，例如 JMA、AMOS（首尔/釜山）、NMC、HKO、CWA、METAR、TAF。
 
 ## 4. DEB 家族去重
 
@@ -151,7 +151,6 @@ HRDPS > RDPS > GDPS > GEM
 - MGM
 - NWS
 - HKO
-- LGBM
 - Open-Meteo
 
 ECMWF IFS 与 ECMWF AIFS 分开保留，因为前者是传统 NWP，后者是 AIFS 模型。
@@ -166,11 +165,73 @@ raw current_forecasts
   -> 按模型家族去重
   -> 历史 MAE 统计
   -> MAE 倒数权重
-  -> 输出 blended_high + weights_info
+  -> 输出 raw blended_high
+  -> recent signed-bias correction
+  -> 输出 production prediction + raw_prediction + version
 ```
 
 当 `weights_info` 出现 `家族去重`，表示当前输入模型数量多于 DEB 实际入模数量，系统已先折叠同家族模型。
 
+### 5.1 DEB hourly consensus
+
+当前图表和峰值窗口优先使用 `deb_hourly_consensus.v1`。
+
+入口：
+
+- `src/analysis/deb_hourly_consensus.py`
+- `web/analysis_service.py`
+- `src/analysis/trend_engine.py`
+
+处理逻辑：
+
+```text
+multi_model hourly curves
+  -> 按 DEB 可用模型和家族去重口径选择候选
+  -> 使用 DEB 权重生成逐小时 consensus
+  -> 输出 deb.hourly_consensus
+  -> 图表 DEB Forecast 与 peak-window 逻辑优先读取该路径
+```
+
+关键口径：
+
+- `deb_hourly_consensus.v1` 是预测曲线，不是实测曲线。
+- 它只用于日内形状、峰值窗口和 DEB Forecast 展示；视觉预警和“接近峰值”状态必须优先读取实测/跑道/官方站点当前值与今日实测高点。
+- 如果多模型小时路径缺失，系统才回退旧的 `hourly_plus_deb_offset`。
+
+### 5.2 版本化预测与偏差校正
+
+DEB 原始融合逻辑不推倒重写，`calculate_dynamic_weights(...)` 仍作为 raw baseline。线上生产入口使用 `calculate_deb_prediction(...)` 包装 raw baseline，并在有足够历史样本时追加城市级 recent signed-bias correction。
+
+当前版本：
+
+- `deb_v1_raw`：原始 DEB，最近模型误差倒数加权后的融合值。
+- `deb_v1_recent_bias_corrected`：在 raw DEB 上叠加最近已结算样本的有符号偏差校正。偏差使用 shrinkage，样本少时自动收缩，避免单日异常过拟合。
+
+API `deb` payload 会保留：
+
+- `prediction`：当前生产使用值。
+- `raw_prediction`：未经 recent-bias correction 的原始 DEB。
+- `version`：生产值对应的 DEB 版本。
+- `bias_adjustment` / `bias_samples`：城市级偏差校正幅度与训练样本数。
+- `intraday_adjustment`：网页 full detail 中额外的日内观测路径修正，仅用于当前日实时展示。
+
+版本化回测命令：
+
+```bash
+python scripts/backtest_deb_versions.py \
+  --output-json data/deb_backtest_latest.json \
+  --output-csv data/deb_backtest_latest.csv
+```
+
+本地 `data/polyweather.db` 于 2026-05-27 的回测样本显示：
+
+| 版本 | 样本 | MAE | RMSE | Bias | 结算桶命中率 |
+| --- | ---: | ---: | ---: | ---: | ---: |
+| `deb_v1_raw` | 1272 | 1.626 | 2.602 | -0.633 | 25.8% |
+| `deb_v1_recent_bias_corrected` | 1272 | 1.499 | 2.542 | +0.263 | 31.4% |
+
+该结果只证明当前历史样本上的离线表现改善；后续仍需要持续用版本化回测追踪不同城市、季节与结算源下的漂移。
+
 ## 6. 前端展示
 
 网页的模型展示读取：
@@ -178,6 +239,7 @@ raw current_forecasts
 - `multi_model`
 - `multi_model_daily`
 - `source_forecasts.open_meteo_multi_model.model_metadata`
+- `deb.hourly_consensus`
 
 显示分组：
 
@@ -198,6 +260,13 @@ raw current_forecasts
 
 区域模型不覆盖时不显示空模型。
 
+终端图表默认：
+
+- 展示“全天”视图，按城市当地日 00:00-23:59 和真实观测时间绘制。
+- 可选“高温”视图，窗口由 `deb_hourly_consensus.v1` 的峰值区域推导。
+- DEB Forecast 使用橙色预测曲线；实测/跑道/官方站点曲线独立展示，不把 DEB 当成实测。
+- legacy 高斯概率显示为水平温度带和 `mu` 参考线，不参与时间序列曲线。
+
 ### 6.1 “来源 Open-Meteo”是什么意思
 
 前端中的 `来源 - Open-Meteo` 表示本次多模型数据通过 Open-Meteo model API 归一化接入。
@@ -219,7 +288,6 @@ raw current_forecasts
 当前前端把三层拆开展示：
 
 - `模型区间与分歧`：解释不同模型当前给出的最高温范围和分歧，不直接等于命中概率。
-- `校准模型概率`：由当前生产概率引擎输出温度桶概率；默认可保持 legacy，EMOS / LGBM 只在评估通过、显式启用或 shadow 对照时进入展示。
 - `市场参考`：只展示市场价格和错价背景，不再作为主判断，也不默认输出 BUY YES / BUY NO。
 
 模型票数只用于解释“哪些模型支持某个档位”，不等于最终概率。最终概率应优先读取 `probabilities.engine` 对应的校准分布。
@@ -230,7 +298,7 @@ raw current_forecasts
 
 - `tests/test_multi_model_sources.py`
 - `tests/test_deb_model_family.py`
-- `tests/test_lgbm_features.py`
+- `tests/test_deb_evaluation_upgrade.py`
 
 重点覆盖：
 
@@ -240,3 +308,4 @@ raw current_forecasts
 - DEB 家族去重
 - 历史不足时的去重等权
 - 有历史 MAE 时的去重动态权重
+- DEB raw/corrected 版本化评估、recent-bias correction、JSON/CSV 回测输出

docs/MONITORING_ZH.md

@@ -1,6 +1,6 @@
 # 外部监控与告警说明
 
-最后更新：`2026-04-18`
+最后更新：`2026-05-28`
 
 ## 1. 目标
 
@@ -11,6 +11,7 @@
 - Relay 把告警推到运营频道
 - Grafana 展示趋势面板
 - 巡检脚本补健康检查
+- 关注 `/api/events` 长连接与 realtime event store 是否正常 replay
 
 ## 2. 组件
 
@@ -89,6 +90,14 @@ POLYWEATHER_MONITORING_ALERT_CHAT_IDS=
 - Source Requests by Outcome
 - Source Error Rate (15m)
 
+实时事件层建议额外观察：
+
+- Redis Stream latest revision
+- Redis 连接状态
+- SQLite fallback 是否被启用
+- SSE active connection count
+- `resync_required` 出现频率
+
 ## 7. 巡检脚本
 
 手动巡检：
@@ -102,6 +111,7 @@ python scripts/check_ops_health.py --base-url http://127.0.0.1:8000
 - `/healthz`
 - `/api/system/status`
 - `/metrics`
+- `/api/events`（手动验证时查看 `connected` / `heartbeat` / replay 事件）
 
 任何一项失败都会非零退出，适合挂到 crontab 或 systemd timer。
 
@@ -114,12 +124,6 @@ python scripts/check_ops_health.py --base-url http://127.0.0.1:8000
 
 目前已覆盖：
 
-- `prewarm` worker 是否启用、线程 / heartbeat 是否活着
-- 最近一轮 prewarm 的：
-  - `cycle_count`
-  - `success_count / failure_count`
-  - `last_started_at / last_finished_at`
-  - `last_summary_ok / last_detail_ok / last_market_ok`
 - 缓存桶条目数：
   - `api_cache`
   - `metar`
@@ -136,6 +140,11 @@ python scripts/check_ops_health.py --base-url http://127.0.0.1:8000
   - 多日预报是否只返回当天单卡
   - 日内分析 full detail / market scan 是否仍在同步
   - 右侧详情面板是否正在用同步占位卡提示用户
+- 实时事件状态：
+  - event store 类型（Redis / SQLite）
+  - latest revision
+  - Redis 是否连通
+  - 是否处于 `degraded_from=redis` fallback
 
 这意味着：
 
@@ -186,3 +195,4 @@ npm run build
 - 更细粒度支付指标
 - 按城市/来源拆分的业务 SLA
 - 按城市拆分的前端补齐耗时与 stale-detail 告警
+- Redis Stream 长度、内存与 replay gap 告警

docs/OPS_ADMIN_ZH.md

@@ -6,7 +6,7 @@
 
 前端入口：
 
-- `https://polyweather-pro.vercel.app/ops`
+- `https://polyweather.top/ops`
 
 ## 2. 权限
 
@@ -25,7 +25,6 @@ POLYWEATHER_OPS_ADMIN_EMAILS=yhrsc30@gmail.com
 - 系统健康
 - SQLite / rollout / metrics 摘要
 - 支付运行态
-- prewarm worker 运行态
 - 缓存桶状态与 summary cache hit/miss
 - 当前会员
 - 周榜
@@ -101,11 +100,9 @@ python scripts/reconcile_subscription_by_email.py --email <user_email>
 
 ## 7. 备注
 
-### 7.1 当前 prewarm / 缓存观测项
 
 `/ops` 里的系统状态卡目前已额外展示：
 
-- `prewarm` 是否启用
 - `thread_alive` / `heartbeat_age_sec`
 - 最近一轮：
   - `cycle_count`

docs/PROBABILITY_SNAPSHOT_ARCHIVE_ZH.md

@@ -1,347 +0,0 @@
-# 概率训练样本归档说明（中文）
-
-最后更新：`2026-04-19`
-
-## 1. 目的
-
-这份文档说明两件事：
-
-1. 为什么 `EMOS` 训练不能只依赖历史实测天气
-2. 未来如何持续沉淀“历史预测记录”，让概率引擎越训越稳
-
-一句话结论：
-
-- 历史实测天气只能补 `actual_high`
-- 真正决定 `EMOS` 训练质量的是“当时那一刻的预测快照”
-
-## 2. 什么是“历史预测记录”
-
-对 PolyWeather 来说，一条可训练的历史预测记录，至少应该包含这些字段：
-
-- `city`
-- `timestamp`
-- `date`
-- `raw_mu`
-- `raw_sigma`
-- `deb_prediction`
-- `ensemble p10 / p50 / p90`
-- `multi-model forecasts`
-- `max_so_far`
-- `peak_status`
-- `prob_snapshot`
-- `probability_engine`
-- `calibration_mode`
-- `calibration_version`
-- `raw_mu / raw_sigma`
-- `calibrated_mu / calibrated_sigma`
-- `shadow_distribution`
-- 当天最终 `actual_high`
-- 当天最终 `settlement bucket`
-
-这类记录的核心价值是：
-
-- 还原“当时系统实际看到什么”
-- 再对照“后来真实发生了什么”
-
-只有这两者成对，`EMOS` 才能学习偏差。
-
-## 3. 为什么不能只用历史天气实测
-
-历史天气 CSV 只能告诉你：
-
-- 当天最高温是多少
-- 某小时温度是多少
-
-但它不能告诉你：
-
-- 当天早上 09:00 时，系统的 `mu` 是多少
-- 当时的 `ensemble spread` 是多少
-- 当时 `DEB` 怎么看
-- 当时的 top bucket 是什么
-
-所以：
-
-- 历史实测天气是标签
-- 历史预测记录才是训练输入
-
-缺少后者，EMOS 只能学到很有限的东西。
-
-## 4. 当前项目里已经有的基础
-
-### 4.1 已有历史日记录
-
-文件：
-
-- [daily_records.json](/E:/web/PolyWeather/data/daily_records.json)
-
-当前已经保存了一部分训练相关字段，例如：
-
-- `forecasts`
-- `actual_high`
-- `deb_prediction`
-- `mu`
-- `prob_snapshot`
-- `shadow_prob_snapshot`
-- `probability_calibration`
-- `probability_features`
-
-这已经是“历史预测记录”的雏形。
-
-### 4.2 已有历史天气 CSV
-
-目录：
-
-- [data/historical](/E:/web/PolyWeather/data/historical)
-
-它们可以帮助补：
-
-- `actual_high`
-- `settlement history`
-
-但不能替代预测快照归档。
-
-## 5. 未来应该怎么存历史预测记录
-
-推荐做法是：
-
-### 5.1 固定时点归档
-
-每天为每个重点城市固定存几次快照，例如：
-
-- 当地 `09:00`
-- 当地 `12:00`
-- 当地 `15:00`
-
-这样能确保每个交易日都有稳定可比样本。
-
-### 5.2 关键变化时补充归档
-
-除了固定时点，还应该在以下情况额外存一次：
-
-- `max_so_far` 创新高
-- `mu` 变化超过阈值
-- `top bucket` 发生变化
-- `shadow top bucket` 发生变化
-
-这样能捕捉真正有训练价值的转折点。
-
-### 5.3 建议的存储格式
-
-建议新增一个文件，例如：
-
-- `data/probability_training_snapshots.jsonl`
-
-每一行保存一条 JSON 记录。
-
-优点：
-
-- 追加写入简单
-- 后续导出训练集方便
-- 不容易因为单个大 JSON 文件损坏而全盘受影响
-
-## 6. 一条建议的快照结构
-
-示例：
-
-```json
-{
-  "city": "ankara",
-  "timestamp": "2026-03-20T12:00:00+03:00",
-  "date": "2026-03-20",
-  "raw_mu": 15.2,
-  "raw_sigma": 1.2,
-  "deb_prediction": 15.4,
-  "ensemble": {
-    "p10": 14.8,
-    "median": 15.8,
-    "p90": 17.9
-  },
-  "multi_model": {
-    "ECMWF": 15.8,
-    "GFS": 14.1,
-    "ICON": 15.9,
-    "GEM": 16.5,
-    "JMA": 14.5
-  },
-  "max_so_far": 15.0,
-  "peak_status": "before",
-  "prob_snapshot": [
-    {"v": 15, "p": 0.552},
-    {"v": 16, "p": 0.377}
-  ],
-  "shadow_prob_snapshot": [
-    {"v": 15, "p": 0.324},
-    {"v": 16, "p": 0.238}
-  ],
-  "probability_engine": "legacy",
-  "probability_mode": "emos_shadow",
-  "calibration_mode": "emos_shadow",
-  "calibration_version": "emos-20260320130245",
-  "calibrated_mu": 15.4,
-  "calibrated_sigma": 1.1
-}
-```
-
-当天结束后，再由后处理脚本回填：
-
-- `actual_high`
-- `settlement_bucket`
-
-当前前端把这类快照解释为“校准模型概率”。如果 `probability_engine` 为 LGBM 相关值，则显示为 LGBM 校准概率；模型舍入票数和市场价格只用于解释，不直接作为最终概率。
-
-## 7. 现阶段你可以执行的命令
-
-### 7.1 回填历史天气 CSV
-
-```bash
-python scripts/backfill_historical_weather.py
-```
-
-作用：
-
-- 补全 30 城市历史天气时序 CSV
-
-### 7.2 从历史 CSV 构建日级结算标签
-
-```bash
-python scripts/build_settlement_history_from_csv.py
-```
-
-作用：
-
-- 生成 [settlement_history.json](/E:/web/PolyWeather/artifacts/probability_calibration/settlement_history.json)
-
-### 7.3 导出当前训练样本
-
-```bash
-python scripts/export_probability_training_dataset.py
-```
-
-作用：
-
-- 生成 [training_samples.json](/E:/web/PolyWeather/artifacts/probability_calibration/training_samples.json)
-
-### 7.4 重训 EMOS
-
-推荐在本地电脑使用生产 SQLite 副本训练，不建议在低配 VPS 上训练：
-
-```powershell
-scp root@38.54.27.70:/var/lib/polyweather/polyweather.db E:\web\PolyWeather\data\polyweather-prod.db
-$env:POLYWEATHER_DB_PATH="E:\web\PolyWeather\data\polyweather-prod.db"
-$env:POLYWEATHER_RUNTIME_DATA_DIR="E:\web\PolyWeather\artifacts\local_runtime"
-python scripts\auto_retrain_probability_calibration.py --verbose --snapshot-limit 50000
-```
-
-作用：
-
-- 生成新的候选 `default.json`
-- 同时生成 `evaluation_report.json` 与 `auto_retrain_report.json`
-- 不自动覆盖线上参数
-
-### 7.5 离线评估训练效果
-
-```bash
-python scripts/evaluate_probability_calibration.py
-```
-
-作用：
-
-- 生成 [evaluation_report.json](/E:/web/PolyWeather/artifacts/probability_calibration/evaluation_report.json)
-
-### 7.6 回填 shadow 结果到历史记录
-
-```bash
-python scripts/backfill_probability_shadow_history.py
-```
-
-作用：
-
-- 把 `shadow_prob_snapshot` 和 `probability_calibration` 回填到 [daily_records.json](/E:/web/PolyWeather/data/daily_records.json)
-
-### 7.7 生成线上 shadow 滚动报表
-
-```bash
-python scripts/build_probability_shadow_report.py
-```
-
-作用：
-
-- 生成 [shadow_report.json](/E:/web/PolyWeather/artifacts/probability_calibration/shadow_report.json)
-
-## 8. 推荐的一整套重训流程
-
-如果过了十天、半个月，想重新训练一次，当前推荐流程是：
-
-```powershell
-scp root@38.54.27.70:/var/lib/polyweather/polyweather.db E:\web\PolyWeather\data\polyweather-prod.db
-$env:POLYWEATHER_DB_PATH="E:\web\PolyWeather\data\polyweather-prod.db"
-$env:POLYWEATHER_RUNTIME_DATA_DIR="E:\web\PolyWeather\artifacts\local_runtime"
-python scripts\auto_retrain_probability_calibration.py --verbose --snapshot-limit 50000
-```
-
-只有 `auto_retrain_report.json` 中 `ready_for_promotion=true`，才把候选参数传回 VPS，并优先用 `emos_shadow` 观察。
-
-如果只是做历史真值补数，才需要额外执行：
-
-```bash
-python scripts/backfill_historical_weather.py
-python scripts/build_settlement_history_from_csv.py
-```
-
-## 9. 怎么判断这次训练有没有进步
-
-重训后，不要只看一个指标。
-
-至少看这 4 个：
-
-1. `CRPS`
-- 越低越好
-
-2. `MAE`
-- 越低越好
-- 至少不要明显变差
-
-3. `Bucket Hit Rate`
-- 越高越好
-- 这是业务上非常关键的指标
-
-4. `Bucket Brier`
-- 越低越好
-- 反映概率分布质量
-
-当前自动门禁至少要求：
-
-- `CRPS` 下降
-- `MAE` 最多轻微退化 `0.05`
-- `Bucket Hit Rate` 退化不超过 `0.05`
-
-人工复核还应看城市级结果，避免少数关键城市大幅退化。`Bucket Hit Rate` 受整数结算边界影响大，不能单独作为唯一判断。
-
-## 10. 当前最重要的现实判断
-
-过去的“完整历史预测记录”通常没法完全补出来，除非：
-
-1. 你之前就存过
-2. 你接入了支持 forecast archive 的商业数据源
-
-所以现实里最重要的不是“把过去全补齐”，而是：
-
-- 从现在开始系统化归档
-- 每天稳定沉淀可训练样本
-- 定期离线重训
-
-## 11. 推荐的下一步
-
-最值得做的改造是：
-
-1. 新增 `probability_training_snapshots.jsonl`
-2. 每次分析时自动追加一条快照
-3. 当天结束后自动回填 `actual_high`
-4. 每 1-2 周在本地电脑重新训练一次
-5. VPS 只加载通过评估的参数文件，不做全量训练
-
-## 12. 总结
-
-如果只记住一句话，就记这个：
-
-**EMOS 要想越训越好，关键不是多下载一点历史天气，而是持续保存“当时系统看到的预测快照”。**

docs/SERVICES_ZH.md

@@ -0,0 +1,65 @@
+# 外部服务依赖总览
+
+最后更新：`2026-05-29`
+
+项目调用外部天气、鉴权、支付和实时事件服务。原则是：核心链路必须有明确健康检查；可选数据源不可拖垮已可用城市；实时事件层可从 Redis Stream 降级到 SQLite event log。
+
+## 核心（必须有，挂了服务不可用）
+
+| 服务 | 用途 | 状态 |
+| --- | --- | --- |
+| Open-Meteo | 51 城天气预报、多模型小时曲线、DEB hourly consensus 输入 | ✅ |
+| AviationWeather (NOAA) | METAR / TAF 航空观测 | ✅ |
+| MADIS (NOAA) | 美国机场 5 分钟高频观测 | ✅ |
+| Supabase | 用户认证、订阅状态、会员恢复 | ✅ |
+| Telegram Bot API | Bot 消息、群成员检查、双语跑道推送 | ✅ |
+| Redis | `city_observation_patch.v1` Stream、SSE replay、多 worker fanout | ✅ |
+| SQLite | 运行态数据库、支付审计、实时事件 fallback | ✅ |
+
+## 国家气象源（特定城市必须）
+
+| 服务 | 城市 | 状态 |
+| --- | --- | --- |
+| JMA AMeDAS | Tokyo | ✅ |
+| AMOS (韩国) | Seoul, Busan 跑道传感器 | ✅ |
+| AMSC AWOS (中国) | 北京、上海、广州、成都、重庆、武汉、青岛跑道端点气温 | ✅ |
+| MGM (土耳其) | Ankara, Istanbul | ✅ |
+| FMI (芬兰) | Helsinki | ✅ |
+| KNMI (荷兰) | Amsterdam | ✅（需 key） |
+| CoWIN 6087 (香港) | Hong Kong 1 分钟参考站 | ✅ |
+| HKO (香港) | Hong Kong / Shenzhen / Lau Fau Shan 10 分钟官方气象层 | ✅ |
+| CWA (台湾) | Taipei | ✅ |
+| Singapore MSS | Singapore | ✅ |
+| IMS Lod (以色列) | Tel Aviv | ✅ |
+| AEROWEB / AROME HD | Paris | ✅ |
+| NMC (中国) | 国内城市 fallback | ✅ |
+| IMGW (波兰) | Warsaw | ⚠️ 未配 key |
+
+## 可选 / 已禁用
+
+| 服务 | 用途 | 状态 |
+| --- | --- | --- |
+| OpenWeatherMap | 天气 fallback | ⚠️ 未配 key |
+| VisualCrossing | 历史天气 | ⚠️ 未配 key |
+| SynopticData | 美国站点观测 | ⚠️ 未配 key |
+| Meteoblue | 天气预报 | ❌ 已移除 |
+| Russia pogodaiklimat | Moscow 历史源 | ❌ 已移除 |
+| Groq | AI commentary | ❌ 已移除 |
+
+## AI / 支付 / 前端
+
+| 服务 | 用途 | 状态 |
+| --- | --- | --- |
+| MiMo (xiaomimimo) | 城市分析 AI 评论 | ✅ 当前使用 |
+| DeepSeek | AI fallback | 备用 |
+| Polygon RPC | checkout 合约支付、Polygon USDC / USDC.e 自动确认 | ✅ |
+| Ethereum RPC | Ethereum 主网 USDC 直转确认 | ✅（启用多链支付时必须） |
+| WalletConnect | 前端钱包连接 | ⚠️ 未配 key 时钱包入口降级 |
+
+## 运维口径
+
+- 生产实时事件推荐：`POLYWEATHER_EVENT_STORE=redis` + `POLYWEATHER_REDIS_URL=redis://polyweather_redis:6379/0`。
+- 本地或单进程兜底：`POLYWEATHER_EVENT_STORE=sqlite`。
+- Redis 只负责短窗口 replay 与多 worker fanout，不是长期天气历史库。
+- DEB hourly consensus 依赖 Open-Meteo 多模型小时曲线；若上游限流，图表应保留已有 snapshot 和实测 patch，不把缺失模型误报为实测缺失。
+- 支付多链确认依赖 `POLYWEATHER_PAYMENT_RPC_URLS_BY_CHAIN_JSON`；如果启用 Ethereum 主网 USDC，必须配置 `chain_id=1` 的 RPC，否则用户提交 Ethereum tx hash 后无法自动确认。

docs/SUPABASE_SETUP_ZH.md

@@ -1,12 +1,12 @@
-# Supabase + 登录 + 支付接入说明（v1.5.1）
+# Supabase + 登录 + 支付接入说明（v1.8.1）
 
-最后更新：`2026-03-14`
+最后更新：`2026-05-29`
 
 ## 1. 目标
 
 - 前端支持 Google 一键登录 + 邮箱注册/登录。
 - 后端支持 Supabase JWT 鉴权。
-- 支持 Polygon 合约支付（USDC / USDC.e）并自动确认开通订阅。
+- 支持 Polygon 合约支付（USDC / USDC.e）和 Ethereum 主网 USDC 直转支付，并自动确认开通订阅。
 
 ## 2. Supabase 控制台配置
 
@@ -15,13 +15,14 @@
    - `https://<project-ref>.supabase.co/auth/v1/callback`
 3. `Auth -> URL Configuration` 添加：
    - 站点 URL（生产域名）
-   - 回调 URL（例如 `https://polyweather-pro.vercel.app/auth/callback`）
+   - 回调 URL（例如 `https://polyweather.top/auth/callback`）
 
 ## 3. 数据库脚本
 
 在 Supabase SQL Editor 执行：
 
 - `scripts/supabase/schema.sql`
+- 既有生产项目遇到 Disk IO Budget 告警时，再执行 `scripts/supabase/io_budget_indexes.sql`
 
 会创建支付与订阅相关表：
 
@@ -33,9 +34,18 @@
 - `payment_intents`
 - `payment_transactions`
 
+### 3.1 Disk IO 告警处理
+
+如果 Supabase 提示项目正在耗尽 Disk IO Budget，先在 SQL Editor 执行：
+
+1. `scripts/supabase/io_budget_indexes.sql`
+2. `scripts/supabase/disk_io_diagnostics.sql`
+
+第一个脚本会把热查询索引收敛为更低写放大的部分索引，移除已被唯一约束覆盖或无热路径使用的冗余索引，并对相关表执行 `ANALYZE`。第二个脚本用于查看表扫描、dead tuples、索引命中和 `pg_stat_statements` 中的高读块 SQL。生产执行后，继续观察 Supabase daily/hourly Disk IO 图表，确认请求延迟和 IO wait 是否下降。
+
 ## 4. 环境变量
 
-### 4.1 前端（Vercel / frontend/.env.local）
+### 4.1 前端（Docker 容器 / frontend/.env.local）
 
 ```env
 NEXT_PUBLIC_SUPABASE_URL=
@@ -66,46 +76,41 @@ SUPABASE_SERVICE_ROLE_KEY=
 SUPABASE_HTTP_TIMEOUT_SEC=8
 
 POLYWEATHER_PAYMENT_ENABLED=true
+# 默认链仍是 Polygon，因为当前 checkout 合约部署在 Polygon。
 POLYWEATHER_PAYMENT_CHAIN_ID=137
 POLYWEATHER_PAYMENT_RPC_URL=https://polygon-bor-rpc.publicnode.com
+POLYWEATHER_PAYMENT_RPC_URLS_BY_CHAIN_JSON={"137":["https://polygon-bor-rpc.publicnode.com"],"1":["https://ethereum-rpc.example"]}
 POLYWEATHER_PAYMENT_RECEIVER_CONTRACT=0x<receiver_contract>
+POLYWEATHER_PAYMENT_DIRECT_RECEIVER_ADDRESS=0x<treasury_or_receiver_wallet>
 POLYWEATHER_PAYMENT_CONFIRMATIONS=2
 POLYWEATHER_PAYMENT_INTENT_TTL_SEC=1800
 POLYWEATHER_PAYMENT_WALLET_CHALLENGE_TTL_SEC=600
 POLYWEATHER_PAYMENT_POLL_INTERVAL_SEC=4
 POLYWEATHER_PAYMENT_MAX_WAIT_SEC=50
 
-# 支持双币种（示例）
-POLYWEATHER_PAYMENT_ACCEPTED_TOKENS_JSON=[{"code":"usdc_e","symbol":"USDC.e","name":"USDC.e (PoS)","address":"0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174","decimals":6,"receiver_contract":"0x<receiver>","is_default":true},{"code":"usdc","symbol":"USDC","name":"Native USDC","address":"0x3c499c542cef5e3811e1192ce70d8cc03d5c3359","decimals":6,"receiver_contract":"0x<receiver>"}]
+# 支持多链多币种（示例）
+# Ethereum 主网 USDC 当前建议只开 direct transfer，不走 Polygon checkout 合约。
+POLYWEATHER_PAYMENT_ACCEPTED_TOKENS_JSON=[{"code":"usdc_polygon","symbol":"USDC","name":"USDC on Polygon","chain_id":137,"chain_code":"polygon","chain_name":"Polygon","address":"0x3c499c542cef5e3811e1192ce70d8cc03d5c3359","decimals":6,"receiver_contract":"0x<receiver_contract>","direct_receiver_address":"0x<treasury_or_receiver_wallet>","is_default":true},{"code":"usdc_e_polygon","symbol":"USDC.e","name":"USDC.e on Polygon","chain_id":137,"chain_code":"polygon","chain_name":"Polygon","address":"0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174","decimals":6,"receiver_contract":"0x<receiver_contract>","direct_receiver_address":"0x<treasury_or_receiver_wallet>"},{"code":"usdc_ethereum","symbol":"USDC","name":"USDC on Ethereum","chain_id":1,"chain_code":"ethereum","chain_name":"Ethereum Mainnet","address":"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48","decimals":6,"direct_receiver_address":"0x<treasury_or_receiver_wallet>","supports_contract_checkout":false,"supports_direct_transfer":true,"confirmations":2,"explorer_tx_url":"https://etherscan.io/tx/{tx_hash}"}]
 
-# 套餐（当前只保留月付）
-POLYWEATHER_PAYMENT_PLAN_CATALOG_JSON={"pro_monthly":{"plan_id":101,"amount_usdc":"5","duration_days":30}}
-POLYWEATHER_PAYMENT_ALLOWED_PLAN_CODES=pro_monthly
+# 套餐
+POLYWEATHER_PAYMENT_PLAN_CATALOG_JSON={"pro_monthly":{"plan_id":101,"amount_usdc":"29.9","duration_days":30},"pro_quarterly":{"plan_id":102,"amount_usdc":"79.9","duration_days":90}}
+POLYWEATHER_PAYMENT_ALLOWED_PLAN_CODES=pro_monthly,pro_quarterly
 
 # 积分抵扣
 POLYWEATHER_PAYMENT_POINTS_ENABLED=true
 POLYWEATHER_PAYMENT_POINTS_PER_USDC=500
 POLYWEATHER_PAYMENT_POINTS_MAX_DISCOUNT_USDC=3
+POLYWEATHER_PAYMENT_POINTS_MAX_DISCOUNT_USDC_BY_PLAN_JSON={"pro_monthly":3,"pro_quarterly":8}
 
 # 支付自动补单
 POLYWEATHER_PAYMENT_EVENT_LOOP_ENABLED=true
 POLYWEATHER_PAYMENT_CONFIRM_LOOP_ENABLED=true
+POLYWEATHER_PAYMENT_CONFIRM_LOOP_INTERVAL_SEC=20
+POLYWEATHER_PAYMENT_CONFIRM_LOOP_IDLE_INTERVAL_SEC=300
+POLYWEATHER_PAYMENT_CONFIRM_LOOP_IDLE_AFTER_EMPTY_CYCLES=3
 ```
 
-## 5. 钱包异动频道拆分（推荐）
-
-如果要把“钱包异动监控”发到独立频道：
-
-```env
-POLYMARKET_WALLET_ACTIVITY_CHAT_ID=-1003821482461
-```
-
-说明：
-
-- 设置了 `POLYMARKET_WALLET_ACTIVITY_CHAT_ID(S)` 后，钱包异动推送优先发该频道。
-- 未设置时，回退到全局 `TELEGRAM_CHAT_IDS/TELEGRAM_CHAT_ID`。
-
-## 6. 验证步骤
+## 5. 验证步骤
 
 1. 登录后请求 `/api/auth/me`，确认 `authenticated=true`。
 2. 请求 `/api/payments/config`，确认 `enabled=true`、`configured=true`。
@@ -113,10 +118,16 @@ POLYMARKET_WALLET_ACTIVITY_CHAT_ID=-1003821482461
    - `POST /api/payments/wallets/challenge`
    - `POST /api/payments/wallets/verify`
 4. 支付流程：
-   - `POST /api/payments/intents`
+   - `POST /api/payments/intents`；多链时前端会带 `chain_id` 和 `token_address`
    - 发链上交易
    - `POST /api/payments/intents/{id}/submit`
    - `POST /api/payments/intents/{id}/confirm`
 5. 若前端显示 pending，轮询：
    - `GET /api/payments/intents/{id}`
 6. 确认订阅：`/api/auth/me` 返回 `subscription_active=true`。
+
+## 6. 多链支付口径
+
+- Polygon 是默认链，仍支持钱包合约支付和手动直转确认。
+- Ethereum 主网 USDC 是正式支付链路，但当前建议只走手动直转：用户选择 Ethereum 后，前端展示收款钱包、金额、代币合约和 Etherscan 链接，用户提交 tx hash 后后端按 `intent.chain_id=1` 查询 Ethereum RPC。
+- 不要只依赖前端文案阻止错链付款；后端必须把每笔 intent 的 `chain_id`、`token_address`、`receiver_address` 落库，并在确认时按该链校验 `Transfer` 事件。

docs/TECH_DEBT_ZH.md

@@ -1,4 +1,4 @@
-# 技术债与工程待办（v1.6.0）
+# 技术债与工程待办（v1.8.1）
 
 最后更新：`2026-05-10`
 
@@ -29,7 +29,6 @@ flowchart TD
     end
 
     subgraph S["状态与概率"]
-        S1["EMOS 本地训练与 shadow 发布门禁"]
     end
 
     A --> P
@@ -47,16 +46,13 @@ flowchart TD
 - 支付运行态 API 与 SQLite 审计事件已补齐。
 - 钱包绑定支持浏览器钱包 + WalletConnect。
 - 账户中心与 Pro 权限展示链路打通。
-- 钱包异动支持独立频道路由。
 - 运行态状态/缓存与核心离线训练、评估、回填链路已完成 SQLite 主路径收口。
 - 轻量可观测性已上线（`/healthz`、`/api/system/status`、`/metrics`）。
-- EMOS/CRPS 校准链路已接通；生产主概率保持 `legacy` 或 `emos_shadow`，`emos_primary` 只允许本地训练通过门禁后人工灰度。
 
 ## 3. 高优先级技术债
 
 | 项目 | 影响 | 建议动作 |
 | :-- | :-- | :-- |
-| EMOS 发布门禁 | 低配 VPS 不适合训练，主概率不能绕过评估 | 本地拉生产 SQLite 训练，`ready_for_promotion=true` 后先 `emos_shadow` |
 | 外部监控与告警 | 只有轻量指标，无外部抓取 | 接 Prometheus/Grafana 或最小巡检 |
 | 退款与售后链路 | 商业闭环不完整 | 增加退款状态机与工单系统 |
 
@@ -64,7 +60,7 @@ flowchart TD
 
 | 项目 | 影响 | 建议动作 |
 | :-- | :-- | :-- |
-| 积分发放可解释性 | 用户理解成本高 | 输出积分来源明细（发言/奖励/手动补分） |
+| 积分发放可解释性 | 用户理解成本高 | 输出积分来源明细（有效付费邀请/后台人工补发/积分抵扣消费） |
 | 支付合约 V2 升级 | 当前仍是最小可用合约 | 升级到 SafeERC20 + Pausable + plan 绑定 |
 | 支付失败文案标准化 | 转化率受影响 | 建立错误码 -> 文案映射表 |
 
@@ -77,6 +73,5 @@ flowchart TD
 
 ## 6. 下阶段里程碑
 
-1. 固化 EMOS 本地训练流程，禁止低配 VPS 自动训练和自动主用。
 2. 补外部监控抓取与告警阈值。
 3. 评估并推进支付合约 V2 升级。

docs/data-architecture-review.md

@@ -0,0 +1,106 @@
+# PolyWeather 数据链路架构审查
+
+> 审查日期：2026-06 | 视角：系统架构师 | 范围：完整数据采集→分析→API→前端状态
+> 
+> **修复状态：9/9 已完成；最后校准：2026-05-28**
+
+## 一、数据架构总览
+
+```
+外部数据源                   Python 后端                         Next.js 前端
+===========                  ==========                          ===========
+
+Open-Meteo (预报+多模型) ─┐
+METAR/TAF (航空气象)     ─┤
+NWS (美国) / MGM (土耳其) ─┤
+JMA/AMOS/AMSC/HKO/CWA    ─┤
+CoWIN / MADIS / NOAA     ─┤
+                              ├─ WeatherDataCollector            ├─ dashboard-client.ts
+                              │   (内存缓存 + SQLite磁盘缓存)      │   (ETag浏览器缓存 + SWR)
+                              │                                  │
+                              ├─ _analyze()                      ├─ useDashboardStore
+                              │   ├─ DEB 融合 (11模型加权)        │   (双Context拆分)
+                              │   └─ 趋势引擎                    │   (扫描数据预加载)
+                              │                                  │
+                              ├─ scan_terminal_service.py        ├─ 扫描终端查询
+                              │   ├─ ThreadPoolExecutor(4)       │   (120s TTL)
+                              │   └─ AI 增强层 (DeepSeek)        │
+                              │                                  │
+                              ├─ FastAPI routes                  └─ API代理 (Next.js rewrites)
+                              │   (HTTP snapshot + ETag 304)
+                              │
+                              └─ SSE /api/events
+                                  (Redis Stream / SQLite replay)
+```
+
+## 二、数据采集层
+
+### 源端（14个外部源）
+
+| 源 | 类型 | 覆盖 | TTL |
+|------|------|---------|------|
+| Open-Meteo | 预报 + 多模型集合 | 全球 | 300s |
+| METAR | 机场观测 | 全球 ICAO | 60s |
+| TAF | 机场预报 | 全球 ICAO | 600s |
+| NWS | 国家预报 | 美国 | 按请求 |
+| MGM | 国家官方 | 土耳其 | 300s |
+| ECMWF/GFS/ICON/GEM/JMA | 多模型 NWP | 全球 | 300s |
+| HKO/CWA/NOAA/AMOS/AMSC/CoWIN | 结算/参考观测 | 特定国家 | 60s-600s |
+| Redis Stream | 实时事件 replay / 多 worker fanout | 后端内部 | event-driven |
+
+### 待改进
+
+| # | 问题 | 优先级 |
+|---|------|------|
+| 1 | 无源端健康状态检测 | 🟡 |
+| 2 | METAR TTL 60s 过于激进（机场每小时发一次） | 🟡 |
+| 3 | 无请求重试（`POLYWEATHER_HTTP_RETRY_COUNT` 默认 0） | 🟡 |
+
+## 三、分析层
+
+### DEB 动态集成混合
+
+自适应加权：11 模型按过去 7 天 MAE 动态分配权重。回退链完善。
+
+
+### 概率校准
+
+
+**已修复：校准漂移检测** — `check_calibration_drift()` 对比最近 CRPS 与基线，漂移 >15% 时告警，集成在 `/api/system/status` 的 `probability.drift` 字段。
+
+| # | 问题 | 优先级 |
+|---|------|------|
+| 4 | 校准系数静态 JSON 文件，数据分布变化需手动重新训练 | 🟡 |
+
+## 四、API 与缓存层
+
+**已修复：ETag 304** — 后端 `_etag_middleware` 对 GET /api/* 自动返回 ETag (MD5)，支持 `If-None-Match`，匹配返回 304 + `Cache-Control: private, max-age=30`。
+
+**已修复：TTL 匹配** — `SCAN_TERMINAL_PAYLOAD_TTL_SEC` 30s → 120s，匹配 ThreadPoolExecutor(4)×60 城的实际重算耗时。
+
+**已实现：SSE 增量推送（SSE Patch）与可重放事件日志** — 引入 FastAPI SSE 广播通道 (`/api/events`)。数据采集端更新时自动向 `/api/internal/collector-patch` 推送最新温度；后端标准化为 `city_observation_patch.v1`，写入 Redis Stream（生产）或 SQLite event log（兜底）后再广播。前端扫描终端订阅该流，不再执行固定的 5 分钟定时轮询，而是根据 Patch 变化即时更新列表；当前选中图表基于 `useLatestPatch` 实现 1 分钟级温度的增量合并与实时曲线绘制。
+
+| # | 问题 | 优先级 |
+|---|------|------|
+| 5 | 缓存键过粗（city::mode），微小变化也触发完整重算 | 🟡 |
+
+## 五、前端状态管理
+
+**已修复：sessionStorage 限制** — 只保留最近 3 个城市的详情，避免 3-10MB JSON 序列化阻塞主线程。
+
+**已修复：Context 拆分** — `CityDetailsContext` 独立管理 `cityDetailsByName` 变更，新增 `useCityDetails` hook。只读详情数据的组件不因其他状态变化而重渲染。
+
+**已修复：Stale-while-revalidate** — `ensureCityDetail` 过期缓存立即返回 + 后台异步刷新，用户不再看到 loading spinner。
+
+**已修复：扫描数据复用** — `preloadCityFromRow()` 从扫描终端行预填充城市详情缓存，选城市后详情面板立即显示。
+
+**已实现：SSE 订阅、replay 与 2 分钟无 Patch 兜底机制** — 引入 `useLatestPatch` 与 `useSsePatchVersion` 管理实况数据的准实时合并。若长连接中断，前端使用 `since_revision` replay 缺失事件；若 2 分钟内未收到任何增量 Patch，可见图表自动触发 60s 降级轮询（从 `/api/city/{city}/summary` 获取最新实况，并以 ignoreCache 强刷 full detail）。浏览器后台恢复时会主动刷新可见图表 full detail。
+
+## 六、待办
+
+| # | 问题 | 优先级 | 说明 |
+|---|------|------|------|
+| 1 | 校准系数需手动重新训练 | 🟡 | 漂移检测已有，但自动触发重训练需要 GPU/算力资源 |
+| 2 | 缓存键过粗 — `city::mode` 粒度 | 🟢 | 微小温度变化触发完整重算，可考虑内容 hash 键 |
+
+> 注：原审查中 METAR TTL 60s 实际为 600s（误诊）；扫描终端轮询已有 `AbortController` + `requestSeq` 保护（误诊）。

docs/deep-research-report.md

@@ -2,26 +2,24 @@
 
 ## 执行摘要
 
-PolyWeather（仓库：`yangyuan-zhen/PolyWeather`）定位为**面向温度类结算预测市场（如 Polymarket 的温度结算合约）**的“生产级气象情报系统”，核心在于把多源天气观测/预报转化为**结算导向的概率桶（μ + bucket distribution）**，并进一步映射到市场报价完成**错价扫描**；同时提供 Web 仪表盘与 Telegram Bot 两套交互入口，并包含 Polygon 链上 USDC/USDC.e 支付、自动补单与订阅/积分体系。项目 README 现明确仓库代码采用 `AGPL-3.0-only`，同时将品牌、商标、生产私有数据与运营阈值保留在代码许可证之外。
-从工程实现看，截至 `2026-04-27`，项目已经完成一轮更明确的工程化收口：多源天气采集仍保持现有业务能力，同时已完成采集层与 Web API 大文件拆分、CI 质量门禁、配置分级（`.env.example` / `.env.secrets.example` / 中文部署文档）、EMOS/CRPS 校准链路、运行态状态与缓存迁移到 SQLite 主路径，以及最小外部监控链路（`/healthz`、`/api/system/status`、`/metrics` + Prometheus + Alertmanager + Grafana + Telegram relay）。除此之外，项目还补上了**历史真值治理**：`daily_records` 继续只保留近 14 天运行态缓存，但新增了永久真值表、真值 revision 审计表和长期训练特征表，并开始把监督真值与训练特征从“短期缓存”正式拆到“长期可追溯存储”。2026-04 下旬新增的前端城市决策卡把“多模型 + METAR + 市场桶”进一步组合成面向单城点击的解释层：AI 机场报文解读、最高温中枢、完整市场桶匹配与“模型-市场差”已成为 Scan Terminal 的核心决策入口。
-这意味着报告里最初最突出的“工程地基缺失”问题，已经有一部分被关闭：`src/data_collection/weather_sources.py` 与 `web/app.py` 不再是原来的超大单文件；GitHub Actions 已覆盖 Python、前端和 Docker build；配置与密钥治理已成体系；运行态状态不再只能依赖 JSON/JSONL 文件；EMOS 也不再只是概念，而是进入了可训练、可评估、可 shadow、可门禁判断的阶段；更重要的是，监督真值与训练特征不再只能附着在 14 天运行态缓存上。
-但项目仍处在“从可用走向稳态”的中段，而不是终局。当前真正的高优先级问题已进一步收敛：**EMOS 仍未达到生产切换标准**，当前门禁结论明确为 `hold`，阻塞原因是 shadow bucket brier 明显退化，同时历史长期特征仍处在“刚开始积累”的阶段。SQLite 迁移方面，运行态主读切换和核心离线训练/回填链路已经完成验收：在移除 `data/*.json` / `data/*.jsonl` 后，训练、评估、shadow report 与关键 backfill 脚本仍可仅依赖运行时数据库正常执行；当前保留的 legacy 文件路径主要用于迁移、导出、校验和显式回退输入。历史真值治理方面，新增的永久真值表、revision 审计表与长期训练特征表已经落地，`Taipei` / `Shenzhen` 的历史页面回填也已接通，因此当前缺口已从“历史真值是否会继续丢失”转为“历史特征是否能持续增长并支撑 EMOS/LGBM 评估”。可观测性方面，最小外部监控链路已经补齐：Prometheus 抓取、Alertmanager 规则、Grafana 面板、Telegram 告警 relay 与巡检脚本均已落地；当前剩余缺口已从“有没有外部监控”转为“监控覆盖深度是否足够”，例如节点级资源、数据库体积趋势、支付细粒度指标、按城市/来源拆分的业务 SLA。支付链路方面，链下审计与容灾已明显增强：事件重放、SQLite 审计事件、RPC 多节点容灾、合约静态检查、`/ops` 支付异常单都已补齐；当前剩余风险主要集中在**链上合约本身仍是最小实现**，尚未升级到 SafeERC20、Pausable、链上套餐绑定等更强防护版本。
-因此，当前阶段最正确的策略已经不是继续做“大范围基础重构”，而是围绕**EMOS 上线门禁稳定化、长期训练特征持续积累、监控覆盖深挖、城市决策卡可观测性、支付合约防护升级**这五条线持续收口。短中期内更高 ROI 的方向依然不是引入新的大模型，而是把现有“采集→后处理→市场映射→前端决策→支付/订阅”的链路做成**状态一致、指标可见、发布可控、回退明确**的生产平台。
+PolyWeather（仓库：`yangyuan-zhen/PolyWeather`）定位为**面向温度类结算预测市场（如 Polymarket 的温度结算合约）**的”生产级气象情报系统”，核心在于把多源天气观测/预报转化为**结算导向的概率桶（μ + bucket distribution）**；同时提供 Web 仪表盘与 Telegram Bot 两套交互入口，并包含 Polygon 链上 USDC/USDC.e 支付、Ethereum 主网 USDC 直转确认、自动补单与订阅/积分体系。项目 README 现明确仓库代码采用 `AGPL-3.0-only`，同时将品牌、商标、生产私有数据与运营阈值保留在代码许可证之外。
+
+> **2026-05-29 更新**：支付 intent 已支持多链 `chain_id`，Polygon 继续承载 checkout 合约，Ethereum 主网 USDC 作为直转确认通道；终端图表继续使用 HTTP snapshot + SSE Patch + Redis Stream/SQLite replay 架构。
 ## 项目概览
 
-PolyWeather 的目标与范围在 README/README_ZH 中定义得较清楚：为温度结算市场提供气象情报（多源采集→融合→概率→对照市场报价），并提供“官方看板（Vercel 前端）+ VPS 后端 + Telegram Bot”。
+PolyWeather 的目标与范围在 README/README_ZH 中定义得较清楚：为温度结算市场提供气象情报（多源采集→融合→概率→对照市场报价），并提供“官方看板（Docker/VPS 前端）+ VPS 后端 + Telegram Bot”。
 项目主功能可归纳为五层：
-**天气层（数据源/采集）**：聚合 52 个城市的实测与预报；支持 AviationWeather METAR（机场观测）、土耳其 MGM 站网、Open-Meteo（含多模型与集合预报）、美国 NWS（仅美国城市）、以及部分城市使用明确官方站点或历史页面入口（香港 HKO、台湾/深圳相关历史页面等）等。机场类市场仍以 METAR / 机场主站为结算锚点，Wunderground 不描述为物理观测站。
+**天气层（数据源/采集）**：聚合 51 个城市的实测与预报；支持 AviationWeather METAR/TAF、韩国 AMOS 跑道级观测（首尔/釜山）、中国 AMSC AWOS 跑道端点气温、香港 CoWIN 6087 / HKO、土耳其 MGM、Open-Meteo 多模型与集合预报、美国 MADIS HFMETAR 等。机场类市场仍以 METAR / 机场主站或明确官方结算源为锚点，Wunderground 不描述为物理观测站。
 **分析层（DEB/趋势/概率/结算口径）**：
 DEB（Dynamic Error Balancing）基于过去 N 天模型误差（MAE）倒数加权，输出融合预报；运行态仍维护近 14 天 `daily_records` 缓存做当前对账，但长期监督真值与训练特征已经迁到 SQLite 永久表中，并支持基于 WU（Weather Underground 口径）四舍五入的结算命中评估。
 趋势/概率引擎在 `trend_engine.py` 中实现：综合“集合预报区间→σ/μ→高温窗口→死盘判定→温度桶概率分布→边界提示”等，用于 bot 展示与 web 结构化数据输出。
-**城市决策层（Scan Terminal / AI 机场报文解读）**：地图点击城市后加入城市决策卡，前端拉取 full detail、多模型区间、最新 METAR，并通过 `/api/scan/terminal/ai-city/stream` 生成城市级 AI 解读。该解读由 `final_judgment`、`metar_read`、`reasoning`、`model_cluster_note`、`risks` 与原始 METAR 证据组成；最高温中枢优先使用 AI `predicted_max`，再回退到 DEB、多模型中心、日内 pace 或当前实测。
-**市场层（Polymarket 行情对照）**：只读模式从 Gamma API 发现市场、从 CLOB（`py-clob-client` 或 REST 回退）读取价格/盘口，并用完整 `all_buckets` 对目标温度桶做 exact/range/“or higher”/“or lower” 严格匹配，计算“模型-市场差”（模型概率 − 市场隐含概率）生成信号标签。
-**商业化与支付**：订阅（`Pro Monthly 5 USDC`）、积分抵扣、Polygon 链上收款合约（USDC/USDC.e），并提供“事件监听 + 周期确认”的自动补单机制。
+**城市决策层（Scan Terminal / 结构化实况层）**：地图点击城市后加入城市决策卡，前端拉取 full detail、多模型区间、最新 METAR/官方站点/跑道观测，并通过 `/api/city/{name}/detail` 生成城市级结构化数据。终端图表使用 HTTP snapshot + SSE patch + Redis/SQLite replay，最高温中枢优先使用 DEB hourly consensus，再结合多模型中心、日内 pace 和当前实测。
+**市场层（Polymarket 行情对照）**：*[v1.7.0 已移除]* 原先从 Gamma API 发现市场、从 CLOB 读取价格/盘口并计算”模型-市场差”，已于 2026-05-23 随 Polymarket 价格拉取层一并删除。当前 `market_scan` 返回空。
+**商业化与支付**：订阅（`Pro Monthly 29.9 USDC / 30 天`、`Pro Quarterly 79.9 USDC / 90 天`）、邀请积分抵扣、Polygon 链上收款合约（USDC/USDC.e）、Ethereum 主网 USDC 直转确认，并提供“事件监听 + 周期确认”的自动补单机制。
 **支持的数据集/数据源**：项目不是传统“训练数据集+模型训练”的机器学习仓库；其“数据集”本质是外部实时/预报 API 与站点观测数据。对外部数据的使用需要遵守来源方的访问与速率限制，例如 AviationWeather Data API 明确限制请求频率（含每分钟请求上限/建议降低频率与使用缓存文件）。
 **许可证**：仓库根目录 `LICENSE` 当前为 `AGPL-3.0-only`。同时 README 与策略文档明确：品牌、商标、生产私有数据与运营策略不随代码许可证一并授权。
-（插图：项目 README 中包含产品截图，可用于快速理解信息架构与 UI 形态） 
-![PolyWeather demo map](https://raw.githubusercontent.com/yangyuan-zhen/PolyWeather/main/docs/images/demo_map.png)
+（插图：项目 README 中包含产品截图，可用于快速理解实时终端与 Telegram 推送形态）
+![PolyWeather realtime terminal](https://raw.githubusercontent.com/yangyuan-zhen/PolyWeather/main/frontend/public/static/web.png)
 
 ## 架构与代码库分析
 
@@ -30,12 +28,11 @@ DEB（Dynamic Error Balancing）基于过去 N 天模型误差（MAE）倒数加
 从 README、Docker/Compose、入口脚本与核心模块引用关系，可以抽象出如下模块地图（按“运行时组件”与“Python 域模块”两层描述）：
 | 层级 | 目录/文件 | 角色定位 | 关键说明 |
 | ------------- | ------------------------------------------------------------------------ | ------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| 运行时组件 | `frontend/` | Next.js 前端（Vercel） | 前端重构报告提到 App Router、Route Handlers（BFF）、缓存策略、支付与账户中心等；Scan Terminal 已新增城市决策卡、AI 机场报文解读、页面内存/localStorage 双层缓存、AI stream 小并发队列与完整市场桶映射。 |
-| 运行时组件 | `web/app.py` + `web/core.py` + `web/routes.py` + `web/analysis_service.py` + `web/scan_terminal_service.py` | FastAPI 后端 API | 已从单文件入口拆为启动入口、核心上下文、路由层、分析服务层；Scan Terminal 侧提供 `/api/scan/terminal/ai-city/stream`，城市 AI 默认 30s 超时并支持 stream parse failure 的非流式重试。 |
+| 运行时组件 | `frontend/` | Next.js 前端（Docker / VPS） | 前端重构报告提到 App Router、Route Handlers（BFF）、缓存策略、支付与账户中心等；Scan Terminal 已新增城市决策卡、结构化实况层、页面内存/localStorage 双层缓存、structured detail 小并发队列与完整市场桶映射。 |
+| 运行时组件 | `web/app.py` + `web/core.py` + `web/routes.py` + `web/analysis_service.py` + `web/scan_terminal_service.py` | FastAPI 后端 API | 已从单文件入口拆为启动入口、核心上下文、路由层、分析服务层；Scan Terminal 侧提供 `/api/city/{name}/detail`，城市结构化分析 默认 30s 超时并支持 stream parse failure 的非流式重试。 |
 | 运行时组件 | `bot_listener.py` + `src/bot/*` | Telegram Bot | 入口 `bot_listener.py` 调 `start_bot()`，并由 `StartupCoordinator` 启动多个后台 loop。 |
-| Python 域模块 | `src/data_collection/*` | 天气采集 + 城市注册 + 市场读取 | 采集层已拆为 `weather_sources.py` 编排层 + `open_meteo_cache.py`、`settlement_sources.py`、`metar_sources.py`、`mgm_sources.py`、`nws_open_meteo_sources.py`。 |
+| Python 域模块 | `src/data_collection/*` | 天气采集 + 城市注册 | 采集层已拆为 `weather_sources.py` 编排层 + `open_meteo_cache.py`、`settlement_sources.py`、`metar_sources.py`、`mgm_sources.py`、`amos_station_sources.py`、`jma_amedas_sources.py`、`nws_open_meteo_sources.py`、`country_networks.py` 等。v1.7.0 已移除 NMC、pogodaiklimat、Meteoblue 数据源。 |
 | Python 域模块 | `src/analysis/*` | DEB/趋势/概率/结算口径 | `deb_algorithm.py`、`trend_engine.py`、`settlement_rounding.py`。 |
-| Python 域模块 | `src/analysis/probability_calibration.py` + `src/analysis/probability_rollout.py` | 概率校准与上线门禁 | 已支持 `legacy / emos_shadow / emos_primary`，并可产出 rollout 判断。 |
 | Python 域模块 | `src/payments/*` + `contracts/*` | 支付合约 + 事件监听/补单 | Solidity 合约 + Python 侧事件扫描/确认循环 + SQLite 审计事件 + RPC 多节点容灾 + 合约静态检查。 |
 | Python 域模块 | `src/auth/*`、`docs/SUPABASE_SETUP_ZH.md`、`scripts/supabase/schema.sql` | Supabase 鉴权/订阅/积分 | 使用 `/auth/v1/user` 校验 JWT、`/rest/v1/subscriptions` 查订阅（服务端角色 key 必须保密）。 |
 | Python 域模块 | `src/database/runtime_state.py` | 运行态状态、永久真值与训练特征仓储 | 已接入 `daily_records`、`telegram_alert_state`、`probability_training_snapshots`、`open_meteo` 持久缓存，并新增永久真值表、真值修订审计表、长期训练特征表。 |
@@ -47,14 +44,14 @@ DEB（Dynamic Error Balancing）基于过去 N 天模型误差（MAE）倒数加
 ```mermaid
 flowchart TB
  subgraph Clients
- WEB[Next.js Frontend<br/>Vercel]
- CITYCARD[Scan Terminal City Cards<br/>AI airport read + bucket mapping]
+ WEB[Next.js Frontend<br/>Docker / VPS]
+ CITYCARD[Scan Terminal City Cards<br/>structured observations + probability mapping]
  TG[Telegram Bot<br/>TeleBot + Handlers]
  end
 
  subgraph API
  FAST[FastAPI<br/>web/app.py]
- LLM[City AI stream<br/>OpenAI-compatible provider]
+ LLM[City structured detail<br/>OpenAI-compatible provider]
  end
 
  subgraph Data
@@ -69,13 +66,12 @@ JSON[Legacy JSON files<br/>migration/export/explicit fallback only]
  OM[Open-Meteo Forecast/Ensemble/Multi-model]
  AW[AviationWeather Data API<br/>METAR]
  MGM[MGM Turkey]
+ AMOS[global.amo.go.kr<br/>AMOS runway sensors]
  NWS[api.weather.gov]
  HKO[data.weather.gov.hk]
  CWA[opendata.cwa.gov.tw]
- PM_G[Polymarket Gamma API]
- PM_C[Polymarket CLOB API]
  SB[Supabase Auth/REST]
- RPC[Polygon RPC]
+ RPC[Polygon / Ethereum RPC]
  end
 
  subgraph Payments
@@ -95,12 +91,11 @@ JSON[Legacy JSON files<br/>migration/export/explicit fallback only]
  WX --> OM
  WX --> AW
  WX --> MGM
+ WX --> AMOS
  WX --> NWS
  WX --> HKO
  WX --> CWA
 
- FAST --> PM_G
- FAST --> PM_C
  FAST --> LLM
 
  FAST --> SB
@@ -118,13 +113,13 @@ JSON[Legacy JSON files<br/>migration/export/explicit fallback only]
 
 
 
-### 城市决策卡工作流（2026-04 更新）
+### 城市决策卡工作流（2026-05 更新）
 
 Scan Terminal 的城市决策卡现在承担“从天气分析到市场动作解释”的前端决策层：
 
 1. **地图点击与 pinned city**：免费/付费入口都会先把城市加入决策卡；未付费用户若权限不足，仍应保留卡片承载升级/限制提示，而不是点击后无反馈。
-2. **full detail hydration**：卡片请求城市 full detail，拿到 DEB、当前/历史实测、多模型区间与最新 METAR。现阶段 detail hydration 仍偏保守串行，优先保障后端数据源稳定；真正消耗 LLM 的 AI 解读另行限流。
-3. **AI 机场报文解读**：前端最多同时保留 2 条城市 AI stream，第三个及以后城市会进入队列并展示排队提示，避免多个 provider stream 同时竞争导致第三城/第四城解析失败。当前临时使用 MiMo：`POLYWEATHER_SCAN_AI_BASE_URL=https://token-plan-cn.xiaomimimo.com/v1`、`POLYWEATHER_SCAN_CITY_AI_MODEL=mimo-v2.5-pro`；其他后端城市 AI 配置建议为 `POLYWEATHER_SCAN_CITY_AI_TIMEOUT_SEC=30`、`POLYWEATHER_SCAN_CITY_AI_MAX_TOKENS=900`、`POLYWEATHER_SCAN_CITY_AI_RETRY_ON_STREAM_PARSE_ERROR=true`。
+2. **full detail hydration**：卡片请求城市 full detail，拿到 DEB、当前/历史实测、多模型区间与最新 METAR。现阶段 detail hydration 仍偏保守串行，优先保障后端数据源稳定；真正消耗 LLM 的 结构化解读另行限流。
+3. **结构化实况层**：前端最多同时保留 2 条城市结构化分析 stream，第三个及以后城市会进入队列并展示排队提示，避免多个 provider stream 同时竞争导致第三城/第四城解析失败。当前临时使用 MiMo：`POLYWEATHER_API_BASE_URL=<backend>`、`POLYWEATHER_SCAN_TERMINAL_PAYLOAD_TTL_SEC=300`；其他后端城市结构化分析 配置建议为 `POLYWEATHER_SCAN_TERMINAL_BUILD_TIMEOUT_SEC=120`、`POLYWEATHER_SCAN_TERMINAL_MAX_WORKERS=8`、`POLYWEATHER_SCAN_TERMINAL_PAYLOAD_TTL_SEC=300`。
 4. **缓存策略**：页面内存缓存保留 loading/stream/final 状态，切换选项卡返回时不应空白重拉；localStorage 持久化最终成功、非 degraded 的 payload；后端 city AI cache key 已移除当前 `local_time` 干扰，主要按城市、日期与 METAR signature 失效。
 5. **市场桶匹配**：城市市场扫描必须使用 full `all_buckets`，按温度 exact/range/“or higher”/“or lower” 方向严格匹配；不再用宽松 ±8°C fallback，以避免拿到 16°C 之类错误桶。前端展示统一使用“模型-市场差”，即 `model_probability - market_implied_probability`，并修复温度单位重复渲染（如 `31°°C`）。
 
@@ -132,7 +127,7 @@ Scan Terminal 的城市决策卡现在承担“从天气分析到市场动作解
 
 **Python 依赖**：`requirements.txt` 包含 `requests`、`loguru`、`pyTelegramBotAPI`、`python-dotenv`、`numpy`、`web3`、`fastapi`、`uvicorn` 等，符合“采集+bot+api+链上交互”的需求。
 **容器环境**：`Dockerfile` 基于 `python:3.11-slim`，默认启动 bot；`docker-compose.yml` 通过不同 command 分别启动 bot 与 web（`python bot_listener.py` / `python web/app.py`），并挂载运行态数据目录。
-**前端依赖**：前端 README 描述 Next.js、Leaflet、Chart.js、Supabase Auth、WalletConnect 等；`frontend/package.json` 是前端依赖来源。
+**前端依赖**：前端 README 描述 Next.js、Leaflet、Recharts、Supabase Auth、WalletConnect 等；`frontend/package.json` 是前端依赖来源。
 ### 数据预处理、模型与“训练/推理”管线
 
 本项目的“模型”主要是统计融合与规则/启发式引擎，而非深度网络训练：
@@ -141,20 +136,19 @@ Scan Terminal 的城市决策卡现在承担“从天气分析到市场动作解
 **DEB（Dynamic Error Balancing）**：以最近 N 天各模型的 MAE 计算倒数权重并做加权融合；同时将 `forecasts / actual_high / deb_prediction / mu / prob_snapshot` 写入 `data/daily_records.json`，并提供命中率/MAE/Brier 等统计口径。
 **概率引擎**：`trend_engine.py` 以集合预报的 p10/p90 推 σ（并考虑历史 MAE floor、风向/云量/压强的 shock_score、以及峰值窗口 time-decay），再用正态近似把连续分布映射为 WU 整数“温度桶概率”。
 **推理流水线（在线）**：
-Web/Telegram 请求 → FastAPI 调用采集器抓取/复用缓存 → 分析引擎输出结构化结果（μ、概率桶、趋势、死盘/窗口判定、DEB 预测、市场扫描）→ 前端渲染或 bot 消息格式化。对城市决策卡而言，在线推理还会叠加“latest METAR + 多模型区间 + AI city stream + full all_buckets 市场匹配”，最终输出最高温中枢、AI 机场报文解读和模型-市场差。
+Web/Telegram 请求 → FastAPI 调用采集器抓取/复用缓存 → 分析引擎输出结构化结果（μ、概率桶、趋势、死盘/窗口判定、DEB 预测、市场扫描）→ 前端渲染或 bot 消息格式化。对城市决策卡而言，在线推理还会叠加“latest METAR + 多模型区间 + structured city detail + full all_buckets 市场匹配”，最终输出最高温中枢、结构化实况层和模型-市场差。
 **检查点（checkpoints）**：传统 ML checkpoint 不适用；但项目现已形成两类“业务状态 checkpoint”：
 （a）SQLite 运行态存储（当前线上与核心离线链路主路径）；（b）SQLite 永久真值/训练特征表（当前监督真值与训练样本长期主存）；（c）legacy JSON/JSONL 文件（主要保留给迁移回滚、导出比对与显式回退输入）。当前设计仍支持 `POLYWEATHER_STATE_STORAGE_MODE=file|dual|sqlite`，但对线上部署与离线训练/回填而言，推荐目标状态都已经是 `sqlite`。
 ### 测试、CI/CD 与运维验证
 
 **测试**：仓库存在 `tests/test_trend_engine.py`，覆盖 μ 计算、死盘判定、预报崩盘提示、趋势方向等核心逻辑（通过 patch 隔离外部依赖）。前端侧已通过 `npm run build` 验证 Scan Terminal 改动可以编译；后续仍建议为城市决策卡补固定 fixture，覆盖 `all_buckets` 匹配、温度单位渲染、AI 缓存 key 与 stream 队列行为。
 **CI/CD**：已补齐 GitHub Actions 工作流，至少覆盖 Python lint/test、前端 build、Docker build 三条门禁；当前缺口不再是“有没有 CI”，而是“是否已在 GitHub 分支保护中强制执行”。
-**运维验收**：除 `scripts/validate_frontend_cache.sh` 外，现已新增配置校验、运行态迁移/核验、EMOS rollout 判断等脚本，并提供 `/healthz`、`/api/system/status`、`/metrics` 作为基础观测入口。
 **部署/更新**：Compose 用于启动服务；另有 `update.sh` 通过 `pkill` + `nohup` 重启 bot 与 web。
 ## 优势与薄弱点
 
 ### 优势
 
-**产品闭环完整、目标明确**：从“天气→结算→市场→错价信号→付费体系（订阅/积分/链上支付）”形成可商业化闭环，并在 README 清晰列出当前产品状态（订阅、积分抵扣、链上支付、自动补单等已上线）。
+**产品闭环完整、目标明确**：从“天气→结算→市场→错价信号→付费体系（订阅/积分/链上支付）”形成可商业化闭环，并在 README 清晰列出当前产品状态（订阅、积分抵扣、链上支付、自动补单等已上线）。2026-05 完成积分制度改造：`/city` `/deb` 改为免费（每日各 10 次），积分获取切换为有效付费邀请奖励；Telegram 群发言不再发放积分。
 **复用一套分析内核服务多端**：趋势/概率/DEB 等核心逻辑被抽成分析模块，并被 web 与 bot 共用，避免“两套逻辑漂移”。前端城市决策卡在此基础上补足“机场报文解释 + 市场桶动作口径”，让用户从地图点击可以直接进入可解释决策。
 **面向外部 API 的工程防护意识较强**：Open-Meteo 429 冷却期、最小调用间隔、磁盘缓存、缓存 TTL 等措施表明作者已遭遇并处理速率限制与冷启动问题。 同时 AviationWeather 官方文档也明确建议控制频率并可使用 cache 文件降低负载，项目后续可进一步对齐最佳实践。
 **支付侧有“事件监听 + 确认补单”的双通路**：支付链路天然存在“交易 pending / RPC 延迟 / 日志索引不完整”等问题，项目通过 event loop 与 confirm loop 双机制提升最终一致性。
@@ -164,41 +158,35 @@ Web/Telegram 请求 → FastAPI 调用采集器抓取/复用缓存 → 分析引
 **可复现性已从“缺模板”进入“模板与生产对齐”的阶段**：`.env.example`、`.env.secrets.example`、中文配置文档、前端部署文档、运行时配置校验器都已存在；当前风险主要在于线上历史 `.env` 与新模板并存、旧变量命名残留、以及密钥轮换与分层是否真正落实。
 **CI 已建立，但组织级质量门禁未必完全收口**：CI 现已覆盖 Python、前端与 Docker build。当前问题不再是“缺 CI”，而是是否把这些 status check 绑定到 `main` 保护策略，以及是否逐步引入更严格的 pre-merge 审查。
 **运行态状态/缓存与核心离线链路的 SQLite 收口已完成**：`daily_records`、`telegram_alert_state`、`probability_training_snapshots`、`open_meteo` 缓存已经支持并在生产中主读 SQLite，迁移/校验脚本可用；进一步地，在临时移除 `data/*.json` / `data/*.jsonl` 后，训练集导出、概率拟合、评估报告、shadow report 和关键 backfill 脚本已验证仍可运行。当前 legacy 文件路径主要是显式回退入口，而不再是默认主输入。
-**历史真值治理已从设计缺陷修复到可追溯运行**：`daily_records` 继续作为近 14 天运行态缓存，但已经不再承担长期监督真值职责；项目新增了永久真值表、真值 revision 审计表和长期训练特征表，并为 `Taipei` / `Shenzhen` 补上了历史页面回填链路。当前风险已不再是“监督真值会不会继续被 14 天裁剪吞掉”，而是“历史长期特征能否持续积累到足够支撑 EMOS/LGBM 重新评估”。
 **第三方服务合规与稳定性风险**：
-项目强依赖外部 API（Open-Meteo、AviationWeather、NWS、HKO、CWA、Polymarket、Supabase）以及城市 AI provider（OpenAI-compatible stream，当前临时 MiMo）。其中 AviationWeather Data API 有明确速率限制；Polymarket 官方说明 Gamma/Data/CLOB 三套 API 分属不同域，CLOB 交易端点需鉴权且策略可能变化；Supabase 明确强调 `service_role`/secret keys 绝不可暴露。若缺乏集中治理（重试/退避/熔断/降级/配额监控/密钥轮换），稳定性与合规不可控。城市 AI 解读已经通过前端 2 并发队列、30s timeout、stream parse retry 与缓存 key 稳定化降低第三/第四城市失败概率，但仍需持续记录 stream duration、cache hit、retry、degraded 与 queue depth。
-**可观测性最小闭环已完成，但监控深度仍待加强**：项目现在已有 `/healthz`、`/api/system/status`、`/metrics`，并已补齐 Prometheus 抓取、Alertmanager 规则、Grafana 面板、Telegram relay 与巡检脚本。与此同时，`/ops` 已经逐步演进为后台管理台而不只是状态页：除支付、会员、用户与 EMOS 门禁外，还新增了训练数据治理卡片、城市覆盖矩阵，以及 `/ops/truth-history` 这种可直接查询 `actual_high / settlement_source / station_code / truth_version / updated_by / updated_at` 的真值表浏览页。当前缺口不再是“有没有外部监控”，而是节点级资源、数据库体积趋势、更细粒度支付指标、按城市/来源拆分的业务 SLA，以及是否需要进一步补 `truth revision` 明细页、趋势图和运营日报。
-**EMOS 已完成工程接入，但未完成生产发布**：EMOS/CRPS 校准、shadow 观测、rollout report、上线门禁都已实现；当前真实门禁结果为 `hold`，阻塞原因是 shadow bucket brier 明显退化。因此概率引擎标准化并非未做，而是“工程完成、发布未通过”。
+项目强依赖外部 API（Open-Meteo、AviationWeather、global.amo.go.kr AMOS、NWS、HKO、CWA、Supabase）以及城市结构化分析 provider（OpenAI-compatible stream，当前使用 MiMo）。其中 AviationWeather Data API 有明确速率限制；Supabase 明确强调 `service_role`/secret keys 绝不可暴露。若缺乏集中治理（重试/退避/熔断/降级/配额监控/密钥轮换），稳定性与合规不可控。城市结构化分析 解读已经通过前端 2 并发队列、30s timeout、stream parse retry 与缓存 key 稳定化降低第三/第四城市失败概率，但仍需持续记录 stream duration、cache hit、retry、degraded 与 queue depth。
+
+> **v1.7.0 更新**：Polymarket（Gamma/CLOB）API 依赖已随市场价格拉取层一并移除。
 **许可证/商业使用的潜在冲突点**：仓库自身现为 `AGPL-3.0-only`，但如果未来尝试引入外部神经天气模型，仍需单独核验第三方代码与权重的商用条件：GraphCast 仓库代码 Apache-2.0，但权重使用 CC BY-NC-SA 4.0（非商业），Pangu-Weather 权重同样 BY-NC-SA 且明确禁止商业用途；不加区分地把这些模型用于付费产品会留下法律风险。
 ## 对标分析
 
 为满足“至少 3 个相似开源项目或近期论文”对标，本报告选择三类代表：
 1）**AI 气象预报模型**（GraphCast / FourCastNet / Pangu-Weather）：用于评估“若 PolyWeather 未来扩展到更强预测能力”的技术与许可边界； 
-2）**概率后处理方法**（EMOS）：作为 PolyWeather 概率引擎的更标准化替代/对照； 
-3）**预测市场 API 客户端生态**（Polymarket/py-clob-client、aiopolymarket）：用于评估市场层的工程选型。
+3）**预测市场 API 客户端生态**（Polymarket/py-clob-client、aiopolymarket）：*[v1.7.0 后已不适用]* 市场价格拉取层已移除，此对标仅作历史参考。
 ### 关键对比表
 
 | 项目/论文 | 解决的问题 | 输出形态 | 性能/效果（公开描述） | 易用性与依赖 | 许可证要点 |
 | --------------------------------------------------------- | ---------------------------------------------------- | ------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------- |
-| **PolyWeather**（本仓库） | 温度结算市场气象情报：多源→校准概率桶→错价扫描→城市决策卡→订阅/支付 | 生产级应用（Web+Bot+API+支付） | 以工程能力为主；内置 DEB、LGBM/EMOS 校准概率、死盘判定、市场扫描；当前覆盖 52 城市，并已补齐真值治理、后台运维视图、AI 机场报文解读与 full bucket 决策映射。 | 主要依赖外部 API 与城市 AI provider；Docker Compose 一键启动。 | 仓库 `AGPL-3.0-only`；品牌、生产私有数据与运营规则不随代码许可证授权。 |
 | **GraphCast**（google-deepmind/graphcast） | 10 天全球中期预报（ML 替代/增强 NWP） | 模型代码+权重+notebooks | 论文与介绍提到在大量指标上优于主流确定性系统；仓库提供预训练权重与示例数据入口，并提示 ERA5/HRES 数据条款需另行遵守。 | 完整训练需 ERA5 等；更适合科研/平台级推理，不是产品级 BFF。 | 代码 Apache-2.0；权重 CC BY-NC-SA 4.0（商业限制）。 |
 | **FourCastNet**（NVlabs/FourCastNet） | 高分辨率 data-driven 全球预报（AFNO/ViT） | 模型训练/推理代码+数据/权重链接 | README 描述：0.25° 分辨率、周尺度推理非常快，并可做大规模集合；适合平台型预报。 | 训练/数据依赖大（ERA5 子集 TB 级）；工程集成成本高。 | BSD 3-Clause（代码）。 |
 | **Pangu-Weather**（198808xc/Pangu-Weather + Nature 论文） | 3D Transformer 架构的中期全球预报 | ONNX 推理代码+预训练模型 | Nature 论文称在 reanalysis 上对比 IFS 有更强确定性预报表现，并强调速度优势；仓库提供 ONNX 推理与 lite 版训练说明。 | 模型文件大（多份 ~GB 级），训练资源需求高；更适合科研推理或内部平台。 | 权重 BY-NC-SA 4.0、明确禁止商业用途。 |
-| **EMOS**（Gneiting & Raftery 等） | 集合预报校准：纠偏与解决 underdispersion | 统计后处理方法 | 提出用回归形式输出概率分布（常见为高斯），并以 CRPS 等指标拟合，属于成熟的气象概率校准路线。 | 易落地：对 PolyWeather 而言只需“历史库+拟合器”。 | 方法论（论文）；可自行实现，无额外许可约束（注意论文版权）。 |
-| **Polymarket/py-clob-client** | Polymarket CLOB 读写 SDK | Python SDK | 官方 SDK，支持 read-only 与交易接口；协议与端点在官方文档中给出。 | 易用，适合增强 PolyWeather 市场层。 | MIT。 |
-| **aiopolymarket** | Polymarket APIs 的 async 客户端 | Python async 客户端 | 强调类型安全（Pydantic）、自动分页、重试与 backoff，适合高并发与健壮性诉求。 | 适合替换/补强当前同步 requests 与自定义缓存。 | 以仓库许可为准（此处建议上线前核验）。 |
+| **Polymarket/py-clob-client** | Polymarket CLOB 读写 SDK | Python SDK | *[2026-05 起不再使用]* 官方 SDK，支持 read-only 与交易接口。 | 曾用作 PolyWeather 市场层参考。 | MIT。 |
+| **aiopolymarket** | Polymarket APIs 的 async 客户端 | Python async 客户端 | *[2026-05 起不再使用]* 类型安全（Pydantic）、自动分页、重试与 backoff。 | 曾用作市场层升级候选。 | 以仓库许可为准。 |
 
 **对标结论**：PolyWeather 与这类“全球神经天气模型”不在同一层级：PolyWeather 是“面向结算市场的产品化情报系统”，其价值核心是**将预测转成可交易/可结算的决策信息**。短中期内更高 ROI 的方向不是“自训大模型”，而是把现有“采集+后处理+市场映射”的链路做成**可复现、可观测、可评测、可扩展**的工程平台；在许可合规前提下，再评估引入外部模型推理作为额外信号源。
 ## 优先级改进建议
 
-下表按截至 `2026-04-27` 的真实状态重排优先级。已完成项不再继续列为“待做”，只保留当前仍需推进的事项。
+下表按截至 `2026-05-28` 的真实状态重排优先级。已完成项不再继续列为”待做”，只保留当前仍需推进的事项。
 | 优先级 | 改进项 | 预估工作量 | 主要收益 | 主要风险 | 可执行步骤（建议顺序） |
 | ------ | --------------------------------------------------------------------------------------------------------------------------------- | -------------------: | ------------------------------------------------------------------- | ------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| 高 | **稳定 EMOS shadow 并收紧上线门禁** | 1–2 周 | 让概率引擎升级具备明确发布条件，避免拍脑袋切换 | 当前 shadow bucket brier 退化明显，存在误上线风险 | 1) 持续积累 snapshot 样本 → 2) 定期重训与生成 `evaluation_report` / `shadow_report` / `rollout_report` → 3) 重点压 `bucket_brier` 退化 → 4) 只有门禁从 `hold` 进入 `observe/promote` 后才考虑上线 |
-| 高 | **持续积累长期训练特征，验证 SQLite 真值治理后的样本增长** | 1–2 周 | 让 EMOS/LGBM 的重训真正建立在长期可信样本上，而不是继续被短期特征缺口卡住 | 当前真值已长期化，但历史长期特征仍偏少，EMOS/LGBM 样本增长会滞后 | 1) 持续写入 `training_feature_records_store` → 2) 每日检查 `/ops` 训练数据与 `/ops/truth-history` → 3) 定期对 `Taipei` / `Shenzhen` 的历史页面回填做抽查 → 4) 观察样本是否自然增长后再重训 |
 | 中 | **把最小外部监控继续补深**：从“可告警”提升到“可运营” | 3–7 天 | 不再只知道服务坏没坏，还能看资源趋势、来源 SLA 和支付波动 | 指标过多会带来维护噪音 | 1) 增加节点 CPU/内存/磁盘 → 2) 增加 SQLite/支付体积与事件趋势 → 3) 把 HTTP/来源指标细分到城市/来源维度 → 4) 增加日报或异常摘要 |
-| 中 | **城市决策卡 AI 解读可观测性与回放测试** | 3–5 天 | 降低第三/第四/第五城市 AI 解读失败，验证缓存与队列是否真正生效 | 外部 AI stream 仍可能超时或输出截断，若无指标很难复盘 | 1) 记录 city-ai stream status/duration/retry/degraded/cache-hit/queue-depth → 2) 增加固定 METAR + detail + all_buckets fixture → 3) 回归断言 bucket 匹配、模型-市场差、温度单位与缓存 key → 4) 将生产 env 建议同步进部署文档 |
-| 中 | **市场层升级为 async + 类型安全**：引入 `aiopolymarket` 或在现有层加重试/backoff/连接池 | 4–7 天 | 行情层更稳，减少短时网络抖动；更易扩展更多市场/分页 | 依赖升级带来的行为差异 | 1) 把 requests.Session 替换为 aiohttp/httpx → 2) 在 Gamma/CLOB 调用侧实现指数退避 → 3) 引入 typed models，减少解析失败 |
+| 中 | **城市决策卡 结构化解读可观测性与回放测试** | 3–5 天 | 降低第三/第四/第五城市结构化分析 解读失败，验证缓存与队列是否真正生效 | 外部 structured detail 仍可能超时或输出截断，若无指标很难复盘 | 1) 记录 city-ai stream status/duration/retry/degraded/cache-hit/queue-depth → 2) 增加固定 METAR + detail + all_buckets fixture → 3) 回归断言 bucket 匹配、模型-市场差、温度单位与缓存 key → 4) 将生产 env 建议同步进部署文档 |
+| - | ~~市场层升级为 async + 类型安全~~ | N/A | *[v1.7.0 已移除]* 市场价格拉取层已删除，此改进项不再适用 | - | - |
 | 中 | **支付合约从“最小可用”升级到“更强合约防护”** | 1–2 周 | 在已完成的链下审计与容灾之上，进一步收紧链上授权边界 | 合约升级需要重新部署、迁移配置并再次验证 | 1) 维持现有事件重放、SQLite 审计、多 RPC fallback → 2) 升级合约到 SafeERC20 + Pausable → 3) 评估链上 plan/amount/token 绑定或 EIP-712 签名校验 → 4) 迁移后更新 PolygonScan 验证与支付审计文档 |
 | 中 | **将 CI 与分支保护/发布流程真正绑定** | 1–3 天 | 让现有 CI 从“存在”变成“强制门禁” | 历史分支/热修流程可能受影响 | 1) GitHub `main` 开启 required checks → 2) 把 release/tag 流程绑定 CI → 3) 明确热修例外流程 |
 | 低 | **引入外部神经天气模型作为附加信号**（GraphCast/FourCastNet/Pangu-Weather 等） | 2–6 周（取决于范围） | 可能提升极端/中期预测能力与差异化 | **商业许可限制**（多为 CC BY-NC-SA/禁止商业）与算力成本 | 1) 先做合规评审（权重许可/数据条款）→ 2) 仅在研究/非商业环境评估 → 3) 若要商用，优先选择可商用权重或自研/购买授权 |
@@ -206,7 +194,7 @@ Web/Telegram 请求 → FastAPI 调用采集器抓取/复用缓存 → 分析引
 ### 文档、测试与贡献流程的具体补强建议（落到仓库层面）
 
 1）**文档体系**：保留现有中文 API/TechDebt 文档的同时，增加三份“高价值”文档：
-（a）《运行与配置手册》：按环境（本地/测试/VPS/生产）列必需变量、默认值、敏感等级，并明确城市 AI 推荐配置（`POLYWEATHER_SCAN_CITY_AI_TIMEOUT_SEC=30`、`POLYWEATHER_SCAN_CITY_AI_MAX_TOKENS=900`、`POLYWEATHER_SCAN_CITY_AI_RETRY_ON_STREAM_PARSE_ERROR=true`）；（b）《数据源与合规说明》：列出 Open-Meteo、AviationWeather、NWS、HKO、CWA、Polymarket、Supabase 的使用条款要点、速率限制与降级策略（例如 AviationWeather 明确建议降低请求频率并提供 cache 文件）。 （c）《故障排查 Runbook》：429、支付 pending、市场扫描 miss、城市 AI stream timeout/JSON 截断、前端缓存异常、温度桶错配等典型故障处理。
+（a）《运行与配置手册》：按环境（本地/测试/VPS/生产）列必需变量、默认值、敏感等级，并明确城市结构化分析 推荐配置（`POLYWEATHER_SCAN_TERMINAL_BUILD_TIMEOUT_SEC=120`、`POLYWEATHER_SCAN_TERMINAL_MAX_WORKERS=8`、`POLYWEATHER_SCAN_TERMINAL_PAYLOAD_TTL_SEC=300`）；（b）《数据源与合规说明》：列出 Open-Meteo、AviationWeather、NWS、HKO、CWA、Supabase 的使用条款要点、速率限制与降级策略（例如 AviationWeather 明确建议降低请求频率并提供 cache 文件）。 （c）《故障排查 Runbook》：429、支付 pending、城市结构化分析 stream timeout/JSON 截断、前端缓存异常、温度桶错配等典型故障处理。
 2）**测试金字塔**：在现有 `trend_engine` 单测基础上，补齐：
 （a）天气 provider 的“录制回放”测试（VCR 思路：固定响应→确保解析稳定）；（b）市场层的契约测试（Gamma/CLOB schema 变更时提前失败）；（c）城市决策卡 fixture 测试（固定 `detail/market_scan/all_buckets/METAR` → 断言 bucket mapping、模型-市场差、温度单位、AI 缓存 key 与排队提示）；（d）支付链路的本地链集成测试（Hardhat/Anvil + 事件扫描回放）。这些测试能把“外部依赖漂移”尽量转成可控的回归失败。
 3）**贡献工作流**：引入 `CONTRIBUTING.md`（分支策略、PR 模板、变更日志、版本号策略）、`CODEOWNERS`（核心模块审查人）、`SECURITY.md`（漏洞披露与密钥处理），并把静态检查（ruff/eslint）作为 pre-commit + CI 必过项。
@@ -221,34 +209,33 @@ PolyWeather 的评测应围绕“结算场景”而非传统数值天气预报
 **指标** 
 1）确定性误差：MAE、RMSE（按城市、按季节、按风险等级分组）； 
 2）结算命中率：`WU_round(pred) == WU_round(actual)`（项目已有统计口径）； 
-3）概率质量：Brier Score（对离散温度桶），以及建议补充 CRPS（连续变量概率评分，EMOS 体系常用）。
 4）校准曲线：预测概率分箱的可靠性图（reliability diagram）与 Sharpness（分布集中度）。
 **基线**
 
 - Baseline A：Open-Meteo 当日最高温（或 forecast median）作为点预测；
 - Baseline B：等权平均（DEB 在历史少时也会回退此策略）；
 - Baseline C：当前 DEB；
-- Baseline D：EMOS（以 ensemble 均值/方差为输入，拟合 μ 与 σ，优化 CRPS）。
 **预期结果（定性）**
 
 - 若历史样本足够，DEB 应在“系统性偏差明显”的城市提升 MAE；
-- EMOS 类方法通常能在概率校准（可靠性与 CRPS）上更稳定，尤其当 ensemble 信息可用（项目已接入 Open-Meteo ensemble/p10/p90）。
-**算力**：以上评测全部可在 CPU 上完成；数据量按“52 城市 × 180 天”级别，pandas/duckdb 即可。若引入更复杂拟合（如分层贝叶斯/分位数回归），也通常不需要 GPU。
-### 错价信号与市场有效性基准
+**算力**：以上评测全部可在 CPU 上完成；数据量按“51 城市 × 180 天”级别，pandas/duckdb 即可。若引入更复杂拟合（如分层贝叶斯/分位数回归），也通常不需要 GPU。
+### 错价信号与市场有效性基准 *[v1.7.0 已暂停]*
+
+> **2026-05-23 更新**：Polymarket 价格拉取层与市场扫描（`market_scan`）已于 v1.7.0 移除。本节基准评测方案暂不适用，留待未来若重新引入市场数据层时参考。
 
 **数据集**
 
-- 保存每次扫描输出：`date/city/bucket/bucket_label/bucket_direction/model_probability/market_implied/model_market_diff/yes_buy/quote_source/liquidity/matching_reason`，并加上未来 `settled_bucket` 作为标签；Polymarket 市场发现与报价来自 Gamma/CLOB（官方文档说明三套 API：Gamma/Data/CLOB）。
+- 若恢复：保存每次扫描输出：`date/city/bucket/bucket_label/bucket_direction/model_probability/market_implied/model_market_diff/yes_buy/quote_source/liquidity/matching_reason`，并加上未来 `settled_bucket` 作为标签。
 **指标**
 
 - Signal 覆盖率：能否找到正确 market / bucket；
 - Edge 稳健性：不同流动性分位的 edge 分布；
-- 交易模拟（如需）：在考虑滑点/手续费/成交概率下的期望收益（即使项目当前只读，也可以离线评估“若执行”会怎样）。
+- 交易模拟（如需）：在考虑滑点/手续费/成交概率下的期望收益。
 **基线**
 
 - 简单策略：仅用市场中间价（不做模型）作为概率；
 - 当前策略：模型概率 vs 市场概率 edge 阈值；
-- 改进策略：引入“流动性/盘口深度/波动”作为信号置信度（aiopolymarket/py-clob-client 提供更完整的盘口读取能力）。
+- 改进策略：引入”流动性/盘口深度/波动”作为信号置信度。
 **算力**：CPU 即可；关键在于数据采样与回放。
 ## 路线图与风险缓解
 
@@ -256,20 +243,21 @@ PolyWeather 的评测应围绕“结算场景”而非传统数值天气预报
 | 时间窗 | 里程碑 | 交付物 | 资源/备注 |
 | ----------- | ----------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------- |
 | 第 1 周 | 城市决策卡稳定性补强 | city-ai stream/cache/queue 指标；固定 METAR + `all_buckets` fixture；温度桶匹配与模型-市场差回归测试；生产 env 文档化 | 前端为主，后端补指标 |
-| 第 2 周 | 市场层与 Scan Terminal 数据回放 | 保存 `bucket_label/bucket_direction/model_market_diff/matching_reason`；支持回放第三/第四/第五城市 AI 解读失败案例 | 用真实失败样本压回归 |
-| 第 3–4 周 | EMOS 与长期特征继续收口 | 持续积累 `training_feature_records_store`；定期生成 evaluation/shadow/rollout report；继续观察 `bucket_brier` 是否退出 hold | 数据工程为主 |
-| 第 4–5 周 | 监控深挖与运维日报 | 来源 SLA、城市维度延迟、AI stream 状态、SQLite 体积、支付事件趋势、异常摘要 | 避免指标过多，先覆盖高频故障 |
+| 第 2 周 | 市场层与 Scan Terminal 数据回放 | 保存 `bucket_label/bucket_direction/model_market_diff/matching_reason`；支持回放第三/第四/第五城市结构化分析 解读失败案例 | 用真实失败样本压回归 |
+| 第 4–5 周 | 监控深挖与运维日报 | 来源 SLA、城市维度延迟、structured detail 状态、SQLite 体积、支付事件趋势、异常摘要 | 避免指标过多，先覆盖高频故障 |
 | 第 6 周 | 支付合约与发布门禁升级 | SafeERC20/Pausable 方案评审；CI required checks 与 release/tag 流程绑定；热修例外流程 | 合约升级需单独部署验证 |
 
 ### 主要风险与缓解策略
 
-**外部 API / AI provider 速率限制与格式变更**：AviationWeather 明确 rate limit 与建议使用 cache 文件；Open-Meteo 也可能在不同端点策略上变化；OpenAI-compatible city AI stream 可能出现 timeout、stream JSON 截断或并发竞争。缓解：统一“请求预算”与退避/熔断；关键响应做 schema 校验与回放测试；对高频数据优先拉取官方 cache/批量接口（若可用）；城市 AI 保持小并发队列、30s timeout、stream parse retry、页面内存缓存与 degraded fallback。
+**外部 API / AI provider 速率限制与格式变更**：AviationWeather 明确 rate limit 与建议使用 cache 文件；Open-Meteo 也可能在不同端点策略上变化；OpenAI-compatible city structured detail 可能出现 timeout、stream JSON 截断或并发竞争。缓解：统一“请求预算”与退避/熔断；关键响应做 schema 校验与回放测试；对高频数据优先拉取官方 cache/批量接口（若可用）；城市结构化分析 保持小并发队列、30s timeout、stream parse retry、页面内存缓存与 degraded fallback。
 **密钥泄露与权限滥用**：Supabase 明确强调 `service_role` 属高权限密钥，绝不可出现在前端或公开环境。缓解：密钥分级、CI secret scan、运行时最小权限、日志脱敏。
 **支付链路最终一致性与链上不确定性**：链上事件索引延迟、RPC 不稳定、交易确认数不足都会导致误判。当前项目已经补齐“事件监听 + 确认补单”双路径、事件重放脚本、SQLite 审计事件与多 RPC fallback；现阶段的主要剩余风险不再是“没有防护”，而是链上合约仍为最小实现，owner 为单地址管理，且没有 pause 开关与 SafeERC20。
 **引入外部神经天气模型的商业合规风险**：GraphCast/Pangu-Weather 的权重许可均带非商业限制（CC BY-NC-SA/BY-NC-SA）；若 PolyWeather 是付费产品，必须先做法务与授权评审。缓解：只在研究环境评估；商用优先选择可商用权重/购买授权/自研。
 **代码公开与生产私有资产边界导致的“公开仓库与生产行为不一致”**：README 明确品牌、商标、生产私有数据与运营阈值不在代码许可证授权范围内。缓解：把“公开核心”的可复现与评测做扎实（接口/数据 schema/测试/评测），私有策略只作为可插拔 policy layer 接入。
 ## 参考链接
 
+> **v1.7.0 注**：以下 Polymarket 相关链接已不再被项目使用，保留作为历史参考。
+
 - PolyWeather 仓库（本次评估对象）：https://github.com/yangyuan-zhen/PolyWeather
 - Polymarket API 文档（Gamma/Data/CLOB）：https://docs.polymarket.com/api-reference
 - AviationWeather Data API（METAR 等）：https://aviationweather.gov/data/api/
@@ -282,5 +270,3 @@ PolyWeather 的评测应围绕“结算场景”而非传统数值天气预报
 - Pangu-Weather（权重 BY-NC-SA，禁商用）：https://github.com/198808xc/Pangu-Weather
 - Polymarket 官方 Python CLOB SDK（MIT）：https://github.com/Polymarket/py-clob-client
 - aiopolymarket（async、类型安全）：https://github.com/the-odds-company/aiopolymarket
-
-

docs/frontend-ui-design-review.md

@@ -134,7 +134,7 @@
 
 2. **Tab 下划线指示器不够明显**：`2px` 高度 + `opacity: 0.8` 的蓝色下划线容易被忽略。
 
-3. **按钮层级不够清晰**：`.scan-primary-button`（蓝紫渐变）、`.scan-ai-button`（青绿渐变）、`.scan-ai-city-icon-button`（蓝色边框半透明）、`.scan-theme-button`（无边框无背景）四种视觉权重混在一起，用户难以判断优先级。
+3. **按钮层级不够清晰**：`.scan-primary-button`（蓝紫渐变）、`.scan-ai-button`（青绿渐变）、`.scan-city-icon-button`（蓝色边框半透明）、`.scan-theme-button`（无边框无背景）四种视觉权重混在一起，用户难以判断优先级。
 
 4. **空状态/加载状态设计不一致**：
    - 地图加载有精美的云/雷达/热力动画
@@ -233,7 +233,7 @@
    - Tab 切换缺少 `role="tablist"`/`role="tab"`/`aria-selected`
    - 折叠按钮缺少 `aria-expanded`
 
-2. **焦点指示器不可见**：自定义按钮（如 `scan-theme-button`、`scan-ai-city-icon-button`）没有 focus-visible 样式
+2. **焦点指示器不可见**：自定义按钮（如 `scan-theme-button`、`scan-city-icon-button`）没有 focus-visible 样式
 
 3. **颜色不是唯一的信息传达方式**：风险等级、Market decision 的色彩编码缺少对应的文字标签或图标补充
 

docs/operations/user-growth-history.json

@@ -0,0 +1,10 @@
+[
+  {
+    "recorded_at": "2026-06-12T23:32:49+08:00",
+    "total_registered_users": 588,
+    "verified_users": 573,
+    "ever_signed_in_users": 561,
+    "source": "supabase_auth_admin",
+    "note": "Baseline recorded before verified-user growth milestone rewards launched."
+  }
+]

docs/payments/PAYMENT_AUDIT_ZH.md

@@ -1,6 +1,6 @@
 # PolyWeather 支付审计与防护说明
 
-最后更新：`2026-03-21`
+最后更新：`2026-05-29`
 
 ## 1. 当前已落地的防护
 
@@ -19,9 +19,9 @@
 
 ### 事件确认边界
 
-- 后端只认链上 `OrderPaid` 事件。
+- 后端只认链上可验证事件：checkout 合约路径认 `OrderPaid`，直转路径认对应链上 USDC `Transfer`。
 - 前端提交 intent 不会直接视为支付完成。
-- `confirm_loop` 会再次按链上交易与确认数校验 intent。
+- `confirm_loop` 会再次按 intent 的 `chain_id`、`token_address`、收款地址、金额与确认数校验链上交易。
 - 若确认失败，当前会明确把 intent / transaction 落为失败态，而不是长期停留在 `submitted`。
 
 当前已显式识别的失败原因包括：
@@ -29,19 +29,23 @@
 - `receiver_mismatch`
 - `sender_mismatch`
 - `event_mismatch`
+- `token_mismatch`
 - `tx_reverted`
 
 ### RPC 多节点容灾
 
-- 支持 `POLYWEATHER_PAYMENT_RPC_URLS`
+- 支持默认链 `POLYWEATHER_PAYMENT_RPC_URLS`
+- 支持多链 `POLYWEATHER_PAYMENT_RPC_URLS_BY_CHAIN_JSON`
 - 格式示例：
 
 ```env
 POLYWEATHER_PAYMENT_RPC_URLS=https://polygon-rpc.com,https://polygon-bor-rpc.publicnode.com
+POLYWEATHER_PAYMENT_RPC_URLS_BY_CHAIN_JSON={"137":["https://polygon-rpc.com","https://polygon-bor-rpc.publicnode.com"],"1":["https://ethereum-rpc.example"]}
 ```
 
 - 启动时按顺序探活。
 - 当前节点断连或收据查询失败时，会自动切换到下一个可用 RPC。
+- 多链支付确认不会用默认链硬查交易；每笔 intent 会按自己的 `chain_id` 选择 RPC。
 
 ### 事件重放
 
@@ -87,8 +91,24 @@ python scripts/replay_payment_events.py --from-block 10000000 --to-block 1000100
 - 已付款但未开通
 - 打到旧收款地址
 - 交易事件不匹配
+- 用户在钱包默认 Ethereum 网络付款，但旧系统只按 Polygon intent 查账
 
-## 2. 当前合约的授权边界
+## 2. 当前支付链路边界
+
+当前支持两类链路：
+
+1. Polygon checkout 合约
+- 前端钱包支付会先切到 Polygon。
+- 后端创建 intent 后给出合约 `tx_payload`。
+- 确认时校验 `OrderPaid(orderId, payer, planId, amount, token)`。
+
+2. Ethereum 主网 USDC 直转
+- 前端展示 Ethereum 网络、USDC 合约、收款钱包和金额。
+- 用户提交 tx hash 后，后端按 `intent.chain_id=1` 查询 Ethereum RPC。
+- 确认时校验 USDC `Transfer(from, to, amount)` 的 `to`、`token_address` 和金额。
+- 这条链路不依赖 Polygon checkout 合约，适合处理“用户钱包默认网络付款”的真实行为。
+
+## 3. 当前合约的授权边界
 
 合约源码：
 - [PolyWeatherCheckout.sol](/E:/web/PolyWeather/contracts/PolyWeatherCheckout.sol)
@@ -110,7 +130,7 @@ python scripts/replay_payment_events.py --from-block 10000000 --to-block 1000100
 4. 订单边界
 - 同一个 `orderId` 只能成功支付一次
 
-## 3. 重入与重复支付判断
+## 4. 重入与重复支付判断
 
 当前合约的 `pay` 逻辑顺序是：
 
@@ -136,7 +156,7 @@ python scripts/replay_payment_events.py --from-block 10000000 --to-block 1000100
 - **最小可用支付合约**
 - 不是“全功能强防护合约”
 
-## 4. 当前静态审计结论
+## 5. 当前静态审计结论
 
 已提供脚本：
 - [check_payment_contract_security.py](/E:/web/PolyWeather/scripts/check_payment_contract_security.py)
@@ -160,7 +180,7 @@ python scripts/check_payment_contract_security.py
 - 是否使用 SafeERC20
 - 是否在链上绑定套餐价格
 
-## 5. 当前主要剩余风险
+## 6. 当前主要剩余风险
 
 1. 单地址 owner
 - 建议把 `owner` 迁移到多签钱包
@@ -175,7 +195,7 @@ python scripts/check_payment_contract_security.py
 - 当前使用 `IERC20.transferFrom`
 - 升级版合约更建议改为 OpenZeppelin `SafeERC20`
 
-## 6. 推荐操作
+## 7. 推荐操作
 
 ### 每次支付配置变更后
 
@@ -233,7 +253,7 @@ docker compose exec polyweather_web python scripts/reconcile_subscription_by_ema
 - 用户声称已付费但未开通
 - 需要快速确认最近一笔 intent 是否能自动恢复
 
-## 7. 下一版合约建议
+## 8. 下一版合约建议
 
 如果后续升级合约，优先级建议：
 

docs/payments/POLYGONSCAN_VERIFY.md

@@ -1,4 +1,4 @@
-# PolyWeatherCheckout PolygonScan 验证（v1.5.1）
+# PolyWeatherCheckout PolygonScan 验证（v1.8.1）
 
 最后更新：`2026-03-20`
 

docs/product-review-jun-2026.md

@@ -0,0 +1,69 @@
+# PolyWeather 前端产品审查报告
+
+> 审查日期：2026-06 | 视角：产品经理 | 范围：`frontend/` 全部页面、组件、用户流程 | 最后校准：2026-05-28
+
+## 一、产品概览
+
+PolyWeather 是一个面向天气衍生品交易者的气象情报平台。核心价值主张：**结合多模型气象预报 + 结构化实况层 + Polymarket 市场价格，为交易决策提供一站式证据链。**
+
+### 产品分层
+
+| 层级 | 功能 | 门槛 |
+|------|------|------|
+| 免费 | 交互式全球天气地图 + 城市简报 | 无需登录 |
+| Pro 试用 | 3 天全功能 | 注册后自动获得 |
+| Pro 订阅 | 城市决策卡（结构化实况 + 模型证据 + 市场层）、日内分析、历史对账、未来预报 | 月付 29.9 USDC / 30 天，季度 79.9 USDC / 90 天（月付最多抵 3 USDC，季度最多抵 8 USDC） |
+
+### 页面结构（9 个路由）
+
+| 路由 | 功能 | 是否必需登录 |
+|------|------|-------------|
+| `/` | 主看板 — 实时天气决策台 | 否 |
+| `/account` | 账户中心 — 身份/订阅/钱包/积分/Bot 绑定 | 是 |
+| `/auth/login` | 登录页（Google OAuth + 邮箱密码） | 否 |
+| `/docs/[...slug]` | 产品文档中心（8 篇双语文档） | 否 |
+| `/subscription-help` | 订阅 FAQ（双语） | 否 |
+| `/entitlement-required` | 访问被拒页面 | 否 |
+| `/ops` | 运营管理后台 | 是（管理员） |
+| `/ops/truth-history` | 真值历史查看器 | 是（管理员） |
+
+## 二、用户流程分析
+
+### 主看板的两个视图
+
+```
+┌─ 分布视图（地图） ──────────────────────────────┐
+│  Leaflet 交互式地图，城市彩色气泡                      │
+│  点击城市 → 自动添加到决策卡工作区 + 切换到卡片视图          │
+│  免费用户和 Pro 用户均可使用                            │
+├─ 决策卡（分析） ──────────────────────────────┤
+│  钉选的城市卡片：结构化实况 + 模型集群 + 市场层 + 实时图表     │
+│  需要 Pro 订阅                                        │
+└──────────────────────────────────────────────┘
+        └── 右侧栏：城市简报面板（始终可见，免费可用）
+```
+
+### 关键用户路径
+
+1. **新用户落地** → 看到 3 步引导 → 地图 + 城市列表 → 点击城市 → 看到城市简报 → 想深入分析 → 遇到 Pro 付费墙（含功能说明）
+2. **Pro 用户工作流** → 地图选城市 → 自动钉选到决策卡 → 展开卡片 → 查看实测/DEB/概率/市场层 → 判断交易方向
+
+## 三、做得好的地方
+
+1. **地图 → 决策卡的自动流转设计** — 点击地图城市自动钉选到分析工作区并切换视图，"零步骤发现"
+2. **双语覆盖完整** — 所有 UI 文案、文档、结构化解读都有中英文对照，覆盖率接近 100%
+3. **数据新鲜度可视化** — DataFreshnessBar 让用户一眼看到 METAR/模型/市场数据的新鲜度
+4. **结构化解读的产品化程度高** — 分层展示：快速判断 → 完整解读 → 证据链 → 风险提示
+5. **免费层有实际价值** — 地图 + 城市简报不是"空壳"，用户可以看真实气象数据
+6. **支付链路完整** — 从钱包绑定到链上签约到支付恢复，处理了多种异常情况
+7. **空状态有引导文字** — "Click a city on the map" 告诉用户下一步做什么
+8. **浅色/深色主题都有** — 两个主题都经过完整设计
+9. **Ops 面板功能齐全** — 系统健康、转化漏斗、缓存状态、支付异常、用户管理一览无余
+
+## 四、存在的问题与待办
+
+| # | 问题 | 优先级 |
+|---|------|------|
+| 1 | **Docs 无搜索** — 8 篇文档没有搜索功能，用户必须逐篇浏览 | 🟢 待做 |
+| 2 | **Ops 面板无审计日志** — 管理员补发积分等操作没有审计记录 | 🟢 需后端 |
+| 3 | **注册后邮件验证引导** — 未验证邮箱的用户反复登录失败 | 🟡 需后端 |

docs/social/2026-06-12-growth-rewards-x-post.md

@@ -0,0 +1,32 @@
+# PolyWeather Growth Rewards
+
+PolyWeather has reached **588 registered users**.
+
+That number matters because every new user helps us improve the product: more
+feedback, more real-world usage, and more pressure to make weather observations
+faster, clearer, and more reliable for prediction-market decisions.
+
+We are introducing **PolyWeather Growth Rewards**.
+
+From now on, verified-user milestones will unlock additional Pro time for every
+active paid member:
+
+- 600 verified users: **+1 Pro day**
+- 750 verified users: **+2 Pro days**
+- 1,000 verified users: **+3 Pro days**
+- Every additional 100 verified users after 1,000: **+3 Pro days**
+
+Rewards are issued automatically to active paid members when each milestone is
+reached. Every milestone can only be claimed once.
+
+This is separate from our referral program. Referrals still reward the people
+who directly help PolyWeather grow, while Growth Rewards let all paying members
+share in the progress of the community.
+
+We currently have **588 registered users**, including **573 verified users**.
+The first Growth Reward unlocks at 600 verified users.
+
+Grow together. Earn more Pro time.
+
+https://polyweather.top
+

docs/superpowers/plans/2026-05-15-amsc-awos-runway-observations.md

@@ -0,0 +1,102 @@
+# AMSC AWOS Runway Observation Implementation Plan
+
+> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
+
+**Goal:** Add a China-only AMSC AWOS runway observation source and expose it as a runway observation tab next to Market Monitor.
+
+**Architecture:** Backend fetches and normalizes AMSC `getWindPlate?cccc=...` payloads into the existing `amos`/`runway_obs` shape so current dashboard consumers can reuse runway display logic. Frontend adds a dedicated `runway` scan terminal tab that fetches a domestic city whitelist and renders runway TDZ/MID/END air temperatures without changing settlement anchors.
+
+**Tech Stack:** Python data collection + pytest, Next.js/React TypeScript, existing business-state test runner.
+
+---
+
+### Task 1: Backend parser and source
+
+**Files:**
+- Create: `src/data_collection/amsc_awos_sources.py`
+- Create: `tests/test_amsc_awos_sources.py`
+- Modify: `src/data_collection/weather_sources.py`
+- Modify: `src/data_collection/country_networks.py`
+
+- [ ] **Step 1: Write failing parser tests**
+
+Add tests that import `_amsc_parse_wind_plate_payload`, `_amsc_supported_city_codes`, and `AmscAwosSourceMixin`, parse a ZBAA-style sample, assert runway point temperatures, UTC observation conversion, `runway_temp_range`, and unauthorized/no-data fallback.
+
+- [ ] **Step 2: Run red test**
+
+Run: `python -m pytest tests/test_amsc_awos_sources.py -q`
+Expected: FAIL because `src.data_collection.amsc_awos_sources` does not exist.
+
+- [ ] **Step 3: Implement minimal backend source**
+
+Create a source module with China whitelist: `shanghai=ZSPD`, `beijing=ZBAA`, `guangzhou=ZGGG`, `shenzhen=ZGSZ`, `chengdu=ZUUU`, `chongqing=ZUCK`, `wuhan=ZHHH`, `qingdao=ZSQD`. Fetch `https://www.amsc.net.cn/gateway/api/saas/rest/amc/AwosController/getWindPlate?cccc=<ICAO>`, optionally using `POLYWEATHER_AMSC_COOKIE` or `POLYWEATHER_AMSC_SESSION_ID`, and return existing-compatible `amos` payload with `source="amsc_awos"`.
+
+- [ ] **Step 4: Run green backend tests**
+
+Run: `python -m pytest tests/test_amsc_awos_sources.py tests/test_amos_station_sources.py -q`
+Expected: PASS.
+
+### Task 2: Backend integration
+
+**Files:**
+- Modify: `src/data_collection/weather_sources.py`
+- Modify: `src/data_collection/country_networks.py`
+
+- [ ] **Step 1: Attach AMSC after AMOS**
+
+Add `AmscAwosSourceMixin` to `WeatherDataCollector`, call `_attach_china_amsc_awos_data` in both Open-Meteo and fallback paths, and persist aggregate plus first runway rows to `airport_obs_log` like AMOS.
+
+- [ ] **Step 2: Normalize airport primary source labels**
+
+Teach `_airport_primary_from_raw` that `raw["amos"].source == "amsc_awos"` should use `source_code="amsc_awos"`, `source_label="AMSC AWOS"`.
+
+- [ ] **Step 3: Compile check**
+
+Run: `python -m py_compile src/data_collection/amsc_awos_sources.py src/data_collection/weather_sources.py src/data_collection/country_networks.py`
+Expected: exit 0.
+
+### Task 3: Frontend runway tab
+
+**Files:**
+- Create: `frontend/components/dashboard/scan-terminal/RunwayObservationsPanel.tsx`
+- Create: `frontend/components/dashboard/scan-terminal/__tests__/runwayObservationTab.test.ts`
+- Modify: `frontend/components/dashboard/scan-terminal/ScanTerminalShellParts.tsx`
+- Modify: `frontend/components/dashboard/ScanTerminalDashboard.tsx`
+- Modify: `frontend/lib/dashboard-types.ts`
+- Modify: `frontend/components/dashboard/monitoring/monitor-temperature.ts`
+- Modify: `frontend/components/dashboard/monitoring/MonitorPanel.tsx`
+
+- [ ] **Step 1: Write failing frontend business-state test**
+
+Add a source-scan test asserting `ScanTerminalContentView` includes `runway`, dashboard has a `跑道观测` tab, and the panel includes `AMSC AWOS` plus TDZ/MID/END labels.
+
+- [ ] **Step 2: Run red frontend test**
+
+Run: `cd frontend; npm run test:business`
+Expected: FAIL because the runway tab/panel strings do not exist yet.
+
+- [ ] **Step 3: Implement tab and panel**
+
+Add `runway` view next to Monitor. The panel fetches domestic whitelist details with `ensureCityDetail(key, false, "panel")`, displays city cards with runway rows and local-time labels, and uses a not-available message for cities without AMSC data.
+
+- [ ] **Step 4: Run green frontend checks**
+
+Run: `cd frontend; npm run test:business; npm run typecheck`
+Expected: PASS.
+
+### Task 4: Final verification and publish
+
+**Files:**
+- All changed files from Tasks 1-3.
+
+- [ ] **Step 1: Full verification**
+
+Run backend tests, Python compile, frontend business tests, typecheck, and build.
+
+- [ ] **Step 2: Completion audit**
+
+Map user requirement “国内几个城市的机场跑道温度，放在市场监控旁边 Tab” to changed backend source, frontend tab, tests, and build evidence.
+
+- [ ] **Step 3: Commit/push/deploy**
+
+If verification passes, commit, push `main`, and rely on configured deployment.

docs/superpowers/plans/2026-05-18-telegram-group-pricing.md

@@ -0,0 +1,61 @@
+# Telegram Group Pricing Implementation Plan
+
+> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (- [ ]) syntax for tracking.
+
+**Goal:** Add Telegram Login verification so backend decides Pro price: group member 5U, non-member 10U.
+
+**Architecture:** Keep Supabase as the website account session, add Telegram Login as an identity link/price verification step. Backend verifies Telegram Login hash, checks getChatMember, stores the Telegram link in existing supabase_bindings, and payment intent creation recalculates price server-side.
+
+**Tech Stack:** FastAPI, existing DBManager bindings, Telegram Bot HTTP API, Next.js proxy routes, React account center, pytest.
+
+---
+
+### Task 1: Telegram auth service
+
+**Files:**
+- Create: src/auth/telegram_group_pricing.py
+- Test: 	ests/test_telegram_group_pricing.py
+
+- [ ] Verify Telegram Login payload HMAC using bot token.
+- [ ] Call Telegram getChatMember and treat member, dministrator, creator as group members.
+- [ ] Return 5U/10U pricing payload.
+
+### Task 2: Backend auth route
+
+**Files:**
+- Modify: web/core.py
+- Modify: web/services/auth_api.py
+- Modify: web/routers/auth.py
+
+- [ ] Add TelegramLoginRequest model.
+- [ ] Add POST /api/auth/telegram/login requiring Supabase identity.
+- [ ] Link Telegram id to current Supabase user via DBManager.bind_supabase_identity.
+- [ ] Return Telegram member status and effective price.
+
+### Task 3: Payment dynamic price
+
+**Files:**
+- Modify: src/payments/contract_checkout.py
+- Modify: web/services/payment_api.py
+
+- [ ] At payment intent creation, check linked Telegram id and group membership.
+- [ ] Override pro_monthly amount to 5U for members, 10U otherwise.
+- [ ] Store pricing source in metadata.
+
+### Task 4: Frontend Telegram Login entry
+
+**Files:**
+- Modify: rontend/components/account/AccountCenter.tsx
+- Create: rontend/app/api/auth/telegram/login/route.ts
+
+- [ ] Load Telegram Login widget with configured bot username.
+- [ ] Send payload to backend proxy.
+- [ ] Show group/member price status before checkout.
+
+### Task 5: Verification
+
+**Commands:**
+- python -m pytest tests\test_telegram_group_pricing.py tests\test_direct_payment.py tests\test_payments_runtime.py -q
+- python -m py_compile src\auth\telegram_group_pricing.py src\payments\contract_checkout.py web\core.py web\services\auth_api.py
+- python -m ruff check src\auth\telegram_group_pricing.py src\payments\contract_checkout.py web\core.py web\services\auth_api.py tests\test_telegram_group_pricing.py
+- cd frontend; npm run typecheck

docs/superpowers/plans/2026-05-25-terminal-continent-grouping-plan.md

@@ -0,0 +1,929 @@
+# 终端城市表格按大洲分组 — 实施计划
+
+> **For agentic workers:** 使用 superpowers:subagent-driven-development 或 superpowers:executing-plans 按任务逐步实施。
+
+**目标:** 将扫描终端的平铺城市表格重构为按时区分组 + Active Signals 虚拟分组的金融终端风格，桌面端 9 列可折叠分组表格，移动端 Tab 切换 + 卡片流。
+
+**架构:** 抽取分组逻辑到 `continent-grouping.ts`，新增 `ContinentGroupHeader`、`MobileCityCard`、`MobileRegionTabs` 三个子组件，重构 `ScanTerminalDashboard.tsx` 中的 `KoyfinWeatherTerminal` 和 `MarketTable`。数据字段全部就绪，后端零改动。
+
+**技术栈:** React 19 + TypeScript + Tailwind CSS 3 + CSS Modules
+
+---
+
+### Task 1: 创建 continent-grouping.ts 分组逻辑
+
+**文件:**
+- 创建: `frontend/components/dashboard/scan-terminal/continent-grouping.ts`
+
+这个文件负责所有分组逻辑：按 `trading_region` 分桶、Active Signals 筛选、折叠状态管理、Gap 颜色映射。
+
+- [ ] **Step 1: 写入 continent-grouping.ts**
+
+```typescript
+import type { ScanOpportunityRow } from "@/lib/dashboard-types";
+
+// 7 trading regions from backend scan_terminal_filters.py
+export const TRADING_REGIONS = [
+  { key: "east_asia", labelEn: "East Asia", labelZh: "东亚", sort: 1 },
+  { key: "southeast_asia", labelEn: "Southeast Asia", labelZh: "东南亚", sort: 2 },
+  { key: "central_asia", labelEn: "Central / South Asia", labelZh: "中亚 / 南亚", sort: 3 },
+  { key: "west_asia", labelEn: "West Asia / Middle East", labelZh: "西亚 / 中东", sort: 4 },
+  { key: "europe_africa", labelEn: "Europe / Africa", labelZh: "欧洲 / 非洲", sort: 5 },
+  { key: "south_america", labelEn: "Latin America", labelZh: "拉美", sort: 6 },
+  { key: "north_america", labelEn: "North America", labelZh: "北美", sort: 7 },
+] as const;
+
+export type TradingRegionKey = (typeof TRADING_REGIONS)[number]["key"];
+
+export interface ContinentGroup {
+  key: string; // "active_signals" | TradingRegionKey
+  labelEn: string;
+  labelZh: string;
+  sort: number;
+  rows: ScanOpportunityRow[];
+  activeCount: number;
+  watchCount: number;
+  hotCity: string | null;
+  localTimeRange: string | null;
+}
+
+export function isActiveSignal(row: ScanOpportunityRow): boolean {
+  const decision = String(row.ai_decision || row.v4_metar_decision || "").toLowerCase();
+  if (decision.includes("approve")) return true;
+  if (row.tradable && row.active) return true;
+  return false;
+}
+
+export function isWatchSignal(row: ScanOpportunityRow): boolean {
+  const decision = String(row.ai_decision || row.v4_metar_decision || row.signal_status || "").toLowerCase();
+  if (decision.includes("watch")) return true;
+  if (decision.includes("monitor")) return true;
+  if (!row.tradable && row.active) return true;
+  return false;
+}
+
+export function isDeadSignal(row: ScanOpportunityRow): boolean {
+  if (row.closed) return true;
+  const decision = String(row.ai_decision || row.v4_metar_decision || "").toLowerCase();
+  if (decision.includes("veto")) return true;
+  return false;
+}
+
+export function getSignalState(row: ScanOpportunityRow): "active" | "watch" | "closed" | "data" {
+  if (isDeadSignal(row)) return "closed";
+  if (isActiveSignal(row)) return "active";
+  if (isWatchSignal(row)) return "watch";
+  return "data";
+}
+
+export function getSignalLabel(state: ReturnType<typeof getSignalState>, isEn: boolean): string {
+  switch (state) {
+    case "active": return isEn ? "◆ Active" : "◆ 活跃";
+    case "watch": return isEn ? "● Watch" : "● 观察";
+    case "closed": return isEn ? "○ Closed" : "○ 关闭";
+    case "data": return isEn ? "! Data" : "! 数据";
+  }
+}
+
+export type GapColor = "green" | "orange" | "slate" | "gray" | "red";
+
+export function getGapColor(row: ScanOpportunityRow): GapColor {
+  const gap = Number(row.signed_gap ?? row.gap_to_target);
+  const edge = Number(row.edge_percent || 0);
+  const spread = Number(row.spread || 0);
+  const liq = Number(row.book_liquidity || row.market_liquidity || 0);
+
+  if (!Number.isFinite(gap)) return "gray";
+  if (liq <= 0 || spread > 20) return "red";
+  if (gap >= 2) return "green";
+  if (gap >= 0 && edge > 5) return "orange";
+  if (gap >= 0) return "slate";
+  if (gap < -5 || edge < -10) return "gray";
+  return "slate";
+}
+
+export const GAP_COLOR_MAP: Record<GapColor, string> = {
+  green: "text-emerald-600",
+  orange: "text-amber-600",
+  slate: "text-slate-500",
+  gray: "text-slate-400",
+  red: "text-red-500",
+};
+
+export function formatPrice(midpoint?: number | null, ask?: number | null, bid?: number | null): string {
+  const m = Number(midpoint);
+  if (Number.isFinite(m) && m > 0) {
+    const cents = Math.round(m * 100);
+    return `Y ${cents}¢`;
+  }
+  const a = Number(ask);
+  if (Number.isFinite(a) && a > 0) {
+    const cents = Math.round(a * 100);
+    return `Y ${cents}¢`;
+  }
+  return "--";
+}
+
+export function formatSpreadLiquidity(spread?: number | null, liquidity?: number | null): string {
+  const sp = Number(spread);
+  const liq = Number(liquidity);
+  const spStr = Number.isFinite(sp) ? `${Math.round(sp)}¢` : "--";
+  const liqStr = Number.isFinite(liq)
+    ? liq >= 1000
+      ? `$${(liq / 1000).toFixed(1)}K`
+      : `$${Math.round(liq)}`
+    : "--";
+  return `${spStr} / ${liqStr}`;
+}
+
+export function buildContinentGroups(rows: ScanOpportunityRow[], isEn: boolean): ContinentGroup[] {
+  const regionMap = new Map<string, ScanOpportunityRow[]>();
+
+  for (const row of rows) {
+    const region = String(row.trading_region || "unknown").toLowerCase();
+    if (!regionMap.has(region)) regionMap.set(region, []);
+    regionMap.get(region)!.push(row);
+  }
+
+  const groups: ContinentGroup[] = [];
+
+  // Active Signals virtual group
+  const activeRows = rows.filter((r) => isActiveSignal(r));
+  if (activeRows.length > 0) {
+    const hotRow = activeRows.reduce((best, r) =>
+      Number(r.edge_percent || 0) > Number(best.edge_percent || 0) ? r : best
+    );
+    groups.push({
+      key: "active_signals",
+      labelEn: "Active Signals",
+      labelZh: "活跃信号",
+      sort: 0,
+      rows: activeRows,
+      activeCount: activeRows.filter((r) => isActiveSignal(r)).length,
+      watchCount: activeRows.filter((r) => isWatchSignal(r)).length,
+      hotCity: hotRow?.city_display_name || hotRow?.city || null,
+      localTimeRange: null,
+    });
+  }
+
+  for (const region of TRADING_REGIONS) {
+    const regionRows = regionMap.get(region.key) || [];
+    if (regionRows.length === 0) continue;
+
+    const activeCount = regionRows.filter((r) => isActiveSignal(r)).length;
+    const watchCount = regionRows.filter((r) => isWatchSignal(r)).length;
+    const sorted = [...regionRows].sort((a, b) =>
+      Number(b.final_score || 0) - Number(a.final_score || 0)
+    );
+    const hotCity = sorted[0]?.city_display_name || sorted[0]?.city || null;
+
+    // Compute local time range for this region
+    const times = regionRows.map((r) => String(r.local_time || "").trim()).filter(Boolean);
+    const ltRange = times.length >= 2
+      ? `${times[0]}-${times[times.length - 1]}`
+      : times[0] || null;
+
+    groups.push({
+      key: region.key,
+      labelEn: region.labelEn,
+      labelZh: region.labelZh,
+      sort: region.sort,
+      rows: regionRows,
+      activeCount,
+      watchCount,
+      hotCity,
+      localTimeRange: ltRange,
+    });
+  }
+
+  // Sort: active_signals first, then by trading_region_sort
+  groups.sort((a, b) => a.sort - b.sort);
+  return groups;
+}
+
+export function getDefaultExpanded(groups: ContinentGroup[]): Set<string> {
+  const expanded = new Set<string>();
+  for (const g of groups) {
+    if (g.key === "active_signals") {
+      expanded.add(g.key);
+    } else if (g.activeCount > 0 || g.watchCount > 0) {
+      expanded.add(g.key);
+    }
+  }
+  return expanded;
+}
+```
+
+- [ ] **Step 2: 验证 TypeScript 类型**
+
+```bash
+cd frontend && npx tsc --noEmit src/components/dashboard/scan-terminal/continent-grouping.ts 2>&1 || true
+```
+
+预期：类型通过（可能有模块路径的错误，这些在组件集成后解决）。
+
+- [ ] **Step 3: 提交**
+
+```bash
+git add frontend/components/dashboard/scan-terminal/continent-grouping.ts
+git commit -m "新增终端大洲分组逻辑模块"
+```
+
+---
+
+### Task 2: 创建 ContinentGroupHeader.tsx 分组标题行组件
+
+**文件:**
+- 创建: `frontend/components/dashboard/scan-terminal/ContinentGroupHeader.tsx`
+
+- [ ] **Step 1: 写入组件**
+
+```tsx
+"use client";
+
+import { ChevronDown, ChevronRight } from "lucide-react";
+import type { ContinentGroup } from "@/components/dashboard/scan-terminal/continent-grouping";
+
+export function ContinentGroupHeader({
+  group,
+  isExpanded,
+  isEn,
+  onToggle,
+}: {
+  group: ContinentGroup;
+  isExpanded: boolean;
+  isEn: boolean;
+  onToggle: () => void;
+}) {
+  const label = isEn ? group.labelEn : group.labelZh;
+  const parts: string[] = [`${group.rows.length}`];
+
+  if (group.activeCount > 0) {
+    parts.push(isEn ? `Active ${group.activeCount}` : `活跃 ${group.activeCount}`);
+  }
+  if (group.watchCount > 0) {
+    parts.push(isEn ? `Watch ${group.watchCount}` : `观察 ${group.watchCount}`);
+  }
+  if (group.localTimeRange) {
+    parts.push(`LT ${group.localTimeRange}`);
+  }
+  if (group.hotCity) {
+    parts.push(isEn ? `Hot: ${group.hotCity}` : `热门: ${group.hotCity}`);
+  }
+
+  return (
+    <button
+      type="button"
+      onClick={onToggle}
+      className="group flex w-full items-center gap-2 border-b border-slate-200 bg-[#eef2f6] px-3 py-2 text-left hover:bg-[#e2e8f0] transition-colors"
+    >
+      <span className="grid h-5 w-5 shrink-0 place-items-center text-slate-400 group-hover:text-slate-600">
+        {isExpanded ? <ChevronDown size={14} /> : <ChevronRight size={14} />}
+      </span>
+      <span className="text-xs font-black uppercase tracking-wide text-slate-600">
+        {label}
+      </span>
+      <span className="text-[11px] text-slate-400">
+        {parts.join(" · ")}
+      </span>
+    </button>
+  );
+}
+```
+
+- [ ] **Step 2: 提交**
+
+```bash
+git add frontend/components/dashboard/scan-terminal/ContinentGroupHeader.tsx
+git commit -m "新增终端大洲分组标题行组件"
+```
+
+---
+
+### Task 3: 创建 MobileCityCard.tsx 移动端卡片组件
+
+**文件:**
+- 创建: `frontend/components/dashboard/scan-terminal/MobileCityCard.tsx`
+
+- [ ] **Step 1: 写入组件**
+
+```tsx
+"use client";
+
+import type { ScanOpportunityRow } from "@/lib/dashboard-types";
+import {
+  formatPrice,
+  formatSpreadLiquidity,
+  GAP_COLOR_MAP,
+  getGapColor,
+  getSignalLabel,
+  getSignalState,
+} from "@/components/dashboard/scan-terminal/continent-grouping";
+
+function rowName(row: ScanOpportunityRow) {
+  return row.city_display_name || row.display_name || row.city || "--";
+}
+
+function tempVal(value?: number | null, symbol?: string | null) {
+  const n = Number(value);
+  if (!Number.isFinite(n)) return "--";
+  return `${n.toFixed(1)}${symbol || "°"}`;
+}
+
+export function MobileCityCard({
+  isEn,
+  onClick,
+  row,
+}: {
+  isEn: boolean;
+  onClick: (row: ScanOpportunityRow) => void;
+  row: ScanOpportunityRow;
+}) {
+  const signal = getSignalState(row);
+  const gapColor = GAP_COLOR_MAP[getGapColor(row)];
+
+  return (
+    <button
+      type="button"
+      onClick={() => onClick(row)}
+      className="w-full rounded-lg border border-slate-200 bg-white p-3 text-left shadow-sm hover:bg-blue-50/70 transition-colors"
+    >
+      {/* Row 1: City + Signal */}
+      <div className="flex items-center justify-between gap-2">
+        <span className="truncate text-sm font-bold text-slate-900">
+          {rowName(row)}
+        </span>
+        <span className="shrink-0 text-xs font-black">
+          <span className={signal === "active" ? "text-emerald-600" : signal === "watch" ? "text-amber-600" : signal === "closed" ? "text-slate-400" : "text-red-500"}>
+            {getSignalLabel(signal, isEn)}
+          </span>
+        </span>
+      </div>
+
+      {/* Row 2: Obs · Gap · Market */}
+      <div className="mt-2 flex flex-wrap items-center gap-x-3 gap-y-1 text-xs">
+        <span className="font-mono font-bold">
+          Obs {tempVal(row.current_temp, row.temp_symbol)}
+        </span>
+        <span className={gapColor}>
+          Gap {tempVal(row.signed_gap ?? row.gap_to_target, row.temp_symbol)}
+        </span>
+        <span className="text-slate-600">
+          {formatPrice(row.midpoint, row.ask, row.bid)}
+        </span>
+      </div>
+
+      {/* Row 3: High · DEB */}
+      <div className="mt-1 flex flex-wrap items-center gap-x-3 gap-y-1 text-xs text-slate-500">
+        <span>
+          High {tempVal(row.current_max_so_far, row.temp_symbol)}
+        </span>
+        <span>
+          DEB {tempVal(row.deb_prediction, row.temp_symbol)}
+        </span>
+      </div>
+    </button>
+  );
+}
+```
+
+- [ ] **Step 2: 提交**
+
+```bash
+git add frontend/components/dashboard/scan-terminal/MobileCityCard.tsx
+git commit -m "新增终端移动端城市卡片组件"
+```
+
+---
+
+### Task 4: 创建 MobileRegionTabs.tsx 移动端 Tab 栏
+
+**文件:**
+- 创建: `frontend/components/dashboard/scan-terminal/MobileRegionTabs.tsx`
+
+- [ ] **Step 1: 写入组件**
+
+```tsx
+"use client";
+
+import clsx from "clsx";
+import type { ContinentGroup } from "@/components/dashboard/scan-terminal/continent-grouping";
+
+export function MobileRegionTabs({
+  activeTab,
+  groups,
+  isEn,
+  onSelectTab,
+}: {
+  activeTab: string;
+  groups: ContinentGroup[];
+  isEn: boolean;
+  onSelectTab: (key: string) => void;
+}) {
+  return (
+    <div className="flex overflow-x-auto border-b border-slate-200 bg-white px-2 no-scrollbar">
+      {groups.map((g) => {
+        const label = isEn ? g.labelEn : g.labelZh;
+        const isActive = activeTab === g.key;
+        return (
+          <button
+            key={g.key}
+            type="button"
+            onClick={() => onSelectTab(g.key)}
+            className={clsx(
+              "shrink-0 px-3 py-2.5 text-xs font-bold whitespace-nowrap border-b-2 transition-colors",
+              isActive
+                ? "border-blue-600 text-blue-700"
+                : "border-transparent text-slate-500 hover:text-slate-700"
+            )}
+          >
+            {label}
+            <span className="ml-1 text-[10px] text-slate-400">
+              {g.activeCount > 0 ? `${g.activeCount}A` : g.rows.length}
+            </span>
+          </button>
+        );
+      })}
+    </div>
+  );
+}
+```
+
+- [ ] **Step 2: 提交**
+
+```bash
+git add frontend/components/dashboard/scan-terminal/MobileRegionTabs.tsx
+git commit -m "新增终端移动端大洲 Tab 栏组件"
+```
+
+---
+
+### Task 5: 重构 ScanTerminalDashboard.tsx — 重写 MarketTable 为分组表格
+
+**文件:**
+- 修改: `frontend/components/dashboard/ScanTerminalDashboard.tsx` (替换 `MarketTable` 函数)
+
+这个步骤将现有的 `MarketTable` 替换为支持分组标题行的新版本 `GroupedMarketTable`。
+
+- [ ] **Step 1: 替换 MarketTable 组件 (第 245-323 行)**
+
+删除旧 `MarketTable`，替换为：
+
+```tsx
+import { ChevronDown, ChevronRight } from "lucide-react";
+import {
+  ContinentGroup,
+  buildContinentGroups,
+  formatPrice,
+  formatSpreadLiquidity,
+  GAP_COLOR_MAP,
+  getDefaultExpanded,
+  getGapColor,
+  getSignalLabel,
+  getSignalState,
+} from "@/components/dashboard/scan-terminal/continent-grouping";
+
+function GroupedMarketTable({
+  groups,
+  isEn,
+  onSelect,
+  selectedId,
+}: {
+  groups: ContinentGroup[];
+  isEn: boolean;
+  onSelect: (row: ScanOpportunityRow) => void;
+  selectedId?: string | null;
+}) {
+  const [collapsed, setCollapsed] = useState<Set<string>>(() => {
+    const c = new Set<string>();
+    const defaultExpanded = getDefaultExpanded(groups);
+    for (const g of groups) {
+      if (!defaultExpanded.has(g.key)) c.add(g.key);
+    }
+    return c;
+  });
+
+  const toggleGroup = (key: string) => {
+    setCollapsed((prev) => {
+      const next = new Set(prev);
+      if (next.has(key)) next.delete(key);
+      else next.add(key);
+      return next;
+    });
+  };
+
+  return (
+    <div className="overflow-auto">
+      <table className="w-full min-w-[800px] border-collapse text-[13px]">
+        <thead>
+          <tr className="border-b border-slate-200 bg-[#f5f7fa] text-left text-[11px] uppercase text-slate-500">
+            <th className="px-3 py-2 font-black">City</th>
+            <th className="px-2 py-2 text-right font-black">Obs</th>
+            <th className="px-2 py-2 text-right font-black">High</th>
+            <th className="px-2 py-2 text-right font-black">DEB</th>
+            <th className="px-2 py-2 text-right font-black">Gap</th>
+            <th className="px-2 py-2 text-right font-black">Market</th>
+            <th className="px-2 py-2 text-right font-black">Edge</th>
+            <th className="px-2 py-2 text-right font-black">Spr/Liq</th>
+            <th className="px-3 py-2 font-black">Signal</th>
+          </tr>
+        </thead>
+        <tbody>
+          {groups.map((group) => {
+            const isExpanded = !collapsed.has(group.key);
+            const label = isEn ? group.labelEn : group.labelZh;
+            return (
+              <Fragment key={group.key}>
+                {/* Group header row */}
+                <tr className="border-b border-slate-200 bg-[#eef2f6]">
+                  <td colSpan={9} className="p-0">
+                    <button
+                      type="button"
+                      onClick={() => toggleGroup(group.key)}
+                      className="flex w-full items-center gap-2 px-3 py-1.5 text-left hover:bg-[#e2e8f0] transition-colors"
+                    >
+                      <span className="grid h-4 w-4 place-items-center text-slate-400">
+                        {isExpanded ? <ChevronDown size={12} /> : <ChevronRight size={12} />}
+                      </span>
+                      <span className="text-[11px] font-black uppercase tracking-wide text-slate-600">
+                        {label}
+                      </span>
+                      <span className="text-[10px] text-slate-400">
+                        {group.rows.length} · {isEn ? "Active" : "活跃"} {group.activeCount} · {isEn ? "Watch" : "观察"} {group.watchCount}
+                        {group.localTimeRange ? ` · LT ${group.localTimeRange}` : ""}
+                        {group.hotCity ? ` · Hot: ${group.hotCity}` : ""}
+                      </span>
+                    </button>
+                  </td>
+                </tr>
+                {/* Data rows */}
+                {isExpanded &&
+                  group.rows.map((row) => {
+                    const signal = getSignalState(row);
+                    const gapColor = GAP_COLOR_MAP[getGapColor(row)];
+                    return (
+                      <tr
+                        key={row.id}
+                        className={clsx(
+                          "cursor-pointer border-b border-slate-100 hover:bg-blue-50/70",
+                          selectedId === row.id && "bg-blue-50"
+                        )}
+                        onClick={() => onSelect(row)}
+                      >
+                        <td className="px-3 py-2">
+                          <div className="font-bold text-slate-900">{rowName(row)}</div>
+                          <div className="truncate text-[11px] text-slate-500">
+                            {row.airport || ""}{row.local_time ? ` · ${row.local_time}` : ""}
+                          </div>
+                        </td>
+                        <td className="px-2 py-2 text-right font-mono font-bold">
+                          {temp(row.current_temp, row.temp_symbol)}
+                        </td>
+                        <td className="px-2 py-2 text-right font-mono">
+                          {temp(row.current_max_so_far, row.temp_symbol)}
+                        </td>
+                        <td className="px-2 py-2 text-right font-mono">
+                          {temp(row.deb_prediction, row.temp_symbol)}
+                        </td>
+                        <td className={clsx("px-2 py-2 text-right font-mono font-bold", gapColor)}>
+                          {temp(row.signed_gap ?? row.gap_to_target, row.temp_symbol)}
+                        </td>
+                        <td className="px-2 py-2 text-right font-mono">
+                          {formatPrice(row.midpoint, row.ask, row.bid)}
+                        </td>
+                        <td className={clsx("px-2 py-2 text-right font-mono font-bold", edgeClass(row.edge_percent))}>
+                          {pct(row.edge_percent)}
+                        </td>
+                        <td className="px-2 py-2 text-right font-mono text-[11px]">
+                          {formatSpreadLiquidity(row.spread, row.book_liquidity ?? row.market_liquidity)}
+                        </td>
+                        <td className="px-3 py-2">
+                          <span className={clsx(
+                            "text-[11px] font-black",
+                            signal === "active" ? "text-emerald-600" :
+                            signal === "watch" ? "text-amber-600" :
+                            signal === "closed" ? "text-slate-400" : "text-red-500"
+                          )}>
+                            {getSignalLabel(signal, isEn)}
+                          </span>
+                        </td>
+                      </tr>
+                    );
+                  })}
+              </Fragment>
+            );
+          })}
+        </tbody>
+      </table>
+    </div>
+  );
+}
+```
+
+需要在本文件顶部新增 `import { Fragment, ... }` from react。
+
+- [ ] **Step 2: 更新 import 语句 (文件第 1 行)**
+
+将 `import { useEffect, useMemo, useState } from "react";` 改为：
+```tsx
+import { Fragment, useEffect, useMemo, useState } from "react";
+```
+
+- [ ] **Step 3: 验证 TypeScript**
+
+```bash
+cd frontend && npx tsc --noEmit 2>&1 | head -30
+```
+
+- [ ] **Step 4: 提交**
+
+```bash
+git add frontend/components/dashboard/ScanTerminalDashboard.tsx
+git commit -m "终端表格重构为9列时区分组布局：新增 City/Obs/High/DEB/Gap/Market/Edge/SprLiq/Signal 列"
+```
+
+---
+
+### Task 6: 重构 KoyfinWeatherTerminal — 接入分组逻辑
+
+**文件:**
+- 修改: `frontend/components/dashboard/ScanTerminalDashboard.tsx` (修改 `KoyfinWeatherTerminal`)
+
+在 `KoyfinWeatherTerminal` 中引入 `buildContinentGroups`，将左列 `MarketTable` 替换为 `GroupedMarketTable`，中列 `MarketTable` 替换为 `GroupedMarketTable`，右列 Watchlist 保留列表展示。
+
+- [ ] **Step 1: 修改 KoyfinWeatherTerminal 中的左列表格部分 (第 460-491 行)**
+
+找到左列 `<Panel title="Weather Contracts">` 内的 `<MarketTable>`，替换为：
+
+```tsx
+<Panel title={isEn ? "Weather Contracts" : "天气合约"}>
+  <div className="grid grid-cols-3 border-b border-slate-200 text-center">
+    <div className="p-3">
+      <div className="text-[11px] font-black uppercase text-slate-500">
+        {isEn ? "Rows" : "行数"}
+      </div>
+      <div className="font-mono text-xl font-black">{rows.length}</div>
+    </div>
+    <div className="border-x border-slate-200 p-3">
+      <div className="text-[11px] font-black uppercase text-slate-500">
+        Avg Edge
+      </div>
+      <div className={clsx("font-mono text-xl font-black", edgeClass(avgEdge))}>
+        {pct(avgEdge)}
+      </div>
+    </div>
+    <div className="p-3">
+      <div className="text-[11px] font-black uppercase text-slate-500">
+        Liquidity
+      </div>
+      <div className="font-mono text-xl font-black">
+        {money(totalLiquidity)}
+      </div>
+    </div>
+  </div>
+  <GroupedMarketTable
+    groups={continentGroups}
+    isEn={isEn}
+    selectedId={selectedRow?.id}
+    onSelect={setSelectedRow}
+  />
+</Panel>
+```
+
+- [ ] **Step 2: 替换中列 MarketTable (第 600-606 行)**
+
+```tsx
+<Panel title={isEn ? "All Contracts" : "全部合约"}>
+  <GroupedMarketTable
+    groups={continentGroups}
+    isEn={isEn}
+    selectedId={selectedRow?.id}
+    onSelect={setSelectedRow}
+  />
+</Panel>
+```
+
+- [ ] **Step 3: 在 KoyfinWeatherTerminal 中计算 continentGroups**
+
+在组件内部，紧接 `const selectedLabel = ...` 之后添加：
+
+```tsx
+const continentGroups = useMemo(
+  () => buildContinentGroups(rows, isEn),
+  [rows, isEn]
+);
+```
+
+- [ ] **Step 4: 提交**
+
+```bash
+git add frontend/components/dashboard/ScanTerminalDashboard.tsx
+git commit -m "终端三列布局接入大洲分组数据"
+```
+
+---
+
+### Task 7: 实现移动端响应式布局 — Tab + 卡片流
+
+**文件:**
+- 修改: `frontend/components/dashboard/ScanTerminalDashboard.tsx` (修改 `KoyfinWeatherTerminal` main 区域)
+
+在 `<main>` 内，用 `useMediaQuery` 或 Tailwind 响应式类区分桌面/移动端布局。移动端显示 `MobileRegionTabs` + `MobileCityCard` 列表。
+
+- [ ] **Step 1: 在 KoyfinWeatherTerminal 中添加移动端状态和渲染**
+
+在组件顶部添加：
+```tsx
+const [mobileTab, setMobileTab] = useState<string>("active_signals");
+```
+
+在 `continentGroups` 计算后添加：
+```tsx
+const mobileActiveGroup = useMemo(
+  () => continentGroups.find((g) => g.key === mobileTab) || continentGroups[0],
+  [continentGroups, mobileTab]
+);
+
+useEffect(() => {
+  if (continentGroups.length > 0 && !continentGroups.find((g) => g.key === mobileTab)) {
+    setMobileTab(continentGroups[0].key);
+  }
+}, [continentGroups, mobileTab]);
+```
+
+- [ ] **Step 2: 修改 main 区域为响应式双布局 (第 458-673 行)**
+
+在 `<main>` 中包裹条件渲染：
+
+```tsx
+<main className="min-h-0 flex-1 overflow-auto p-2">
+  {/* Mobile layout */}
+  <div className="flex flex-col gap-2 lg:hidden">
+    <MobileRegionTabs
+      activeTab={mobileTab}
+      groups={continentGroups}
+      isEn={isEn}
+      onSelectTab={setMobileTab}
+    />
+    <div className="space-y-2 px-1">
+      {mobileActiveGroup?.rows.map((row) => (
+        <MobileCityCard
+          key={row.id}
+          row={row}
+          isEn={isEn}
+          onClick={setSelectedRow}
+        />
+      ))}
+    </div>
+  </div>
+
+  {/* Desktop layout (existing 3-column grid) */}
+  <div className="hidden min-h-full grid-cols-1 gap-2 lg:grid xl:grid-cols-[1.12fr_1.6fr_1.1fr]">
+    {/* ... existing 3 columns unchanged ... */}
+  </div>
+</main>
+```
+
+现有的三列布局代码放入 `{/* Desktop layout */}` 块中，用 `hidden lg:grid` 控制显示。
+
+- [ ] **Step 3: 验证 TypeScript**
+
+```bash
+cd frontend && npx tsc --noEmit 2>&1 | head -40
+```
+
+- [ ] **Step 4: 提交**
+
+```bash
+git add frontend/components/dashboard/ScanTerminalDashboard.tsx
+git commit -m "终端新增移动端 Tab+卡片流响应式布局"
+```
+
+---
+
+### Task 8: 添加 CSS 样式 — 分组行和移动端卡片
+
+**文件:**
+- 创建: `frontend/components/dashboard/ScanTerminalContinent.module.css`
+- 修改: `frontend/components/dashboard/scan-root-styles.ts`
+
+- [ ] **Step 1: 写入 CSS Module**
+
+```css
+/* ScanTerminalContinent.module.css */
+
+.root {
+  --gap-green: #16a34a;
+  --gap-orange: #ea580c;
+  --gap-slate: #475569;
+  --gap-gray: #94a3b8;
+  --gap-red: #dc2626;
+}
+
+/* Group header */
+.groupHeader {
+  background: #eef2f6;
+  border-bottom: 1px solid #cbd5e1;
+}
+.groupHeader:hover {
+  background: #e2e8f0;
+}
+
+/* Mobile: hide scrollbar on tab bar */
+.mobileTabs {
+  scrollbar-width: none;
+  -ms-overflow-style: none;
+}
+.mobileTabs::-webkit-scrollbar {
+  display: none;
+}
+
+/* Mobile card */
+.mobileCard {
+  border: 1px solid #e2e8f0;
+  background: #ffffff;
+  border-radius: 8px;
+  box-shadow: 0 1px 2px rgba(0, 0, 0, 0.04);
+}
+.mobileCard:hover {
+  background: #f0f7ff;
+}
+
+/* Signal badge */
+.signalActive {
+  color: #059669;
+}
+.signalWatch {
+  color: #d97706;
+}
+.signalClosed {
+  color: #94a3b8;
+}
+.signalData {
+  color: #dc2626;
+}
+
+/* Light theme */
+:global(html.light) .groupHeader {
+  background: #f8fafc;
+  border-bottom-color: #e2e8f0;
+}
+:global(html.light) .groupHeader:hover {
+  background: #f1f5f9;
+}
+:global(html.light) .mobileCard {
+  background: #ffffff;
+  border-color: #e2e8f0;
+}
+```
+
+- [ ] **Step 2: 注册到 scan-root-styles.ts barrel**
+
+读取 `frontend/components/dashboard/scan-root-styles.ts`，追加：
+```typescript
+import sContinent from "@/components/dashboard/ScanTerminalContinent.module.css";
+// ... add sContinent.root to the barrel export
+```
+
+- [ ] **Step 3: 提交**
+
+```bash
+git add frontend/components/dashboard/ScanTerminalContinent.module.css frontend/components/dashboard/scan-root-styles.ts
+git commit -m "新增终端大洲分组与移动端卡片样式"
+```
+
+---
+
+### Task 9: 最终验证与构建
+
+- [ ] **Step 1: TypeScript 类型检查**
+
+```bash
+cd frontend && npx tsc --noEmit
+```
+预期：0 errors。
+
+- [ ] **Step 2: 生产构建**
+
+```bash
+cd frontend && npm run build
+```
+预期：✓ Compiled successfully，66 pages generated。
+
+- [ ] **Step 3: 启动 dev server 验证 UI**
+
+```bash
+cd frontend && npm run dev
+```
+
+打开 http://localhost:3000/terminal 验证：
+- 桌面端：Active Signals 展开显示，时区分组折叠/展开，9 列表格
+- 移动端：Tab 切换流畅，卡片流显示正常
+- 双主题切换无样式错误
+
+- [ ] **Step 4: 提交**
+
+```bash
+git add -A
+git commit -m "终端大洲分组功能验证通过"
+```

docs/superpowers/plans/2026-05-26-live-temperature-chart-split.md

@@ -0,0 +1,26 @@
+# Live Temperature Chart Split Implementation Plan
+
+> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
+
+**Goal:** Split `LiveTemperatureThresholdChart.tsx` so chart data generation and SSE patch merge logic live in focused pure modules, while the visible chart behavior stays unchanged.
+
+**Architecture:** Keep the React component as the orchestration/rendering layer. Move types, constants, time helpers, series builders, fallback rules, and patch merge into adjacent modules under `frontend/components/dashboard/scan-terminal/`. Preserve existing test exports through the component file during the first split to avoid changing test callers.
+
+**Tech Stack:** Next.js/React, TypeScript, Recharts, existing business-state test runner.
+
+---
+
+## Files
+
+- Create: `frontend/components/dashboard/scan-terminal/temperature-chart-logic.ts`
+- Modify: `frontend/components/dashboard/scan-terminal/LiveTemperatureThresholdChart.tsx`
+- Modify: `frontend/components/dashboard/scan-terminal/__tests__/ssePatchArchitecture.test.ts`
+- Verify: `frontend/components/dashboard/scan-terminal/__tests__/temperatureDefaultVisibilityPolicy.test.ts`
+
+## Tasks
+
+- [ ] Add a failing architecture test that rejects keeping all chart data builders inside `LiveTemperatureThresholdChart.tsx`.
+- [ ] Extract pure chart logic into `temperature-chart-logic.ts`.
+- [ ] Import extracted functions/types back into `LiveTemperatureThresholdChart.tsx`.
+- [ ] Keep the current test-only exports stable from `LiveTemperatureThresholdChart.tsx`.
+- [ ] Run `npm run test:business`, `npm run typecheck`, and `npm run build`.

docs/superpowers/plans/2026-05-26-production-realtime-sse.md

@@ -0,0 +1,71 @@
+# Production Realtime SSE Patch Implementation Plan
+
+> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
+
+**Goal:** Upgrade PolyWeather terminal charts from in-process best-effort SSE patches to a replayable, city-scoped, versioned realtime observation stream for PM highest-temperature prediction workflows.
+
+**Architecture:** Keep HTTP APIs as the full snapshot/source-of-truth layer. Add a short-window SQLite event log for SSE replay, version observations as `city_observation_patch.v1`, fan out live events through the existing SSE manager, and let the frontend subscribe only to visible cities with `since_revision` reconnect replay.
+
+**Tech Stack:** FastAPI, SQLite/WAL via `DBManager`, in-process `asyncio.Queue` SSE fanout, React/Next.js `EventSource`, TypeScript external store hooks.
+
+---
+
+## Constraints
+
+- Default replay retention is 6 hours because this event log is not the business history store.
+- The retention can be raised with `POLYWEATHER_PATCH_EVENT_RETENTION_HOURS`, but the product does not need all-day patch retention.
+- First production step is SQLite-only; Redis/Postgres pub/sub remains a later multi-instance extension.
+- Existing legacy `city_patch` ingest and frontend handling must keep working during rollout.
+
+## Tasks
+
+- [ ] Backend schema tests
+  - Add tests proving legacy collector payloads normalize to `city_observation_patch.v1`.
+  - Cover runway point conversion from `amos.runway_obs.point_temperatures`.
+  - Cover invalid payload rejection when city and useful observation data are missing.
+
+- [ ] Backend schema implementation
+  - Add `web/realtime_patch_schema.py`.
+  - Normalize city/source/obs time/temp/max/runway payload fields.
+  - Keep payload small and JSON-serializable.
+
+- [ ] Event store tests
+  - Add tests for monotonic SQLite revisions.
+  - Add city-filtered replay tests.
+  - Add retention cleanup tests for stale replay rows.
+
+- [ ] Event store implementation
+  - Add `observation_patch_events` table and indexes in `DBManager`.
+  - Add `web/realtime_event_store.py` for append, replay, latest revision, and cleanup.
+  - Use `POLYWEATHER_PATCH_EVENT_RETENTION_HOURS=6` as the default.
+
+- [ ] SSE replay tests
+  - Add tests for `/api/events?cities=...&since_revision=...`.
+  - Verify replay only returns subscribed cities.
+  - Verify replay over limit emits `resync_required`.
+
+- [ ] SSE implementation
+  - Update router to parse `cities`, `since_revision`, and bounded `replay_limit`.
+  - Write normalized events to SQLite before broadcasting.
+  - Update manager to track per-connection city subscriptions while keeping heartbeat behavior.
+
+- [ ] Frontend SSE tests
+  - Extend architecture tests for v1 schema, `cities`, `since_revision`, replay/resync handling.
+  - Add chart merge coverage for v1 runway point payloads.
+
+- [ ] Frontend SSE implementation
+  - Update `use-sse-patches.ts` to normalize v1 and legacy patch events.
+  - Track global `lastRevision`.
+  - Reconnect with visible-city `cities` and `since_revision`.
+  - Expose a resync signal for charts when the server cannot replay.
+
+- [ ] Chart/list integration
+  - Ensure visible charts register their city subscription.
+  - Keep terminal row patching lightweight: current temp, current max, local time, revision.
+  - Append v1 temp/runway points into existing chart series without forcing full-detail polling.
+
+- [ ] Verification
+  - Run targeted backend pytest files.
+  - Run `npm run test:business`.
+  - Run `npm run typecheck`.
+  - Run `npm run build`.

docs/superpowers/plans/2026-05-27-redis-stream-realtime-event-architecture.md

@@ -0,0 +1,107 @@
+# Redis Stream Realtime Event Architecture Implementation Plan
+
+> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
+
+**Goal:** Add Redis Stream as the production realtime event store and live fanout source while preserving the existing SSE patch protocol.
+
+**Implementation status (2026-05-28):** completed in `v1.8.1`. Production uses Redis Stream when `POLYWEATHER_EVENT_STORE=redis`; SQLite remains the local/fallback event log. Browser API and frontend contract stayed on `/api/events` + `city_observation_patch.v1`.
+
+**Architecture:** Keep `city_observation_patch.v1` and numeric `revision` as the browser contract. Add a Redis-backed event store beside the existing SQLite store, select it through an event-store factory, and let Redis-backed deployments fan out live events through a Redis subscriber loop instead of direct in-process ingest broadcast.
+
+**Tech Stack:** FastAPI, redis-py, Redis Stream, SQLite fallback, pytest, existing frontend EventSource hook.
+
+---
+
+### Task 1: Redis Store Contract
+
+**Files:**
+- Create: `tests/test_redis_realtime_event_store.py`
+- Create: `web/redis_realtime_event_store.py`
+
+- [x] **Step 1: Write failing tests**
+
+Cover append, replay by city, replay gap, and fallback-independent event shape.
+
+- [x] **Step 2: Verify tests fail**
+
+Run: `python -m pytest tests/test_redis_realtime_event_store.py -q`
+
+Expected: fails because `web.redis_realtime_event_store` does not exist.
+
+- [x] **Step 3: Implement Redis store**
+
+Add `RedisRealtimeEventStore` with `append_event`, `latest_revision`, `replay_events`, `replay_requires_resync`, and idempotent `start_live_subscription`.
+
+- [x] **Step 4: Verify tests pass**
+
+Run: `python -m pytest tests/test_redis_realtime_event_store.py -q`
+
+### Task 2: Store Factory And SSE Router
+
+**Files:**
+- Create: `web/realtime_event_store_factory.py`
+- Modify: `web/routers/sse_router.py`
+- Test: `tests/test_sse_replay.py`
+
+- [x] **Step 1: Write failing tests**
+
+Cover `POLYWEATHER_EVENT_STORE=redis` selecting Redis, SQLite fallback when Redis is not configured, and Redis ingest not doing direct local broadcast.
+
+- [x] **Step 2: Verify tests fail**
+
+Run: `python -m pytest tests/test_sse_replay.py tests/test_realtime_event_store_factory.py -q`
+
+- [x] **Step 3: Implement factory and router integration**
+
+Use Redis store when configured; otherwise keep existing SQLite store. Ingest broadcasts directly only for stores that do not provide external live fanout.
+
+- [x] **Step 4: Verify tests pass**
+
+Run: `python -m pytest tests/test_sse_replay.py tests/test_realtime_event_store_factory.py -q`
+
+### Task 3: Dependency And Operational Config
+
+**Files:**
+- Modify: `requirements.txt`
+- Modify: `docs/superpowers/specs/2026-05-27-redis-stream-realtime-event-architecture-design.md`
+
+- [x] **Step 1: Add redis-py dependency**
+
+Add `redis>=5.0.0` to `requirements.txt`.
+
+- [x] **Step 2: Add final config notes**
+
+Ensure the design doc names the runtime env vars used by code.
+
+### Task 4: Verification
+
+**Files:**
+- No production edits unless tests reveal a gap.
+
+- [x] **Step 1: Run backend realtime tests**
+
+Run:
+
+```powershell
+python -m pytest tests/test_realtime_patch_schema.py tests/test_realtime_event_store.py tests/test_redis_realtime_event_store.py tests/test_realtime_event_store_factory.py tests/test_sse_replay.py -q
+```
+
+- [x] **Step 2: Run broader frontend/backend checks**
+
+Run:
+
+```powershell
+cd frontend
+npm run test:business
+npm run typecheck
+npm run build
+```
+
+- [x] **Step 3: Inspect diff**
+
+Run:
+
+```powershell
+git diff --check
+git status --short
+```

docs/superpowers/plans/2026-06-08-feedback-reward-account-detail.md

@@ -0,0 +1,345 @@
+# Feedback Reward Account Detail Implementation Plan
+
+> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
+
+**Goal:** Let users see which submitted feedback earned points, how many points were awarded, and the reward reason in the account page.
+
+**Architecture:** Store reward metadata directly on `user_feedback` rows so the existing feedback list API can expose the reward source without a separate ledger join. The account feedback panel renders reward state inline with each feedback item and stays silent for rows with no reward metadata.
+
+**Tech Stack:** Python SQLite `DBManager`, FastAPI feedback service, Next.js/React account components, TypeScript source-based business tests.
+
+---
+
+## File Structure
+
+- Modify `src/database/db_manager.py`: add reward columns, serialize them, and add `update_user_feedback_reward()` for future ops reward workflows.
+- Modify `tests/test_user_feedback.py`: add backend coverage for reward defaults and reward metadata round trip.
+- Modify `frontend/types/ops.ts`: add optional reward fields to `UserFeedbackEntry`.
+- Modify `frontend/components/account/AccountFeedbackPanel.tsx`: render reward labels and reasons inside each feedback row.
+- Modify `frontend/components/account/__tests__/accountFeedbackPanel.test.ts`: assert the panel handles reward display states.
+
+---
+
+### Task 1: Backend Feedback Reward Metadata
+
+**Files:**
+- Modify: `tests/test_user_feedback.py`
+- Modify: `src/database/db_manager.py`
+
+- [ ] **Step 1: Write the failing backend test**
+
+Add this test to `tests/test_user_feedback.py`:
+
+```python
+def test_user_feedback_reward_metadata_round_trip(tmp_path):
+    db = DBManager(str(tmp_path / "polyweather-feedback-reward.db"))
+
+    created = db.append_user_feedback(
+        category="data",
+        message="Hong Kong COWIN reading was stale.",
+        user_id="user-reward",
+        user_email="reward@example.com",
+    )
+
+    assert created["reward_points"] == 0
+    assert created["reward_reason"] == ""
+    assert created["reward_status"] == ""
+    assert created["rewarded_at"] is None
+
+    rewarded = db.update_user_feedback_reward(
+        created["id"],
+        points=300,
+        reason="Valid data freshness report",
+        status="granted",
+    )
+
+    assert rewarded is not None
+    assert rewarded["reward_points"] == 300
+    assert rewarded["reward_reason"] == "Valid data freshness report"
+    assert rewarded["reward_status"] == "granted"
+    assert rewarded["rewarded_at"]
+
+    row = db.list_user_feedback(
+        limit=10,
+        user_id="user-reward",
+        user_email="reward@example.com",
+    )[0]
+    assert row["id"] == created["id"]
+    assert row["reward_points"] == 300
+    assert row["reward_reason"] == "Valid data freshness report"
+    assert row["reward_status"] == "granted"
+    assert row["rewarded_at"] == rewarded["rewarded_at"]
+```
+
+- [ ] **Step 2: Run the backend test and verify it fails**
+
+Run:
+
+```powershell
+python -m pytest tests/test_user_feedback.py::test_user_feedback_reward_metadata_round_trip -q
+```
+
+Expected: failure because `reward_points` is missing or `update_user_feedback_reward` is undefined.
+
+- [ ] **Step 3: Add reward columns and serialization**
+
+In `src/database/db_manager.py`, update `user_feedback` schema and migration:
+
+```python
+reward_points INTEGER DEFAULT 0,
+reward_reason TEXT DEFAULT '',
+rewarded_at TIMESTAMP,
+reward_status TEXT DEFAULT ''
+```
+
+Add `_ensure_column()` calls for the same columns in the existing migration block.
+
+Update every feedback `SELECT` to include:
+
+```sql
+reward_points, reward_reason, rewarded_at, reward_status
+```
+
+Update `_feedback_row_to_dict()` to return:
+
+```python
+"reward_points": max(0, int(row["reward_points"] or 0)),
+"reward_reason": str(row["reward_reason"] or ""),
+"rewarded_at": row["rewarded_at"],
+"reward_status": str(row["reward_status"] or ""),
+```
+
+- [ ] **Step 4: Add reward update method**
+
+Add this method near `update_user_feedback_status()` in `src/database/db_manager.py`:
+
+```python
+def update_user_feedback_reward(
+    self,
+    feedback_id: int,
+    *,
+    points: int,
+    reason: str = "",
+    status: str = "granted",
+) -> Optional[Dict[str, Any]]:
+    safe_points = max(0, int(points or 0))
+    normalized_reason = str(reason or "").strip()[:500]
+    normalized_status = str(status or "").strip().lower()[:40]
+    if not normalized_status:
+        normalized_status = "granted" if safe_points > 0 else "skipped"
+    now = datetime.now().isoformat()
+    with self._get_connection() as conn:
+        conn.row_factory = sqlite3.Row
+        conn.execute(
+            """
+            UPDATE user_feedback
+            SET reward_points = ?,
+                reward_reason = ?,
+                reward_status = ?,
+                rewarded_at = ?,
+                updated_at = ?
+            WHERE id = ?
+            """,
+            (
+                safe_points,
+                normalized_reason,
+                normalized_status,
+                now,
+                now,
+                int(feedback_id),
+            ),
+        )
+        row = conn.execute(
+            """
+            SELECT id, category, message, source, status, contact, user_id,
+                   user_email, context_json, reward_points, reward_reason,
+                   rewarded_at, reward_status, created_at, updated_at
+            FROM user_feedback
+            WHERE id = ?
+            """,
+            (int(feedback_id),),
+        ).fetchone()
+        conn.commit()
+    return self._feedback_row_to_dict(row) if row else None
+```
+
+- [ ] **Step 5: Run backend tests**
+
+Run:
+
+```powershell
+python -m pytest tests/test_user_feedback.py -q
+```
+
+Expected: all `test_user_feedback.py` tests pass.
+
+---
+
+### Task 2: Account Feedback Reward Display
+
+**Files:**
+- Modify: `frontend/types/ops.ts`
+- Modify: `frontend/components/account/AccountFeedbackPanel.tsx`
+- Modify: `frontend/components/account/__tests__/accountFeedbackPanel.test.ts`
+
+- [ ] **Step 1: Write the failing frontend test**
+
+Extend the final assertion in `frontend/components/account/__tests__/accountFeedbackPanel.test.ts` or add a new assertion:
+
+```ts
+assert(
+  feedbackPanelSource.includes("reward_points") &&
+    feedbackPanelSource.includes("reward_reason") &&
+    feedbackPanelSource.includes("reward_status") &&
+    feedbackPanelSource.includes("formatRewardPoints") &&
+    feedbackPanelSource.includes("renderFeedbackReward") &&
+    feedbackPanelSource.includes("奖励原因"),
+  "account feedback panel must show per-feedback reward points and reward reasons",
+);
+```
+
+- [ ] **Step 2: Run the frontend business test and verify it fails**
+
+Run:
+
+```powershell
+cd frontend; npm run test:business -- accountFeedbackPanel
+```
+
+Expected: failure because the panel does not yet reference the reward fields.
+
+- [ ] **Step 3: Extend frontend type**
+
+Add optional fields to `UserFeedbackEntry` in `frontend/types/ops.ts`:
+
+```ts
+  reward_points?: number;
+  reward_reason?: string;
+  rewarded_at?: string | null;
+  reward_status?: string;
+```
+
+- [ ] **Step 4: Add account reward rendering helpers**
+
+In `AccountFeedbackPanel.tsx`, add helpers:
+
+```tsx
+function formatRewardPoints(points?: number) {
+  const value = Math.max(0, Number(points || 0));
+  return `+${value.toLocaleString()} points`;
+}
+
+function rewardStatusText(status?: string, isEn = false) {
+  const key = String(status || "").toLowerCase();
+  if (key === "pending") return isEn ? "Reward pending" : "奖励待处理";
+  if (key === "skipped") return isEn ? "No points awarded" : "未发放积分";
+  return isEn ? "Feedback reward" : "反馈奖励";
+}
+
+function renderFeedbackReward(entry: UserFeedbackEntry, isEn: boolean) {
+  const points = Math.max(0, Number(entry.reward_points || 0));
+  const rewardStatus = String(entry.reward_status || "").toLowerCase();
+  const reason = String(entry.reward_reason || "").trim();
+  if (points <= 0 && !rewardStatus && !reason) return null;
+  const granted = points > 0 || rewardStatus === "granted";
+  return (
+    <div className={`mt-2 rounded-lg border px-3 py-2 text-xs ${
+      granted
+        ? "border-amber-200 bg-amber-50 text-amber-800"
+        : "border-slate-200 bg-slate-50 text-slate-600"
+    }`}>
+      <div className="flex flex-wrap items-center justify-between gap-2">
+        <span className="font-bold">{rewardStatusText(rewardStatus, isEn)}</span>
+        {points > 0 ? <span className="font-mono font-black">{formatRewardPoints(points)}</span> : null}
+      </div>
+      {reason ? (
+        <div className="mt-1 leading-5 text-slate-600">
+          {isEn ? "Reason" : "奖励原因"}: {reason}
+        </div>
+      ) : null}
+      {entry.rewarded_at ? (
+        <div className="mt-1 font-mono text-[11px] text-slate-400">
+          {compactDate(entry.rewarded_at)}
+        </div>
+      ) : null}
+    </div>
+  );
+}
+```
+
+- [ ] **Step 5: Render reward detail in each feedback row**
+
+Inside each feedback row, after the feedback message paragraph, add:
+
+```tsx
+{renderFeedbackReward(entry, isEn)}
+```
+
+- [ ] **Step 6: Run frontend business test**
+
+Run:
+
+```powershell
+cd frontend; npm run test:business -- accountFeedbackPanel
+```
+
+Expected: `accountFeedbackPanel` passes.
+
+---
+
+### Task 3: Verification and Commit
+
+**Files:**
+- Verify all touched files.
+
+- [ ] **Step 1: Run targeted backend verification**
+
+Run:
+
+```powershell
+python -m pytest tests/test_user_feedback.py -q
+```
+
+Expected: all tests pass.
+
+- [ ] **Step 2: Run targeted frontend verification**
+
+Run:
+
+```powershell
+cd frontend; npm run test:business -- accountFeedbackPanel
+```
+
+Expected: `accountFeedbackPanel` test passes.
+
+- [ ] **Step 3: Run broader low-cost verification**
+
+Run:
+
+```powershell
+python -m ruff check .
+cd frontend; npm run typecheck
+```
+
+Expected: both commands pass.
+
+- [ ] **Step 4: Check status and commit**
+
+Run:
+
+```powershell
+git status --short
+git diff --check
+git add docs/superpowers/plans/2026-06-08-feedback-reward-account-detail.md tests/test_user_feedback.py src/database/db_manager.py frontend/types/ops.ts frontend/components/account/AccountFeedbackPanel.tsx frontend/components/account/__tests__/accountFeedbackPanel.test.ts
+git commit -m "Show feedback reward details in account"
+```
+
+Expected: commit succeeds with only planned files staged.
+
+---
+
+## Self-Review
+
+- Spec coverage: reward metadata fields, existing API payload, account inline display, missing metadata fallback, and future ops reuse are covered.
+- Scope control: the plan does not implement automatic reward issuance or external notifications.
+- Type consistency: frontend fields use `reward_points`, `reward_reason`, `rewarded_at`, and `reward_status`, matching backend serialization.

docs/superpowers/plans/2026-06-12-growth-milestone-pro-rewards.md

@@ -0,0 +1,68 @@
+# Growth Milestone Pro Rewards Implementation Plan
+
+> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
+
+**Goal:** Automatically extend active paid Pro memberships when verified-user growth milestones are reached.
+
+**Architecture:** A low-frequency Bot-owned loop reads Supabase Auth and payment data, stores daily growth history in SQLite, and grants idempotent milestone-specific bonus subscriptions. SQLite settlement and payout records prevent duplicate processing and support retries.
+
+**Tech Stack:** Python, SQLite, Supabase REST/Auth Admin API, Telegram Bot runtime, pytest
+
+---
+
+### Task 1: Define milestone and eligibility policy
+
+**Files:**
+- Create: `src/bot/growth_milestone_reward_loop.py`
+- Test: `tests/test_growth_milestone_reward_loop.py`
+
+- [ ] Write failing tests for the 600/750/1000/100-step milestone schedule and paid-member eligibility intersection.
+- [ ] Run `python -m pytest tests/test_growth_milestone_reward_loop.py -q` and confirm failure because the module is missing.
+- [ ] Implement pure policy helpers and Supabase query helpers.
+- [ ] Re-run the focused tests and confirm they pass.
+
+### Task 2: Persist history and settlement state
+
+**Files:**
+- Modify: `src/database/db_manager.py`
+- Test: `tests/test_growth_milestone_reward_loop.py`
+
+- [ ] Write failing tests for daily snapshot upsert, payout idempotency, and milestone settlement.
+- [ ] Run the focused tests and confirm the new DB methods are missing.
+- [ ] Add `user_growth_snapshots`, `growth_milestone_runs`, and `growth_milestone_payouts`.
+- [ ] Re-run the focused tests and confirm they pass.
+
+### Task 3: Run and announce automatic settlement
+
+**Files:**
+- Modify: `src/bot/growth_milestone_reward_loop.py`
+- Modify: `src/bot/runtime_coordinator.py`
+- Modify: `src/utils/config_validation.py`
+- Modify: `.env.example`
+- Test: `tests/test_growth_milestone_reward_loop.py`
+- Test: `tests/test_bot_runtime_coordinator.py`
+
+- [ ] Write failing tests for idempotent bonus grants and runtime-loop registration.
+- [ ] Run focused tests and confirm the expected failures.
+- [ ] Implement the settlement loop, retry behavior, and bilingual announcement.
+- [ ] Re-run focused tests and confirm they pass.
+
+### Task 4: Record baseline and publishable announcement
+
+**Files:**
+- Create: `docs/operations/user-growth-history.json`
+- Create: `docs/social/2026-06-12-growth-rewards-x-post.md`
+- Create: `docs/social/assets/polyweather-588-growth-rewards.png`
+
+- [ ] Record the verified 2026-06-12 baseline.
+- [ ] Write the English X announcement with accurate total-user and verified-user wording.
+- [ ] Save the generated social image in the repository.
+
+### Task 5: Verify and deploy
+
+- [ ] Run focused backend tests.
+- [ ] Run `python -m ruff check src/bot/growth_milestone_reward_loop.py src/bot/runtime_coordinator.py src/database/db_manager.py tests/test_growth_milestone_reward_loop.py tests/test_bot_runtime_coordinator.py`.
+- [ ] Run the broader relevant test suite.
+- [ ] Commit and push to `main`.
+- [ ] Check GitHub Actions and production health.
+

docs/superpowers/plans/2026-06-23-deb-training-settlement-worker.md

@@ -0,0 +1,138 @@
+# DEB Training Settlement Worker Implementation Plan
+
+> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
+
+**Goal:** Restore automatic DEB training data freshness after the realtime collector/canonical-cache split.
+
+**Architecture:** Add a dedicated low-frequency training settlement service that runs city analysis for forecast/DEB snapshots and reconciles recent settled actual highs. Keep it separate from the high-frequency observation collector so user-facing realtime updates stay light.
+
+**Tech Stack:** Python, FastAPI service modules, Docker Compose, pytest, existing `update_daily_record()` and `reconcile_recent_actual_highs()` paths.
+
+---
+
+### Task 1: Training Settlement Service
+
+**Files:**
+- Create: `web/training_settlement_service.py`
+- Create: `tests/test_training_settlement_service.py`
+
+- [ ] **Step 1: Write the failing service test**
+
+```python
+def test_training_settlement_cycle_runs_analysis_and_reconciles_supported_cities():
+    calls = {"analysis": [], "reconcile": []}
+
+    def analysis_runner(city):
+        calls["analysis"].append(city)
+        return {"city": city, "deb": {"prediction": 31.2}}
+
+    def reconciler(city, *, lookback_days):
+        calls["reconcile"].append((city, lookback_days))
+        return {"ok": True, "updated": 1}
+
+    result = run_training_settlement_cycle(
+        city_registry={
+            "shanghai": {"icao": "ZSSS", "settlement_source": "metar"},
+            "legacy": {"settlement_source": "wunderground"},
+        },
+        analysis_runner=analysis_runner,
+        actual_reconciler=reconciler,
+        lookback_days=9,
+    )
+
+    assert result["ok"] is True
+    assert result["processed"] == 1
+    assert calls["analysis"] == ["shanghai"]
+    assert calls["reconcile"] == [("shanghai", 9)]
+```
+
+- [ ] **Step 2: Run the test to verify it fails**
+
+Run: `python -m pytest tests/test_training_settlement_service.py::test_training_settlement_cycle_runs_analysis_and_reconciles_supported_cities -q`
+
+Expected: FAIL because `web.training_settlement_service` does not exist.
+
+- [ ] **Step 3: Implement the service**
+
+Create `run_training_settlement_cycle()` with injectable `city_registry`, `analysis_runner`, and `actual_reconciler`. Default analysis runner calls `web.analysis_service._analyze(city, force_refresh=False, detail_mode="panel")`; default reconciler calls `src.analysis.deb_algorithm.reconcile_recent_actual_highs()`.
+
+- [ ] **Step 4: Run the test to verify it passes**
+
+Run: `python -m pytest tests/test_training_settlement_service.py -q`
+
+Expected: PASS.
+
+### Task 2: Worker Entrypoint And Compose
+
+**Files:**
+- Create: `web/training_settlement_worker.py`
+- Modify: `docker-compose.yml`
+- Modify: `tests/test_deployment_runtime_config.py`
+
+- [ ] **Step 1: Write failing deployment tests**
+
+Assert the compose file contains `polyweather_training_settlement`, command `python -m web.training_settlement_worker`, role `training_settlement`, and conservative interval/lookback environment variables.
+
+- [ ] **Step 2: Run the deployment test to verify it fails**
+
+Run: `python -m pytest tests/test_deployment_runtime_config.py::test_runtime_compose_splits_realtime_workers -q`
+
+Expected: FAIL because the worker service is absent.
+
+- [ ] **Step 3: Implement worker and compose service**
+
+The worker loops `run_training_settlement_cycle()` every `POLYWEATHER_TRAINING_SETTLEMENT_INTERVAL_SEC` seconds, with initial delay and lookback from environment.
+
+- [ ] **Step 4: Run focused tests**
+
+Run: `python -m pytest tests/test_training_settlement_service.py tests/test_deployment_runtime_config.py -q`
+
+Expected: PASS.
+
+### Task 3: Stale Monitoring
+
+**Files:**
+- Modify: `web/diagnostics/health.py`
+- Modify: `web/services/system_api.py`
+- Modify: `tests/test_web_observability.py`
+
+- [ ] **Step 1: Write failing observability tests**
+
+Assert system status training summaries include `stale_days` for daily/truth/features, and Prometheus exports stale gauges for training data.
+
+- [ ] **Step 2: Run focused observability tests to verify failure**
+
+Run: `python -m pytest tests/test_web_observability.py::test_system_status_includes_training_data tests/test_web_observability.py::test_metrics_endpoint_returns_prometheus_payload_for_ops_admin -q`
+
+Expected: FAIL because stale fields/gauges are absent.
+
+- [ ] **Step 3: Implement stale summary and gauges**
+
+Add date-diff calculation against UTC today. Export `polyweather_daily_records_stale_days`, `polyweather_truth_records_stale_days`, `polyweather_training_features_stale_days`, and `polyweather_training_data_stale`.
+
+- [ ] **Step 4: Run focused observability tests**
+
+Run: `python -m pytest tests/test_web_observability.py::test_system_status_includes_training_data tests/test_web_observability.py::test_metrics_endpoint_returns_prometheus_payload_for_ops_admin -q`
+
+Expected: PASS.
+
+### Task 4: Verification And Backfill
+
+**Files:**
+- Optional create: `scripts/backfill_training_settlement.py`
+
+- [ ] **Step 1: Run backend checks**
+
+Run: `python -m ruff check .`
+
+Run: `python -m pytest tests/test_training_settlement_service.py tests/test_deployment_runtime_config.py tests/test_web_observability.py -q`
+
+- [ ] **Step 2: Run local one-shot cycle**
+
+Run: `python -m web.training_settlement_worker --once --lookback-days 10 --cities shanghai`
+
+Expected: JSON-like log output with `ok=True`; local DB should get a fresh row for the current local target date if analysis succeeds.
+
+- [ ] **Step 3: Production note**
+
+Missed forecast snapshots from 2026-06-15 to 2026-06-22 cannot be reconstructed honestly unless archived city analysis payloads exist. The worker restores forward automatic samples; actual-high truth can still be reconciled for supported settlement sources.

docs/superpowers/specs/2026-05-25-terminal-continent-grouping-design.md

@@ -0,0 +1,137 @@
+# 终端城市表格按大洲分组 — 设计文档
+
+日期：2026-05-25
+状态：已确认
+
+## 目标
+
+将扫描终端（Scan Terminal）的城市列表从平铺表格改造为按时区分组、按交易信号优先的金融终端风格布局。
+
+## 数据
+
+所有字段已在 `/api/scan/terminal` 响应的 `ScanOpportunityRow` 中就绪，无需后端改动。
+
+### 列 → 字段映射
+
+| 列名 | 字段 | 类型 |
+|------|------|------|
+| City | `city`, `airport`, `local_time` | `string` |
+| Obs | `current_temp` | `number \| null` |
+| High | `current_max_so_far` | `number \| null` |
+| DEB | `deb_prediction` | `number \| null` |
+| Gap | `signed_gap` / `gap_to_target` | `number \| null` |
+| Market | `midpoint`, `bid`, `ask` | `number \| null` |
+| Edge | `edge_percent` | `number \| null` |
+| Spr/Liq | `spread`, `book_liquidity` | `number \| null` |
+| Signal | `signal_status`, `ai_decision` | `string \| null` |
+
+## 时区分组
+
+后端 `scan_terminal_filters.py` 按 UTC 偏移量划分 7 个交易区域：
+
+| 排序 | 区域键 | 英文 | 中文 | UTC 条件 |
+|------|--------|------|------|----------|
+| 1 | east_asia | East Asia | 东亚 | >= +8 |
+| 2 | southeast_asia | Southeast Asia | 东南亚 | >= +7 |
+| 3 | central_asia | Central / South Asia | 中亚/南亚 | >= +5 |
+| 4 | west_asia | West Asia / Middle East | 西亚/中东 | >= +3 |
+| 5 | europe_africa | Europe / Africa | 欧洲/非洲 | >= 0 |
+| 6 | south_america | Latin America | 拉美 | >= -5 |
+| 7 | north_america | North America | 北美 | < -5 |
+
+## 桌面端布局（≥ 768px）
+
+### 虚拟分组："Active Signals"
+
+在 7 个时区分组上方插入一个虚拟分组，聚合当前最重要的信号：
+
+- 筛选条件：`ai_decision === "approve"`、`tradable === true`、`peak`、`rising`、`超预期`
+- 标题行显示：城市数量、Hot 城市、更新时间
+- 格式：`▼ Active Signals  活跃信号   6 · Hot: Tokyo · Updated 14:32`
+
+### 时区分组标题行
+
+- 显示：折叠箭头、中英文名、城市数、active 数、watch 数、本地时间
+- 热门城市标注
+- 格式：`▼ East Asia  东亚   5 · Active 2 · Watch 1 · LT 14:20`
+- 可折叠，默认规则：
+  - Active Signals 始终展开
+  - 包含 active/watch 的时区展开
+  - 无机会的时区折叠
+
+### 表格行
+
+- 9 列：City | Obs | High | DEB | Gap | Market | Edge | Spr/Liq | Signal
+- Market 列显示价格格式：`Y 72¢` / `N 28¢`
+- Signal 列显示：`◆ Active` / `● Watch` / `○ Closed` (文字+图标)
+
+### Gap 列颜色语义
+
+| 状态 | 颜色 | 含义 |
+|------|------|------|
+| 已突破/超预期 | 绿色 `#22c55e` | 对市场方向有利 |
+| 接近目标未突破 | 橙色 `#f59e0b` | Peak Watch |
+| 明显低于目标 | 蓝灰 `#64748b` | 尚不到位 |
+| 追不上/时间不够 | 灰色 `#94a3b8` | 机会减弱 |
+| 数据异常/风险 | 红色 `#ef4444` | 需关注 |
+
+## 移动端布局（< 768px）
+
+### Tab 栏
+
+横向滚动，包含：`All | Active | 东亚 | 东南亚 | 中亚南亚 | 西亚 | 欧洲非洲 | 北美 | 拉美`
+
+当前时区 Tab 默认选中。
+
+### 信号卡片流
+
+每张卡片两行信息：
+
+```
+┌──────────────────────────────┐
+│ Tokyo · ◆ Active             │
+│ Obs 28.1°C · Gap -0.8°C · Y 72¢ │
+│ High 29.3°C · DEB 30.0°C    │
+└──────────────────────────────┘
+```
+
+卡片字段：City、Signal、Obs、Gap、Market（第一行），High、DEB（第二行）
+
+## 文件变更范围
+
+### 主要文件
+
+| 文件 | 变更 | 说明 |
+|------|------|------|
+| `components/dashboard/ScanTerminalDashboard.tsx` | 重构 | 拆分 `MarketTable`、`KoyfinWeatherTerminal`，新增分组和卡片组件 |
+| `components/dashboard/scan-terminal/` | 新增 | `ContinentGroupHeader.tsx`、`ActiveSignalsGroup.tsx`、`MobileCityCard.tsx`、`MobileRegionTabs.tsx` |
+| `components/dashboard/scan-terminal/continent-grouping.ts` | 新增 | 分组逻辑：按 `trading_region` 分桶、Active Signals 筛选、折叠状态管理 |
+| `components/dashboard/scan-terminal/decision-utils.ts` | 修改 | 补充排序逻辑，Active Signals 置顶 |
+| `components/dashboard/ScanTerminalDashboard.module.css` | 修改 | 新增分组标题行、卡片流、Tab 栏样式 |
+| `components/dashboard/ScanTerminalLightTheme.module.css` | 新增/修改 | 浅色主题适配 |
+
+### 不改的文件
+
+- 后端 API：所有字段已就绪
+- `ScanOpportunityRow` 类型定义：字段充足
+- 数据获取 hooks：`useScanTerminalQuery` 保持不变
+
+## 信号状态枚举
+
+```
+◆ Active   — approve / tradable + active
+● Watch    — watch / monitor / peak_watch
+○ Closed   — veto / closed / inactive
+! Data     — 数据异常/缺失/延迟
+```
+
+## 验收标准
+
+1. 桌面端：7 时区 + Active Signals 分组，可折叠，9 列表格
+2. 移动端：Tab 切换 + 卡片流
+3. Gap 颜色按语义映射，非简单正负色
+4. Market 列显示价格格式（Y XX¢）
+5. 默认折叠规则：Active Signals 展开、有机遇展开、无机遇折叠
+6. 双主题（dark/light）CSS 适配
+7. TypeScript 类型检查通过
+8. `npm run build` 通过

docs/superpowers/specs/2026-05-26-production-realtime-sse-design.md

@@ -0,0 +1,319 @@
+# Production Realtime SSE Patch Design
+
+> 日期: 2026-05-26
+> 范围: PolyWeather 网站终端图表的生产级实时观测增量层
+> 目标服务器: 2 vCPU / 8 GB RAM / 50 GB 系统盘
+
+## 背景
+
+当前网站已经有 SSE patch 通道，但它更像一个进程内即时广播层：
+
+- 后端 `web/sse_manager.py` 用进程内 `asyncio.Queue` 管连接。
+- 采集器通过 `/api/internal/collector-patch` 推送城市温度变化。
+- 前端 `use-sse-patches.ts` 用 `EventSource` 接收 patch，并把温度合并到终端列表和图表。
+
+这个结构能做轻量实时更新，但还不是生产级“像股票行情一样”的实时架构。主要缺口是：
+
+- 断线后没有 replay event log。
+- 连接不能按城市订阅，只能广播后让前端筛选。
+- patch schema 没有版本化，后续扩展跑道、站点、最高温字段风险较高。
+- 多实例共享 pub/sub 还没有抽象边界。
+
+## 目标
+
+把当前实时层升级为“HTTP 快照基线 + SSE 增量观测事件 + 可重放事件日志”的架构：
+
+- 页面首屏仍通过 HTTP snapshot 加载完整 terminal rows / city detail。
+- 实测温度、站点观测、跑道观测通过 SSE 增量追加到图表。
+- 浏览器断线重连后可以通过 `since_revision` 补发错过的事件。
+- 前端只订阅当前可见城市，例如 2x2 图表中的四个城市。
+- patch payload 明确使用 `city_observation_patch.v1` schema。
+- 第一版用 SQLite event log 适配当前服务器规格，预留 Redis/Postgres event bus 接口。
+
+## 非目标
+
+第一版不做这些事：
+
+- 不把全部 terminal state 改成 event sourcing。
+- 不用 SSE 取代 `/api/scan/terminal` 或 `/api/city/{name}/detail`。
+- 不在第一版强依赖 Redis。
+- 不把 DEB、多模型、概率分布改成分钟级实时更新。
+- 不做 WebSocket；继续使用 SSE，因为浏览器端简单、代理友好、适合单向行情流。
+
+## 推荐架构
+
+```mermaid
+flowchart LR
+    Collector["WeatherDataCollector"] --> Ingest["POST /api/internal/collector-patch"]
+    Ingest --> Normalize["Patch schema normalizer"]
+    Normalize --> Log["SQLite observation_patch_events"]
+    Normalize --> Bus["PatchEventBus"]
+    Bus --> SSE["GET /api/events?cities=...&since_revision=..."]
+    API["HTTP snapshot APIs"] --> FE["Frontend terminal/chart state"]
+    SSE --> FE
+    FE -->|gap / stale / reconnect| API
+```
+
+## 事件存储
+
+新增 SQLite 表 `observation_patch_events`，由 `DBManager` 初始化。
+
+字段：
+
+- `revision INTEGER PRIMARY KEY AUTOINCREMENT`
+- `schema_type TEXT NOT NULL`
+- `schema_version INTEGER NOT NULL`
+- `city TEXT NOT NULL`
+- `source TEXT NOT NULL`
+- `obs_time TEXT`
+- `payload_json TEXT NOT NULL`
+- `created_at TEXT NOT NULL`
+
+索引：
+
+- `idx_observation_patch_events_city_revision(city, revision)`
+- `idx_observation_patch_events_created_at(created_at)`
+
+保留策略：
+
+- 默认保留 6 小时。
+- event log 只用于 SSE 断线 replay，不作为日内历史曲线归档。
+- 完整日内曲线仍由 `/api/city/{name}/detail` 从现有观测存储和 city cache 构建。
+- 6 小时窗口覆盖浏览器短线重连、页面休眠恢复和用户午后交易窗口内的 replay；超过窗口直接触发 HTTP resync。
+- 每次写入后低频触发清理，避免每条事件都扫表。
+- 环境变量：`POLYWEATHER_PATCH_EVENT_RETENTION_HOURS=6`。
+
+## Patch Schema v1
+
+事件类型固定为：
+
+```json
+{
+  "type": "city_observation_patch.v1",
+  "revision": 12345,
+  "city": "shanghai",
+  "source": "amsc_awos",
+  "obs_time": "2026-05-26T10:02:00Z",
+  "ts": 1780000000000,
+  "payload": {
+    "temp": 30.4,
+    "max_so_far": 31.0,
+    "station_code": "ZSPD",
+    "station_label": "Shanghai Pudong",
+    "series_key": "airport_primary",
+    "unit": "celsius",
+    "runway_points": [
+      {
+        "runway": "17L/35R",
+        "temp": 30.8,
+        "tdz_temp": 30.5,
+        "mid_temp": 30.6,
+        "end_temp": 30.8,
+        "is_settlement": true
+      }
+    ]
+  }
+}
+```
+
+兼容要求：
+
+- 前端仍接受旧 `city_patch` 一段时间，避免部署顺序问题。
+- 新事件统一转换成前端内部 `CityPatch`。
+- 后端 ingest 接受旧字段 `changes`，但写入 event log 时规范化成 v1。
+
+## SSE API
+
+`GET /api/events`
+
+查询参数：
+
+- `cities`: 逗号分隔城市 key，例如 `shanghai,hong kong,taipei`
+- `since_revision`: 客户端上次处理过的最大 revision
+- `replay_limit`: 最大补发数量，默认 500，上限 2000
+
+连接行为：
+
+1. 建立连接。
+2. 返回 `connected` event，包含当前 server revision。
+3. 如果传入 `since_revision`，先从 SQLite 补发匹配城市的历史事件。
+4. 进入 live stream，只推送匹配城市的事件。
+5. 每 30 秒发送 heartbeat。
+
+gap 处理：
+
+- 如果 `since_revision` 太旧，超过保留窗口或补发上限，服务端发送：
+
+```json
+{
+  "type": "resync_required",
+  "reason": "replay_window_exceeded",
+  "latest_revision": 12345
+}
+```
+
+- 前端收到后对当前可见城市调用 HTTP full detail resync。
+
+## 后端模块边界
+
+新增或调整模块：
+
+- `web/realtime_patch_schema.py`
+  - 负责规范化旧 `city_patch` 输入为 `city_observation_patch.v1`。
+  - 负责校验城市、温度、时间、source。
+
+- `web/realtime_event_store.py`
+  - 封装 SQLite event log 写入、查询、保留清理。
+  - 使用 `DBManager` 的 DB path。
+
+- `web/sse_manager.py`
+  - 从纯进程队列升级为基于 `PatchEventBus` 的连接管理。
+  - 保留进程内 live fanout。
+  - 每个连接记录订阅城市集合。
+
+- `web/routers/sse_router.py`
+  - 解析 `cities`、`since_revision`、`replay_limit`。
+  - ingest 后先写 event log，再广播 live event。
+
+第一版 `PatchEventBus`：
+
+- `SQLitePatchEventBus`
+- 写入 SQLite event log。
+- 进程内广播给当前 worker 的连接。
+
+后续可新增：
+
+- `RedisPatchEventBus`
+- `PostgresPatchEventBus`
+
+## 前端模块边界
+
+调整：
+
+- `frontend/hooks/use-sse-patches.ts`
+  - 支持 `city_observation_patch.v1`。
+  - 记录 `lastRevision`。
+  - 支持按可见城市集合建立 SSE URL。
+  - 收到 `resync_required` 时通知图表重拉。
+
+- `frontend/components/dashboard/scan-terminal/use-scan-terminal-query.ts`
+  - 继续负责 terminal rows 的 HTTP snapshot。
+  - 消费 patch 时只更新轻量字段：当前温度、最高温、观测时间。
+
+- `frontend/components/dashboard/scan-terminal/LiveTemperatureThresholdChart.tsx`
+  - 消费 patch 时追加分钟级观测点。
+  - 对 runway patch 更新对应 runway series。
+  - resync required 或长时间无 patch 时重拉 `/api/city/{name}/detail`。
+
+城市订阅策略：
+
+- 2x2 / 3x3 图表只订阅当前 slots 中的城市。
+- 移动端只订阅当前主图城市。
+- 切换布局或城市后重建 SSE 连接。
+
+## 数据流
+
+### 首屏加载
+
+1. 前端调用 `/api/scan/terminal` 得到 terminal rows。
+2. 每个可见图表调用 `/api/city/{name}/detail` 得到完整基线曲线。
+3. 前端用可见城市列表连接 `/api/events?cities=...&since_revision=...`。
+
+### 新观测进入
+
+1. `WeatherDataCollector` 发现温度或跑道观测变化。
+2. POST `/api/internal/collector-patch`。
+3. 后端规范化为 `city_observation_patch.v1`。
+4. 写入 SQLite event log，生成 revision。
+5. 广播给订阅该城市的 SSE 连接。
+6. 前端追加图表点并更新 terminal row。
+
+### 断线重连
+
+1. 前端保留 `lastRevision`。
+2. EventSource 断线后指数退避重连。
+3. 重连 URL 带 `since_revision=lastRevision`。
+4. 后端 replay missed events。
+5. 如果 replay 不完整，返回 `resync_required`，前端 HTTP 重拉。
+
+## 错误处理
+
+- ingest payload 无 city 或无有效 temp/runway point：返回 400。
+- event log 写入失败：返回 500，不广播，避免前端看到不可 replay 的事件。
+- SSE replay 查询失败：发送 `resync_required`，然后继续 heartbeat/live stream。
+- 前端收到未知 schema：忽略并记录 debug log。
+- 前端 revision 倒退：忽略。
+- 前端 revision 跳号：标记 gap，并触发 HTTP resync。
+
+## 测试策略
+
+后端：
+
+- `tests/test_realtime_patch_schema.py`
+  - 旧 `city_patch` 输入能规范化成 `city_observation_patch.v1`。
+  - 跑道 payload 保留 runway point。
+  - 无效 city/temp 返回校验失败。
+
+- `tests/test_realtime_event_store.py`
+  - append event 生成单调 revision。
+  - replay 按 city 过滤。
+  - retention cleanup 删除旧事件。
+
+- `tests/test_sse_replay.py`
+  - `/api/events?cities=...&since_revision=...` 只 replay 匹配城市。
+  - replay window 超限返回 `resync_required`。
+
+前端：
+
+- `frontend/components/dashboard/scan-terminal/__tests__/ssePatchArchitecture.test.ts`
+  - 确认 v1 schema、city subscription、since_revision URL 存在。
+
+- `frontend/components/dashboard/scan-terminal/__tests__/temperatureDefaultVisibilityPolicy.test.ts`
+  - 确认 patch 追加分钟级观测点。
+  - 确认 runway patch 更新对应 runway series。
+
+验收命令：
+
+```powershell
+pytest tests/test_realtime_patch_schema.py tests/test_realtime_event_store.py tests/test_sse_replay.py
+cd frontend
+npm run test:business
+npm run typecheck
+npm run build
+```
+
+## 部署与容量
+
+当前服务器 2 vCPU / 8 GB / 50 GB 足够第一版 SQLite-first：
+
+- 30 个高频城市，每分钟 1 条事件，约 43,200 条/天。
+- 默认只保留 6 小时，约 10,800 条事件。
+- payload 控制在 1-3 KB，SQLite event log 体积预计维持在几十 MB 内。
+- PM 最高温预测市场不需要把当天所有 patch 都保留在 event log；超过 replay 窗口时用 HTTP detail 重建当前画面。
+
+运行建议：
+
+- SQLite 使用 WAL。
+- event log 与现有 `POLYWEATHER_DB_PATH` 同库。
+- 先保持单 backend worker，避免进程内 fanout 跨 worker 不一致。
+- 多实例或多 worker 时再启用 Redis bus。
+
+## 后续 Redis 扩展
+
+当部署变成多实例或多 worker 后，新增 `RedisPatchEventBus`：
+
+- SQLite 仍作为 replay log。
+- Redis Pub/Sub 或 Redis Stream 负责跨实例 live fanout。
+- 每个 worker 从 Redis 订阅 live event，再投递给本进程 SSE 连接。
+
+这个扩展不改变前端协议。
+
+## 验收标准
+
+- 页面加载后可见图表只订阅当前城市。
+- 高频城市新观测进入后，图表在无需手动刷新下追加新点。
+- 浏览器断线重连后，能补齐断线期间的事件。
+- replay 超窗时，前端自动 HTTP resync。
+- 未订阅城市的事件不会推送到该连接。
+- 旧 `city_patch` 输入在迁移期仍可用。
+- 所有新增行为有自动化测试覆盖。

docs/superpowers/specs/2026-05-27-redis-stream-realtime-event-architecture-design.md

@@ -0,0 +1,408 @@
+# Redis Stream Realtime Event Architecture Design
+
+> 日期: 2026-05-27
+> 范围: PolyWeather 网站图表实时观测事件层
+> 目标服务器: 2 vCPU / 8 GB RAM / 50 GB 系统盘
+> 实施状态: 2026-05-28 已落地为 `v1.8.1`
+
+## 背景
+
+当前实时层已经具备生产化雏形：
+
+- 后端已有 `city_observation_patch.v1` schema。
+- `web/realtime_event_store.py` 使用 SQLite 保存 `observation_patch_events`，支持 `since_revision` replay。
+- `/api/events?cities=...&since_revision=...&replay_limit=...` 已经是前端 SSE 入口。
+- 前端 `frontend/hooks/use-sse-patches.ts` 使用 `EventSource`，并按当前可见城市订阅。
+
+这解决了单进程、单实例下的实时推送和短窗口 replay，但还不够“一步到位”：
+
+- 多 worker / 多实例时，进程内广播不能共享。
+- SQLite replay log 可以补数据，但不适合作为跨实例 live fanout。
+- 服务重启、浏览器后台恢复、SSE 断线后，需要更稳定的事件源。
+- 后续如果把采集器拆成独立进程，需要一个明确的后端事件总线。
+
+## 目标
+
+升级为“Redis Stream 主事件日志 + SSE 浏览器传输 + SQLite fallback”的架构：
+
+- Redis Stream 是生产环境实时事件主通道。
+- SSE 仍然是浏览器唯一实时入口。
+- 前端协议保持 `city_observation_patch.v1`，不让浏览器感知 Redis。
+- 继续使用 numeric `revision`，兼容现有前端 `since_revision` 逻辑。
+- 支持按城市订阅、断线 replay、多 worker fanout。
+- 事件只保留短窗口；当前默认按 Redis Stream `MAXLEN` 控制，建议以约 24 小时 replay 为目标，不做 72 小时保留。
+
+## 非目标
+
+这次不做以下事情：
+
+- 不引入 Kafka、RabbitMQ 或复杂 consumer group。
+- 不把天气历史数据全部 event sourcing。
+- 不让浏览器直接连接 Redis。
+- 不把 DEB 预测、模型曲线、概率分布都改成事件流。
+- 不做永久行情归档；超过 replay 窗口时继续走 HTTP full detail resync。
+
+## 推荐架构
+
+```mermaid
+flowchart LR
+    Collector["WeatherDataCollector / city refresh"] --> Ingest["POST /api/internal/collector-patch"]
+    Ingest --> Normalize["city_observation_patch.v1 normalizer"]
+    Normalize --> Store["RealtimeEventStore interface"]
+    Store --> Redis["Redis Stream: stream:city_observation"]
+    Store --> SQLite["SQLite fallback: observation_patch_events"]
+    Redis --> WorkerSub["Redis XREAD subscriber per API worker"]
+    WorkerSub --> LocalFanout["Local SSE fanout"]
+    SQLite --> ReplayFallback["SQLite replay fallback"]
+    SSE["GET /api/events?cities=...&since_revision=..."] --> Browser["Frontend EventSource"]
+    LocalFanout --> SSE
+    Redis --> SSE
+    ReplayFallback --> SSE
+    Browser --> Chart["Chart applies patch"]
+    Browser -->|resync_required| Detail["HTTP /api/city/{city}/detail"]
+```
+
+关键原则：
+
+- Redis Stream 负责后端事件保存、短窗口 replay、多实例共享。
+- SSE 负责服务端到浏览器的单向推送。
+- SQLite 只做 fallback 和本地开发，不再作为生产主事件总线。
+- 前端只认 patch event，不关心事件来自 Redis 还是 SQLite。
+
+## 事件模型
+
+继续使用现有 schema：
+
+```json
+{
+  "type": "city_observation_patch.v1",
+  "revision": 12345,
+  "city": "taipei",
+  "source": "cwa",
+  "obs_time": "2026-05-27T10:00:00+08:00",
+  "observed_at_utc": "2026-05-27T02:00:00Z",
+  "observed_at_local": "2026-05-27T10:00:00+08:00",
+  "city_local_date": "2026-05-27",
+  "city_timezone": "Asia/Taipei",
+  "source_cadence_sec": 600,
+  "ts": 1780000000000,
+  "payload": {
+    "temp": 34.2,
+    "max_so_far": 34.2,
+    "station_code": "466920",
+    "station_label": "中央气象署台北站",
+    "series_key": "settlement",
+    "unit": "celsius"
+  }
+}
+```
+
+`revision` 仍然是前端公开排序键，必须是全局单调递增整数。
+
+Redis Stream 自身的 stream ID，例如 `1780000000000-0`，只作为后端内部定位信息，不暴露给前端作为主 revision。
+
+## Redis Stream 设计
+
+Stream key:
+
+```text
+stream:city_observation
+```
+
+Revision key:
+
+```text
+counter:city_observation_revision
+```
+
+每条 stream entry 字段：
+
+- `revision`: 全局递增整数，公开给 SSE/前端。
+- `type`: `city_observation_patch.v1`
+- `city`: normalized city key。
+- `source`: source code，例如 `cwa`, `metar`, `amos`, `amsc_awos`。
+- `obs_time`: 原始观测时间。
+- `payload_json`: compact JSON。
+- `created_at_ms`: 写入 Redis 的 UTC epoch ms。
+- `producer_id`: API worker / collector instance id，便于排查。
+
+写入必须通过 Lua 脚本原子完成：
+
+1. `INCR counter:city_observation_revision`
+2. `XADD stream:city_observation MAXLEN ~ {maxlen} * revision ... payload_json ...`
+3. 返回 `{revision, stream_id}`
+
+原因：
+
+- 避免 `INCR` 成功但 `XADD` 失败后造成非必要 gap。
+- 让 revision 分配和事件入流成为一个原子操作。
+- 保持现有前端 numeric `since_revision` 不变。
+
+## Replay 策略
+
+`GET /api/events` 收到 `since_revision` 后：
+
+1. 读取 Redis Stream 最旧 entry，拿到 oldest revision。
+2. 如果 `since_revision > 0` 且 `since_revision < oldest_revision - 1`，发送 `resync_required`。
+3. 从 Redis Stream 顺序扫描事件。
+4. 过滤 `revision > since_revision`。
+5. 过滤 `city IN subscribed_cities`。
+6. 返回最多 `replay_limit + 1` 条。
+7. 如果超过 `replay_limit`，发送 `resync_required`，让前端 HTTP resync。
+
+当前事件量很小，单个 stream 顺序扫描 24 小时事件是可以接受的：
+
+- 30 城市 * 1 条/分钟 * 24 小时 = 43,200 条。
+- replay 通常只发生在断线重连，不是高频查询。
+
+如果后续城市量扩大，或者确实需要超过 24 小时的 replay，再加 per-city stream 或 Redis sorted index。
+
+## Live Fanout
+
+每个 API worker 启动一个 Redis subscriber loop：
+
+```text
+XREAD BLOCK 5000 STREAMS stream:city_observation {last_seen_stream_id}
+```
+
+读取到事件后：
+
+1. 解析 `city_observation_patch.v1`。
+2. 按本进程 SSE 连接的 `cities` subscription 过滤。
+3. 推送给本进程匹配的浏览器连接。
+4. 更新 worker 内存中的 `last_seen_stream_id`。
+
+ingest endpoint 写入 Redis 后不直接广播本地连接，由 subscriber loop 统一 fanout。这样避免同一个 worker 上“写入后本地广播一次、subscriber 又广播一次”的重复事件。
+
+前端仍然用 revision 去重。即使极端情况下收到重复 revision，也应忽略旧 revision。
+
+## SQLite Fallback
+
+保留当前 SQLite store，但角色调整为：
+
+- 本地开发无需 Redis 时使用。
+- Redis 不可用且允许降级时使用。
+- 单实例临时运行时可用。
+
+新增环境变量：
+
+```text
+POLYWEATHER_EVENT_STORE=redis
+POLYWEATHER_EVENT_STORE_FALLBACK=sqlite
+POLYWEATHER_REDIS_URL=redis://127.0.0.1:6379/0
+POLYWEATHER_REDIS_STREAM_KEY=stream:city_observation
+POLYWEATHER_REDIS_STREAM_MAXLEN=50000
+POLYWEATHER_PATCH_EVENT_RETENTION_HOURS=24
+POLYWEATHER_REDIS_REQUIRED=true
+```
+
+推荐生产策略：
+
+- `POLYWEATHER_EVENT_STORE=redis`
+- `POLYWEATHER_REDIS_REQUIRED=true`
+- Redis 写入失败时 ingest 返回 503，不广播不可 replay 的事件。
+
+推荐本地策略：
+
+- 不配置 Redis，自动使用 SQLite。
+- 或 `POLYWEATHER_EVENT_STORE=sqlite`。
+
+## Redis 容量与配置
+
+当前 VPS 可以跑本机 Redis。
+
+建议：
+
+```text
+bind 127.0.0.1
+protected-mode yes
+appendonly yes
+appendfsync everysec
+maxmemory 512mb
+maxmemory-policy noeviction
+```
+
+默认 `MAXLEN ~ 50000` 足够约 24 小时事件：
+
+- 30 城市 * 1/min * 24h = 43,200 条。
+- payload 约 1-3 KB，实际内存取决于 Redis Stream overhead。
+- 512 MB Redis maxmemory 对当前事件量足够。
+
+注意：这个事件流不是永久数据仓库。超过 24 小时窗口后，前端应 HTTP resync 当前城市 detail。
+
+## 模块边界
+
+新增/调整后端接口：
+
+### `web/realtime_event_store.py`
+
+定义统一接口：
+
+```python
+class RealtimeEventStore:
+    def append_event(self, event: dict) -> dict: ...
+    def replay_events(self, *, cities: set[str] | None, since_revision: int, limit: int) -> list[dict]: ...
+    def replay_requires_resync(self, *, cities: set[str] | None, since_revision: int, replay_count: int, limit: int) -> bool: ...
+    def latest_revision(self) -> int: ...
+```
+
+保留现有 SQLite 实现，新增 Redis 实现。
+
+### `web/redis_realtime_event_store.py`
+
+职责：
+
+- Redis 连接与健康检查。
+- Lua append script。
+- Redis Stream replay。
+- maxlen trim。
+- entry 到 SSE event 的反序列化。
+
+### `web/sse_manager.py`
+
+职责：
+
+- 管理本进程 SSE 连接。
+- 记录每个连接订阅城市集合。
+- 将 Redis subscriber 读到的 event fanout 给匹配连接。
+
+### `web/routers/sse_router.py`
+
+职责：
+
+- `/api/internal/collector-patch` 规范化并写入 event store。
+- `/api/events` 处理 connected、replay、heartbeat、live stream。
+- 当 replay 不完整时发送 `resync_required`。
+
+### 前端
+
+前端原则上不需要大改：
+
+- `use-sse-patches.ts` 继续使用 `EventSource`。
+- `lastRevision` 仍然是 number。
+- `resync_required` 继续触发当前可见城市 HTTP detail refresh。
+- 继续按可见城市列表构建 `cities` 参数。
+
+## 运行流程
+
+### 首屏
+
+1. 前端 HTTP 加载 terminal rows。
+2. 可见图表 HTTP 加载 full detail。
+3. 前端连接 `/api/events?cities=...&since_revision=...&replay_limit=500`。
+4. 后端先 replay Redis Stream 中缺失事件，再进入 live stream。
+
+### 新观测
+
+1. 采集器产生 `city_patch` 或 v1 patch。
+2. ingest endpoint 规范化成 `city_observation_patch.v1`。
+3. Redis Lua script 写入 stream 并生成 revision。
+4. 每个 API worker 的 subscriber loop 读到事件。
+5. worker fanout 给订阅对应城市的 SSE 连接。
+6. 前端 apply patch，图表无痛追加点。
+
+### 浏览器后台恢复
+
+1. EventSource 如果断线，前端按指数退避重连。
+2. URL 带 `since_revision=lastRevision`。
+3. Redis replay 补齐后台期间错过的事件。
+4. 如果 revision 太旧或 replay 超限，前端收到 `resync_required`，HTTP 重拉 full detail。
+
+## 错误处理
+
+- Redis append 失败且 `POLYWEATHER_REDIS_REQUIRED=true`：ingest 返回 503，不广播。
+- Redis append 失败且允许 fallback：写入 SQLite，并在 health 状态标记 degraded。
+- Redis replay 失败：SSE 发送 `resync_required`，然后继续尝试 live stream。
+- Redis subscriber loop 断开：指数退避重连；期间 SSE heartbeat 仍可维持连接，但不会有 live patch。
+- 前端收到 revision 倒退或重复：忽略。
+- 前端收到未知 event type：忽略并记录 debug。
+
+## 监控与诊断
+
+新增健康指标：
+
+- 当前 event store mode: `redis` / `sqlite` / `degraded_sqlite`
+- Redis ping latency
+- latest revision
+- stream length
+- oldest revision
+- subscriber connected
+- SSE active connection count
+- dropped/resync_required count
+
+建议暴露到现有 health endpoint 或日志：
+
+```json
+{
+  "realtime": {
+    "store": "redis",
+    "redis_connected": true,
+    "stream_len": 43210,
+    "latest_revision": 123456,
+    "oldest_revision": 80200,
+    "subscriber_connected": true,
+    "sse_connections": 9
+  }
+}
+```
+
+## 测试策略
+
+后端：
+
+- Redis store append 会生成全局递增 numeric revision。
+- Redis replay 支持 city 过滤。
+- Redis replay 支持 `since_revision`。
+- Redis replay 超出 retention/limit 返回 resync required。
+- Redis 不可用时，根据 env 严格失败或 fallback SQLite。
+- SQLite store 现有测试保持通过。
+- SSE router 在 Redis store 下仍发送 connected、replay、heartbeat。
+
+前端：
+
+- `use-sse-patches.ts` 保持 `revision` numeric。
+- 重连 URL 保留 `since_revision`。
+- 收到 `resync_required` 会触发 visible city refresh。
+- 重复 revision 不重复追加图表点。
+
+验收命令：
+
+```powershell
+python -m pytest tests/test_realtime_patch_schema.py tests/test_realtime_event_store.py tests/test_sse_replay.py
+python -m pytest tests/test_redis_realtime_event_store.py
+cd frontend
+npm run test:business
+npm run typecheck
+npm run build
+```
+
+## 迁移步骤
+
+1. 保留现有 SQLite implementation，抽出 event store factory。
+2. 新增 Redis implementation 和单元测试。
+3. 新增 Redis subscriber loop，但先在本地开发环境跑。
+4. `/api/events` 接入 event store factory。
+5. 线上安装 Redis，只监听 `127.0.0.1`。
+6. 先用 `POLYWEATHER_EVENT_STORE=redis`、`POLYWEATHER_REDIS_REQUIRED=false` 灰度。
+7. 观察 stream length、latest revision、SSE error、resync count。
+8. 稳定后切换 `POLYWEATHER_REDIS_REQUIRED=true`。
+9. 保留 SQLite fallback 代码，但生产不主动降级，避免多实例状态分裂。
+
+## 验收标准
+
+- 断开浏览器网络 1-5 分钟后恢复，图表自动补齐期间 patch。
+- 后台挂页面再回来，图表不需要等待 full loading 才更新当前点。
+- 多 worker 下，任意 worker 写入的 patch 都能推到其他 worker 的 SSE 连接。
+- `/api/events?cities=taipei,shanghai&since_revision=...` 只 replay 指定城市。
+- Redis 重启后，前端收到 `resync_required` 并 HTTP 重建画面。
+- 前端无需知道 Redis 存在。
+- 现有 `city_observation_patch.v1` schema 不破坏。
+
+## 结论
+
+这是一种“一步到位但不过度设计”的方案：
+
+- 一步到位的是事件契约、replay、跨实例 fanout 和生产部署边界。
+- 不过度设计的是不用 Kafka、不做永久行情库、不重写前端协议。
+
+对当前产品最关键的是：图表像股票行情一样无痛刷新，断线可补，后台恢复可追上，多实例以后不用再推倒实时层。

docs/superpowers/specs/2026-06-08-feedback-reward-account-detail-design.md

@@ -0,0 +1,124 @@
+# Feedback Reward Account Detail Design
+
+## Goal
+
+Show users which submitted feedback earned points, how many points were awarded, and why.
+
+The first implementation focuses on account-page visibility. The later ops workflow for automatic reward issuance should reuse the same fields and display contract.
+
+## Current Context
+
+- `user_feedback` already stores each submitted feedback item with `status`, `message`, `user_id`, `user_email`, timestamps, and context JSON.
+- `/api/feedback` already returns the current user's feedback list.
+- `AccountFeedbackPanel` already renders the current user's feedback in the account page.
+- Current points balance is shown through `/api/auth/me`, but account UI has no per-feedback reward source detail.
+- Existing points grant helpers update `users.points`; feedback-specific rewards are not yet linked back to a feedback row.
+
+## Scope
+
+In scope:
+
+- Add feedback reward metadata to feedback rows.
+- Return reward metadata through the existing current-user feedback API.
+- Display feedback reward details in the account page next to the matching feedback item.
+- Keep the data contract ready for future ops automation: a processed feedback item can carry reward points and a human-readable reason.
+
+Out of scope for this phase:
+
+- Building the ops action that decides and grants points.
+- Sending push/email/Telegram notifications after ops processing.
+- Rebuilding a general points ledger for all point sources.
+- Merging historical Supabase referral ledger entries into the account page.
+
+## Data Model
+
+Extend `user_feedback` with nullable columns:
+
+- `reward_points INTEGER DEFAULT 0`
+- `reward_reason TEXT DEFAULT ''`
+- `rewarded_at TIMESTAMP`
+- `reward_status TEXT DEFAULT ''`
+
+Recommended `reward_status` values:
+
+- empty string: no reward decision recorded
+- `granted`: points were awarded for this feedback
+- `skipped`: reviewed but no points awarded
+- `pending`: reward decision is queued or awaiting processing
+
+The display should treat `reward_points > 0` as the strongest signal that the user earned points.
+
+## API Contract
+
+`DBManager._feedback_row_to_dict()` should include:
+
+- `reward_points`
+- `reward_reason`
+- `rewarded_at`
+- `reward_status`
+
+`GET /api/feedback` should continue using the same response shape:
+
+```json
+{
+  "feedback": [
+    {
+      "id": 123,
+      "status": "resolved",
+      "message": "Hong Kong COWIN reading looked stale",
+      "reward_points": 300,
+      "reward_reason": "Valid data freshness report",
+      "rewarded_at": "2026-06-08T12:00:00",
+      "reward_status": "granted"
+    }
+  ]
+}
+```
+
+The frontend proxy does not need a new route if it transparently forwards the existing payload.
+
+## Account UI
+
+`AccountFeedbackPanel` should show reward detail inside each feedback row:
+
+- Granted reward: `+300 points` plus reward reason.
+- Skipped reward: a muted note that no points were awarded, with reason if available.
+- Pending reward: a small pending label.
+- No reward metadata: render nothing extra to avoid noise.
+
+The account page should remain dense and scannable. Reward content belongs inside the existing feedback row, not in a separate marketing-style card.
+
+## Future Ops Workflow
+
+The later feedback-processing feature can use a single backend operation:
+
+1. Update feedback status.
+2. Grant points to the matching user.
+3. Write `reward_points`, `reward_reason`, `rewarded_at`, and `reward_status = granted` back to the same feedback row.
+
+If the grant fails, the operation should not mark the feedback as granted. It should either keep `reward_status = pending` or return a clear ops error.
+
+## Error Handling
+
+- Missing reward fields should default to zero or empty strings in API responses.
+- If old SQLite databases do not have the new columns, `DBManager` migration should add them with `_ensure_column`.
+- Account UI should tolerate partial payloads without crashing.
+- Reward reason should be bounded in storage and display to avoid oversized rows.
+
+## Testing
+
+Backend tests:
+
+- Existing feedback rows serialize reward fields with defaults.
+- Updating reward metadata for a feedback row returns the fields in `/api/feedback`.
+- Old rows without rewards still list normally.
+
+Frontend tests:
+
+- Account feedback panel displays `+N points` and reason for rewarded feedback.
+- Skipped and pending reward states render without implying points were granted.
+- Rows without reward metadata do not show an empty reward block.
+
+## Rollout
+
+This is a backward-compatible schema and UI change. Existing feedback rows keep working with empty reward metadata. The account page can ship before the ops reward action; it will simply show reward details once rows carry those fields.

docs/superpowers/specs/2026-06-12-growth-milestone-pro-rewards-design.md

@@ -0,0 +1,51 @@
+# Growth Milestone Pro Rewards Design
+
+## Goal
+
+Reward active paid Pro members with additional membership time when PolyWeather
+reaches verified-user growth milestones.
+
+## Confirmed Rules
+
+- Growth is measured using verified Supabase Auth users.
+- The historical launch baseline is:
+  - 588 total registered users
+  - 573 verified users
+  - recorded on 2026-06-12
+- Milestones and rewards:
+  - 600 verified users: +1 Pro day
+  - 750 verified users: +2 Pro days
+  - 1000 verified users: +3 Pro days
+  - every additional 100 verified users after 1000: +3 Pro days
+- Each milestone settles at most once.
+- Only users who currently have active membership access and have at least one
+  confirmed real payment are eligible.
+- Trial-only, manual-grant-only, and reward-only users are excluded.
+
+## Architecture
+
+The Telegram Bot process already acts as the single background-job owner. A new
+growth milestone loop runs there on a low-frequency interval. It reads verified
+Auth-user counts, writes one daily growth snapshot, checks unsettled milestones,
+selects eligible paid members, and grants an append-only bonus subscription
+window.
+
+SQLite stores daily snapshots, milestone settlement summaries, and per-user
+payout records. Supabase stores the actual bonus subscription. The bonus source
+contains the milestone number so a retry can detect an already-issued reward.
+
+## Failure Handling
+
+- Supabase read failures do not advance or settle a milestone.
+- Successful user payouts are recorded individually.
+- Failed payouts are retried on the next loop run.
+- A milestone is marked settled only when all eligible payouts succeed.
+- Bonus subscription writes use a milestone-specific source as an additional
+  idempotency guard.
+
+## Notification
+
+After a milestone settles, the Bot posts one concise bilingual group
+announcement when announcements are enabled. It includes the milestone, reward
+days, and rewarded member count.
+

docs/ux-research-review.md

@@ -0,0 +1,189 @@
+# PolyWeather UX 研究员审查报告
+
+> 审查日期：2026-06 | 视角：UX 研究员 | 范围：用户理解修正逻辑、第一眼认知、图表误导风险、普通用户语言、天气异常体验
+
+## 一、修正逻辑：用户是否看懂"上修/下修/维持"？
+
+### 当前状态
+
+AI 后端提示词明确要求 AI 使用**上修 / 下修 / 维持**三个方向词（`scan_city_ai_prompt.py:47-51`）。但前端 `WeatherDecisionBand` 完全不用这三个词，而是用：
+
+| AI 判断方向 | 前端实际展示 | 中文原文 |
+|------------|------------|---------|
+| 上修（偏暖） | "Watch hotter range" | "关注偏高温区间" |
+| 下修（偏冷） | "Avoid chasing high" | "暂不追高温" |
+| 维持（中性） | "Wait for peak-window confirmation" | "等待峰值窗口确认" |
+
+### 问题
+
+| # | 问题 | 严重度 |
+|---|------|------|
+| 1 | **AI 输出与前端展示词汇不一致** — AI 用"上修/下修/维持"，用户看到的是"关注偏高温/暂不追/等待确认"。这是两套完全不同的语言体系，用户读完 AI 解读再看决策条可能对不上号 | 🔴 |
+| 2 | **没有"维持/不变"标签** — 中性状态被表述为动作（"等待确认"），而不是状态（"维持不变"）。用户想知道"现在是什么判断"而不是"现在该做什么" | 🟡 |
+| 3 | **"偏高温区间" vs "暂不追高温" 不对称** — 上修方向指向一个温度区间，下修方向指向一个行为。一个说 where，一个说 what。逻辑结构不一致 | 🟡 |
+| 4 | **颜色语义双重解读** — warm=红色边框=偏暖（上修），cold=绿色边框=偏冷（下修）。天气直觉是"热=红、冷=蓝/绿"，但金融直觉是"红=跌、绿=涨"。两类用户可能得出相反的解读 | 🟡 |
+
+### 建议
+
+统一词汇体系，前端和 AI 使用同一套语言：
+
+| 方向 | 建议前端标签 | 建议说明 |
+|------|------------|---------|
+| 上修 | **"预计最高温上修"** / "Revise upward" | 比 DEB/模型集群基准偏高 |
+| 下修 | **"预计最高温下修"** / "Revise downward" | 比 DEB/模型集群基准偏低 |
+| 维持 | **"维持模型基准"** / "Stay with model base" | 无需显著上修或下修 |
+
+---
+
+## 二、第一眼理解：用户打开卡片看到什么？
+
+### 视觉层级
+
+```
+1. CityCardHeader
+   ├─ Kicker: "城市深度分析" / "Deep analysis"
+   ├─ 城市名（大号标题）
+   ├─ 状态标签（实测突破 / METAR 过旧 / 模型高度一致 等）
+   ├─ 数据新鲜度条（METAR / 模型 / 市场 / AI 各自的新鲜度）
+   └─ 三指标：当前温度 | 预计最高温 | 峰值时间
+
+2. WeatherDecisionBand（修正条）
+   ├─ Kicker: "天气优先判断 · 市场价格另列"
+   ├─ 主体判断（大号粗体）: "关注偏高温区间" / "暂不追高温" / "等待峰值窗口确认"
+   ├─ 原因文字（高亮 pill 内）
+   └─ 三指标：天气区间 | 路径偏差 | 报价状态
+
+3. 图表 + AI 证据 + 模型证据
+```
+
+### 问题
+
+| # | 问题 | 严重度 |
+|---|------|------|
+| 5 | **Kicker 说了两遍"市场"** — Header 的 kicker 是"城市深度分析"，Decision band 的 kicker 是"天气优先判断 · 市场价格另列"。两个 kicker 都提到了市场，但新手不知道"市场"指的是 Polymarket 温度合约。这个词对圈外人完全无意义 | 🟡 |
+| 6 | **"预计最高温"没有解释来源** — 用户看到这个数字，不知道它是 AI 独立判断的、还是 DEB 融合的、还是某一个模型给的。只有一个数字，没有可信度标签 | 🟡 |
+| 7 | **状态标签过多** — 一个卡片可能同时显示 3-4 个标签：实测突破 + 峰值窗口已过 + METAR 过旧 + 模型高度一致。这些标签颜色不同、含义各异，用户需要逐一解码 | 🟢 |
+
+---
+
+## 三、图表是否误导？
+
+### 日内温度图表（`AiCityTemperatureChart`）
+
+三条线：
+- 灰色虚线：DEB 原始路径（过去+未来都是虚线）
+- 蓝色实线：METAR 修正路径
+- 绿色散点：METAR 实测
+
+### 问题
+
+| # | 问题 | 严重度 |
+|---|------|------|
+| 8 | **DEB 路径永远是虚线** — 即使过去部分（已发生的几小时）也是虚线。虚线在图形语言中普遍表示"不确定/预测"，但过去几小时 DEB 已经是根据已知观测计算的，不应该看起来不确定 | 🟡 |
+| 9 | **没有"现在"标记** — 图表上没有任何竖线或标记指示当前时间。用户不知道图表上哪里是"现在"，哪里是"未来" | 🔴 |
+| 10 | **X 轴标签稀疏** — 每 4 个小时才显示一个标签，最多 6 个。用户可能以为数据只在标记的小时上有，实际上每个小时都有数据 | 🟢 |
+| 11 | **HistoryChart 缺 °C/°F** — 历史图 tooltip 只显示 `°`，没有 `C` 或 `F`。在混合温度单位的环境下可能混淆 | 🟡 |
+| 12 | **没有轴标题** — Y 轴只有数字 + °C，没有"温度"标签。对新手来说不够自解释（虽然常见于仪表盘类产品） | 🟢 |
+
+### 建议
+
+| 建议 | 实现 |
+|------|------|
+| 添加"现在"竖线 | `chart-utils.ts` 中在 `currentIndex` 位置画一条 annotation line |
+| 过去 DEB 改为实线 | `segment: { borderDash: past=[], future=[6,4] }` 给过去和未来不同样式 |
+| HistoryChart tooltip 补全单位 | 使用 `data.temp_symbol` 替代硬编码 `°` |
+
+---
+
+## 四、普通用户能看懂多少？
+
+### 高频出现的专业术语
+
+| 术语 | 出现次数 | 用户理解难度 | 是否有解释 |
+|------|---------|------------|----------|
+| **METAR** | ~50+ 处 | 高 — 只有飞行员/气象人员知道 | ❌ 无 |
+| **DEB** | ~30+ 处 | 高 — 项目内部术语 | ❌ 无 |
+| **TAF** | ~15 处 | 高 — 航空术语 | ❌ 无 |
+| **峰值窗口** | ~20 处 | 中 — 可推测含义 | ❌ 无 |
+| **模型集群** | ~10 处 | 中 — 可推测含义 | ❌ 无 |
+| **边界层** | 3 处 | 极高 — 气象学专业术语 | ❌ 无 |
+| **冷平流/暖平流** | 2 处 | 极高 — 气象学专业术语 | ❌ 无 |
+| **中枢** | ~8 处 | 中 — 在这个语境下表示中心值 | ❌ 无 |
+
+### 问题
+
+| # | 问题 | 严重度 |
+|---|------|------|
+| 13 | **所有专业术语都没有 tooltip 或解释** — METAR、DEB、TAF 在全站出现数十次，没有任何地方解释它们是什么。用户的唯一学习途径是 `/docs` 页面，但需要主动离开看板去查阅 | 🔴 |
+| 14 | **AI 输出的"最终判断"字段直接暴露给用户** — 如果 AI 提到了"冷平流支撑"、"边界层逆温"等术语，前端不做任何改写或解释，直接原样展示。用户要么读懂，要么跳过 | 🟡 |
+| 15 | **"DEB 融合"对普通用户完全无意义** — 这是一个内部算法名称。用户需要的是"综合预报"或"多模型加权平均"，而不是一个缩写 | 🟡 |
+
+### 建议
+
+| 建议 | 实现 |
+|------|------|
+| 核心术语加 tooltip | 首次出现的 METAR/DEB/TAF 加 `title` 属性或悬浮解释 |
+| DEB 改用用户语言 | "DEB 融合" → "多模型综合预报" 或保留 DEB 但加括号说明 |
+| AI 术语过滤 | 在后端 `scan_city_ai_fallback.py` 或前端展示层过滤掉过于专业的术语 |
+
+---
+
+## 五、天气异常时的体验
+
+### 当前异常信号和用户看到的反馈
+
+| 异常事件 | 前端展示 | 评估 |
+|---------|---------|------|
+| 实测温度突破模型上沿 | 红色标签"实测突破" + "Observation has broken above the model range" | ✅ 清晰 |
+| METAR 数据过旧（超过一天） | 黄色标签"METAR 过旧" + "已过旧，仅作背景参考" + 数据新鲜度条标红 | ✅ 清晰 |
+| 峰值窗口已过 | 灰色标签"峰值窗口已过" + 温度图表可能显示下降趋势 | ⚠️ 图表不标注窗口起止 |
+| 模型数据不足（<2个模型） | "等待模型补齐" | ⚠️ 没说为什么模型少、什么时候能补上 |
+| 市场价格不可用 | "市场价暂不可用" + "天气证据可参考，但暂无可交易价格" | ✅ 清晰 |
+| 快速判断与完整解读不一致 | 先显示"快速判断已完成"，再异步合并完整 AI 解读 | ⚠️ 两种状态切换可能让用户困惑 |
+
+### 问题
+
+| # | 问题 | 严重度 |
+|---|------|------|
+| 16 | **异常没有"下一步"指引** — 当实测突破模型上沿时，用户看到"Observation has broken above the model range"，但不知道这意味着该做什么。是应该买入？卖出？等待？系统不给建议 | 🔴 |
+| 17 | **"快速判断"和"完整解读"的切换可能造成 flicker** — 卡片先显示快速判断文案，然后完整 AI 返回后替换。如果两者结论一致，用户感知不到变化；如果不一致，用户会困惑"刚才不是这么说的" | 🟡 |
+| 18 | **极端天气没有特别处理** — 如果城市出现 40°C+ 或 -10°C 以下的极端温度，卡片和普通温度展示方式完全一样，没有视觉强调 | 🟢 |
+
+### 建议
+
+| 建议 | 实现 |
+|------|------|
+| 异常加行动建议 | 在 `primaryReason` 后追加一句行动建议（"建议等待下一报文后再做判断" / "建议关注更高温区间"） |
+| 极端温度视觉强化 | 温度超过历史极值时加大字号或添加红色脉冲高亮 |
+| 快速→完整过渡加标记 | 文案更新时显示 "✓ 已更新" 小标记，避免用户以为信息没变 |
+
+---
+
+## 六、优先级总结
+
+### P0 — 用户理解障碍
+
+| # | 问题 | 建议 |
+|---|------|------|
+| 1 | AI 用"上修/下修"，前端用"偏高温/暂不追" | 统一为"上修/下修/维持"三词 |
+| 9 | 图表没有"现在"标记 | 在 currentIndex 位置画竖线 |
+| 13 | METAR/DEB/TAF 全站无解释 | 加 title tooltip + 首次出现时加括号说明 |
+| 16 | 异常没有行动建议 | 在 primaryReason 后追加引导文字 |
+
+### P1 — 体验提升
+
+| # | 问题 | 建议 |
+|---|------|------|
+| 3 | 上修/下修文案不对称 | 统一用"方向 + 幅度"格式 |
+| 4 | 红/绿颜色双重解读 | 保留但加文字标签确认 |
+| 8 | DEB 路径全是虚线 | 过去部分用实线，未来部分用虚线 |
+| 15 | "DEB 融合"对普通用户无意义 | 改为"多模型综合预报" |
+
+### P2 — 优化打磨
+
+| # | 问题 | 建议 |
+|---|------|------|
+| 11 | HistoryChart 缺 °C/°F | 使用 temp_symbol |
+| 12 | 图表无轴标题 | 可加可不加（仪表盘惯例） |
+| 17 | 快速→完整 flicker | 加过渡标记 |
+| 18 | 极端温度无强调 | 加视觉强化 |

extension/README.md

@@ -1,12 +1,12 @@
 # PolyWeather Side Panel
 
-`PolyWeather Side Panel` 是一个面向天气交易场景的 Chrome / Edge 浏览器侧边栏工具。
+`PolyWeather Side Panel` 是一个面向天气交易市场的 Chrome / Edge 浏览器侧边栏工具。
 
 ## 功能
 
 1. 自动识别当前 Polymarket 页面中的城市，也支持手动切换。
 2. 展示城市档案：结算站点、站点距离、观测更新时间、周边站点数量。
-3. 展示今日日内走势（简版）：`DEB` 走势与官方观测（`METAR / HKO / CWA / NOAA`）对照，可悬停查看时间与温度。
+3. 展示今日日内走势（简版）：`DEB` 走势与机场/官方观测对照，可悬停查看时间与温度。
 4. 展示多日最高温预报（简版），当前以 `DEB` 优先。
 5. 支持一键刷新，强制拉取最新温度数据。
 6. 支持本地缓存，提升打开速度；插件版本更新时会刷新城市列表缓存。
@@ -15,8 +15,9 @@
 ## 数据说明
 
 - 香港使用 `HKO`（香港天文台）结算源。
-- 其他城市按配置使用 `METAR / NOAA / 官方数据源`。
+- 其他城市按配置使用 `METAR / NOAA / AMOS / JMA / MGM / FMI / KNMI` 等官方数据源。
 - 城市展示名以主站返回值为准，例如 `aurora` 市场在插件中会显示为 `Denver`。
+- 首尔/釜山/东京/安卡拉/伊斯坦布尔/赫尔辛基/阿姆斯特丹已接入高频机场实时数据（1-10 分钟级）。
 
 ## 权限说明
 
@@ -33,24 +34,24 @@
 1. 打开 Chrome/Edge 扩展页面：
    - Chrome：`chrome://extensions`
    - Edge：`edge://extensions`
-2. 打开“开发者模式”。
-3. 选择“加载已解压的扩展程序”。
+2. 打开"开发者模式"。
+3. 选择"加载已解压的扩展程序"。
 4. 选择目录：`extension/`。
 5. 点击扩展图标，侧边栏会打开。
 
 ## 设置
 
-首次建议打开扩展“选项页”并确认：
+首次建议打开扩展"选项页"并确认：
 
-- `网站基础地址`：你的前端域名（例如 `https://polyweather-pro.vercel.app`）
+- `网站基础地址`：你的前端域名（例如 `https://polyweather.top`）
 - `API 基础地址`：你的后端 API 域名（若同域也可填前端域名）
 - `Bearer Token`：后端开启鉴权时填写
 
 ## 说明
 
-- 当前版本仍是轻量产品，重点是“监控 + 基础判断 + 导流回站”，未接入支付链路。
+- 当前版本仍是轻量产品，重点是"监控 + 基础判断 + 导流回站"，未接入支付链路。
 - 若你的 API 做了严格鉴权，请先在设置页填写 token 再使用。
-- 插件城市列表来自主站 `/api/cities`，不是插件内置静态列表；本版已升级缓存版本，安装更新后会重新拉取 Manila、Karachi、Masroor Air Base 等最新城市。
-- 插件走势图与主站保持一致：`Wunderground / weather.com` 是历史参考页，不是物理实测站；机场市场统一显示机场 `METAR` / 官方观测点位。
-- 点击“打开网站查看更多”会回到主站继续查看完整分析。
+- 插件城市列表来自主站 `/api/cities`，非内置静态列表；安装更新后自动刷新最新城市。
+- 机场市场统一显示机场 `METAR` / 官方观测点位，部分城市已覆盖 1 分钟级实时数据。
+- 点击"打开网站查看更多"会回到主站继续查看完整分析。
 - 插件不会承载完整分析；完整结构判断、历史对账和更多信号仍以主站为准。

extension/manifest.json

@@ -2,7 +2,7 @@
   "manifest_version": 3,
   "name": "PolyWeather Side Panel",
   "description": "Weather side panel for Polymarket.",
-  "version": "0.1.10",
+  "version": "0.1.11",
   "icons": {
     "16": "icon-16.png",
     "32": "icon-32.png",

extension/options.html

@@ -12,12 +12,12 @@
 
       <label class="field">
         <span id="siteBaseLabel">Site Base URL</span>
-        <input id="siteBaseInput" type="text" placeholder="https://polyweather-pro.vercel.app" />
+        <input id="siteBaseInput" type="text" placeholder="https://polyweather.top" />
       </label>
 
       <label class="field">
         <span id="apiBaseLabel">API Base URL</span>
-        <input id="apiBaseInput" type="text" placeholder="https://polyweather-pro.vercel.app" />
+        <input id="apiBaseInput" type="text" placeholder="https://polyweather.top" />
       </label>
 
       <label class="field">

extension/options.js

@@ -1,6 +1,6 @@
 const DEFAULT_CONFIG = {
-  apiBase: "https://polyweather-pro.vercel.app",
-  siteBase: "https://polyweather-pro.vercel.app",
+  apiBase: "https://polyweather.top",
+  siteBase: "https://polyweather.top",
   authToken: "",
   selectedCity: ""
 };

extension/sidepanel.js

@@ -1,8 +1,8 @@
 const DEFAULT_CONFIG = {
-  apiBase: "https://polyweather-pro.vercel.app",
+  apiBase: "https://polyweather.top",
   authToken: "",
   selectedCity: "",
-  siteBase: "https://polyweather-pro.vercel.app"
+  siteBase: "https://polyweather.top"
 };
 const CACHE_VERSION = "v3";
 const locale = String(navigator.language || "en").toLowerCase().startsWith("zh")

frontend-next-3002.log

@@ -1,10 +0,0 @@
-
-> polyweather-frontend@1.5.4 start
-> next start -p 3002
-
-   ▲ Next.js 15.5.12
-   - Local:        http://localhost:3002
-   - Network:      http://172.23.64.1:3002
-
- ✓ Starting...
- ✓ Ready in 541ms

frontend/.dockerignore

@@ -0,0 +1,12 @@
+.git
+.next
+node_modules
+
+.env
+.env.local
+.env.production
+.env.*
+!.env.example
+
+*.log
+*.tsbuildinfo

frontend/.env.example

@@ -15,6 +15,11 @@ NEXT_PUBLIC_POLYWEATHER_API_BASE_URL=
 NEXT_PUBLIC_SUPABASE_URL=
 NEXT_PUBLIC_SUPABASE_ANON_KEY=
 
+# 必填：生产环境站点 URL（OAuth 回调强制使用此域名）
+# 设置后，所有登录回调将始终跳转到此域名，而非当前浏览器地址。
+# 生产环境必须设为 https://polyweather.top
+NEXT_PUBLIC_SITE_URL=https://polyweather.top
+
 # 常用：前端鉴权开关
 # true: 启用 Supabase 登录
 # false: 关闭登录能力，访客模式
@@ -25,10 +30,6 @@ POLYWEATHER_AUTH_ENABLED=false
 # false: 登录可选，访客可浏览
 POLYWEATHER_AUTH_REQUIRED=false
 
-# 可选：分享式看板访问令牌
-# 设置后，可通过 /?access_token=<token> 打开受保护看板
-POLYWEATHER_DASHBOARD_ACCESS_TOKEN=
-
 # 可选：前端 API Route 转发到后端时附带的共享令牌
 # 仅当后端启用了 entitlement / 订阅校验时需要
 POLYWEATHER_BACKEND_ENTITLEMENT_TOKEN=
@@ -36,7 +37,11 @@ POLYWEATHER_BACKEND_ENTITLEMENT_TOKEN=
 # 可选：钱包支付 / Telegram 入口
 NEXT_PUBLIC_WALLETCONNECT_PROJECT_ID=
 NEXT_PUBLIC_WALLETCONNECT_POLYGON_RPC_URL=https://polygon-bor-rpc.publicnode.com
-NEXT_PUBLIC_PAYMENT_ALLOWED_HOSTS=polyweather-pro.vercel.app
+NEXT_PUBLIC_PAYMENT_ALLOWED_HOSTS=polyweather.top,www.polyweather.top
+NEXT_PUBLIC_TURNSTILE_SITE_KEY=
+POLYWEATHER_TURNSTILE_SECRET_KEY=
+POLYWEATHER_TURNSTILE_BYPASS=false
 POLYWEATHER_OPS_ADMIN_EMAILS=yhrsc30@gmail.com
 NEXT_PUBLIC_TELEGRAM_GROUP_URL=https://t.me/your_group
-NEXT_PUBLIC_TELEGRAM_BOT_URL=https://t.me/WeatherQuant_bot
+NEXT_PUBLIC_TELEGRAM_BOT_URL=https://t.me/polyyuanbot
+NEXT_PUBLIC_TELEGRAM_LOGIN_BOT_USERNAME=polyyuanbot

frontend/.env.local

@@ -1 +0,0 @@
-POLYWEATHER_API_BASE_URL=http://127.0.0.1:8000

frontend/.gitignore

@@ -1 +1,6 @@
 .vercel
+.env
+.env.local
+.env.production
+.env.*
+!.env.example

frontend/Dockerfile

@@ -0,0 +1,44 @@
+FROM node:20-alpine AS deps
+
+WORKDIR /app/frontend
+COPY package.json package-lock.json ./
+RUN npm ci
+
+FROM node:20-alpine AS builder
+
+ARG NEXT_PUBLIC_SUPABASE_URL
+ARG NEXT_PUBLIC_SUPABASE_ANON_KEY
+ARG NEXT_PUBLIC_SITE_URL
+ARG NEXT_PUBLIC_POLYWEATHER_API_BASE_URL
+ARG NEXT_PUBLIC_POLYWEATHER_LOCAL_FULL_ACCESS
+ARG NEXT_PUBLIC_WALLETCONNECT_PROJECT_ID
+ARG NEXT_PUBLIC_WALLETCONNECT_POLYGON_RPC_URL
+ARG NEXT_PUBLIC_PAYMENT_ALLOWED_HOSTS
+ARG NEXT_PUBLIC_TURNSTILE_SITE_KEY
+
+ENV NEXT_PUBLIC_SUPABASE_URL=$NEXT_PUBLIC_SUPABASE_URL
+ENV NEXT_PUBLIC_SUPABASE_ANON_KEY=$NEXT_PUBLIC_SUPABASE_ANON_KEY
+ENV NEXT_PUBLIC_SITE_URL=$NEXT_PUBLIC_SITE_URL
+ENV NEXT_PUBLIC_POLYWEATHER_API_BASE_URL=$NEXT_PUBLIC_POLYWEATHER_API_BASE_URL
+ENV NEXT_PUBLIC_POLYWEATHER_LOCAL_FULL_ACCESS=$NEXT_PUBLIC_POLYWEATHER_LOCAL_FULL_ACCESS
+ENV NEXT_PUBLIC_WALLETCONNECT_PROJECT_ID=$NEXT_PUBLIC_WALLETCONNECT_PROJECT_ID
+ENV NEXT_PUBLIC_WALLETCONNECT_POLYGON_RPC_URL=$NEXT_PUBLIC_WALLETCONNECT_POLYGON_RPC_URL
+ENV NEXT_PUBLIC_PAYMENT_ALLOWED_HOSTS=$NEXT_PUBLIC_PAYMENT_ALLOWED_HOSTS
+ENV NEXT_PUBLIC_TURNSTILE_SITE_KEY=$NEXT_PUBLIC_TURNSTILE_SITE_KEY
+
+WORKDIR /app/frontend
+COPY --from=deps /app/frontend/node_modules ./node_modules
+COPY . ./
+RUN npm run build && npm prune --omit=dev
+
+FROM node:20-alpine AS runner
+
+ENV NODE_ENV=production
+WORKDIR /app/frontend
+
+COPY --from=builder /app/frontend/public ./public
+COPY --from=builder /app/frontend/.next/standalone ./
+COPY --from=builder /app/frontend/.next/static ./.next/static
+
+EXPOSE 3000
+CMD ["node", "server.js"]

frontend/README.md

@@ -3,13 +3,13 @@
 PolyWeather Pro 的生产前端工程。
 
 线上地址：
-- [https://polyweather-pro.vercel.app/](https://polyweather-pro.vercel.app/)
+- [https://polyweather.top/](https://polyweather.top/)
 
 ## 技术栈
 
 - Next.js App Router
 - React + Tailwind
-- Leaflet + Chart.js
+- 自研温度图表 + Recharts 运营图表
 - Supabase Auth
 - WalletConnect + 浏览器 EVM 钱包
 
@@ -21,30 +21,21 @@ PolyWeather Pro 的生产前端工程。
 
 ## 当前前端能力
 
-- 主站 Dashboard 支持地图、城市详情、今日日内分析、历史准确率对账和账户中心
-- `/docs` 已提供公开双语产品文档中心，解释日内分析、校准概率、模型栈、TAF、结算来源和历史对账
-- 今日日内分析支持：
-  - `锚点状态`
-  - `当前节奏`
-  - `校准模型概率`
-  - `模型区间与分歧`
-  - `专业气象结论条`
-  - `气象证据链 / 失效条件 / 确认条件`
-  - 非香港机场城市的 `TAF` 时段提示与走势图联动
-- 历史对账支持：
-  - `DEB / 最佳单模型 / 实测最高温` 对比
-  - 峰值前 12 小时 `DEB` 参考（近似）
+- 主站为实时天气决策台，包含 `天气决策 / 训练数据 / 使用指南` 三个主入口
+- `/docs` 提供公开双语产品文档中心，当前保留简介、图表阅读、实时数据频率、结算站点和浏览器插件说明
+- 天气决策台支持 1x1 到 3x3 图表槽位，可按区域、搜索和城市选择进行多城市巡检
+- 终端图表默认展示全天，可切换高温窗口；所有横轴与 tooltip 时间按城市当地时间渲染
+- 可见终端图表通过 SSE patch 增量刷新，后台切回前台时主动补齐最新 detail，不用 loading 遮罩覆盖已有曲线
+- AMSC/AMOS 跑道城市默认展示结算跑道曲线并高亮，辅助跑道弱化展示；单跑道机场不重复展示聚合线
+- 香港默认展示 CoWIN 6087 参考站 1 分钟曲线，并保留 HKO 10 分钟官方气象层
+- legacy 高斯概率在图表上展示为概率温度带和 `mu` 参考线，不作为时间序列曲线
+- 使用指南内置图表阅读顺序、图层含义、常用操作和默认可见性规则
 - `/ops` 已支持桌面表格 + 手机端卡片化视图
-- 点击城市图标后会显示地图顶部同步提醒与详情面板内同步徽标，避免用户误判为卡住
-- 城市详情会自动识别“单模型 / 单日”的稀疏缓存并主动刷新，避免误把残缺 detail 当作完整结果
-- 右侧详情面板在多日预报仍未补齐时会显示同步占位卡，不再把“只有今天一张卡”的中间态伪装成完整数据
-- 日内分析弹窗在 full detail / market scan 同步时会锁住旧内容并显示刷新状态，避免用户短暂看到旧城市或旧日期的数据
-- 城市决策卡支持从地图点击城市进入；机会榜和日历仍按 Pro 权限控制，地图探索和城市简报可作为轻量入口
-- 城市决策卡的 AI 机场报文解读包括最终判断、METAR 解读、推理说明、模型集群备注、风险提示和原始 METAR
-- AI 机场报文解读按 `city + local_date + locale + METAR signature` 做页面内存缓存和 `localStorage` 最终结果缓存；切换选项卡返回时会优先恢复已有内容
-- 市场价格层使用完整 `all_buckets` 匹配温度桶，并把 `模型-市场差` 解释为 `模型概率 - 市场隐含概率`
-- 概率区展示当前生产概率引擎输出；EMOS / LGBM 只在评估通过或 shadow 对照时进入解释层，模型共识和市场价格只作为辅助说明
-- `/ops` 现已展示 prewarm worker 运行态、缓存桶状态与 summary cache hit/miss
+- 城市 detail 自动识别稀疏缓存并主动刷新，避免误把残缺 detail 当作完整结果
+- 市场价格层使用完整 `all_buckets` 匹配温度桶，市场信号作为交易判断层，不替代实测结算源
+- legacy 高斯概率在图表上展示为概率温度带和 `mu` 参考线，不作为时间序列曲线
+- 账户中心支付区支持后端下发的多链网络选择；Polygon 继续走 checkout 合约，Ethereum 主网 USDC 走手动直转确认
+- 缓存桶状态与 summary cache hit/miss
 
 ## 本地开发
 
@@ -55,7 +46,7 @@ npm ci
 npm run dev
 ```
 
-## Vercel 最小部署配置
+## 最小部署配置
 
 只跑看板和基础鉴权时，先填这 4 项：
 
@@ -93,12 +84,12 @@ POLYWEATHER_BACKEND_ENTITLEMENT_TOKEN=
 # 钱包支付
 NEXT_PUBLIC_WALLETCONNECT_PROJECT_ID=
 NEXT_PUBLIC_WALLETCONNECT_POLYGON_RPC_URL=https://polygon-bor-rpc.publicnode.com
-NEXT_PUBLIC_PAYMENT_ALLOWED_HOSTS=polyweather-pro.vercel.app
+NEXT_PUBLIC_PAYMENT_ALLOWED_HOSTS=polyweather.top,www.polyweather.top
 POLYWEATHER_OPS_ADMIN_EMAILS=yhrsc30@gmail.com
 
 # 社群入口
 NEXT_PUBLIC_TELEGRAM_GROUP_URL=https://t.me/<your_group>
-NEXT_PUBLIC_TELEGRAM_BOT_URL=https://t.me/WeatherQuant_bot
+NEXT_PUBLIC_TELEGRAM_BOT_URL=https://t.me/polyyuanbot
 
 # 推荐默认关闭的前端观测 / 预热开关
 NEXT_PUBLIC_POLYWEATHER_APP_ANALYTICS=false
@@ -106,7 +97,7 @@ NEXT_PUBLIC_POLYWEATHER_WEB_VITALS=false
 NEXT_PUBLIC_POLYWEATHER_EAGER_CITY_SUMMARIES=false
 ```
 
-更完整的 Vercel 配置说明见：
+更完整的部署配置说明见：
 - [docs/FRONTEND_DEPLOYMENT_ZH.md](/E:/web/PolyWeather/docs/FRONTEND_DEPLOYMENT_ZH.md)
 
 ## 路由处理器
@@ -117,7 +108,6 @@ NEXT_PUBLIC_POLYWEATHER_EAGER_CITY_SUMMARIES=false
 - `GET /api/city/[name]`
 - `GET /api/city/[name]/summary`
 - `GET /api/city/[name]/detail`
-- `GET /api/history/[name]`
 
 鉴权：
 
@@ -148,13 +138,12 @@ Ops：
 
 当前前端已内置轻量管理页：
 
-- [https://polyweather-pro.vercel.app/ops](https://polyweather-pro.vercel.app/ops)
+- [https://polyweather.top/ops](https://polyweather.top/ops)
 
 页面当前支持：
 
 - 系统状态
 - SQLite / rollout / 支付运行态
-- prewarm worker 运行态
 - 缓存桶状态与 summary cache hit/miss
 - 用户查询
 - 当前会员
@@ -166,7 +155,7 @@ Ops：
 注意：
 
 - `/ops` 现在是前后端双层管理员限制
-- Vercel 前端和后端都应配置相同的 `POLYWEATHER_OPS_ADMIN_EMAILS`
+- 前端容器和后端都应配置相同的 `POLYWEATHER_OPS_ADMIN_EMAILS`
 - 前端登录邮箱本身不会自动获得管理员权限
 
 ## 支付安全补充
@@ -177,12 +166,13 @@ Ops：
 2. 若 `receiver_contract` 已更新，先切到最新地址
 3. 若后端返回的 `tx_payload.to` 与最新地址不一致，直接阻断支付
 4. 仅允许在 `NEXT_PUBLIC_PAYMENT_ALLOWED_HOSTS` 白名单域名上创建 payment intent
-5. 支付区会明确显示当前账号、付款钱包和收款合约，避免账号/钱包/地址混淆
+5. 支付区会明确显示当前账号、付款钱包、支付网络和收款合约/钱包，避免账号/钱包/地址/链混淆
+6. 多链支付时，前端会把用户选择的 `chain_id` 和 `token_address` 发给后端，由后端按 intent 的链确认交易
 
 这意味着：
 
 - 旧标签页风险已明显降低
-- 但支付地址变更后，仍建议在 Vercel 上 redeploy 当前 production，并清理明显过期 deployment
+- 支付地址变更后，由于地址在前端镜像构建期注入，需要触发一次 `main` push（或重跑 deploy workflow）发布新镜像；浏览器侧靠 `/api/payments/config` 的运行时校验兜底
 
 ## 缓存行为
 
@@ -190,13 +180,15 @@ Ops：
 - `summary?force_refresh=true`：`no-store`
 - 支付相关路由：`no-store`
 - 当 detail 缓存只返回单模型或单日 forecast 时，前端会自动强刷完整 detail，并在补齐前显示同步提示 / 占位卡
-- 今日日内分析打开时如果正在切换城市、日期或 detail 深度，弹窗会阻断旧内容点击并显示刷新锁
+- detail 正在切换城市、日期或分辨率时，图表保留已有曲线并显示同步提示，避免把旧数据当作当前状态
+- 终端图表订阅 `/api/events?cities=...&since_revision=...&replay_limit=按可见城市数动态限制`，接收 `city_observation_patch.v1`；无 patch 超过 2 分钟时，可见图表才触发 60 秒兜底刷新
+- 前端只消费 HTTP snapshot + SSE patch，不直接感知 Redis；Redis Stream / SQLite event log 都由后端统一封装
 
-## Vercel 节流建议
+## 成本与节流建议
 
-- 生产环境建议关闭 `Web Analytics` 和 `Speed Insights`
+- 前端与后端以 Docker Compose 部署在同一 VPS，静态资源通过 Cloudflare 缓存（见 `next.config.mjs` 的 `headers()` 和 CI 的 `cloudflare-cache-rules` job）
 - 建议把自建 `app analytics / web vitals / eager city summaries` 默认保持关闭
-- 如果你部署在 Vercel，可在 Firewall 中加一条 `WordPress / php scanner` 拦截规则，避免无效扫描白白触发 middleware
+- 如果扫描流量明显，可在 Cloudflare WAF 中加一条 `WordPress / php scanner` 拦截规则，避免无效扫描白白触发 Nginx / middleware
 
 ## AGPL 与商用边界说明
 
@@ -205,4 +197,4 @@ Ops：
 
 详见根目录策略文档：`docs/OPEN_CORE_POLICY.md`
 
-最后更新：`2026-04-19`
+最后更新：`2026-05-29`

frontend/app/account/error.tsx

@@ -0,0 +1,97 @@
+"use client";
+
+import { RefreshCw } from "lucide-react";
+import { useEffect } from "react";
+import { I18nProvider, useI18n } from "@/hooks/useI18n";
+
+function AccountErrorContent({
+  error,
+  reset,
+}: {
+  error: Error & { digest?: string };
+  reset: () => void;
+}) {
+  const { locale } = useI18n();
+  const isEn = locale === "en-US";
+
+  useEffect(() => {
+    console.error("Account page error:", error);
+  }, [error]);
+
+  return (
+    <div
+      style={{
+        display: "flex",
+        flexDirection: "column",
+        alignItems: "center",
+        justifyContent: "center",
+        minHeight: "100vh",
+        padding: "2rem",
+        gap: "1rem",
+        backgroundColor: "var(--color-bg-base, #0B1220)",
+        color: "var(--color-text-primary, #E6EDF3)",
+        fontFamily: "var(--font-data, Inter, sans-serif)",
+        textAlign: "center",
+      }}
+    >
+      <h1
+        style={{
+          fontSize: "1.25rem",
+          fontWeight: 600,
+          margin: 0,
+          color: "var(--color-accent-primary, #4DA3FF)",
+        }}
+      >
+        {isEn ? "Account Page Error" : "账户页面出错"}
+      </h1>
+      <p
+        style={{
+          color: "var(--color-text-secondary, #9FB2C7)",
+          fontSize: "0.875rem",
+          margin: 0,
+          maxWidth: 420,
+          lineHeight: 1.7,
+        }}
+      >
+        {isEn
+          ? "If this happened during payment or wallet binding, the most common cause is conflicting wallet extensions (e.g. MetaMask and Rabby open at the same time). Try disabling other wallet extensions and refresh."
+          : "如果是在支付或绑定钱包时出现此问题，常见原因是钱包插件冲突（例如同时开启了 MetaMask 和 Rabby）。请尝试关闭其他钱包插件后刷新页面重试。"}
+      </p>
+      <button
+        type="button"
+        onClick={reset}
+        style={{
+          marginTop: "0.5rem",
+          display: "inline-flex",
+          alignItems: "center",
+          gap: "0.5rem",
+          padding: "0.5rem 1.25rem",
+          borderRadius: "var(--radius-md, 10px)",
+          border: "1px solid var(--color-border-default, rgba(159,178,199,0.16))",
+          backgroundColor: "var(--color-bg-raised, #111A2E)",
+          color: "var(--color-accent-primary, #4DA3FF)",
+          cursor: "pointer",
+          fontSize: "0.875rem",
+          fontWeight: 500,
+        }}
+      >
+        <RefreshCw size={14} />
+        {isEn ? "Retry" : "重试"}
+      </button>
+    </div>
+  );
+}
+
+export default function AccountErrorPage({
+  error,
+  reset,
+}: {
+  error: Error & { digest?: string };
+  reset: () => void;
+}) {
+  return (
+    <I18nProvider>
+      <AccountErrorContent error={error} reset={reset} />
+    </I18nProvider>
+  );
+}

frontend/app/account/page.tsx

@@ -1,4 +1,5 @@
 import type { Metadata } from "next";
+import { Suspense } from "react";
 import { I18nProvider } from "@/hooks/useI18n";
 import { AccountEntry } from "@/components/account/AccountEntry";
 
@@ -10,7 +11,9 @@ export const metadata: Metadata = {
 export default function AccountPage() {
   return (
     <I18nProvider>
-      <AccountEntry />
+      <Suspense fallback={null}>
+        <AccountEntry />
+      </Suspense>
     </I18nProvider>
   );
 }

frontend/app/api/analytics/events/route.ts

@@ -7,47 +7,118 @@ import {
   buildProxyExceptionResponse,
   buildUpstreamErrorResponse,
 } from "@/lib/api-proxy";
+import {
+  createProxyTimer,
+  finishProxyTimedResponse,
+} from "@/lib/proxy-timing";
 
 const API_BASE = process.env.POLYWEATHER_API_BASE_URL;
 const ANALYTICS_ENABLED =
-  process.env.NEXT_PUBLIC_POLYWEATHER_APP_ANALYTICS === "true";
+  process.env.NEXT_PUBLIC_POLYWEATHER_APP_ANALYTICS !== "false";
+const ANALYTICS_PROXY_TIMEOUT_MS = Math.max(
+  250,
+  Number(process.env.POLYWEATHER_ANALYTICS_PROXY_TIMEOUT_MS || "1500") || 1500,
+);
 
 export async function POST(req: NextRequest) {
+  const timer = createProxyTimer(req, "analytics_events");
   if (!ANALYTICS_ENABLED) {
-    return new NextResponse(null, { status: 204 });
-  }
-
-  if (!API_BASE) {
-    return NextResponse.json(
-      { error: "POLYWEATHER_API_BASE_URL is not configured" },
-      { status: 500 },
+    return finishProxyTimedResponse(
+      new NextResponse(null, { status: 204 }),
+      timer,
+      "disabled",
     );
   }
 
+  if (!API_BASE) {
+    return finishProxyTimedResponse(
+      NextResponse.json(
+        { error: "POLYWEATHER_API_BASE_URL is not configured" },
+        { status: 500 },
+      ),
+      timer,
+      "missing_api_base",
+    );
+  }
+
+  const controller = new AbortController();
+  const timeoutId = setTimeout(() => controller.abort(), ANALYTICS_PROXY_TIMEOUT_MS);
+  let auth: Awaited<ReturnType<typeof buildBackendRequestHeaders>> | null = null;
+
   try {
-    const body = await req.json();
-    const auth = await buildBackendRequestHeaders(req);
+    const body = await timer.measure("request_read", () => req.json());
+    const payload =
+      body && typeof body.payload === "object" && body.payload != null
+        ? body.payload
+        : {};
+    const enrichedBody = {
+      ...(body ?? {}),
+      payload: {
+        ...payload,
+        cf_country: req.headers.get("cf-ipcountry") || "",
+        user_agent: req.headers.get("user-agent") || "",
+        referer_header: req.headers.get("referer") || "",
+      },
+    };
+    auth = await timer.measure("auth_headers", () =>
+      buildBackendRequestHeaders(req, {
+        includeSupabaseIdentity: false,
+      }),
+    );
     const headers = new Headers(auth.headers);
     headers.set("Content-Type", "application/json");
-    const res = await fetch(`${API_BASE}/api/analytics/events`, {
-      method: "POST",
-      headers,
-      body: JSON.stringify(body ?? {}),
-      cache: "no-store",
-    });
+    const res = await timer.measure("backend_fetch", () =>
+      fetch(`${API_BASE}/api/analytics/events`, {
+        method: "POST",
+        headers,
+        body: JSON.stringify(enrichedBody),
+        cache: "no-store",
+        signal: controller.signal,
+      }),
+    );
+    const backendServerTiming = res.headers.get("server-timing") || "";
     if (!res.ok) {
-      const raw = await res.text();
+      const raw = await timer.measure("backend_read", () => res.text());
       const response = buildUpstreamErrorResponse(res.status, raw, {
         detailLimit: 260,
       });
-      return applyAuthResponseCookies(response, auth.response);
+      return finishProxyTimedResponse(
+        applyAuthResponseCookies(response, auth.response),
+        timer,
+        `upstream_${res.status}`,
+        { backendServerTiming },
+      );
     }
-    const data = await res.json();
+    const data = await timer.measure("backend_read", () => res.json());
     const response = NextResponse.json(data);
-    return applyAuthResponseCookies(response, auth.response);
+    return finishProxyTimedResponse(
+      applyAuthResponseCookies(response, auth.response),
+      timer,
+      "ok",
+      { backendServerTiming },
+    );
   } catch (error) {
-    return buildProxyExceptionResponse(error, {
-      publicMessage: "Failed to track analytics event",
-    });
+    const timedOut = controller.signal.aborted;
+    const response = timedOut
+      ? NextResponse.json(
+          {
+            ok: false,
+            accepted: true,
+            dropped: true,
+            reason: "timeout",
+          },
+          { status: 202 },
+        )
+      : buildProxyExceptionResponse(error, {
+          publicMessage: "Failed to track analytics event",
+        });
+    const withCookies = auth ? applyAuthResponseCookies(response, auth.response) : response;
+    return finishProxyTimedResponse(
+      withCookies,
+      timer,
+      timedOut ? "timeout_accepted" : "exception",
+    );
+  } finally {
+    clearTimeout(timeoutId);
   }
 }

frontend/app/api/auth/me/route.ts

@@ -4,104 +4,686 @@ import {
   buildBackendRequestHeaders,
 } from "@/lib/backend-auth";
 import {
-  buildProxyExceptionResponse,
   buildUpstreamErrorResponse,
 } from "@/lib/api-proxy";
 import {
   getLocalDevAuthPayload,
   isLocalFullAccessHost,
 } from "@/lib/local-dev-access";
+import {
+  applyEntitlementSnapshotCookie,
+  clearEntitlementSnapshotCookie,
+  entitlementSnapshotToAuthPayload,
+  readEntitlementSnapshot,
+} from "@/lib/entitlement-snapshot";
+import {
+  buildSubscriptionRequiredAuthProfile,
+  isSubscriptionRequiredBackendResponse,
+} from "@/lib/auth-profile-proxy";
+import {
+  hasSupabaseServerEnv,
+  hasSupabaseSessionCookieValues,
+} from "@/lib/supabase/server";
 
 const API_BASE = process.env.POLYWEATHER_API_BASE_URL;
 
+type AuthMeTimingStage = {
+  durationMs: number;
+  name: string;
+};
+
+type AuthMeTimer = {
+  hasAuthorization: boolean;
+  hasSupabaseCookie: boolean;
+  measure<T>(name: string, action: () => Promise<T>): Promise<T>;
+  measureSync<T>(name: string, action: () => T): T;
+  preferSnapshot: boolean;
+  stages: AuthMeTimingStage[];
+  totalMs(): number;
+};
+
+function authMeNowMs() {
+  return typeof performance !== "undefined" ? performance.now() : Date.now();
+}
+
+function createAuthMeTimer(req: NextRequest): AuthMeTimer {
+  const startedAt = authMeNowMs();
+  const stages: AuthMeTimingStage[] = [];
+  const recordStage = (name: string, stageStartedAt: number) => {
+    stages.push({
+      durationMs: Math.round((authMeNowMs() - stageStartedAt) * 10) / 10,
+      name,
+    });
+  };
+
+  return {
+    hasAuthorization: Boolean(req.headers.get("authorization")),
+    hasSupabaseCookie: hasRequestSupabaseSessionCookie(req),
+    async measure<T>(name: string, action: () => Promise<T>) {
+      const stageStartedAt = authMeNowMs();
+      try {
+        return await action();
+      } finally {
+        recordStage(name, stageStartedAt);
+      }
+    },
+    measureSync<T>(name: string, action: () => T) {
+      const stageStartedAt = authMeNowMs();
+      try {
+        return action();
+      } finally {
+        recordStage(name, stageStartedAt);
+      }
+    },
+    preferSnapshot: req.nextUrl.searchParams.get("prefer_snapshot") === "1",
+    stages,
+    totalMs() {
+      return Math.round((authMeNowMs() - startedAt) * 10) / 10;
+    },
+  };
+}
+
+function formatServerTiming(stages: AuthMeTimingStage[], totalMs: number) {
+  return [...stages, { durationMs: totalMs, name: "total" }]
+    .map(({ durationMs, name }) => {
+      const safeName = name.replace(/[^A-Za-z0-9_-]/g, "_");
+      return `${safeName};dur=${Math.max(0, durationMs).toFixed(1)}`;
+    })
+    .join(", ");
+}
+
+function buildBackendAuthMeUrl(req: NextRequest) {
+  const url = new URL(`${API_BASE!.replace(/\/+$/, "")}/api/auth/me`);
+  if (req.nextUrl.searchParams.get("scope") === "entitlement") {
+    url.searchParams.set("scope", "entitlement");
+  }
+  return url.toString();
+}
+
+function finishAuthMeResponse(
+  response: NextResponse,
+  timer: AuthMeTimer,
+  outcome: string,
+  extra?: { backendServerTiming?: string },
+) {
+  const total = timer.totalMs();
+  const ownServerTiming = formatServerTiming(timer.stages, total);
+  const backendServerTiming = String(extra?.backendServerTiming || "").trim();
+  response.headers.set("Cache-Control", "no-store");
+  response.headers.set(
+    "Server-Timing",
+    backendServerTiming
+      ? `${ownServerTiming}, ${backendServerTiming}`
+      : ownServerTiming,
+  );
+  console.info(
+    "[auth-me-timing]",
+    JSON.stringify({
+      backendServerTiming: backendServerTiming || undefined,
+      hasAuthorization: timer.hasAuthorization,
+      hasSupabaseCookie: timer.hasSupabaseCookie,
+      outcome,
+      preferSnapshot: timer.preferSnapshot,
+      stagesMs: Object.fromEntries(
+        timer.stages.map((stage) => [stage.name, stage.durationMs]),
+      ),
+      status: response.status,
+      totalMs: total,
+    }),
+  );
+  return response;
+}
+
+async function trackAuthDiagnosticEvent(
+  req: NextRequest,
+  {
+    email,
+    reason,
+    responseMode,
+    userId,
+  }: {
+    email: string | null;
+    reason: string;
+    responseMode: "snapshot" | "degraded" | "anonymous";
+    userId?: string | null;
+  },
+) {
+  if (!API_BASE) return;
+  const normalizedUserId = String(userId || "").trim();
+  const controller = new AbortController();
+  const timeoutId = setTimeout(() => controller.abort(), 1200);
+  try {
+    await fetch(`${API_BASE}/api/analytics/events`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({
+        event_type: "degraded_auth_profile",
+        client_id: normalizedUserId ? `auth:${normalizedUserId}` : undefined,
+        payload: {
+          route: "/api/auth/me",
+          reason: String(reason || "unknown").slice(0, 240),
+          response_mode: responseMode,
+          user_id: normalizedUserId || undefined,
+          email_domain: email?.includes("@") ? email.split("@").pop() : undefined,
+          cf_country: req.headers.get("cf-ipcountry") || "",
+          user_agent: req.headers.get("user-agent") || "",
+          referer_header: req.headers.get("referer") || "",
+          captured_at: new Date().toISOString(),
+        },
+      }),
+      cache: "no-store",
+      signal: controller.signal,
+    });
+  } catch {
+    // Diagnostics must never block auth/profile fallback responses.
+  } finally {
+    clearTimeout(timeoutId);
+  }
+}
+
+type VerifiedBearerIdentity = {
+  email: string | null;
+  userId: string;
+};
+
+function extractBearerToken(headerValue: string | null) {
+  if (!headerValue) return "";
+  const parts = headerValue.trim().split(/\s+/);
+  if (parts.length === 2 && parts[0].toLowerCase() === "bearer") {
+    return parts[1];
+  }
+  return "";
+}
+
+async function getVerifiedBearerIdentity(
+  req: NextRequest,
+): Promise<VerifiedBearerIdentity | null> {
+  const token = extractBearerToken(req.headers.get("authorization"));
+  if (!token) return null;
+
+  const supabaseUrl = process.env.NEXT_PUBLIC_SUPABASE_URL?.trim();
+  const anonKey = process.env.NEXT_PUBLIC_SUPABASE_ANON_KEY?.trim();
+  if (!supabaseUrl || !anonKey) return null;
+
+  const controller = new AbortController();
+  const timeoutId = setTimeout(() => controller.abort(), 4000);
+  try {
+    const res = await fetch(`${supabaseUrl.replace(/\/+$/, "")}/auth/v1/user`, {
+      cache: "no-store",
+      headers: {
+        apikey: anonKey,
+        Authorization: `Bearer ${token}`,
+      },
+      signal: controller.signal,
+    });
+    if (!res.ok) return null;
+    const user = await res.json();
+    const userId = String(user?.id || "").trim();
+    if (!userId) return null;
+    return {
+      email: String(user?.email || "").trim() || null,
+      userId,
+    };
+  } catch {
+    return null;
+  } finally {
+    clearTimeout(timeoutId);
+  }
+}
+
+async function degradedAuthProfileResponse({
+  email,
+  reason,
+  req,
+  response,
+  userId,
+}: {
+  email: string | null;
+  reason: string;
+  req: NextRequest;
+  response: NextResponse | null;
+  userId: string;
+}) {
+  const snapshotPayload = entitlementSnapshotToAuthPayload(
+    readEntitlementSnapshot(req, userId),
+  );
+  if (snapshotPayload) {
+    await trackAuthDiagnosticEvent(req, {
+      email: snapshotPayload.email || email,
+      reason,
+      responseMode: "snapshot",
+      userId,
+    });
+    const snapshotResponse = NextResponse.json({
+      ...snapshotPayload,
+      email: snapshotPayload.email || email,
+      entitlement_snapshot_reason: reason,
+    });
+    return applyAuthResponseCookies(snapshotResponse, response);
+  }
+
+  await trackAuthDiagnosticEvent(req, {
+    email,
+    reason,
+    responseMode: "degraded",
+    userId,
+  });
+  const degraded = NextResponse.json({
+    authenticated: true,
+    user_id: userId,
+    email,
+    subscription_active: null,
+    subscription_plan_code: null,
+    subscription_expires_at: null,
+    subscription_total_expires_at: null,
+    subscription_queued_days: 0,
+    subscription_queued_count: 0,
+    points: 0,
+    degraded_auth_profile: true,
+    degraded_reason: reason,
+  });
+  return applyAuthResponseCookies(degraded, response);
+}
+
+function subscriptionRequiredAuthProfileResponse({
+  email,
+  response,
+  userId,
+}: {
+  email: string | null;
+  response: NextResponse | null;
+  userId: string;
+}) {
+  const inactive = NextResponse.json(
+    buildSubscriptionRequiredAuthProfile({ email, userId }),
+  );
+  clearEntitlementSnapshotCookie(inactive);
+  return applyAuthResponseCookies(inactive, response);
+}
+
+async function unauthenticatedAuthProfileResponse({
+  reason,
+  req,
+  response,
+}: {
+  reason: string;
+  req: NextRequest;
+  response: NextResponse | null;
+}) {
+  await trackAuthDiagnosticEvent(req, {
+    email: null,
+    reason,
+    responseMode: "anonymous",
+  });
+  const anonymous = NextResponse.json(
+    {
+      authenticated: false,
+      subscription_active: false,
+      points: 0,
+      degraded_auth_profile: true,
+      degraded_reason: reason,
+    },
+    { headers: { "Cache-Control": "no-store" } },
+  );
+  clearEntitlementSnapshotCookie(anonymous);
+  return applyAuthResponseCookies(anonymous, response);
+}
+
+function snapshotAuthProfileResponse({
+  email,
+  reason,
+  req,
+  response,
+  userId,
+}: {
+  email: string | null;
+  reason: string;
+  req: NextRequest;
+  response: NextResponse | null;
+  userId: string;
+}) {
+  const snapshotPayload = entitlementSnapshotToAuthPayload(
+    readEntitlementSnapshot(req, userId),
+  );
+  if (!snapshotPayload) return null;
+  const snapshotResponse = NextResponse.json({
+    ...snapshotPayload,
+    email: snapshotPayload.email || email,
+    entitlement_snapshot_reason: reason,
+  });
+  return applyAuthResponseCookies(snapshotResponse, response);
+}
+
+function applyEntitlementSnapshotFromAuthPayload(
+  response: NextResponse,
+  data: Record<string, unknown>,
+) {
+  if (data.authenticated === true && data.subscription_active === true) {
+    return applyEntitlementSnapshotCookie(response, data);
+  }
+  if (data.authenticated === false || data.subscription_active === false) {
+    return clearEntitlementSnapshotCookie(response);
+  }
+  return response;
+}
+
+function hasRequestSupabaseSessionCookie(req: NextRequest) {
+  return hasSupabaseSessionCookieValues(
+    req.cookies.getAll().map((item) => ({
+      name: item.name,
+      value: item.value,
+    })),
+  );
+}
+
 export async function GET(req: NextRequest) {
+  const timer = createAuthMeTimer(req);
   const requestHost =
     req.headers.get("x-forwarded-host") || req.headers.get("host") || req.nextUrl.host;
   if (
     isLocalFullAccessHost(requestHost) ||
     isLocalFullAccessHost(req.nextUrl.hostname)
   ) {
-    return NextResponse.json(getLocalDevAuthPayload(), {
-      headers: { "Cache-Control": "no-store" },
-    });
-  }
-
-  if (!API_BASE) {
-    return NextResponse.json(
-      { error: "POLYWEATHER_API_BASE_URL is not configured" },
-      { status: 500 },
+    return finishAuthMeResponse(
+      NextResponse.json(getLocalDevAuthPayload(), {
+        headers: { "Cache-Control": "no-store" },
+      }),
+      timer,
+      "local_full_access",
     );
   }
 
-  try {
-    const auth = await buildBackendRequestHeaders(req);
-    const controller = new AbortController();
-    const timeoutId = setTimeout(() => controller.abort(), 6000);
-    let res: Response;
-    try {
-      res = await fetch(`${API_BASE}/api/auth/me`, {
-        headers: auth.headers,
-        cache: "no-store",
-        signal: controller.signal,
-      });
-    } finally {
-      clearTimeout(timeoutId);
+  if (!API_BASE) {
+    return finishAuthMeResponse(
+      NextResponse.json(
+        { error: "POLYWEATHER_API_BASE_URL is not configured" },
+        { status: 500 },
+      ),
+      timer,
+      "missing_api_base",
+    );
+  }
+
+  const preferSnapshot = req.nextUrl.searchParams.get("prefer_snapshot") === "1";
+  if (
+    preferSnapshot &&
+    !req.headers.get("authorization") &&
+    hasRequestSupabaseSessionCookie(req)
+  ) {
+    const snapshotPayload = timer.measureSync(
+      "snapshot_cookie",
+      () => entitlementSnapshotToAuthPayload(readEntitlementSnapshot(req)),
+    );
+    if (snapshotPayload) {
+      return finishAuthMeResponse(
+        NextResponse.json(
+          {
+            ...snapshotPayload,
+            entitlement_snapshot_reason: "prefer_snapshot_fast_path",
+          },
+          { headers: { "Cache-Control": "no-store" } },
+        ),
+        timer,
+        "prefer_snapshot_fast_path",
+      );
     }
-    if (res.status === 401 || res.status === 403) {
+  }
+
+  let auth: Awaited<ReturnType<typeof buildBackendRequestHeaders>> | null = null;
+  let bearerIdentity: VerifiedBearerIdentity | null | undefined;
+  const getBearerIdentityOnce = async () => {
+    if (bearerIdentity !== undefined) return bearerIdentity;
+    bearerIdentity = await timer.measure(
+      "bearer_identity",
+      () => getVerifiedBearerIdentity(req),
+    );
+    return bearerIdentity;
+  };
+  try {
+    auth = await timer.measure(
+      "auth_headers",
+      () => buildBackendRequestHeaders(req),
+    );
+    if (
+      hasSupabaseServerEnv() &&
+      !auth.authUserId &&
+      !req.headers.get("authorization")
+    ) {
       const response = NextResponse.json({
         authenticated: false,
         subscription_active: false,
         points: 0,
       });
-      return applyAuthResponseCookies(response, auth.response);
+      if (!preferSnapshot) clearEntitlementSnapshotCookie(response);
+      return finishAuthMeResponse(
+        applyAuthResponseCookies(response, auth.response),
+        timer,
+        "no_session",
+      );
+    }
+
+    if (preferSnapshot) {
+      const identity =
+        auth.authUserId
+          ? { email: auth.authEmail || null, userId: auth.authUserId }
+          : await getBearerIdentityOnce();
+      if (identity?.userId) {
+        const snapshotResponse = snapshotAuthProfileResponse({
+          email: identity.email,
+          reason: "prefer_snapshot",
+          req,
+          response: auth.response,
+          userId: identity.userId,
+        });
+        if (snapshotResponse) {
+          return finishAuthMeResponse(
+            snapshotResponse,
+            timer,
+            "prefer_snapshot",
+          );
+        }
+      }
+    }
+
+    if (!auth) throw new Error("auth headers unavailable");
+    const backendAuth = auth;
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), 6000);
+    let res: Response;
+    try {
+      res = await timer.measure("backend_fetch", async () =>
+        await fetch(buildBackendAuthMeUrl(req), {
+          headers: backendAuth.headers,
+          cache: "no-store",
+          signal: controller.signal,
+        }),
+      );
+    } finally {
+      clearTimeout(timeoutId);
+    }
+    const backendServerTiming = res.headers.get("server-timing") || "";
+    if (res.status === 401 || res.status === 403) {
+      const raw = await timer.measure("backend_read", () => res.text());
+      const authIdentity = auth.authUserId
+        ? { email: auth.authEmail || null, userId: auth.authUserId }
+        : await getBearerIdentityOnce();
+      if (
+        authIdentity?.userId &&
+        isSubscriptionRequiredBackendResponse(res.status, raw)
+      ) {
+        return finishAuthMeResponse(
+          subscriptionRequiredAuthProfileResponse({
+            email: authIdentity.email,
+            response: auth.response,
+            userId: authIdentity.userId,
+          }),
+          timer,
+          "subscription_required",
+          { backendServerTiming },
+        );
+      }
+      if (auth.authUserId) {
+        return finishAuthMeResponse(
+          await degradedAuthProfileResponse({
+            email: auth.authEmail || null,
+            reason: `backend_${res.status}`,
+            req,
+            response: auth.response,
+            userId: auth.authUserId,
+          }),
+          timer,
+          `degraded_backend_${res.status}`,
+          { backendServerTiming },
+        );
+      }
+      const identity = await getBearerIdentityOnce();
+      if (identity) {
+        return finishAuthMeResponse(
+          await degradedAuthProfileResponse({
+            email: identity.email,
+            reason: `backend_${res.status}`,
+            req,
+            response: auth.response,
+            userId: identity.userId,
+          }),
+          timer,
+          `degraded_backend_${res.status}`,
+          { backendServerTiming },
+        );
+      }
+      const response = NextResponse.json({
+        authenticated: false,
+        subscription_active: false,
+        points: 0,
+      });
+      clearEntitlementSnapshotCookie(response);
+      return finishAuthMeResponse(
+        applyAuthResponseCookies(response, auth.response),
+        timer,
+        `anonymous_backend_${res.status}`,
+        { backendServerTiming },
+      );
     }
     if (!res.ok) {
-      const raw = await res.text();
+      const raw = await timer.measure("backend_read", () => res.text());
       if (auth.authUserId) {
-        const response = NextResponse.json({
-          authenticated: true,
-          user_id: auth.authUserId,
-          email: auth.authEmail || null,
-          subscription_active: null,
-          subscription_plan_code: null,
-          subscription_expires_at: null,
-          subscription_total_expires_at: null,
-          subscription_queued_days: 0,
-          subscription_queued_count: 0,
-          points: 0,
-          degraded_auth_profile: true,
-          degraded_reason: `backend_${res.status}`,
-        });
-        return applyAuthResponseCookies(response, auth.response);
+        return finishAuthMeResponse(
+          await degradedAuthProfileResponse({
+            email: auth.authEmail || null,
+            reason: `backend_${res.status}`,
+            req,
+            response: auth.response,
+            userId: auth.authUserId,
+          }),
+          timer,
+          `degraded_backend_${res.status}`,
+          { backendServerTiming },
+        );
+      }
+      const identity = await getBearerIdentityOnce();
+      if (identity) {
+        return finishAuthMeResponse(
+          await degradedAuthProfileResponse({
+            email: identity.email,
+            reason: `backend_${res.status}`,
+            req,
+            response: auth.response,
+            userId: identity.userId,
+          }),
+          timer,
+          `degraded_backend_${res.status}`,
+          { backendServerTiming },
+        );
       }
       const response = buildUpstreamErrorResponse(res.status, raw);
-      return applyAuthResponseCookies(response, auth.response);
+      return finishAuthMeResponse(
+        applyAuthResponseCookies(response, auth.response),
+        timer,
+        `upstream_${res.status}`,
+        { backendServerTiming },
+      );
+    }
+    const data = await timer.measure("backend_read", () => res.json());
+    if (data?.authenticated === true && data?.subscription_active == null) {
+      const userId = String(data.user_id || auth.authUserId || "").trim();
+      if (userId) {
+        const snapshotResponse = snapshotAuthProfileResponse({
+          email: String(data.email || auth.authEmail || "").trim() || null,
+          reason: "subscription_unknown",
+          req,
+          response: auth.response,
+          userId,
+        });
+        if (snapshotResponse) {
+          return finishAuthMeResponse(
+            snapshotResponse,
+            timer,
+            "subscription_unknown_snapshot",
+            { backendServerTiming },
+          );
+        }
+      }
     }
-    const data = await res.json();
     const response = NextResponse.json(data);
-    return applyAuthResponseCookies(response, auth.response);
+    applyEntitlementSnapshotFromAuthPayload(response, data);
+    return finishAuthMeResponse(
+      applyAuthResponseCookies(response, auth.response),
+      timer,
+      "ok",
+      { backendServerTiming },
+    );
   } catch (error) {
-    const auth = await buildBackendRequestHeaders(req);
-    if (auth.authUserId) {
-      const response = NextResponse.json({
-        authenticated: true,
-        user_id: auth.authUserId,
-        email: auth.authEmail || null,
-        subscription_active: null,
-        subscription_plan_code: null,
-        subscription_expires_at: null,
-        subscription_total_expires_at: null,
-        subscription_queued_days: 0,
-        subscription_queued_count: 0,
-        points: 0,
-        degraded_auth_profile: true,
-        degraded_reason: String(error),
-      });
-      return applyAuthResponseCookies(response, auth.response);
+    if (auth?.authUserId) {
+      return finishAuthMeResponse(
+        await degradedAuthProfileResponse({
+          email: auth.authEmail || null,
+          reason: String(error),
+          req,
+          response: auth.response,
+          userId: auth.authUserId,
+        }),
+        timer,
+        "exception_degraded",
+      );
     }
-    return buildProxyExceptionResponse(error, {
-      publicMessage: "Failed to fetch auth profile",
-    });
+    const identity = await getBearerIdentityOnce();
+    if (identity) {
+      return finishAuthMeResponse(
+        await degradedAuthProfileResponse({
+          email: identity.email,
+          reason: String(error),
+          req,
+          response: auth?.response || null,
+          userId: identity.userId,
+        }),
+        timer,
+        "exception_degraded",
+      );
+    }
+    const snapshotPayload = timer.measureSync(
+      "snapshot_cookie",
+      () => entitlementSnapshotToAuthPayload(readEntitlementSnapshot(req)),
+    );
+    if (snapshotPayload) {
+      const snapshotResponse = NextResponse.json({
+        ...snapshotPayload,
+        entitlement_snapshot_reason: "exception_snapshot",
+      });
+      return finishAuthMeResponse(
+        applyAuthResponseCookies(snapshotResponse, auth?.response || null),
+        timer,
+        "exception_snapshot",
+      );
+    }
+    return finishAuthMeResponse(
+      await unauthenticatedAuthProfileResponse({
+        reason: String(error),
+        req,
+        response: auth?.response || null,
+      }),
+      timer,
+      "exception_anonymous",
+    );
   }
 }
 

frontend/app/api/auth/referral/apply/route.ts

@@ -0,0 +1,43 @@
+import { NextRequest, NextResponse } from "next/server";
+import {
+  applyAuthResponseCookies,
+  buildBackendRequestHeaders,
+  buildJsonBackendRequestHeaders,
+} from "@/lib/backend-auth";
+import {
+  buildProxyExceptionResponse,
+  buildUpstreamErrorResponse,
+} from "@/lib/api-proxy";
+
+const API_BASE = process.env.POLYWEATHER_API_BASE_URL;
+
+export async function POST(req: NextRequest) {
+  if (!API_BASE) {
+    return NextResponse.json(
+      { error: "POLYWEATHER_API_BASE_URL is not configured" },
+      { status: 500 },
+    );
+  }
+  try {
+    const auth = await buildBackendRequestHeaders(req);
+    const body = await req.text();
+    const res = await fetch(`${API_BASE}/api/auth/referral/apply`, {
+      method: "POST",
+      headers: buildJsonBackendRequestHeaders(auth.headers),
+      body,
+      cache: "no-store",
+    });
+    if (!res.ok) {
+      const raw = await res.text();
+      const response = buildUpstreamErrorResponse(res.status, raw);
+      return applyAuthResponseCookies(response, auth.response);
+    }
+    const data = await res.json();
+    const response = NextResponse.json(data);
+    return applyAuthResponseCookies(response, auth.response);
+  } catch (error) {
+    return buildProxyExceptionResponse(error, {
+      publicMessage: "Failed to apply referral code",
+    });
+  }
+}

frontend/app/api/auth/telegram/bind-by-token/route.ts

@@ -0,0 +1,44 @@
+import { NextRequest, NextResponse } from "next/server";
+import {
+  applyAuthResponseCookies,
+  buildBackendRequestHeaders,
+} from "@/lib/backend-auth";
+import {
+  buildProxyExceptionResponse,
+  buildUpstreamErrorResponse,
+} from "@/lib/api-proxy";
+
+const API_BASE = process.env.POLYWEATHER_API_BASE_URL;
+
+export async function POST(req: NextRequest) {
+  if (!API_BASE) {
+    return NextResponse.json(
+      { error: "POLYWEATHER_API_BASE_URL is not configured" },
+      { status: 500 },
+    );
+  }
+  try {
+    const body = await req.text();
+    const auth = await buildBackendRequestHeaders(req);
+    const headers = new Headers(auth.headers);
+    headers.set("Content-Type", "application/json");
+    const res = await fetch(`${API_BASE}/api/auth/telegram/bind-by-token`, {
+      method: "POST",
+      headers,
+      body,
+      cache: "no-store",
+    });
+    if (!res.ok) {
+      const raw = await res.text();
+      const response = buildUpstreamErrorResponse(res.status, raw);
+      return applyAuthResponseCookies(response, auth.response);
+    }
+    const data = await res.json();
+    const response = NextResponse.json(data);
+    return applyAuthResponseCookies(response, auth.response);
+  } catch (error) {
+    return buildProxyExceptionResponse(error, {
+      publicMessage: "Failed to bind Telegram account",
+    });
+  }
+}

frontend/app/api/auth/telegram/bot-bind-link/route.ts

@@ -7,33 +7,22 @@ import {
   buildProxyExceptionResponse,
   buildUpstreamErrorResponse,
 } from "@/lib/api-proxy";
-import { buildCachedJsonResponse } from "@/lib/http-cache";
 
 const API_BASE = process.env.POLYWEATHER_API_BASE_URL;
 
-export async function GET(
-  req: NextRequest,
-  context: { params: Promise<{ name: string }> },
-) {
+export async function POST(req: NextRequest) {
   if (!API_BASE) {
-    const response = NextResponse.json(
+    return NextResponse.json(
       { error: "POLYWEATHER_API_BASE_URL is not configured" },
       { status: 500 },
     );
-    return response;
   }
-
-  const { name } = await context.params;
-  const url = `${API_BASE}/api/history/${encodeURIComponent(name)}`;
-
   try {
     const auth = await buildBackendRequestHeaders(req);
-    const fetchOptions = {
+    const res = await fetch(`${API_BASE}/api/auth/telegram/bot-bind-link`, {
+      method: "POST",
       headers: auth.headers,
-      next: { revalidate: 60 },
-    } as const;
-    const res = await fetch(url, {
-      ...fetchOptions,
+      cache: "no-store",
     });
     if (!res.ok) {
       const raw = await res.text();
@@ -41,16 +30,11 @@ export async function GET(
       return applyAuthResponseCookies(response, auth.response);
     }
     const data = await res.json();
-    const response = buildCachedJsonResponse(
-      req,
-      data,
-      "public, max-age=0, s-maxage=60, stale-while-revalidate=300",
-    );
+    const response = NextResponse.json(data);
     return applyAuthResponseCookies(response, auth.response);
   } catch (error) {
-    const response = buildProxyExceptionResponse(error, {
-      publicMessage: "Failed to fetch history",
+    return buildProxyExceptionResponse(error, {
+      publicMessage: "Failed to create Telegram bot bind link",
     });
-    return response;
   }
 }

frontend/app/api/auth/telegram/login/route.ts

@@ -0,0 +1,44 @@
+import { NextRequest, NextResponse } from "next/server";
+import {
+  applyAuthResponseCookies,
+  buildBackendRequestHeaders,
+} from "@/lib/backend-auth";
+import {
+  buildProxyExceptionResponse,
+  buildUpstreamErrorResponse,
+} from "@/lib/api-proxy";
+
+const API_BASE = process.env.POLYWEATHER_API_BASE_URL;
+
+export async function POST(req: NextRequest) {
+  if (!API_BASE) {
+    return NextResponse.json(
+      { error: "POLYWEATHER_API_BASE_URL is not configured" },
+      { status: 500 },
+    );
+  }
+  try {
+    const body = await req.text();
+    const auth = await buildBackendRequestHeaders(req);
+    const headers = new Headers(auth.headers);
+    headers.set("Content-Type", "application/json");
+    const res = await fetch(`${API_BASE}/api/auth/telegram/login`, {
+      method: "POST",
+      headers,
+      body,
+      cache: "no-store",
+    });
+    if (!res.ok) {
+      const raw = await res.text();
+      const response = buildUpstreamErrorResponse(res.status, raw);
+      return applyAuthResponseCookies(response, auth.response);
+    }
+    const data = await res.json();
+    const response = NextResponse.json(data);
+    return applyAuthResponseCookies(response, auth.response);
+  } catch (error) {
+    return buildProxyExceptionResponse(error, {
+      publicMessage: "Failed to verify Telegram login",
+    });
+  }
+}

frontend/app/api/cities/detail-batch/route.ts

@@ -0,0 +1,128 @@
+import { NextRequest, NextResponse } from "next/server";
+import { proxyBackendJsonGet } from "@/lib/api-proxy";
+import {
+  buildCityDetailProxyCachePolicy,
+  NO_STORE_CACHE_CONTROL,
+} from "@/lib/proxy-cache-policy";
+import {
+  createProxyTimer,
+  finishProxyTimedResponse,
+} from "@/lib/proxy-timing";
+
+const API_BASE = process.env.POLYWEATHER_API_BASE_URL;
+const DETAIL_BATCH_PROXY_TIMEOUT_MS = Number(
+  process.env.POLYWEATHER_CITY_DETAIL_BATCH_PROXY_TIMEOUT_MS || "15000",
+);
+
+function parseRequestedCities(req: NextRequest) {
+  const requestedLimit = Number(req.nextUrl.searchParams.get("limit") || "12");
+  const limit = Number.isFinite(requestedLimit)
+    ? Math.max(1, Math.min(24, requestedLimit))
+    : 12;
+  const seen = new Set<string>();
+  const requestedCities: string[] = [];
+
+  for (const item of (req.nextUrl.searchParams.get("cities") || "").split(
+    ",",
+  )) {
+    const city = item.trim();
+    if (!city || seen.has(city)) continue;
+    seen.add(city);
+    requestedCities.push(city);
+    if (requestedCities.length >= limit) break;
+  }
+
+  return requestedCities;
+}
+
+function buildCityDetailBatchTimeoutPayload(requestedCities: string[]) {
+  const city_status = Object.fromEntries(
+    requestedCities.map((city) => [
+      city,
+      {
+        status: "proxy_timeout",
+        duration_ms: null,
+      },
+    ]),
+  );
+  return {
+    cities: requestedCities,
+    details: {},
+    errors: {},
+    missing: requestedCities,
+    partial: true,
+    timeout: true,
+    diagnostics: {
+      version: 1,
+      response_source: "next_proxy_timeout",
+      partial: true,
+      partial_reason: "proxy_timeout",
+      requested_count: requestedCities.length,
+      completed_count: 0,
+      missing_count: requestedCities.length,
+      error_count: 0,
+      proxy_timeout_ms: DETAIL_BATCH_PROXY_TIMEOUT_MS,
+      city_status,
+    },
+  };
+}
+
+export async function GET(req: NextRequest) {
+  const timer = createProxyTimer(req, "city_detail_batch");
+  if (!API_BASE) {
+    return finishProxyTimedResponse(
+      NextResponse.json(
+        { error: "POLYWEATHER_API_BASE_URL is not configured" },
+        { status: 500 },
+      ),
+      timer,
+      "missing_api_base",
+    );
+  }
+
+  const forceRefresh = req.nextUrl.searchParams.get("force_refresh") ?? "false";
+  const requestedCities = parseRequestedCities(req);
+  const cachePolicy = buildCityDetailProxyCachePolicy(forceRefresh);
+  const searchParams = new URLSearchParams({
+    cities: req.nextUrl.searchParams.get("cities") || "",
+    force_refresh: forceRefresh,
+    limit: req.nextUrl.searchParams.get("limit") || "12",
+  });
+  for (const key of ["market_slug", "target_date", "resolution", "scope"]) {
+    const value = req.nextUrl.searchParams.get(key);
+    if (value) searchParams.set(key, value);
+  }
+
+  const controller = new AbortController();
+  const timeoutId = setTimeout(() => controller.abort(), DETAIL_BATCH_PROXY_TIMEOUT_MS);
+
+  try {
+    return await proxyBackendJsonGet(req, {
+      cacheControl: cachePolicy.responseCacheControl,
+      cacheControlForData: (data) =>
+        data &&
+        typeof data === "object" &&
+        (data as { partial?: unknown }).partial === true
+          ? NO_STORE_CACHE_CONTROL
+          : cachePolicy.responseCacheControl,
+      fetchCache: "no-store",
+      includeSupabaseIdentity: true,
+      publicMessage: "Failed to fetch city detail batch",
+      revalidateSeconds: cachePolicy.revalidateSeconds,
+      signal: controller.signal,
+      timeoutResponse: () =>
+        NextResponse.json(buildCityDetailBatchTimeoutPayload(requestedCities), {
+          headers: {
+            "Cache-Control": NO_STORE_CACHE_CONTROL,
+            "Cloudflare-CDN-Cache-Control": NO_STORE_CACHE_CONTROL,
+          },
+          status: 200,
+        }),
+      timeoutPublicMessage: "City detail batch request timed out",
+      timing: timer,
+      url: `${API_BASE}/api/cities/detail-batch?${searchParams.toString()}`,
+    });
+  } finally {
+    clearTimeout(timeoutId);
+  }
+}

frontend/app/api/cities/route.ts

@@ -1,50 +1,62 @@
-import { NextRequest, NextResponse } from "next/server";
-import {
-  applyAuthResponseCookies,
-  buildBackendRequestHeaders,
-} from "@/lib/backend-auth";
-import {
-  buildProxyExceptionResponse,
-  buildUpstreamErrorResponse,
-} from "@/lib/api-proxy";
+import { NextRequest } from "next/server";
+import { proxyBackendJsonGet } from "@/lib/api-proxy";
 import { buildCachedJsonResponse } from "@/lib/http-cache";
+import {
+  buildCityListCacheControl,
+  buildStaticCityListFallbackCacheControl,
+} from "@/lib/proxy-cache-policy";
+import { STATIC_CITY_LIST } from "@/lib/static-cities";
 
 const API_BASE = process.env.POLYWEATHER_API_BASE_URL;
-export const dynamic = "force-dynamic";
+const CITIES_CACHE_CONTROL = buildCityListCacheControl();
+const STATIC_CITIES_CACHE_CONTROL = buildStaticCityListFallbackCacheControl();
+const CITIES_BACKEND_TIMEOUT_MS = Number(
+  process.env.POLYWEATHER_CITIES_BACKEND_TIMEOUT_MS || 1000,
+);
+
+function staticCitiesFallback(req: NextRequest, reason: string) {
+  const response = buildCachedJsonResponse(
+    req,
+    {
+      cities: STATIC_CITY_LIST,
+      source: "static_fallback",
+      stale: true,
+    },
+    STATIC_CITIES_CACHE_CONTROL,
+  );
+  response.headers.set("x-polyweather-cities-source", "static-fallback");
+  response.headers.set("x-polyweather-cities-fallback-reason", reason);
+  return response;
+}
 
 export async function GET(req: NextRequest) {
   if (!API_BASE) {
-    const response = NextResponse.json(
-      { error: "POLYWEATHER_API_BASE_URL is not configured" },
-      { status: 500 },
-    );
-    return response;
+    return staticCitiesFallback(req, "missing-api-base");
   }
 
+  const abortController = new AbortController();
+  const timeout = setTimeout(() => abortController.abort(), CITIES_BACKEND_TIMEOUT_MS);
+
   try {
-    const auth = await buildBackendRequestHeaders(req, {
-      includeSupabaseIdentity: false,
-    });
-    const res = await fetch(`${API_BASE}/api/cities`, {
-      headers: auth.headers,
-      cache: "no-store",
-    });
-    if (!res.ok) {
-      const raw = await res.text();
-      const response = buildUpstreamErrorResponse(res.status, raw);
-      return applyAuthResponseCookies(response, auth.response);
-    }
-    const data = await res.json();
-    const response = buildCachedJsonResponse(
-      req,
-      data,
-      "no-store, max-age=0",
-    );
-    return applyAuthResponseCookies(response, auth.response);
-  } catch (error) {
-    const response = buildProxyExceptionResponse(error, {
+    const response = await proxyBackendJsonGet(req, {
+      cacheControl: CITIES_CACHE_CONTROL,
       publicMessage: "Failed to fetch cities",
+      revalidateSeconds: 60,
+      signal: abortController.signal,
+      statusOnException: 504,
+      timeoutPublicMessage: "Cities backend timed out",
+      url: `${API_BASE}/api/cities`,
     });
+
+    if (response.status >= 500) {
+      return staticCitiesFallback(
+        req,
+        response.status === 504 ? "backend-timeout" : "backend-error",
+      );
+    }
+
     return response;
+  } finally {
+    clearTimeout(timeout);
   }
 }