问卷考试系统设计（六）：报告生成——模板引擎、AI 接入与 PDF 导出

mumu — Sat, 25 Apr 2026 00:00:00 +0000

数据收集、评分计算都做完了，业务方更关心的是末尾一步：拿到一份类似样的报告。报告生成的完整链路：模板定结构、规则填数据、AI 写解读、图表画可视化、末尾拼成 PDF。

报告生成适合异步化，前端只订阅任务进度，不直接等待 PDF 渲染完成：

sequenceDiagram participant API as 报告 API participant Queue as 异步任务 participant Rule as 规则解读 participant AI as AI 文案 participant Chart as 图表渲染 participant PDF as PDF 导出 participant SSE as SSE 进度 API->>Queue: 提交评分结果 Queue->>SSE: 10% 已接收 Queue->>Rule: 生成规则解读 Queue->>AI: 生成辅助文案 Queue->>Chart: 渲染图表 PNG Queue->>PDF: 拼 HTML 并导出 PDF Queue->>SSE: 100% 报告可下载

报告生成的几种模式

模板填充适合格式固定的报告，模板写好，变量一填就完事。

规则引擎解决条件判断问题。焦虑得分 0-4 分是"无焦虑"，5-9 分是"轻度焦虑"，这种区间映射用硬编码也能写，但规则多了维护起来是噩梦。

AI 生成处理自然语言解读。数字摆在那里，但用户要的是一段"读得懂"的文字。

实际项目中三者结合：模板定骨架，规则引擎填确定性结论，AI 只负责把结论写得更类似人话。先保证可复现，再谈润色。

问卷考试系统设计（七）：数据统计、可视化与系列总结

mumu — Fri, 01 May 2026 00:00:00 +0000

上一篇：问卷考试系统设计（六）：报告生成

数据采集只是起点。问卷系统真正产生价值的时刻，是数据沉淀之后，研究者打开统计面板，看到分组差异、趋势变化和数据质量。这篇聚焦数据统计分析、多格式导出、隐私脱敏、大屏可视化，以及常模的建立过程。

统计分析要区分离线口径和实时看板，避免把探索性分析塞进在线请求：

flowchart LR A["答卷清洗"] --> B["维度分汇总"] B --> C["描述统计"] C --> D["显著性检验"] D --> E["常模构建"] E --> F["离线导出"] B --> G["实时指标聚合"] G --> H["WebSocket 推送"] H --> I["大屏看板"] E --> J["常模版本"] J --> K["评分引擎读取"]

一、描述性统计

拿到一批量表分数，第一件事是看整体面貌：

        
        
        
    
public DescriptiveStats descriptive(List<Double> scores) {
    DoubleSummaryStatistics stats = scores.stream()
        .mapToDouble(Double::doubleValue)
        .summaryStatistics();

    double mean = stats.getAverage();
    double std = Math.sqrt(
        scores.stream()
            .mapToDouble(v -> Math.pow(v - mean, 2))
            .average().orElse(0.0)
    );
    List<Double> sorted = scores.stream().sorted().collect(Collectors.toList());
    double median = sorted.size() % 2 == 0
        ? (sorted.get(sorted.size() / 2 - 1) + sorted.get(sorted.size() / 2)) / 2.0
        : sorted.get(sorted.size() / 2);

    return new DescriptiveStats(mean, std, median, stats.getMin(), stats.getMax(),
        stats.getCount());
}

均值、标准差、中位数、极值，这几个数字能快速告诉研究者数据有没有异常、分布偏不偏。对于问卷系统这个体量的数据（通常几万条以内），纯 Java Stream 基本够用。

ECharts - tag - 沐木

问卷考试系统设计（六）：报告生成——模板引擎、AI 接入与 PDF 导出

报告生成的几种模式

问卷考试系统设计（七）：数据统计、可视化与系列总结

一、描述性统计