79 lines
4.1 KiB
Markdown
79 lines
4.1 KiB
Markdown
# MoFin 文档中心
|
||
|
||
> 文档驱动开发。每次代码变更必须同步更新对应文档。
|
||
> 最后更新：2026-08-11（文档治理：归档 7 份过时文档 + 57 份研究过程文档，见 doc-audit-20260811.md）
|
||
|
||
---
|
||
|
||
## 阅读指引
|
||
|
||
### 🚀 新手入门（按顺序读）
|
||
|
||
| # | 文档 | 内容 | 时间 |
|
||
|---|------|------|------|
|
||
| 1 | [portfolio-data-model.md](portfolio-data-model.md) | 核心数据模型：表结构、币种规则、常见错误 | 10 min |
|
||
| 2 | [DEVELOPMENT_STANDARDS.md](DEVELOPMENT_STANDARDS.md) | 开发规范：代码结构、DB 规范、Prompt 规范、开发流程 | 15 min |
|
||
| 3 | [CHANGELOG.md](../CHANGELOG.md) | 变更日志：所有改动的完整记录 | 5 min |
|
||
|
||
> 系统架构总览已归档（archive/SYSTEM_ARCHITECTURE-root.md）——当前架构以数据模型 + 方法论文档为准。
|
||
|
||
### 🔧 日常开发
|
||
|
||
| 文档 | 何时查阅 |
|
||
|------|---------|
|
||
| [DEVELOPMENT_STANDARDS.md](DEVELOPMENT_STANDARDS.md) | 每次写代码前 |
|
||
| [TEST_PLAN.md](TEST_PLAN.md) | 每次改完代码后跑测试 |
|
||
| [CHANGELOG.md](../CHANGELOG.md) | 改完后追加变更记录 |
|
||
|
||
### 📊 运维参考
|
||
|
||
| 文档 | 内容 |
|
||
|------|------|
|
||
| [cron-review-poversold-20260811.md](cron-review-poversold-20260811.md) | **Cron 梳理报告**（对照 p_oversold 部署，停8/保持30/调整8/新增2）|
|
||
| [QUICKSTART.md](QUICKSTART.md) | 快速操作手册 |
|
||
| [DEPLOY.md](DEPLOY.md) | 部署指南（本地→Gitea→246 工作流）|
|
||
| [DASHBOARD.md](DASHBOARD.md) | Dashboard API 参考 |
|
||
| [HEALTH-PIPELINE.md](HEALTH-PIPELINE.md) | 健康监控管线 |
|
||
| [system-audit-20260810.md](system-audit-20260810.md) | **系统彻查报告**（8/10，含处理状态追踪：9修/6待办）|
|
||
| [doc-audit-20260811.md](doc-audit-20260811.md) | **文档治理核实报告**（15 份文档对照系统实际）|
|
||
|
||
> ⚠️ cron-catalog.md（6/27 版）已归档至 archive/——当前 cron 清单以 cron-review-poversold-20260811.md 为准。
|
||
|
||
### 📈 策略研究（2026-08 起，小小莫维护）
|
||
|
||
| 文档 | 内容 |
|
||
|------|------|
|
||
| [strategy_research_methodology.md](strategy_research_methodology.md) | **研究方法论**：由果及因/12维预测/铁律/支撑压力规范 |
|
||
| [predictive_oversold_strategy.md](predictive_oversold_strategy.md) | **预测超跌反弹策略**（年化 18.57% 达标 v5）|
|
||
| [deployment-plan-predictive-oversold.md](deployment-plan-predictive-oversold.md) | **部署计划**（策略整合 MoFin 全流程）|
|
||
| [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) | 研究经验教训 |
|
||
|
||
> 研究过程文档（57 份单次实验记录）已归档至 `research/archive/`，结论已汇总进 methodology.md。
|
||
> 研究脚本见 `scripts/research/`（含 README.md 索引）。
|
||
|
||
### 📦 历史文档（archive/）
|
||
|
||
旧的设计文档、需求文档、分析报告、已废弃组件文档。仅供参考，不代表当前系统状态。
|
||
|
||
---
|
||
|
||
## 文档规范
|
||
|
||
- 每个 .md 文件顶部标注版本和日期
|
||
- 过时内容追加 `> **已废弃** — 见 XXX 替代`
|
||
- 不直接删除旧文档，移到 `archive/` 保留
|
||
- 交叉引用使用相对路径 `[xxx](xxx.md)`
|
||
|
||
## 当前系统状态（2026-08-11 核实）
|
||
|
||
- **数据**：纯 SQLite（`/home/hmo/MoFin/data/mofin.db`，47 表）。`web-dashboard` 是 MoFin 软链别名
|
||
- **币种**：港股存 HKD，A 股存 CNY，汇总时转换
|
||
- **JSON**：decisions.json / watchlist.json 已移除；**portfolio.json 仍在用**（update_data.py 写、stock_profile.py 读）
|
||
- **服务**：`mofin-dashboard.service`（:8899，API+Dashboard 一体）；无独立 mofin-api 服务
|
||
- **测试**：`scripts/run_all_tests.py` — 33/33 通过
|
||
- **最新**：`CHANGELOG.md` 查看完整变更 |