feat: 新增学习数据导出接口

This commit is contained in:
2026-10-09 12:20:36 +08:00
parent 3cc3be1c8b
commit faaaa132c1
12 changed files with 950 additions and 1 deletions
@@ -0,0 +1,29 @@
package com.guo.learningprogresstracker.dto;
import lombok.Data;
import java.time.LocalDate;
import java.time.LocalDateTime;
import java.util.ArrayList;
import java.util.List;
/**
* 一次导出的完整文档(导出-01)。Markdown 与 JSON 都由它渲染,保证两种格式内容一致。
*/
@Data
public class ExportDocument {
private LocalDateTime generatedTime;
/** TASK / RANGE / ALL */
private String scopeType;
/** 面向读者的范围描述 */
private String scopeLabel;
private LocalDate startDate;
private LocalDate endDate;
private List<ExportTaskSection> tasks = new ArrayList<>();
}
@@ -0,0 +1,22 @@
package com.guo.learningprogresstracker.dto;
import lombok.Data;
import java.time.LocalDateTime;
/**
* 导出的一条内容(学习报告或知识碎片,导出-01)。
*/
@Data
public class ExportEntry {
private Integer id;
/** 记录上下文:产生这条内容的学习会话编号 */
private String sessionNum;
private LocalDateTime createdTime;
/** 报告或碎片的原文 */
private String content;
}
@@ -0,0 +1,25 @@
package com.guo.learningprogresstracker.dto;
import lombok.AllArgsConstructor;
import lombok.Data;
import lombok.NoArgsConstructor;
/**
* 导出结果(导出-01)。
* <p>内容随统一响应体返回,由前端落成文件下载;这样既保持 {@code CommonResult} 的统一包装,
* 也不需要在服务端拼 Content-Disposition。</p>
*/
@Data
@NoArgsConstructor
@AllArgsConstructor
public class ExportResult {
/** 建议的文件名,含扩展名 */
private String fileName;
/** text/markdown; charset=UTF-8 或 application/json; charset=UTF-8 */
private String contentType;
/** 可独立阅读的导出正文 */
private String content;
}
@@ -0,0 +1,24 @@
package com.guo.learningprogresstracker.dto;
import lombok.Data;
import java.util.ArrayList;
import java.util.List;
/**
* 导出文档中的一个学习任务段落(导出-01)。
*/
@Data
public class ExportTaskSection {
private String taskNum;
private String taskName;
/** 任务维度统计:学习时长、复习耗时、报告/碎片数量等 */
private ReviewTaskStats stats;
private List<ExportEntry> reports = new ArrayList<>();
private List<ExportEntry> fragments = new ArrayList<>();
}