booking_admin/doc/座位布局导出功能说明.md

# 座位布局导出功能说明

## 功能概述

在座位布局弹窗中新增了"导出"按钮，可以将座位布局导出为Excel格式文件，包含完整的布局信息和座位状态。

## 功能特点

1. **完整的布局信息**：导出包含所有座位、过道、柱子、投影等布局元素
2. **座位状态显示**：
   - **蓝色单元格**：已预订座位（显示编号、学员姓名、预订日期）
   - **绿色单元格**：空闲座位（显示编号和"空闲"标识）
   - **红色单元格**：不可选座位（显示编号和"不可选"标识）
   - **橙色单元格**：过道
   - **蓝色单元格**：投影区域
   - **灰色单元格**：柱子
   - **浅蓝色单元格**：门
3. **样式美化**：Excel文件包含颜色填充、字体样式、对齐方式等
4. **合并单元格支持**：正确导出合并的单元格

## 使用方法

1. 在教室列表页面，点击某个教室的"座位布局"按钮
2. 在座位布局弹窗的右上角，点击"导 出"按钮
3. 系统会自动生成Excel文件并下载，文件名格式：`教室名称_座位布局_日期.xlsx`

## 技术实现

### 依赖库

- `xlsx-js-style`：用于生成带样式的Excel文件
- `xlsx`：基础Excel处理库

### 安装方式

如果安装失败，可以尝试使用不同的npm源：

```bash
# 使用淘宝镜像
pnpm add xlsx-js-style --registry https://registry.npmmirror.com

# 或使用官方源
pnpm add xlsx-js-style --registry https://registry.npmjs.org
```

### 代码位置

- 导出功能实现：`apps/web-antd/src/views/classroom/list.vue`
- 导出按钮位置：座位布局弹窗顶部右侧

## 导出格式说明

### Excel结构

- **第一行**：列标题（A, B, C, D...）
- **第一列**：行号（1, 2, 3, 4...）
- **数据区域**：座位布局数据，包含颜色和样式

### 单元格内容格式

- **已预订座位**：`编号 学员姓名 预订日期`（蓝色背景）
- **空闲座位**：`编号 空闲`（绿色背景）
- **不可选座位**：`编号 不可选`（红色背景）
- **过道**：`过道`（橙色背景）
- **投影**：`投影`（蓝色背景）
- **柱子**：`柱子`（灰色背景）
- **门**：`门`（浅蓝色背景）

## 注意事项

1. 导出功能需要获取座位状态数据，如果获取失败，将只导出布局信息（不包含预订状态）
2. 合并单元格会正确导出，保持与界面一致的布局
3. Excel文件支持在Excel、WPS等软件中打开和编辑