Bootstrap Python rewrite skeleton

docs/migration-notes.md

@@ -0,0 +1,40 @@
+# 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
+