# MoFin 文档治理核实报告（对照系统实际）

> 状态：✅ 已核实（2026-08-11，实测 246 服务器）
> 范围：15 份"系统实现相关"文档 vs MoFin 实际状态（DB 47表 / crontab / systemd / 进程 / API）
> 方法：数据库 sqlite_master 实查、crontab 实查、systemd 实查、端口/进程实查、API 实测、脚本文件存在性核查

## 一、核实总表

| # | 文档 | 结论 | 一句话 |
|---|------|------|--------|
| 1 | 根目录 SYSTEM_ARCHITECTURE.md | 过时 | 表/模块/DB路径仍准，但 4 个 cron 已停、regenerate_all 已改名、"JSON 全移除"错误 |
| 2 | docs/SYSTEM_ARCHITECTURE.md | 过时+放错目录 | 讲的是 Hermes/XMPP 系统，非 MoFin；端口/PID/bot路径全对不上 |
| 3 | docs/portfolio-data-model.md | 基本一致 | 9 张表全存在、公式/币种正确；唯一错：portfolio.json 仍在用 |
| 4 | docs/decisions-db-migration.md | 过时（历史文档） | 完成声明属实，但正文 strategies 表从未建成（实际 holding_strategies）|
| 5 | docs/QUICKSTART.md | 大体有效（2处硬错） | mofin-api 服务不存在、dashboard.log 路径不存在 |
| 6 | docs/DASHBOARD.md | 基本一致 | 全部端点 200、monitor 状态逐字吻合；示例服务数 5 vs 实际 4 |
| 7 | docs/HEALTH-PIPELINE.md | 基本一致 | Tier1 精确到源码；仅 Tier2 "规划中"过时（已部署）|
| 8 | docs/xiaoguo-signal-pipeline.md | 已废弃 | 小果 7/9 停跑、7/20 归档，无 cron |
| 9 | docs/xiaoguo-scanner-design.md | 已废弃 | 同上 |
| 10 | docs/market-screening-pipeline.md | 过时 | 描述的 17 信号管道已停摆，被 accumulation→candidate 取代 |
| 11 | docs/lifecycle-management.md | 部分过时 | 框架有效、已落地；JSON 中心说法过时、xiaoguo 缺口失效 |
| 12 | docs/morning-health-check.md | 机制有效、细节过期 | 8:00 运行 ✓；但 48 项→40 项、存储改 DB 表 |
| 13 | docs/strategy-review-loop.md | 基本一致（已实施） | 闭环全落地，accuracy_stats 已闭环 |
| 14 | docs/SELF_GROWTH_SYSTEM.md | 部分过时 | 三件套都在跑；cron 表/xiaoguo 章节过期 |
| 15 | docs/TDX_RELAY_COLLAB.md | 已废弃 | TDX relay 7/20 归档，集成逻辑已移除 |

## 二、处置建议

| 处置 | 文档 |
|------|------|
| 归档（7份） | 根 SYSTEM_ARCHITECTURE、docs/SYSTEM_ARCHITECTURE、decisions-db-migration、xiaoguo×2、TDX_RELAY_COLLAB、market-screening-pipeline |
| 保留+更新（6份） | portfolio-data-model、QUICKSTART、DASHBOARD、HEALTH-PIPELINE、morning-health-check、lifecycle-management、SELF_GROWTH_SYSTEM |
| 保留（1份） | strategy-review-loop（标注已实施）|

## 三、关键横切发现

1. **数据库唯一**：data/mofin.db（6.4GB，47表）；根目录 market.db/market_data.db/stock_analysis.db/state.db 全是 0 字节占位
2. **web-dashboard 是软链** → MoFin（6-20 创建），非两套部署
3. **JSON 真实现状**：decisions.json/watchlist.json 已删；**portfolio.json 仍活着**（update_data.py 写、stock_profile.py 读）
4. **调度真实现状**：crontab 39 条；market_screener/system_audit/stale_push_wlin/strategy_review 均未在系统 cron（在 hermes jobs.json）
5. **服务真实现状**：只有 mofin-dashboard.service（= server.py :8899，API+Dashboard 一体）；无 mofin-api.service
6. **已暂停 5 个 job（2026-08-10 22:43-44）**：全部合理，无需恢复
   - 系统健康检查：被 morning_health_check（8:00 更全面）替代
   - 小果市场筛选：小果已废弃
   - 300308 盯盘×2：临时任务结束
   - 自选买入区提醒（per_stock_reassess）：由 watchlist_12d_backfill 承接

## 四、待清理项（独立治理 TODO）

- [ ] 小果残留文件：MoFin 顶层 3 个（xiaoguo_scanner.py / xiaoguo_news_processor.py / inject_xiaoguo_insight.py）+ 运行时目录 4 个
- [ ] server.py /api/update/realtime 死端点（TDX 归档后残留）
- [ ] mofin_db.py / mofin_health.py / system_audit.py 中 xiaoguo 字符串（无害遗留，system_audit 统计恒为 0）
- [ ] candidate_filter / refresh_mtf_cache 近期 database is locked（2026-08-11 已修资金流长锁，观察）