Files
home-automation/docs/migration-notes.md
T

1.0 KiB

Migration Notes

本文档记录 Python skeleton 阶段的迁移说明,帮助后续继续推进时快速恢复上下文。

当前阶段完成内容

  • 建立 FastAPI 应用骨架
  • 建立环境变量配置体系
  • 接入 SQLAlchemy 与 Alembic
  • 建立 Jinja2 模板基础
  • 建立 pytest 基础设施
  • 建立 Docker / Compose 基础骨架
  • 建立 OpenAPI 导出脚本

当前阶段未做内容

  • 未迁移 TickTick 业务逻辑
  • 未迁移 Home Assistant 业务逻辑
  • 未迁移 poo records
  • 未迁移 location / life trajectory
  • 未实现真实 OAuth 流程
  • 未做数据迁移

后续建议顺序

建议继续沿用既有迁移文档中的顺序:

  1. 先迁 location recorder
  2. 再迁 Home Assistant 出站适配层
  3. 再迁 TickTick adapter
  4. 再迁 Home Assistant 命令网关
  5. 最后迁 poo recorder

开发约束提醒

  • 保持对当前 Go 外部行为的兼容意识
  • 不要把旧 Python 版本当作设计基线
  • 不要重新引入 Notion 作为 Python 主系统能力
  • 在迁业务模块时,优先补 contract tests