Codex ONLYOFFICE 数据库迁移｜同步 Flyway、实体和查询测试
EnglishCodex 安装步骤
- 打开 GitHub 固定提交的 `.agents/skills/onlyoffice-data-migrations/SKILL.md`，核对内容与使用条件。
- 在自己的项目中创建 `.agents/skills/onlyoffice-data-migrations/`，把核对后的文件保存为 `.agents/skills/onlyoffice-data-migrations/SKILL.md`。
- 在该项目根目录启动 Codex，输入 `$onlyoffice-data-migrations` 并选择同名技能。
中文摘要
当 ONLYOFFICE 集成项目的数据实体变化时，规划连续版本的 Flyway 迁移，并核对 Entity、Mapper、Repository 和查询测试。
SKILL.md 中文导读
可复现示例
为文档元数据新增一个只供演示的归档状态字段，列出迁移影响。
{"latestMigration":10,"entity":"DocumentMetadataEntity","column":"archived","default":false}工作步骤
- 核对当前最新迁移版本。
- 用连续编号新增迁移，并同步数据类和查询映射。
- 设计测试验证新增字段的读写及所影响的查询。
验收方法
规划 `V11__add_archived_to_document_metadata.sql`，同步实体和映射，并在查询测试中验证默认 `archived=false`。
GitHub 原文 · 更新日期
适用环境
在 Codex 中打开 ONLYOFFICE Integration Starter，准备当前迁移序列、相关数据类和字段预期。
常见问题
新字段的查询条件应放在哪一层？
按项目边界放在 Service 或 Repository，由 Repository 访问持久层。