refactor: remove duplicate scripts + JSON constants + update docs

2026-07-04 09:30:50 +08:00
parent 7d6b08953c
commit 8b114d6e9e
26 changed files with 2200 additions and 4913 deletions
@@ -0,0 +1,109 @@
+# MoFin 系统架构
+
+> 最后更新：2026-07-03
+> 维护人：Sisyphus (小小莫) + Zhiwei (知微)
+
+---
+
+## 一、数据层
+
+### 数据库
+
+所有数据存储在 SQLite：`/home/hmo/web-dashboard/data/mofin.db`
+
+| 表 | 用途 | 写入方 |
+|----|------|--------|
+| `holdings` | 持仓列表 | price_monitor, import_holding_xls |
+| `portfolio_summary` | 总资产/市值/仓位 | price_monitor, regenerate_all |
+| `holding_strategies` | 策略/决策 | regenerate_all, server.py API |
+| `watchlist_stocks` | 自选股 | price_monitor, regenerate_all |
+| `cash_log` | 现金变更审计 | write_cash_log |
+| `market_snapshots` | 大盘数据 | market_watch |
+| `sector_snapshots` | 板块数据 | market_watch |
+| `live_prices` | 实时价格快照 | price_monitor |
+| `mtf_cache` | 多周期K线缓存 | multi_timeframe |
+| `capital_flow_cache` | 资金流缓存 | capital_flow_collector |
+| `price_events` | 价格触发事件 | price_monitor |
+
+### 数据访问
+
+- **读取**：`mo_data.py` — `read_portfolio()` / `read_decisions()` / `read_watchlist()`
+- **写入**：`mofin_db.py` — `write_holdings_batch()` / `write_holding_strategy()` / `write_portfolio_summary()` 等
+
+JSON 文件已全部移除（portfolio.json, decisions.json, watchlist.json 等）。
+
+### 币种
+
+| 品种 | 个股存储 | 汇总 |
+|------|---------|------|
+| 港股 | HKD (currency='HKD') | CNY (×汇率) |
+| A股 | CNY (currency='CNY') | CNY |
+
+`calc_total_assets()` 汇总时自动将港股 HKD 转 CNY。汇率由 `hk_rate.py` 实时获取。
+
+---
+
+## 二、核心模块
+
+```
+MoFin/
+├── mo_models.py          # 统一数据模型：calc_total_assets, is_hk_stock, to_cny
+├── mo_data.py            # 统一读取层：read_portfolio, read_decisions, read_watchlist
+├── mofin_db.py           # DB 层：建表 + 写函数 + 查询函数
+├── mo_config.py          # 配置单例
+├── price_monitor.py      # 价格更新（cron: */2 9-16 1-5）
+├── strategy_lifecycle.py # 策略生命周期（regenerate_all + quality gates）
+├── server.py             # Flask Web API（端口 8899）
+├── market_watch.py       # 大盘采集（cron: */30 9-15）
+├── market_screener.py    # 全市场筛选（cron: */30 9-15）
+├── strategy_tree.py      # 策略树/分支管理
+├── strategy_evaluator.py # 策略评估
+├── hk_rate.py            # 港币汇率（API + 缓存）
+├── multi_timeframe.py    # 多周期K线分析
+├── stock_profile.py      # 个股画像
+├── data_freshness.py     # 数据新鲜度校验
+├── system_audit.py       # 系统审计
+├── system_health_check.py# 系统健康检查
+├── prompt_manager/       # LLM Prompt 管理
+├── scripts/              # 工具/一次性脚本
+└── docs/                 # 文档
+```
+
+---
+
+## 三、数据流
+
+```
+开盘 (9:00-16:00)
+  │
+  ├── price_monitor (每2分钟)
+  │   ├── 东财/腾讯 API → 拉价格
+  │   ├── write_holdings_batch → holdings 表
+  │   └── write_portfolio_summary → portfolio_summary 表
+  │
+  ├── market_watch (每30分钟)
+  │   └── write_market_snapshot → market_snapshots + sector_snapshots
+  │
+  ├── market_screener (每30分钟)
+  │   └── 读 market_snapshots → 小果 LLM 筛选 → candidate_pool
+  │
+  └── stale_push_wlin (每30分钟)
+      └── 读持仓+决策 → 区间检测 → XMPP 推送
+
+盘后
+  │
+  ├── system_audit (17:30) → 全局审计报告
+  ├── strategy_review (20:00) → 策略复盘
+  └── regenerate_all (手动/定时) → 全量策略重评
+```
+
+---
+
+## 四、版本
+
+| 版本 | 日期 | 关键变更 |
+|------|------|---------|
+| 5.0 | 2026-07-03 | JSON 彻底移除，纯 DB。币种修正（港股 HKD，汇总 CNY）。消除重复文件。 |
+| 4.0 | 2026-07-01 | mo_data 统一读取层，cash_log 表 |
+| 3.0 | 2026-06-30 | mo_models 统一数据模型，DSA 集成 |
+| 2.0 | 2026-06-29 | 初始架构重构 |