package com.guo.learningprogresstracker.dto; import io.swagger.v3.oas.annotations.media.Schema; /** * 复习总览的全局汇总。 * *
刻意单独出接口:任务列表已分页,客户端只能看到当前页, * 再把每页的报告数/碎片数相加会得到一个「看起来是总数、其实是本页合计」的错数字。
* *口径与 {@code /review/tasks} 的列表完全一致(列表逐页相加 == 这里的汇总): * 报告按「报告 → 会话 → 任务」归属,碎片按内容归属({@code owner_task_num})统计。 * 因此待归类碎片不计入 {@code fragmentTotal}(由总览的「待归类内容」独立区块展示), * 任务删除后残留的报告也不计入。
*/ public record ReviewSummary( @Schema(description = "任务总数") long taskTotal, @Schema(description = "学习报告总数") long reportTotal, @Schema(description = "学习碎片总数") long fragmentTotal) {}