284 lines
7.1 KiB
Markdown
284 lines
7.1 KiB
Markdown
# 座位分配系统 - Windows部署说明
|
||
|
||
## 目录
|
||
- [概述](#概述)
|
||
- [系统要求](#系统要求)
|
||
- [开发者构建指南](#开发者构建指南)
|
||
- [用户使用指南](#用户使用指南)
|
||
- [故障排除](#故障排除)
|
||
- [技术支持](#技术支持)
|
||
|
||
## 概述
|
||
|
||
本文档说明如何在Windows系统上构建和部署座位分配系统。该系统支持1-10人连坐需求，能够处理不连续座位分配。
|
||
|
||
**主要功能：**
|
||
- 智能座位分配算法
|
||
- 支持连坐组合（1-10人）
|
||
- 完整的文件校验
|
||
- 详细的分配日志
|
||
- 用户友好的命令行界面
|
||
|
||
## 系统要求
|
||
|
||
### 开发环境要求
|
||
- **操作系统**: Windows 7/10/11 (64位)
|
||
- **Python版本**: Python 3.8 或更高版本
|
||
- **内存**: 至少 2GB RAM
|
||
- **磁盘空间**: 至少 500MB 可用空间
|
||
- **网络**: 需要网络连接以下载依赖包
|
||
|
||
### 运行环境要求（最终用户）
|
||
- **操作系统**: Windows 7/10/11 (64位)
|
||
- **内存**: 至少 1GB RAM
|
||
- **磁盘空间**: 至少 100MB 可用空间
|
||
- **Excel**: Microsoft Excel 2010 或更高版本（查看结果文件）
|
||
|
||
## 开发者构建指南
|
||
|
||
### 1. 环境准备
|
||
|
||
#### 1.1 安装Python
|
||
从 [Python官网](https://www.python.org/downloads/) 下载并安装Python 3.8+
|
||
|
||
确保安装时勾选：
|
||
- ✅ Add Python to PATH
|
||
- ✅ Install pip
|
||
|
||
#### 1.2 验证安装
|
||
```cmd
|
||
python --version
|
||
pip --version
|
||
```
|
||
|
||
### 2. 下载源代码
|
||
|
||
```cmd
|
||
git clone <repository-url>
|
||
cd TableSynthesis
|
||
```
|
||
|
||
### 3. 自动构建（推荐）
|
||
|
||
#### 3.1 运行构建脚本
|
||
```cmd
|
||
python windows_build.py
|
||
```
|
||
|
||
构建脚本将自动完成：
|
||
- ✅ 检查系统环境
|
||
- ✅ 安装必要依赖
|
||
- ✅ 构建独立exe文件
|
||
- ✅ 创建分发包
|
||
|
||
#### 3.2 构建输出
|
||
构建成功后，会生成：
|
||
```
|
||
座位分配系统_Windows_分发包/
|
||
├── 座位分配系统.exe # 主程序
|
||
├── 运行座位分配系统.bat # 启动脚本
|
||
├── 使用说明.txt # 使用说明
|
||
├── 人员信息_示例.xlsx # 示例文件
|
||
└── 座位信息_示例.xlsx # 示例文件
|
||
```
|
||
|
||
### 4. 手动构建（可选）
|
||
|
||
如果自动构建失败，可以手动构建：
|
||
|
||
#### 4.1 安装依赖
|
||
```cmd
|
||
pip install pandas>=1.3.0 openpyxl>=3.0.0 numpy>=1.20.0 pyinstaller>=4.0
|
||
```
|
||
|
||
#### 4.2 使用PyInstaller构建
|
||
```cmd
|
||
pyinstaller --clean --noconfirm seat_allocation.spec
|
||
```
|
||
|
||
#### 4.3 手动创建分发包
|
||
```cmd
|
||
mkdir 座位分配系统_Windows_分发包
|
||
copy dist\座位分配系统.exe 座位分配系统_Windows_分发包\
|
||
copy 人员信息.xlsx 座位分配系统_Windows_分发包\人员信息_示例.xlsx
|
||
copy 座位信息.xlsx 座位分配系统_Windows_分发包\座位信息_示例.xlsx
|
||
copy 运行座位分配系统.bat 座位分配系统_Windows_分发包\
|
||
```
|
||
|
||
## 用户使用指南
|
||
|
||
### 1. 获取分发包
|
||
|
||
从开发者处获取 `座位分配系统_Windows_分发包` 文件夹，或下载已构建的发布版本。
|
||
|
||
### 2. 准备数据文件
|
||
|
||
#### 2.1 复制示例文件
|
||
```
|
||
人员信息_示例.xlsx → 人员信息.xlsx
|
||
座位信息_示例.xlsx → 座位信息.xlsx
|
||
```
|
||
|
||
#### 2.2 填写人员信息.xlsx
|
||
|
||
**必需列：**
|
||
- **姓名**: 人员姓名
|
||
- **证件类型**: 身份证、护照等
|
||
- **证件号**: 证件号码
|
||
- **手机号**: 联系电话
|
||
- **备注**: 连坐人数（留空表示单独坐）
|
||
|
||
**连坐规则：**
|
||
- 单人坐位：备注列留空
|
||
- 连坐组合：第一人填写总人数，其他人留空
|
||
|
||
**示例：**
|
||
| 姓名 | 证件类型 | 证件号 | 手机号 | 备注 |
|
||
|------|----------|--------|--------|------|
|
||
| 张三 | 身份证 | 123456789012345678 | 13800138000 | 3 |
|
||
| 李四 | 身份证 | 123456789012345679 | 13800138001 | |
|
||
| 王五 | 身份证 | 123456789012345680 | 13800138002 | |
|
||
| 赵六 | 身份证 | 123456789012345681 | 13800138003 | |
|
||
|
||
上述示例表示：张三、李四、王五需要3人连坐，赵六单独坐。
|
||
|
||
#### 2.3 填写座位信息.xlsx
|
||
|
||
**必需列：**
|
||
- **区域**: 座位区域（如"A区"、"B区"）
|
||
- **楼层**: 楼层信息（如"1层"、"2层"）
|
||
- **排号**: 排号（如"第1排"、"第2排"）
|
||
- **座位号**: 具体座位号（如"1号"、"2号"）
|
||
|
||
**示例：**
|
||
| 区域 | 楼层 | 排号 | 座位号 |
|
||
|------|------|------|--------|
|
||
| A区 | 1层 | 第1排 | 1号 |
|
||
| A区 | 1层 | 第1排 | 2号 |
|
||
| A区 | 1层 | 第1排 | 3号 |
|
||
|
||
### 3. 运行程序
|
||
|
||
#### 3.1 推荐方式（使用bat脚本）
|
||
双击 `运行座位分配系统.bat`
|
||
|
||
脚本会自动：
|
||
- ✅ 检查环境和文件
|
||
- ✅ 提供友好的错误提示
|
||
- ✅ 运行主程序
|
||
- ✅ 显示运行结果
|
||
|
||
#### 3.2 直接运行
|
||
双击 `座位分配系统.exe`
|
||
|
||
### 4. 查看结果
|
||
|
||
程序运行成功后，会生成以下文件：
|
||
|
||
- **座位信息_最终分配.xlsx**: 最终座位分配结果
|
||
- **最终座位分配日志.xlsx**: 详细分配记录
|
||
- **seat_allocation_log.txt**: 运行日志
|
||
|
||
使用Excel打开xlsx文件查看分配结果。
|
||
|
||
## 故障排除
|
||
|
||
### 常见问题
|
||
|
||
#### Q1: 程序无法启动
|
||
**可能原因：**
|
||
- 系统不兼容（需要Windows 7+）
|
||
- 缺少Visual C++ Redistributable
|
||
|
||
**解决方案：**
|
||
1. 确认系统版本：Windows 7/10/11 64位
|
||
2. 下载安装 [Microsoft Visual C++ Redistributable](https://aka.ms/vs/17/release/vc_redist.x64.exe)
|
||
|
||
#### Q2: 提示缺少依赖包
|
||
**可能原因：**
|
||
- 网络连接问题
|
||
- 权限不足
|
||
|
||
**解决方案：**
|
||
1. 确保网络连接正常
|
||
2. 以管理员身份运行
|
||
3. 手动安装：`pip install pandas openpyxl numpy`
|
||
|
||
#### Q3: 文件权限错误
|
||
**可能原因：**
|
||
- Excel文件被占用
|
||
- 程序目录只读
|
||
|
||
**解决方案：**
|
||
1. 关闭所有Excel窗口
|
||
2. 确保程序目录有写入权限
|
||
3. 避免在系统盘根目录运行
|
||
|
||
#### Q4: 数据文件格式错误
|
||
**可能原因：**
|
||
- 列名不匹配
|
||
- 数据类型错误
|
||
- 编码问题
|
||
|
||
**解决方案：**
|
||
1. 对照示例文件检查列名
|
||
2. 确保数据格式正确
|
||
3. 使用UTF-8编码保存
|
||
|
||
#### Q5: 无法找到连续座位
|
||
**可能原因：**
|
||
- 座位信息不连续
|
||
- 连坐组过大
|
||
|
||
**解决方案：**
|
||
1. 检查座位信息的连续性
|
||
2. 适当调整连坐组大小
|
||
3. 增加座位数量
|
||
|
||
### 日志分析
|
||
|
||
查看 `seat_allocation_log.txt` 文件可获取详细错误信息：
|
||
|
||
- **文件加载错误**: 检查文件路径和格式
|
||
- **数据校验错误**: 检查数据完整性
|
||
- **分配算法错误**: 检查座位和人员匹配
|
||
|
||
### 性能优化
|
||
|
||
#### 大数据处理
|
||
- **人员数量**: 建议不超过1000人
|
||
- **座位数量**: 建议不超过2000个
|
||
- **连坐组大小**: 建议不超过8人
|
||
|
||
#### 内存使用
|
||
- 小型场景（<100人）: 约50MB内存
|
||
- 中型场景（100-500人）: 约100MB内存
|
||
- 大型场景（500-1000人）: 约200MB内存
|
||
|
||
## 技术支持
|
||
|
||
### 获取帮助
|
||
|
||
1. **查看日志文件**: `seat_allocation_log.txt`
|
||
2. **检查使用说明**: `使用说明.txt`
|
||
3. **参考示例文件**: 确保数据格式正确
|
||
|
||
### 报告问题
|
||
|
||
报告问题时，请提供：
|
||
- 系统信息（操作系统版本）
|
||
- 错误截图或错误信息
|
||
- 数据文件（脱敏后）
|
||
- seat_allocation_log.txt 内容
|
||
|
||
### 更新与维护
|
||
|
||
- 定期检查更新版本
|
||
- 备份重要数据文件
|
||
- 保持系统和依赖包更新
|
||
|
||
---
|
||
|
||
**版本**: v1.0
|
||
**最后更新**: 2024年12月
|
||
**兼容性**: Windows 7/10/11 (64位) |