HuiDongShuai/onion-dmp

Fork 0

Files

inkling fafd267288 Update README and project cleanup

2026-04-08 14:52:09 +08:00

3.8 KiB

Raw Permalink Blame History

家庭教育档案系统更新总结

📋 完成的工作

1. Excel数据导入

✅ 创建了导入脚本 scripts/import-excel.js

读取 家庭教育档案-天数.xlsx 中的191条档案数据
自动解析"天数"字段（60天/180天）并创建对应的标签分类
将所有信息导入到SQLite数据库

导入结果：

总用户数：191人
├─ 60天课程：187人 (97.91%)
└─ 180天课程：1人 (0.52%)

2. 数据库扩展

✅ 添加了"指导周期"标签分类

分类ID: 1
标签1: 60天课程 (187人)
标签2: 180天课程 (1人)

✅ 每条用户记录的 extra_json 字段保存了详细信息：

{
  "fileName": "聊天记录101",
  "childName": "笑笑",
  "guardian1Name": "马晓娜",
  "childAge": 16,
  "grade": "高一",
  "learningScore": "优秀",
  "familyAddress": "...",
  "questionnaireSummary": "...",
  "duration": "60天"
}

3. 后端API扩展

✅ 添加了新的API端点：GET /api/duration-stats

GET /api/duration-stats?theme=onion
↓
获取指导周期的统计数据
{
  "totalUsers": 191,
  "durationBreakdown": [
    {
      "id": 1,
      "key": "duration_60",
      "name": "60天课程",
      "count": 187,
      "rate": 97.91
    },
    {
      "id": 2,
      "key": "duration_180",
      "name": "180天课程",
      "count": 1,
      "rate": 0.52
    }
  ]
}

✅ 改进了 /api/users/sample 端点

返回的用户数据现在包含 extra_json 中的所有字段
可以看到孩子姓名、年龄、成绩等详细信息

4. 前端功能更新

✅ 添加了"指导周期分析"按钮到顶部导航栏 ✅ 创建了新的右侧面板：loadDurationStats()

显示总参与人数
展示各阶段（60天/180天）的分布情况
包含进度条和百分比两种可视化
详细的说明文字

5. 依赖更新

✅ 在 package.json 中添加了 exceljs@^4.4.0 依赖

🗂️ 新增文件

scripts/
  └─ import-excel.js    # Excel数据导入脚本

🎯 核心特性

数据导入工作流

# 1. 运行导入脚本（将Excel数据导入数据库）
node scripts/import-excel.js

# 2. 启动服务器
node server.js

# 3. 打开浏览器访问
http://localhost:3456

前端交互

指导周期分析面板

点击顶部导航栏的"指导周期分析"按钮
右侧面板显示：
- 📊 总参与人数（191人）
- 📈 60天vs180天的分布对比
- 🎯 相应的百分比和可视化进度条

数据获取

通过配置标记打标：

所有导入的用户自动被标记"60天课程"或"180天课程"标签
可以在前端通过点击这些标签来筛选对应周期的档案

通过API查询：

curl http://localhost:3456/api/duration-stats

📊 数据质量检查

✅ 所有191条档案都被成功导入 ✅ 每条档案都包含完整的监护人、孩子、评估问卷等信息 ✅ "天数"字段被正确分类和统计 ✅ 数据库索引和覆盖率都已更新

🚀 可扩展性

系统已准备好支持：

多阶段课程周期（如：30天、90天、365天等）
按周期进行用户分群分析
生成周期相关的报告和数据可视化
与家庭教育服务流程的深度集成

💾 使用建议

定期导入新数据

node scripts/import-excel.js /path/to/新档案-天数.xlsx

查询特定周期的档案
- 在前端点击"60天课程"或"180天课程"标签
- 系统自动计算该周期的人数和占比
导出数据分析
- 使用 /api/duration-stats 获取统计数据
- 用于BI工具或报表系统

📝 特别说明

系统使用SQLite存储，支持WAL模式下的并发读写
缓存策略：位图交叉计算O(n/64)复杂度，结果缓存5分钟
所有用户详情保存在extra_json，便于后续扩展字段

3.8 KiB Raw Permalink Blame History Unescape Escape