Refresh docs for observability, payments, and SQLite rollout
This commit is contained in:
+10
-25
@@ -78,6 +78,7 @@ PolyWeather 的环境变量很多,但不是所有变量都属于同一层级
|
||||
- `TELEGRAM_CHAT_ID`
|
||||
- `POLYWEATHER_RUNTIME_DATA_DIR`
|
||||
- `POLYWEATHER_DB_PATH`
|
||||
- `POLYWEATHER_STATE_STORAGE_MODE`
|
||||
|
||||
前端:
|
||||
|
||||
@@ -100,6 +101,7 @@ PolyWeather 的环境变量很多,但不是所有变量都属于同一层级
|
||||
- `POLYWEATHER_AUTH_ENABLED`
|
||||
- `POLYWEATHER_AUTH_REQUIRED`
|
||||
- `POLYWEATHER_AUTH_REQUIRE_SUBSCRIPTION`
|
||||
- `POLYWEATHER_STATE_STORAGE_MODE`
|
||||
- `POLYWEATHER_PAYMENT_ENABLED`
|
||||
- `POLYMARKET_MARKET_SCAN_ENABLED`
|
||||
- `POLYGON_WALLET_WATCH_ENABLED`
|
||||
@@ -115,6 +117,7 @@ PolyWeather 的环境变量很多,但不是所有变量都属于同一层级
|
||||
- 各类 `*_TIMEOUT_SEC`
|
||||
- 各类 `*_COOLDOWN_SEC`
|
||||
- 各类 `*_INTERVAL_SEC`
|
||||
- `POLYWEATHER_PAYMENT_RPC_URLS`
|
||||
|
||||
策略:
|
||||
|
||||
@@ -190,6 +193,7 @@ TELEGRAM_BOT_TOKEN=...
|
||||
TELEGRAM_CHAT_ID=...
|
||||
POLYWEATHER_RUNTIME_DATA_DIR=/var/lib/polyweather
|
||||
POLYWEATHER_DB_PATH=/var/lib/polyweather/polyweather.db
|
||||
POLYWEATHER_STATE_STORAGE_MODE=dual
|
||||
UID=1000
|
||||
GID=1000
|
||||
POLYWEATHER_AUTH_ENABLED=true
|
||||
@@ -206,6 +210,8 @@ POLYWEATHER_BACKEND_ENTITLEMENT_TOKEN=...
|
||||
- Windows / macOS 一般可以直接保留默认值。
|
||||
- `POLYWEATHER_RUNTIME_DATA_DIR` 建议放在仓库外,例如 `/var/lib/polyweather`。
|
||||
- `docker-compose.yml` 会把这个目录同时挂载到容器内的 `/var/lib/polyweather` 和 `/app/data`,兼容现有缓存与 SQLite 路径。
|
||||
- `POLYWEATHER_STATE_STORAGE_MODE` 当前推荐先用 `dual`,验证后再切 `sqlite`。
|
||||
- `POLYWEATHER_PAYMENT_RPC_URLS` 支持逗号分隔多个 RPC;如果暂时只用单 RPC,也可以继续只配 `POLYWEATHER_PAYMENT_RPC_URL`。
|
||||
|
||||
## 7. 当前建议的运维规则
|
||||
|
||||
@@ -246,41 +252,20 @@ POLYWEATHER_BACKEND_ENTITLEMENT_TOKEN=...
|
||||
- 使用者只需要先关心 10-20 个关键变量
|
||||
- 其余变量保持默认即可
|
||||
|
||||
## 9. 推荐的下一步
|
||||
|
||||
当前已经完成:
|
||||
## 9. 当前已经完成的配置治理
|
||||
|
||||
1. 根 `.env.example` 收口
|
||||
2. `.env.secrets.example` 新增
|
||||
3. 本文档新增
|
||||
3. 前端 `.env.example` 收口
|
||||
4. 运行时配置校验脚本新增
|
||||
5. 支付运行态与多 RPC 配置支持
|
||||
6. 运行态 SQLite 迁移配置支持
|
||||
|
||||
## 10. 配置校验命令
|
||||
|
||||
在不启动服务的情况下,你可以直接检查配置:
|
||||
|
||||
检查 Web:
|
||||
|
||||
```bash
|
||||
python scripts/validate_runtime_env.py --component web
|
||||
```
|
||||
|
||||
检查 Bot:
|
||||
|
||||
```bash
|
||||
python scripts/validate_runtime_env.py --component bot
|
||||
```
|
||||
|
||||
返回规则:
|
||||
|
||||
- 退出码 `0`:当前配置通过
|
||||
- 退出码 `1`:当前配置存在关键缺失
|
||||
|
||||
如果某个功能已启用但缺关键变量,脚本会直接报错。
|
||||
|
||||
## 11. 推荐的下一步
|
||||
|
||||
后续最值得继续做的是:
|
||||
|
||||
1. 在 GitHub / Vercel / VPS 三侧固化同一套变量命名
|
||||
2. 给生产部署增加一次性配置审计清单
|
||||
|
||||
Reference in New Issue
Block a user