做报表

“做报表”通常指创建或修改统计表、明细表、打印报表、导出报表或报表参数。AI 可以辅助生成结构和检查引用，但报表效果必须在产品中预览和验证。

阅读顺序

1. 先读 SuccApp 官方文档 Skill 中的 AI 低代码开发说明和工作区中的 AI 协作文件，确认目标、环境、范围、禁区和验收方式。
2. 再读元数据系统、报表文件类型和 SuccApp Super JSON。
3. 涉及取数时补充阅读数据模型和查询，并参考当前项目同类报表、参数和单元格配置。
4. 修改后检查报表预览、打印、导出、参数切换和引用关系，必要时按产品验证和Diff 审查验证。

常见文件

文件	用途
.rpt	报表。
.tbl	数据模型。
.query	查询或数据准备。
.spg	报表入口页或嵌入页面。
.ts、.action.ts	报表相关脚本。

AI 修改前

明确告诉 AI：

1. 报表用途，是展示、打印还是导出。
2. 数据来源、统计口径、字段排序和分组方式。
3. 参数、过滤条件和默认值。
4. 是否允许修改模型或查询。
5. 需要验证的输出方式，例如网页预览、打印或 Excel 导出。

推荐流程

1. 让 AI 查找同类报表和数据模型。
2. 确认字段、参数、单元格区域和引用关系。
3. 小步修改 .rpt、.tbl 或 .query。
4. 检查 DTS、同类文件差异和元数据静态结构。
5. 推送测试服务器并预览报表。
6. 验证打印、导出、参数切换和权限数据范围。

验证重点

1. 报表能打开并渲染。
2. 参数默认值和查询条件正确。
3. 分组、合计、排序和格式符合业务口径。
4. 打印和导出效果符合要求。
5. 大数据量场景下查询性能可接受。