ashare-data/TODO.md

TODO

本文件只记录当前通达信本地缓存方案下，仍然值得跟进的事项。

---

🔴 P0 - 需用户授权的高风险动作

1. 清理 git 历史中的明文密码

• 现状：config.yaml 已加入 .gitignore，但历史 commit 中曾提交过明文数据库密码。
• 影响：仓库历史中仍可直接取到旧凭据。
• 处理思路：
  1. 先轮换数据库密码。
  2. 再用 git filter-repo 或 BFG 清理历史。
  3. 必要时强制推送并通知协作者重新克隆。

---

🟢 P2 - 后续工程

2. 北交所数据支持

• 现状：当前主流程对 920xxx 仍然显式跳过。
• 处理思路：调研是否能从通达信本地缓存补齐北交所日线/分钟线，如可行，再补表结构与抓取逻辑。

3. 数据质量校验日报

• 现状：当前只有抓取过程日志，没有统一的每日质量报表。
• 处理思路：增加缺口统计、最新日期、异常波动、停牌覆盖率等摘要，便于盘后检查。

4. 抓取任务调度

• 现状：目前仍依赖手动执行 CLI。
• 处理思路：接入 APScheduler 或系统定时任务，定时跑 --daily、--intraday、--tdx-verify-cache。

5. 质量与工程护栏

• 现状：有 pytest，但还没有 CI 和迁移体系。
• 处理思路：补 GitHub Actions、Alembic、ruff / pre-commit 等基础工程化能力。

---

📌 维护建议

• 新增 TDX 相关抓取能力时，优先先写单测，再更新 README。
• 若要调整本地缓存初始化方式，优先改 src/fetchers/tdx_client.py，避免在各个 fetcher 中重复处理下载逻辑。
• 所有对外说明都以“通达信本地缓存”为唯一数据源口径。