# homework_backend 

**Repository Path**: mr_tangfubin/homework_backend

## Basic Information

- **Project Name**: homework_backend 
- **Description**: 作业管理系统后端代码
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-08-14
- **Last Updated**: 2026-08-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 智能教师作业布置提交批改系统 (Smart Homework System)

## 📖 项目简介
本系统是一套面向教育的智慧教学工具，旨在通过AI技术重塑传统作业流程，解决教师批改负担重、学情数据难沉淀、分层教学难实施等核心痛点。系统实现了从“智能布置”、“多端提交”到“AI+人工协同批改”，再到“精准学情分析”的业务闭环。

## 🎯 核心功能矩阵
系统覆盖作业全生命周期，核心模块划分如下：

| 模块名称 | 核心能力 | 用户角色 |
| :--- | :--- | :--- |
| **作业中心** | 支持一键复用历史作业、按班级/小组分层布置、定时发布与截止提醒 | 教师 |
| **题库中心** | 支持Word/Excel批量导入试题，支持知识点标签化管理与主客观题混合组卷 | 教师/管理员 |
| **批改引擎** | 客观题全自动批改；主观题基于OCR与AI大模型预评分，教师仅需滑动确认或语音批注 | 教师 / AI |
| **数据中心** | 自动生成班级“学情五维图”（正确率、失分点、平均耗时、进步曲线、错题排行榜） | 教师 / 管理员 |
| **学生端** | 在线作答、拍照上传手写答案、接收批改通知、查看个性化错题本与同类题推荐 | 学生 |

## 👥 目标用户与角色
-   **教师**：核心操作用户，负责布置、批阅与讲评。
-   **学生**：作业接收与提交者，获取学习反馈。
-   **管理员**：负责班级架构管理、账号权限分配及系统参数配置。

## 🏗️ 技术架构概览
-   **前端架构**：
    -   教师管理端：`React/Vue` (适合复杂后台交互)
    -   学生移动端：`Uni-app` (跨平台，支持小程序/H5)
-   **后端架构**：`Spring Boot / Node.js` 微服务模式 (作业服务、批改服务、用户服务分离)
-   **AI能力层**：
    -   手写识别：`PaddleOCR` 或云厂商OCR服务
    -   主观题语义评判：本地化部署的开源大模型（保障数据安全）
-   **数据层**：`MySQL` (事务性数据) + `Redis` (缓存与分布式锁) + `OSS` (存储学生答卷图片)

## 🔄 核心业务逻辑流程
系统遵循以下闭环流程，确保数据流转顺畅：

1.  **布置**：教师选/出题 → 设定得分点与难度系数 → 系统预估完成时长 → 推送至指定班级学生端。
2.  **提交**：学生作答（支持断网暂存）→ 联网提交 → 系统自动查重 → 生成提交成功回执。
3.  **批改**：
    -   客观题（选择/判断/填空）：提交即触发全自动批改。
    -   主观题（解答/作文）：AI流水线处理（OCR识别→语义理解→预打分）。
    -   *容错机制*：AI置信度 >95% 则自动归档；<95% 则进入教师“待批改工作台”。
4.  **反馈**：批改完成后，系统实时推送成绩单、错题本及基于知识点的同类题个性化补救练习。

## 🚀 快速开始（开发环境搭建）

### 前置依赖
-   Node.js (v16+)
-   Java (JDK 11+) / 或 Python (3.9+)
-   MySQL (5.7+)
-   Redis

### 本地启动步骤
1.  **克隆代码仓库**
    ```bash
    git clone [your-repository-url]
    cd smart-homework-system
    
### 项目截图
<img src="./screenshots/login.png" width="800"/>
<img src="./screenshots/admin1.png" width="800"/>
<img src="./screenshots/admin2.png" width="800"/>
<img src="./screenshots/teacher1.png" width="800"/>
<img src="./screenshots/teacher2.png" width="800"/>
<img src="./screenshots/teacher3.png" width="800"/>
<img src="./screenshots/teacher4.png" width="800"/>
<img src="./screenshots/teacher5.png" width="800"/>
<img src="./screenshots/teacher6.png" width="800"/>
<img src="./screenshots/teacher7.png" width="800"/>
<img src="./screenshots/teacher8.png" width="800"/>
<img src="./screenshots/teacher9.png" width="800"/>
<img src="./screenshots/student1.png" width="800"/>
<img src="./screenshots/student2.png" width="800"/>
<img src="./screenshots/student3.png" width="800"/>
<img src="./screenshots/student4.png" width="800"/>





##  后端启动 (以Spring Boot为例)
cd backend
mvn clean install
# 修改 application-dev.yml 中的数据库与Redis连接配置
mvn spring-boot:run -Dspring-boot.run.profiles=dev

## 前端启动 (教师端)
cd frontend-teacher
npm install
npm run serve

### 项目目录结构（简要）
smart-homework-system/
├── backend/                  # 后端微服务
│   ├── homework-service/     # 作业布置与提交服务
│   ├── grading-service/      # 批改与评分服务
│   └── user-service/         # 用户与权限管理
├── frontend-teacher/         # 教师端Web应用
├── app-student/              # 学生端跨平台应用
├── ai-engine/                # AI批改核心引擎（OCR+大模型）
├── docs/                     # 项目文档（数据库设计、接口文档等）
│   ├── DATABASE_SCHEMA.sql   # 核心表结构建表语句
│   └── API_DOCUMENTATION.md  # Restful API 定义
└── README.md                 # 项目说明文件

🗺️ 未来迭代规划 (V2.0)
智能预测出题：基于学生历史错题大数据，利用算法预测班级未来失分点，并一键生成专项练习卷。

深度互动：增加教师在线“视频微课”推送功能，针对共性错题进行靶向讲解。

👥 开发团队与贡献
本项目基于系统化需求分析与标准化软件工程流程设计，邀请了多位教育技术专家与AI工程师共同参与开发，主要由汤老师负责整体项目规划和架构。
欢迎提交Issue或Pull Request。