# 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