# 空间批量操作问题修复规格说明书

**文档版本**: v1.0  
**创建日期**: 2026-02-23  
**文档类型**: Bug修复规格说明书

---

## 一、问题描述

用户报告了8个问题，需要逐一分析和修复：

### 问题列表

| 序号 | 问题描述 | 状态 |
|------|---------|------|
| 1 | 批量操作点进去的生成类型不用显示了，隐藏即可 | ✅ 已隐藏 |
| 2 | 批量生成房间保存，提示失败 | ⚠️ 需排查 |
| 3 | 批量生成车位后缀应为空 | ✅ 已设置 |
| 4 | 批量生成车位设置的3位数序号，但生成的是1位数，且自动带上了后缀号车位 | ⚠️ 需排查 |
| 5 | 批量操作不再限定必须选中楼栋或车位才能添加对应批量信息 | ⚠️ 需修改 |
| 6 | 停车区域的子项里显示的车位列表设置成支持分页，每页20个 | ✅ 已支持 |
| 7 | 新增的批量楼栋依然没有生成地址 | ⚠️ 需修改 |
| 8 | 项目查看详情，统计数据里，显示总户数8户，但是我增加了12户。面积为空 | ⚠️ 需排查 |

---

## 二、问题分析

### 2.1 问题1：生成类型隐藏

**文件**: `ether-ui-admin/src/views/mdm/project/components/BatchGenerateModal.vue`

**当前状态**: 第21行已使用 `v-show="false"` 隐藏

```vue
<a-form-item label="生成类型" name="generateType" v-show="false">
```

**结论**: ✅ 已正确隐藏，无需修改

---

### 2.2 问题2：批量生成房间保存失败

**相关文件**:
- 前端: `BatchGenerateModal.vue` 第451-477行
- 后端: `SpaceNodeServiceImpl.java` 第932-994行

**前端代码分析**:
```typescript
const generateRooms = async () => {
  if (!formState.value.buildingIds || formState.value.buildingIds.length === 0) {
    throw new Error("请选择所属楼栋");
  }
  // ... 调用 API
};
```

**后端代码分析**:
```java
public List<SpaceNodeResponse> batchGenerateRooms(BatchGenerateRoomsRequest request) {
    // 检查楼栋是否存在
    SpaceNode building = spaceNodeRepository.findById(buildingId)
            .orElseThrow(() -> new BusinessException("楼栋不存在: " + buildingId));
    // ...
}
```

**可能原因**:
1. 前端传递的 `buildingIds` 可能是空数组
2. 后端 `findById` 可能找不到楼栋（项目隔离问题）
3. 编码冲突导致失败

**需要检查**:
- API 路径是否正确
- 项目上下文是否正确传递
- 后端日志输出

---

### 2.3 问题3：车位后缀应为空

**前端代码**: `BatchGenerateModal.vue` 第490行

```typescript
await spaceNodeApi.batchGenerateParkingSpaces({
  // ...
  suffix: "",  // ✅ 已设置为空字符串
});
```

**结论**: ✅ 已正确设置，无需修改

---

### 2.4 问题4：车位序号位数和名称问题

**后端代码**: `SpaceNodeServiceImpl.java` 第1057-1070行

```java
int digitCount = request.getDigitCount() != null ? request.getDigitCount() : 3;

for (int i = 0; i < request.getCount(); i++) {
    int number = request.getStartNumber() + i;
    String code = (request.getPrefix() != null ? request.getPrefix() : "") 
            + String.format("%0" + digitCount + "d", number);  // ✅ 正确使用位数
    
    // ...
    parkingSpace.setName(code);  // ✅ 名称只使用编码，没有添加"车位"后缀
}
```

**前端代码**: `BatchGenerateModal.vue` 第369-385行

```typescript
const generateParkingCodePreview = () => {
  const { codePrefix, digitCount, startNumber, parkingCount } = formState.value;
  // ...
  const code = `${codePrefix}${String(num).padStart(digitCount, '0')}`;  // ✅ 正确使用位数
};
```

**结论**: 后端代码逻辑正确。需要检查：
1. 前端是否正确传递 `digitCount` 参数
2. 后端是否正确接收 `digitCount` 参数

---

### 2.5 问题5：批量操作限制

**前端代码**: `SpaceManagement.vue` 第613-621行

```typescript
// 计算是否可以批量生成房间（需要选中楼栋）
const canBatchGenerateRoom = computed(() => {
  return selectedNode.value?.nodeType === SpaceNodeType.BUILDING;
});

// 计算是否可以批量生成车位（需要选中停车区域）
const canBatchGenerateParking = computed(() => {
  return selectedNode.value?.nodeType === SpaceNodeType.GARAGE || 
         selectedNode.value?.nodeType === SpaceNodeType.PARKING_AREA;
});
```

