# ClassManager

**Repository Path**: Lirui90/class-manager

## Basic Information

- **Project Name**: ClassManager
- **Description**: 学生管理系统
- **Primary Language**: NodeJS
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-25
- **Last Updated**: 2026-02-25

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 班级管理系统（带登录功能）

一个基于 Node.js + Express 的班级管理系统，提供用户注册、登录认证以及班级/学生信息管理功能。前端页面离线可用，班级数据自动保存在浏览器本地存储中，支持文件导入/导出备份。

---

## 功能特点

- 🔐 **用户认证**：注册、登录，使用 JWT 进行身份验证。
- 📚 **班级管理**：创建、编辑、删除班级。
- 👥 **学生管理**：在班级内添加、编辑、删除学生。
- 💾 **自动保存**：班级和学生数据实时保存到浏览器的 `localStorage`，刷新页面不丢失。
- 📁 **文件备份**：支持将数据导出为 JSON 文件，或从 JSON 文件导入恢复数据。
- 🌐 **离线可用**：登录后班级管理页面完全离线工作（不依赖后端 API）。
- 🔒 **安全存储**：用户密码使用 bcrypt 哈希存储，JWT 密钥可自定义。

---

## 技术栈

| 技术 | 用途 |
|------|------|
| Node.js | 后端运行环境 |
| Express | Web 框架 |
| jsonwebtoken | 生成和验证 JWT |
| bcryptjs | 密码哈希 |
| cors | 跨域支持 |
| body-parser | 解析请求体 |
| HTML/CSS/JavaScript | 前端页面和交互 |
| localStorage | 前端数据持久化 |

---

## 本地部署教程

### 环境要求

- [Node.js](https://nodejs.org/)（建议使用 LTS 版本）
- Git（可选，用于克隆仓库）

### 安装步骤

1. **克隆或下载本项目**
   ```bash
   git clone https://gitee.com/您的用户名/class-manager.git
   cd class-manager
2. **安装后端依赖**

bash:
npm install express jsonwebtoken bcryptjs cors body-parser
3. **启动服务器**

bash:
node server.js
终端显示 Server running at http://localhost:3000 即表示启动成功。

4. **访问应用**
打开浏览器，访问 http://localhost:3000，进入登录页面。

注意：首次运行时，users.json 文件会在第一个用户注册时自动创建。班级数据无需后端，直接在前端操作。