feat: 新增学习数据导出接口
This commit is contained in:
@@ -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<>();
|
||||
}
|
||||
Reference in New Issue
Block a user