**问题**: 这些计算属性已定义但未使用来限制批量生成操作

**需要修改**: 移除限制，允许直接从菜单选择批量生成类型

---

### 2.6 问题6：车位列表分页

**前端代码**: `SpaceManagement.vue` 第225-229行

```vue
<a-table
  :pagination="{
    pageSize: 20,
    showSizeChanger: false,
    showTotal: (total: number) => `共 ${total} 条`
  }"
>
```

**结论**: ✅ 已支持分页，每页20条

---

### 2.7 问题7：批量楼栋地址生成

**后端代码**: `SpaceNodeServiceImpl.java` 第902-911行

```java
if (parentNode != null) {
    building.setTreePath(parentTreePath + "." + buildingId);
    building.setLevel(baseLevel);
    String parentAddress = parentNode.getAddress() != null ? parentNode.getAddress() : parentNode.getName();
    building.setAddress(parentAddress + " " + name);
} else {
    building.setTreePath(buildingId.toString());
    building.setLevel(0);
    building.setAddress(name);  // ⚠️ 没有父节点时，地址只设置为名称
}
```

**问题**: 当没有父节点时，地址只设置为 `name`（如 "B001号楼"），而不是完整地址

**需要修改**: 应该使用项目地址作为基础地址

---

### 2.8 问题8：项目统计数据不正确

**相关文件**:
- 前端: `project/detail.vue` 第458-471行
- 后端: `ProjectServiceImpl.java`

**前端代码**:
```typescript
try {
  statistics.value = await projectApi.getProjectStatistics(projectId);
} catch {
  // 统计接口可能不存在，使用默认值
  statistics.value = {
    totalBuildings: project.value?.totalBuildings ?? 0,
    totalUnits: project.value?.totalUnits ?? 0,
    // ...
  };
}
```

**问题**: 统计数据可能来自项目表的缓存字段，而不是实时计算

**需要检查**:
1. 后端统计接口是否实时计算
2. 项目表的 `totalBuildings`, `totalUnits` 等字段是否正确更新

---

## 三、修复方案

### 3.1 问题2修复：批量生成房间

**需要检查**:
1. 确保前端正确传递项目ID
2. 确保后端使用项目上下文查询楼栋

### 3.2 问题4修复：车位序号位数

**需要验证**:
1. 前端传递的 `digitCount` 参数是否正确
2. 后端接收参数是否正确

### 3.3 问题5修复：移除批量操作限制

**修改文件**: `SpaceManagement.vue`

**修改内容**: 移除 `canBatchGenerateRoom` 和 `canBatchGenerateParking` 的限制检查

### 3.4 问题7修复：楼栋地址生成

**修改文件**: `SpaceNodeServiceImpl.java`

**修改内容**: 当没有父节点时，使用项目地址作为基础地址

### 3.5 问题8修复：项目统计数据

**需要检查**:
1. 后端统计接口实现
2. 空间节点变更时是否更新项目统计字段

---

## 四、测试验证

### 4.1 测试环境

- 前端: http://localhost:5175
- 后端: http://localhost:8080

### 4.2 测试用例

| 序号 | 测试项 | 预期结果 |
|------|--------|---------|
| 1 | 打开批量生成弹窗，确认生成类型已隐藏 | 不显示生成类型选择 |
| 2 | 批量生成房间 | 保存成功 |
| 3 | 批量生成车位，设置3位数序号 | 生成如 001, 002, 003 格式 |
| 4 | 批量生成车位，名称不带"车位"后缀 | 名称与编码一致 |
| 5 | 不选中任何节点，点击批量生成楼栋/房间/车位 | 弹窗正常打开 |
| 6 | 停车区域子项列表 | 支持分页，每页20条 |
| 7 | 批量生成楼栋，查看地址 | 地址包含项目地址 |
| 8 | 项目详情统计数据 | 显示正确的户数和面积 |

---

## 五、风险评估

| 风险项 | 影响 | 缓解措施 |
|--------|------|---------|
| 修改后端地址生成逻辑 | 可能影响现有数据 | 仅影响新生成的楼栋 |
| 移除批量操作限制 | 用户可能误操作 | 在弹窗中提示用户选择正确的父节点 |
| 统计数据修复 | 可能需要数据迁移 | 提供统计刷新接口 |

---

**下一步**: 创建任务清单并开始修复