# 宿舍管理

**Repository Path**: mzb329/dormitory-management

## Basic Information

- **Project Name**: 宿舍管理
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-10
- **Last Updated**: 2026-04-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 宿舍管理系统

基于 Python + PyQt5 + SQLite 的宿舍管理系统。

## 功能特性

### 管理员端
- **学生管理**：学生信息的增删改查、批量导入导出
- **宿舍管理**：宿舍信息管理、批量创建、状态查询
- **入住登记**：选择学生和宿舍办理入住
- **退房登记**：办理退房、水电费校验
- **调宿管理**：办理调宿申请
- **水电费管理**：水电费录入、缴费管理
- **报修管理**：报修状态更新、评价管理
- **数据统计**：可视化图表统计
- **系统设置**：密码修改、数据备份恢复

### 学生端
- **个人信息**：查看个人住宿信息
- **水电费查询**：查看水电费明细
- **申请管理**：退房申请
- **报修管理**：提交报修、查看进度、评价

## 运行环境

- Python 3.8+
- Windows 10/11

## 安装运行

```bash
# 1. 进入项目目录
cd dormitory_management_system

# 2. 安装依赖
pip install -r requirements.txt

# 3. 初始化测试数据（可选）
python init_test_data.py

# 4. 运行程序
python main.py
```

## 默认账号

| 角色 | 用户名 | 密码 |
|------|--------|------|
| 管理员 | admin | admin123 |
| 学生 | 学号 | 学号后6位 |

示例学生账号：
- 学号：240829110101，密码：110101
- 学号：240829110102，密码：110102

## 项目结构

```
dormitory_management_system/
├── main.py                  # 程序入口
├── config.py                # 全局配置
├── init_test_data.py        # 测试数据初始化
├── requirements.txt         # 依赖清单
│
├── database/                # 数据库层
│   ├── db_manager.py       # 数据库管理
│   └── schema.sql          # 表结构
│
├── models/                  # 数据模型
├── dao/                     # 数据访问层
├── services/                # 业务逻辑层
│
├── ui/                      # 界面层
│   ├── common/             # 公共组件
│   ├── admin/              # 管理员端界面
│   └── student/            # 学生端界面
│
├── utils/                   # 工具类
└── tests/                   # 测试模块
```

## 技术栈

- **GUI框架**：PyQt5
- **数据库**：SQLite
- **图表**：matplotlib
- **Excel处理**：openpyxl
- **PDF生成**：reportlab

## 开发信息

- 作者：海永杰
- 指导教师：黄仙姣
- 项目名称：基于Python的宿舍管理系统设计与实现