# SeatsChanger

**Repository Path**: xi-guang1/seats-changer

## Basic Information

- **Project Name**: SeatsChanger
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: GPL-3.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-10-06
- **Last Updated**: 2025-10-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 教室座位安排系统

## 项目概述

教室座位安排系统是一个基于PyQt5开发的图形化工具，旨在帮助教师和管理人员快速、灵活地安排教室座位。该系统提供直观的用户界面，支持拖拽操作、自定义布局和多种导出格式，适用于各种教学场景。

## 功能特点

- **直观的座位管理**：通过拖拽操作轻松安排学生座位
- **自定义布局**：可灵活配置座位行列数、尺寸和列名称
- **学生名单管理**：支持手动添加和CSV批量导入学生名单
- **多种导出格式**：支持将座位表导出为图片

## 安装步骤

### 环境要求
- Python 3.6+ 环境
- PyQt5 库
- qfluentwidgets 库

### 安装依赖

1. 首先确保已安装Python环境
2. 安装必要的Python库：

```bash
pip install PyQt5 PyQt-Fluent-Widgets[full]
```

### 下载项目

1. 克隆或下载本项目到本地
2. 进入项目目录

## 使用方法

### 启动应用

在项目目录下执行以下命令启动应用：

```bash
python main.py
```

### 基本操作

1. **添加学生**：在输入框中输入学生姓名，点击"添加学生"按钮
2. **导入学生**：点击"导入CSV"按钮，选择包含学生名单的CSV文件
3. **安排座位**：从学生列表中拖拽学生姓名到座位区域的座位上
4. **调整布局**：点击"设置"按钮，可修改座位行列数、尺寸和列名称
5. **导出座位表**：点击"导出为图片"按钮，选择保存位置和格式

## 常见问题解答

### Q: 如何导入大量学生名单？
A: 使用"导入CSV"功能，CSV文件需包含学生姓名列，每行一个学生。

### Q: 如何调整座位表布局？
A: 点击"设置"按钮，在弹出的对话框中调整各列的行数、列数和尺寸。

### Q: 如何修改窗口大小和主题？
A: 可以直接拖动窗口边缘调整大小，或通过修改`config.json`文件中的相应配置。

## 项目结构

```
SeatsChanger/
├── .gitignore         # Git忽略文件配置
├── config.json        # 系统配置文件
├── config_manager.py  # 配置管理器
├── export_manager.py  # 导出功能管理器
├── main.py            # 程序入口
├── main_window.py     # 主窗口实现
├── settings.py        # 设置面板
├── utils.py           # 工具函数
└── widgets.py         # 自定义控件
```

## 开发说明

### 代码规范
- 遵循Python PEP8编码规范
- 类名使用大驼峰命名法
- 函数和变量使用小驼峰或下划线命名法
- 每个函数和类都应有适当的文档字符串

### 扩展建议
- 增加座位随机生成功能
- 添加座位表模板功能
- 实现多教室管理
- 支持座位历史记录和版本管理

## 联系方式

如有任何问题或建议，请提交issue或pr

## 更新日志

### 版本 1.0.0
- 初始版本发布
- 实现基本的座位安排和管理功能
- 支持CSV导入和图片导出