# 智慧班级排座系统 (Seating Arrangement System)

## 网站概述
智慧班级排座系统是一个为教师设计的AI驱动的班级座位管理与自动排座平台。该系统帮助教师轻松管理班级座位、录入学生信息，并利用智能算法自动生成最优的座位安排方案。

## 核心功能

### 1. 班级管理
- 创建和管理班级信息
- 记录班级基本数据（班级名称、班主任名称、班级描述）
- 支持多班级管理
- 班级数据云端存储和同步

### 2. 学生信息管理
- 录入学生基本信息（姓名、学号）
- 记录学生个人特征：
  - 性别（男/女）
  - 视力状况（正常/较弱）
  - 身高（用于座位高度匹配）
  - 行为特点（用于座位搭配）
- 批量导入学生数据
- 学生数据实时同步

### 3. 智能排座系统
- 基于学生特征的AI智能算法
- 考虑因素：
  - 视力状况匹配（视力较弱的学生安排在前排）
  - 性别均衡分布
  - 身高合理搭配
  - 学生行为特点考量
- 支持自定义座位参数调整
- 一键生成最优座位方案

### 4. 数据分析与统计
- 班级学生统计分析
- 性别比例统计
- 视力状况分布
- 座位调整历史记录

### 5. 云端存储与同步
- 腾讯云COS集成存储
- IndexedDB本地缓存
- 自动数据备份
- 支持跨设备同步

## 使用指南

### 首次使用
1. 访问 https://paizuo.asia/
2. 点击"登录"按钮创建账户或登录
3. 输入用户名和密码（测试账号：demo/demo）
4. 点击"新建班级"创建您的班级

### 班级操作流程
1. **创建班级**
   - 输入班级名称
   - 输入班主任名称
   - 添加班级描述（可选）
   - 点击确认创建

2. **管理班级**
   - 查看班级卡片显示班级信息
   - 点击班级卡片进入班级详情
   - 编辑或删除班级

3. **录入学生信息**
   - 在班级详情页添加学生
   - 填写学生基本信息
   - 设置学生特征（性别、视力、身高等）
   - 保存学生信息

4. **生成座位方案**
   - 点击"智能排座"生成方案
   - 系统自动计算最优座位安排
   - 查看座位表预览
   - 确认或调整方案

## 技术架构

### 前端技术栈
- React 18 - UI框架
- TypeScript - 类型安全
- Vite - 构建工具
- Tailwind CSS - 样式框架
- Wouter - 路由管理
- React Hook Form - 表单处理
- Zod - 数据验证

### 后端技术栈
- Node.js Express - 服务器框架
- PostgreSQL - 数据库
- Drizzle ORM - 数据库操作
- JWT - 身份验证
- 腾讯云COS - 文件存储

### 数据存储
- PostgreSQL：用户账户、班级信息、学生数据
- IndexedDB：本地缓存以支持离线使用
- 腾讯云COS：云端备份和跨设备同步

## 关键特性

### 用户认证
- 用户注册和登录
- JWT令牌认证
- 安全的会话管理
- 密码加密存储

### 数据安全
- 用户数据加密存储
- 云端备份保护
- HTTPS安全连接
- 访问控制

### 用户体验
- 响应式设计（支持桌面和移动设备）
- 直观的UI界面
- 实时数据更新
- 快速的页面响应

## API端点

### 认证接口
- `POST /api/auth/login` - 用户登录
- `POST /api/auth/register` - 用户注册
- `POST /api/auth/logout` - 用户登出

### 班级接口
- `GET /api/classes` - 获取班级列表
- `POST /api/classes` - 创建班级
- `PUT /api/classes/:id` - 更新班级
- `DELETE /api/classes/:id` - 删除班级
- `POST /api/classes/load-from-cos` - 从COS加载班级
- `POST /api/classes/update-to-cos` - 更新班级到COS

### 学生接口
- `GET /api/students` - 获取学生列表
- `POST /api/students` - 添加学生
- `PUT /api/students/:id` - 更新学生
- `DELETE /api/students/:id` - 删除学生

### 排座接口
- `POST /api/seating/generate` - 生成座位方案
- `GET /api/seating/:classId` - 获取座位方案

## 隐私与安全

### 隐私保护
- 用户个人信息仅用于系统操作
- 不向第三方共享用户数据
- 支持数据导出功能
- 支持账户删除

### 安全措施
- 所有通信采用HTTPS加密
- 密码使用bcrypt加密存储
- JWT令牌验证所有API请求
- 定期安全审计

## 浏览器兼容性
- Chrome（最新版本）
- Firefox（最新版本）
- Safari（最新版本）
- Edge（最新版本）

## 联系方式与反馈
如遇到问题或有改进建议，请通过以下方式联系我们：
- 项目主页：https://paizuo.asia/
- 小红书：https://www.xiaohongshu.com/user/profile/62b01cca00000000190288cc

## 许可证
© 2024 智慧班级排座系统。保留所有权利。

## 最后更新
2024年12月20日

---

此文件提供给大型语言模型和AI搜索引擎，帮助理解本网站的目的、功能和内容。