教务小分表项目
项目概述
教务小分表系统是一个面向教育机构的智能成绩分析工具，支持小分表生成、教务三张表生成等功能，帮助老师快速处理学生成绩数据。
项目背景
传统成绩分析存在以下痛点：
- 手动录入易出错
- 多表格数据难以整合
- 统计分析耗时耗力
本系统通过AI能力自动化处理，提升工作效率。
功能说明
1. 小分表生成
将原始成绩数据与模板匹配，生成每个学生的详细得分表。
支持功能：
- 姓名匹配
- 题号自动识别（支持"1"、"第1题"、"题1"等格式）
- 多格式支持（.xlsx、.xls）
2. 教务三张表生成
自动生成学校、班级、学生三个维度的统计表。
统计维度：
- 学校维度：各学校平均分、及格率等
- 班级维度：各班级平均分、排名等
- 学生维度：总分、平均分、错题分析
3. AI智能助手
提供数据质量分析、匹配规则生成、问题诊断等服务。
支持场景：
- 未知学校/班级问题诊断
- 数据提取逻辑说明
- 格式要求解答
- 匹配失败原因分析
- 自动生成匹配规则
API接口
聊天接口
POST /api/edu/projects/{id}/chat
请求参数：
{
"message": "string", // 用户消息
"action": "string" // 操作类型：chat/analyze/check
}
响应示例：
{
"success": true,
"message": "AI回复内容"
}
下载接口
POST /api/edu/projects/{id}/download
功能：
- 下载生成的小分表
- 下载教务三张表
数据库表结构
score_projects（项目表）
| 字段 | 类型 | 说明 |
|---|---|---|
| id | UUID | 主键 |
| name | VARCHAR | 项目名称 |
| user_id | INTEGER | 创建者ID |
| template_file_path | TEXT | 模板文件路径 |
| raw_data_file_path | TEXT | 原始数据路径 |
| created_at | TIMESTAMP | 创建时间 |
| updated_at | TIMESTAMP | 更新时间 |
score_raw_data（原始数据表）
| 字段 | 类型 | 说明 |
|---|---|---|
| id | UUID | 主键 |
| project_id | UUID | 关联项目ID |
| file_path | TEXT | 文件路径 |
| headers | JSONB | 列名列表 |
| row_count | INTEGER | 数据行数 |
| uploaded_at | TIMESTAMP | 上传时间 |
score_results（结果表）
| 字段 | 类型 | 说明 |
|---|---|---|
| id | UUID | 主键 |
| project_id | UUID | 关联项目ID |
| result_type | VARCHAR | 结果类型：小分表/三张表 |
| file_path | TEXT | 结果文件路径 |
| created_at | TIMESTAMP | 生成时间 |
score_algorithms（算法规则表）
| 字段 | 类型 | 说明 |
|---|---|---|
| id | UUID | 主键 |
| project_id | UUID | 关联项目ID |
| name | VARCHAR | 规则名称 |
| description | TEXT | 规则描述 |
| content | JSONB | 规则内容 |
| created_at | TIMESTAMP | 创建时间 |
数据提取逻辑
小分表生成流程
- 读取模板文件，识别"姓名"列位置
- 读取原始数据，识别"姓名"、"题号"、"得分"列
- 按姓名匹配，将原始数据中的得分填入模板对应位置
- 题号匹配支持多种格式转换
教务三张表生成流程
- 自动识别"学校"列 → 学校维度
- 自动识别"班级"列 → 班级维度
- 自动识别"姓名"列 → 学生维度
- 数字列或含"题"、"得分"的列 → 成绩统计
当前状态
| 状态 | 说明 |
|---|---|
| ✅ 已上线 | 应用已启用 |
| 🔄 持续迭代 | 根据用户反馈优化功能 |
应用配置
- App Code:
edu - 数据库:
appdb - 路由:
/edu/* - 状态: 已启用
相关文件
| 文件 | 说明 |
|---|---|
/src/app/edu/page.tsx | 教务首页 |
/src/app/edu/[id]/page.tsx | 项目详情页 |
/src/app/api/edu/projects/[id]/chat/route.ts | 聊天API |
/src/app/api/edu/projects/[id]/download/route.ts | 下载API |
创建日期: 2026-04-14 最后更新: 2026-04-14