gavindiaz/PolyWeather
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
81604bfe8a268bdd67cfd4cfc8391991d33d40bb
PolyWeather/README_ZH.md
T

139 lines
3.9 KiB
Markdown
Raw Normal View History

docs: Add comprehensive documentation for commercialization and technical debt, and streamline the main README.
2026-03-11 11:18:48 +08:00
# PolyWeather Pro
docs: Enhance README with detailed setup instructions, architecture clarification, and formatting improvements.
2026-02-07 01:59:51 +08:00
docs: Add comprehensive documentation for commercialization and technical debt, and streamline the main README.
2026-03-11 11:18:48 +08:00
面向温度结算市场的生产级气象情报系统。
docs: Apply minor formatting updates to README files.
2026-03-03 00:06:19 +08:00
docs: Add comprehensive documentation for commercialization and technical debt, and streamline the main README.
2026-03-11 11:18:48 +08:00
官方看板：[polyweather-pro.vercel.app](https://polyweather-pro.vercel.app/)
feat: Add database-backed user and subscription management, update project architecture documentation, and outline technical debt.
2026-03-06 19:10:05 +08:00
docs: Add product screenshots to READMEs and include a new demo map image.
2026-03-12 03:18:07 +08:00
## 产品截图
### 全球看板
![PolyWeather 全球地图看板](docs/images/demo_map.png)
### 城市分析（Ankara）
![PolyWeather Ankara 分析页](docs/images/demo_ankara.png)
feat: Introduce open-core policy, commercialization, and payment verification documentation, and update README with new product status, payment architecture, and documentation index.
2026-03-14 10:53:53 +08:00
## 当前产品状态（2026-03）
- 已上线订阅制：`Pro 月付 5 USDC`。
- 已上线积分抵扣：`500 积分 = 1 USDC`，最多抵扣 `3 USDC`。
- 已上线链上支付：Polygon 合约支付（USDC / USDC.e）。
- 已上线自动补单：事件监听 + 周期确认双链路。
## 开源边界（重要）
本项目采用 **Open-Core** 策略：
- 仓库公开部分：天气聚合、基础分析、前端看板、Bot 基础能力、支付标准流程示例。
- 生产私有部分：商业风控规则、运营阈值、收费策略细节、付费用户运营脚本、内部对账与审计策略。
详细见：[Open-Core 与商用边界](docs/OPEN_CORE_POLICY.md)
docs: Add commercialization, technical debt, and frontend documentation, and update project READMEs.
2026-03-12 12:01:29 +08:00
## 核心能力
feat: Add database-backed user and subscription management, update project architecture documentation, and outline technical debt.
2026-03-06 19:10:05 +08:00
feat: Introduce open-core policy, commercialization, and payment verification documentation, and update README with new product status, payment architecture, and documentation index.
2026-03-14 10:53:53 +08:00
- 聚合 20 个监控城市的实测与预报数据。
- DEB（Dynamic Error Balancing）融合多模型最高温。
- 输出结算导向概率分布（`mu` + 温度桶）。
- 将模型观点映射到 Polymarket 行情，做错价扫描。
- Web 仪表盘与 Telegram Bot 复用同一分析内核。
docs: Enhance README with detailed setup instructions, architecture clarification, and formatting improvements.
2026-02-07 01:59:51 +08:00
feat: Introduce open-core policy, commercialization, and payment verification documentation, and update README with new product status, payment architecture, and documentation index.
2026-03-14 10:53:53 +08:00
## 参考架构
docs: rewrite README with high-end quant trading focus and DEB/AI architecture
2026-02-27 01:54:06 +08:00
docs: Add comprehensive documentation for commercialization and technical debt, and streamline the main README.
2026-03-11 11:18:48 +08:00
```mermaid
docs: Add commercialization, technical debt, and frontend documentation, and update project READMEs.
2026-03-12 12:01:29 +08:00
flowchart LR
U["用户（Web / Telegram）"] --> FE["Next.js 前端（Vercel）"]
U --> BOT["Telegram Bot（VPS）"]
FE --> API["FastAPI /web/app.py"]
BOT --> API
API --> WX["Weather Collector"]
WX --> METAR["Aviation Weather（METAR）"]
WX --> MGM["MGM（土耳其站网）"]
WX --> OM["Open-Meteo"]
feat: Introduce open-core policy, commercialization, and payment verification documentation, and update README with new product status, payment architecture, and documentation index.
2026-03-14 10:53:53 +08:00
API --> ANA["DEB + 趋势 + 概率 + 市场扫描"]
ANA --> PAY["支付状态（Intent + Event + Confirm Loop）"]
ANA --> PM["Polymarket 只读层"]
docs: Add comprehensive documentation for commercialization and technical debt, and streamline the main README.
2026-03-11 11:18:48 +08:00
```
docs: add Shock Score, MAE sigma floor, DEB bias analysis to both READMEs
2026-03-01 19:17:27 +08:00
docs: Add commercialization, technical debt, and frontend documentation, and update project READMEs.
2026-03-12 12:01:29 +08:00
## 监控城市（20）
- 欧洲/中东：Ankara、London、Paris、Munich
- 亚太：Seoul、Hong Kong、Shanghai、Singapore、Tokyo、Wellington
- 美洲：Toronto、New York、Chicago、Dallas、Miami、Atlanta、Seattle、Buenos Aires、Sao Paulo
- 南亚：Lucknow
docs: Add comprehensive documentation for commercialization and technical debt, and streamline the main README.
2026-03-11 11:18:48 +08:00
## 快速启动
feat: introduce PolyWeather web map API and frontend with integrated weather data collection and analysis.
2026-03-09 04:41:24 +08:00
docs: Add commercialization, technical debt, and frontend documentation, and update project READMEs.
2026-03-12 12:01:29 +08:00
### 后端 + Bot（Docker）
docs: rewrite README with high-end quant trading focus and DEB/AI architecture
2026-02-27 01:54:06 +08:00
docs: Add comprehensive documentation for commercialization and technical debt, and streamline the main README.
2026-03-11 11:18:48 +08:00
```bash
docker compose up -d --build
feat: Add database-backed user and subscription management, update project architecture documentation, and outline technical debt.
2026-03-06 19:10:05 +08:00
```
docs: rewrite README with high-end quant trading focus and DEB/AI architecture
2026-02-27 01:54:06 +08:00
docs: Add comprehensive documentation for commercialization and technical debt, and streamline the main README.
2026-03-11 11:18:48 +08:00
### 前端本地运行
docs: add VPS one-click update script to README
2026-02-14 21:00:31 +08:00
feat: Introduce PolyWeather Pro commercialization, update project documentation, and add Telegram push utility.
2026-03-06 19:16:48 +08:00
```bash
docs: Add comprehensive documentation for commercialization and technical debt, and streamline the main README.
2026-03-11 11:18:48 +08:00
cd frontend
npm install
npm run dev
docs: add VPS one-click update script to README
2026-02-14 21:00:31 +08:00
```
feat: Introduce open-core policy, commercialization, and payment verification documentation, and update README with new product status, payment architecture, and documentation index.
2026-03-14 10:53:53 +08:00
## 运行数据目录（VPS 推荐）
docs: Enhance README with detailed setup instructions, architecture clarification, and formatting improvements.
2026-02-07 01:59:51 +08:00
feat: Introduce open-core policy, commercialization, and payment verification documentation, and update README with new product status, payment architecture, and documentation index.
2026-03-14 10:53:53 +08:00
建议将运行态数据放到仓库外（避免 `git pull` 被 SQLite 卡住）：
```env
POLYWEATHER_RUNTIME_DATA_DIR=/var/lib/polyweather
POLYWEATHER_DB_PATH=/var/lib/polyweather/polyweather.db
docs: Add comprehensive documentation for commercialization and technical debt, and streamline the main README.
2026-03-11 11:18:48 +08:00
```
docs: add testing and development commands
2026-03-04 03:06:40 +08:00
feat: Introduce API and technical debt documentation, and enhance frontend caching, mispricing radar, and AI decision logic.
2026-03-12 10:43:31 +08:00
## 运维验收
feat: Introduce open-core policy, commercialization, and payment verification documentation, and update README with new product status, payment architecture, and documentation index.
2026-03-14 10:53:53 +08:00
### 前端缓存头
feat: Introduce API and technical debt documentation, and enhance frontend caching, mispricing radar, and AI decision logic.
2026-03-12 10:43:31 +08:00
```bash
./scripts/validate_frontend_cache.sh "https://polyweather-pro.vercel.app"
```
feat: Introduce open-core policy, commercialization, and payment verification documentation, and update README with new product status, payment architecture, and documentation index.
2026-03-14 10:53:53 +08:00
### 支付自动补单日志
feat: Introduce API and technical debt documentation, and enhance frontend caching, mispricing radar, and AI decision logic.
2026-03-12 10:43:31 +08:00
```bash
feat: Introduce open-core policy, commercialization, and payment verification documentation, and update README with new product status, payment architecture, and documentation index.
2026-03-14 10:53:53 +08:00
docker compose logs -f polyweather | egrep "payment event loop started|payment confirm loop started|payment auto-confirmed"
feat: Introduce API and technical debt documentation, and enhance frontend caching, mispricing radar, and AI decision logic.
2026-03-12 10:43:31 +08:00
```
feat: Introduce open-core policy, commercialization, and payment verification documentation, and update README with new product status, payment architecture, and documentation index.
2026-03-14 10:53:53 +08:00
### 钱包异动监听日志
docs: Add commercialization, technical debt, and frontend documentation, and update project READMEs.
2026-03-12 12:01:29 +08:00
```bash
feat: Introduce open-core policy, commercialization, and payment verification documentation, and update README with new product status, payment architecture, and documentation index.
2026-03-14 10:53:53 +08:00
docker compose logs -f polyweather | egrep "polymarket wallet activity watcher started|wallet activity pushed"
docs: Add commercialization, technical debt, and frontend documentation, and update project READMEs.
2026-03-12 12:01:29 +08:00
```
feat: Introduce open-core policy, commercialization, and payment verification documentation, and update README with new product status, payment architecture, and documentation index.
2026-03-14 10:53:53 +08:00
## Telegram 指令
docs: Add commercialization, technical debt, and frontend documentation, and update project READMEs.
2026-03-12 12:01:29 +08:00
| 指令 | 用途 |
| :-- | :-- |
docs: Add comprehensive documentation for commercialization and technical debt, and streamline the main README.
2026-03-11 11:18:48 +08:00
| `/city <name>` | 城市实时分析 |
docs: Add commercialization, technical debt, and frontend documentation, and update project READMEs.
2026-03-12 12:01:29 +08:00
| `/deb <name>` | DEB 历史对账 |
| `/top` | 用户积分排行 |
feat: Introduce open-core policy, commercialization, and payment verification documentation, and update README with new product status, payment architecture, and documentation index.
2026-03-14 10:53:53 +08:00
| `/id` | 查看聊天 Chat ID |
| `/diag` | Bot 启动诊断 |
docs: Add commercialization, technical debt, and frontend documentation, and update project READMEs.
2026-03-12 12:01:29 +08:00
| `/help` | 帮助与用法 |
feat: introduce PolyWeather web map API and frontend with integrated weather data collection and analysis.
2026-03-09 04:41:24 +08:00
docs: Add comprehensive documentation for commercialization and technical debt, and streamline the main README.
2026-03-11 11:18:48 +08:00
## 文档索引
docs: add testing and development commands
2026-03-04 03:06:40 +08:00
feat: Introduce open-core policy, commercialization, and payment verification documentation, and update README with new product status, payment architecture, and documentation index.
2026-03-14 10:53:53 +08:00
- 英文总览：[README.md](README.md)
- API 文档（中文）：[docs/API_ZH.md](docs/API_ZH.md)
- 商业化说明：[docs/COMMERCIALIZATION.md](docs/COMMERCIALIZATION.md)
- Open-Core 边界：[docs/OPEN_CORE_POLICY.md](docs/OPEN_CORE_POLICY.md)
- Supabase 接入：[docs/SUPABASE_SETUP_ZH.md](docs/SUPABASE_SETUP_ZH.md)
- 技术债（中文）：[docs/TECH_DEBT_ZH.md](docs/TECH_DEBT_ZH.md)
- 技术债（英文）：[docs/TECH_DEBT.md](docs/TECH_DEBT.md)
- 支付合约验证：[docs/payments/POLYGONSCAN_VERIFY.md](docs/payments/POLYGONSCAN_VERIFY.md)
- 前端报告：[FRONTEND_REDESIGN_REPORT.md](FRONTEND_REDESIGN_REPORT.md)
docs: sync Chinese README
2026-03-08 04:37:24 +08:00
feat: Introduce open-core policy, commercialization, and payment verification documentation, and update README with new product status, payment architecture, and documentation index.
2026-03-14 10:53:53 +08:00
## 当前版本
docs: sync Chinese README
2026-03-08 04:37:24 +08:00
feat: Introduce open-core policy, commercialization, and payment verification documentation, and update README with new product status, payment architecture, and documentation index.
2026-03-14 10:53:53 +08:00
- 版本：`v1.4`
- 最后更新：`2026-03-14`
Reference in New Issue Copy Permalink