用途:专用于报表层面的 Odoo 版本迁移,将 QWeb HTML/PDF 报表从一个主版本迁移到另一个,同时保留数据语义、访问行为、纸张几何和预期视觉表现。它是 odoo-migration 等模块迁移技能的补充,需与源/目标版本技能、odoo-report-design、odoo-web-testing 组合使用。
主要能力与流程:先确认源版本、目标版本、模块与报表 XML ID、渲染环境、报表动作、模板继承链、纸张格式、资源、自定义取值提供器及需保持稳定的视觉要求。冻结基线:用确定性记录渲染 HTML 与 PDF,记录版本、提交、语言、公司、用户、纸张格式与渲染器细节。清点依赖:继承模板、外部布局、报表资源、SCSS/CSS、字体、图片、纸张格式、翻译和报表动作。多版本跳跃需应用每个中间版本的 Odoo 迁移清单,并分离 API/数据迁移与呈现变更。移植前先查看目标版本的上游报表模板、资源包、CSS 框架、渲染器和报表动作字段。做最小兼容改动,优先使用稳定的继承锚点而非复制旧核心模板。重渲染同一组夹具并分类差异。成功前需验证访问、数据语义、翻译、分页、纸张几何、资源和多记录行为。
限制与注意:报表视觉保留不能仅凭能加载或生成 PDF 判断,不以 PDF 字节比较作为主要视觉断言;不要先随意用 CSS 修布局,需先检查目标模板、资源包、纸张格式、字体和渲染器行为;不得在改呈现时扩大报表访问或暴露数据;基线无法渲染时应记录缺失证据并使用明确标注的重建基线。若属于模块 [MIG] 的报表迁移,仍须走完整 OCA 流程(在 Migration to version 目标 议题公告、创建 <target>-mig-<module> 分支、[MIG] 提交、推送至贡献者 fork、以 [<target>][MIG] <module>: Migration to <target> 为题开 PR),渲染等价性是 PR 的验收标准而非替代;未获得与 odoo-migration 相同的明确确认前,不得发布、推送或开 PR。参考文档包括 REPORT-MIGRATION.md、VISUAL-REGRESSION.md、REPORT-VERSION-MATRIX.md(8.0 至 20.0 的版本敏感审查点);OCA 版本指南见 https://github.com/OCA/maintainer-tools/wiki/Migration-to-version-<version>,该 wiki 优先于此技能包。