# MoFin 文档中心

> 文档驱动开发。每次代码变更必须同步更新对应文档。

---

## 阅读指引

### 🚀 新手入门（按顺序读）

| # | 文档 | 内容 | 时间 |
|---|------|------|------|
| 1 | **[SYSTEM_ARCHITECTURE.md](SYSTEM_ARCHITECTURE.md)** | 系统总览：架构图、数据流、模块职责 | 10 min |
| 2 | **[portfolio-data-model.md](portfolio-data-model.md)** | 核心数据模型：表结构、币种规则、常见错误 | 10 min |
| 3 | **[DEVELOPMENT_STANDARDS.md](DEVELOPMENT_STANDARDS.md)** | 开发规范：代码结构、DB 规范、Prompt 规范、开发流程 | 15 min |
| 4 | **[CHANGELOG.md](../CHANGELOG.md)** | 变更日志：所有改动的完整记录 | 5 min |

### 🔧 日常开发

| 文档 | 何时查阅 |
|------|---------|
| [DEVELOPMENT_STANDARDS.md](DEVELOPMENT_STANDARDS.md) | 每次写代码前 |
| [TEST_PLAN.md](TEST_PLAN.md) | 每次改完代码后跑测试 |
| [CHANGELOG.md](../CHANGELOG.md) | 改完后追加变更记录 |

### 📊 运维参考

| 文档 | 内容 |
|------|------|
| [cron-catalog.md](cron-catalog.md) | Cron 任务清单（知微维护） |
| [decisions-db-migration.md](decisions-db-migration.md) | JSON→DB 迁移记录（✅ 已完成） |

### 📈 策略研究（2026-08 起，小小莫维护）

| 文档 | 内容 |
|------|------|
| [strategy_research_methodology.md](strategy_research_methodology.md) | **研究方法论**：由果及因/12维预测/铁律/支撑压力规范 |
| [predictive_oversold_strategy.md](predictive_oversold_strategy.md) | **预测超跌反弹策略**（年化14.75%达标）|
| [research/README.md](research/README.md) | 研究总索引（过程文档+脚本+数据）|
| [research/methodology.md](research/methodology.md) | 方法论总纲（含铁律0-5）|
| [research/research-log.md](research/research-log.md) | 研究日志（08-08 ~ 08-10 完整历程）|
| [research/research-scripts.md](research/research-scripts.md) | 研究脚本清单 |
| [research/research-status.md](research/research-status.md) | 策略现状与待办 |
| [research/2026-08-06-low-drawdown-study.md](research/2026-08-06-low-drawdown-study.md) | 低回撤组合策略研究 |
| [research/2026-08-08-experience-lessons.md](research/2026-08-08-experience-lessons.md) | 研究经验教训 |
| [research/2026-08-0*.md](research/) | 研究过程文档（57份，08-06~08-09 各策略实验）|

> 研究脚本见 `scripts/research/`（含 README.md 索引）

### 📦 历史文档（archive/）

旧的设计文档、需求文档、分析报告。仅供参考，不代表当前系统状态。

---

## 文档规范

- 每个 .md 文件顶部标注版本和日期
- 过时内容追加 `> **已废弃** — 见 XXX 替代`
- 不直接删除旧文档，移到 `archive/` 保留
- 交叉引用使用相对路径 `[xxx](xxx.md)`

## 当前系统状态

- **数据**：纯 SQLite（`/home/hmo/web-dashboard/data/mofin.db`）
- **币种**：港股存 HKD，A 股存 CNY，汇总时转换
- **JSON**：已全部移除，无残留
- **测试**：`scripts/run_all_tests.py` — 33/33 通过
- **最新**：`CHANGELOG.md` 查看完整变更