SuperAPI AI 工具集

odoo-report-design

编程与开发

查看项目

更新于 10-16 00:06

技能介绍

用途:面向 Odoo 报表的呈现与渲染工作,包括 QWeb HTML/PDF 报表的设计与评审。可结合目标版本技能、odoo-website(共享 QWeb/网站关注点)、odoo-web-testing(浏览器与资源验证)以及 odoo-migration(大版本移植)一起使用。

主要能力与工作方式:先确认目标 Odoo 版本、报表动作、模型、模板链、纸张格式、外部布局、报表资源包以及自定义报表值提供器,并在选择 XPath 锚点或 CSS 类前检查目标版本的父模板与资源。定义输出契约,如纸张尺寸、方向、边距、页眉页脚、页码、语言、RTL 需求、预期分页以及 HTML 与 PDF 是否需要一致。将数据准备与呈现分离:业务计算留在 Python,QWeb 负责组合、格式化、条件和迭代。围绕目标版本支持的报表包装器、外部布局与 .page 边界构建最小稳定结构,报表专用 CSS 与字体放入该版本的报表资源包,不要假定后端或网站资源可用于 PDF 渲染。优先使用语义锚点和小范围继承修改,能扩展就不要复制核心模板。完成前用代表性记录分别渲染 HTML 与 PDF 验证。

设计护栏:默认转义输出,文本用 t-out,格式化模型值用 t-field;富 HTML 须作为明确且记录在案的信任边界。表格需能容纳长名称、翻译标签、缺失值和多记录输出。优先使用本地打包资源与显式打印 CSS,而非远程资源或仅浏览器行为。纸张尺寸、边距、DPI、字体与渲染器可用性属于设计的一部分,而不是部署细节。修改呈现时须保留报表访问规则与数据可见性。

参考文件:REPORT-DESIGN.md(布局、QWeb、CSS、资源与打印约束)、REPORT-REVIEW-CHECKLIST.md(实现与评审清单)。官方文本暂未提供。