知微
110 lines
3.9 KiB
Markdown
110 lines
3.9 KiB
Markdown
# 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 | 初始架构重构 |
|