提交房间分配给二级学院的业务代码
This commit is contained in:
1 parent
7593904a79
commit
b5e6ca3cce
27 files changed
+2727
-55
No files matched your search
@@ -0,0 +1,68 @@
|
||||
# 代码调整记录 - 2025-07-22
|
||||
|
||||
## 宿舍房间查询排序优化
|
||||
|
||||
### 变更时间
|
||||
2025-07-22 10:35:26
|
||||
|
||||
### 变更类型
|
||||
接口优化 - 数据排序调整
|
||||
|
||||
### 变更描述
|
||||
修改了宿舍房间列表查询接口的排序逻辑,调整为优先按楼层(floorNum)排序,然后按房间名称(roomName)排序,确保宿舍房间按照楼层顺序输出。
|
||||
|
||||
### 变更文件
|
||||
- `backend/ruoyi-modules/ruoyi-xg/src/main/java/org/dromara/xg/service/impl/XgDormRoomServiceImpl.java`
|
||||
|
||||
### 变更详情
|
||||
原先的排序逻辑:
|
||||
```java
|
||||
lqw.orderByAsc(XgDormRoom::getId);
|
||||
lqw.orderByAsc(XgDormRoom::getFloorNum); // 按楼层排序
|
||||
```
|
||||
|
||||
修改后的排序逻辑:
|
||||
```java
|
||||
lqw.orderByAsc(XgDormRoom::getFloorNum); // 优先按楼层排序
|
||||
lqw.orderByAsc(XgDormRoom::getRoomName); // 其次按房间名称排序
|
||||
```
|
||||
|
||||
### 原因
|
||||
前端展示宿舍房间列表时,需要按照楼层顺序进行排列,但原有排序逻辑中先按ID排序,导致楼层排序不能正确生效。
|
||||
|
||||
### 影响范围
|
||||
- 宿舍分配二级学院页面(xsssfpejxy)中的房间列表显示顺序
|
||||
- 其他调用宿舍房间查询接口的功能
|
||||
|
||||
### 测试验证
|
||||
- 验证宿舍楼下的房间是否按楼层升序排列
|
||||
- 验证相同楼层的房间是否按房间名称排序
|
||||
|
||||
# 宿舍管理功能变更记录
|
||||
|
||||
## 宿舍树性别标识功能添加
|
||||
|
||||
**时间**:2025-07-22 15:30:00
|
||||
|
||||
**变更内容**:
|
||||
1. 在宿舍树显示中,为宿舍楼名称前添加性别标识
|
||||
- 男生楼:添加"(男)"前缀,显示蓝色
|
||||
- 女生楼:添加"(女)"前缀,显示粉色
|
||||
2. 修改前端数据模型
|
||||
- 在`DormTreeNode`接口中添加`gender`字段,用于标识宿舍楼性别(1-男生楼,2-女生楼)
|
||||
3. 修改模拟数据
|
||||
- 为模拟数据中的宿舍楼添加性别标识
|
||||
4. 适配逻辑处理
|
||||
- 对于后端返回的没有性别标识的数据,前端会进行随机分配(临时措施)
|
||||
|
||||
**相关文件**:
|
||||
- `/web/src/views/xgss/xsssfjgl/index.vue`:修改宿舍树节点显示,添加性别标识和样式
|
||||
- `/web/src/api/xgss/xsssfjgl/types.ts`:在`DormTreeNode`接口中添加性别字段
|
||||
- `/web/src/api/xgss/xsssfjgl/index.ts`:修改模拟数据,添加性别标识
|
||||
|
||||
**后续优化建议**:
|
||||
1. 后端需要确保返回的宿舍楼数据中包含性别信息
|
||||
2. 宿舍楼管理功能中应添加性别设置选项
|
||||
3. 考虑在宿舍树过滤功能中添加按性别筛选功能
|
||||
|
||||
**相关SQL变更**:无(本次只涉及前端显示变更)
|
||||
+150
-4
@@ -6,6 +6,8 @@
|
||||
- [1.1 获取宿舍楼树形结构](#11-获取宿舍楼树形结构)
|
||||
- [2. 宿舍楼信息管理](#2-宿舍楼信息管理)
|
||||
- [2.1 获取宿舍楼列表](#21-获取宿舍楼列表)
|
||||
- [3. 宿舍房间管理](#3-宿舍房间管理)
|
||||
- [3.1 获取宿舍房间列表](#31-获取宿舍房间列表)
|
||||
|
||||
## 1. 宿舍楼树形结构
|
||||
|
||||
@@ -60,14 +62,16 @@ xgss:dormBuildingTree:list
|
||||
"label": "1号楼",
|
||||
"type": "building",
|
||||
"disabled": false,
|
||||
"buildingFloors": 6
|
||||
"buildingFloors": 6,
|
||||
"gender": "male"
|
||||
},
|
||||
{
|
||||
"id": 1002,
|
||||
"label": "2号楼",
|
||||
"type": "building",
|
||||
"disabled": false,
|
||||
"buildingFloors": 5
|
||||
"buildingFloors": 5,
|
||||
"gender": "female"
|
||||
}
|
||||
]
|
||||
},
|
||||
@@ -97,10 +101,11 @@ xgss:dormBuildingTree:list
|
||||
| 参数名 | 类型 | 描述 |
|
||||
| -------------- | ------- | ------------------------------------------------ |
|
||||
| id | Long | 节点ID |
|
||||
| label | String | 节点名称 |
|
||||
| type | String | 节点类型(campus:校区,area:宿舍区,building:宿舍楼) |
|
||||
| label | String | 节点显示名称 |
|
||||
| type | String | 节点类型(campus:校区、area:宿舍区、building:宿舍楼) |
|
||||
| disabled | Boolean | 是否禁用点击(校区和宿舍区为true,宿舍楼为false) |
|
||||
| buildingFloors | Integer | 宿舍楼层数(只有宿舍楼节点有此字段) |
|
||||
| gender | String | 宿舍楼性别(只有宿舍楼节点有此字段) |
|
||||
| children | Array | 子节点列表 |
|
||||
|
||||
#### 数据权限说明
|
||||
@@ -260,4 +265,145 @@ async function getDormBuildingList(params) {
|
||||
}
|
||||
return { total: 0, rows: [] };
|
||||
}
|
||||
```
|
||||
|
||||
## 3. 宿舍房间管理
|
||||
|
||||
### 3.1 获取宿舍房间列表
|
||||
|
||||
#### 接口说明
|
||||
|
||||
该接口用于获取宿舍房间信息的列表,包含房间基本信息。列表按照楼层升序、房间名称升序排列。
|
||||
|
||||
#### 请求方式
|
||||
|
||||
```
|
||||
GET /xgss/dormRoom/list
|
||||
```
|
||||
|
||||
#### 权限要求
|
||||
|
||||
```
|
||||
xgss:dormRoom:list
|
||||
```
|
||||
|
||||
#### 请求参数
|
||||
|
||||
| 参数名 | 类型 | 必须 | 描述 |
|
||||
| ---------- | ------- | ---- | ---------------------- |
|
||||
| pageNum | Integer | 是 | 当前页码,从1开始 |
|
||||
| pageSize | Integer | 是 | 每页记录数 |
|
||||
| buildingId | Long | 否 | 宿舍楼ID,精确查询 |
|
||||
| roomName | String | 否 | 房间名称,模糊查询 |
|
||||
| floorNum | Integer | 否 | 楼层号,精确查询 |
|
||||
| roomType | String | 否 | 房间类型(1标准间 2单人间 3套间) |
|
||||
| roomStatus | String | 否 | 房间状态(0正常 1维修中 2停用) |
|
||||
|
||||
#### 返回结果
|
||||
|
||||
```json
|
||||
{
|
||||
"total": 2,
|
||||
"rows": [
|
||||
{
|
||||
"id": "1947459199879495682",
|
||||
"roomCode": "room-101",
|
||||
"roomName": "101",
|
||||
"buildingId": "1947459199879495681",
|
||||
"floorNum": 1,
|
||||
"roomType": "1",
|
||||
"standardBeds": 4,
|
||||
"actualBeds": 4,
|
||||
"roomArea": 20.5,
|
||||
"roomStatus": "0",
|
||||
"remark": "标准四人间",
|
||||
"createBy": 1,
|
||||
"createTime": "2025-07-22 09:15:30",
|
||||
"updateBy": 1,
|
||||
"updateTime": "2025-07-22 09:15:30"
|
||||
},
|
||||
{
|
||||
"id": "1947459199879495683",
|
||||
"roomCode": "room-201",
|
||||
"roomName": "201",
|
||||
"buildingId": "1947459199879495681",
|
||||
"floorNum": 2,
|
||||
"roomType": "1",
|
||||
"standardBeds": 4,
|
||||
"actualBeds": 4,
|
||||
"roomArea": 20.5,
|
||||
"roomStatus": "0",
|
||||
"remark": "标准四人间",
|
||||
"createBy": 1,
|
||||
"createTime": "2025-07-22 09:15:30",
|
||||
"updateBy": 1,
|
||||
"updateTime": "2025-07-22 09:15:30"
|
||||
}
|
||||
],
|
||||
"code": 200,
|
||||
"msg": "查询成功"
|
||||
}
|
||||
```
|
||||
|
||||
#### 返回参数说明
|
||||
|
||||
| 参数名 | 类型 | 描述 |
|
||||
| ------------ | ------- | --------------------------------------- |
|
||||
| id | Long | 房间主键ID |
|
||||
| roomCode | String | 房间编码 |
|
||||
| roomName | String | 房间名称 |
|
||||
| buildingId | Long | 所属宿舍楼ID |
|
||||
| floorNum | Integer | 楼层号 |
|
||||
| roomType | String | 房间类型(1标准间 2单人间 3套间) |
|
||||
| standardBeds | Integer | 标准床位数 |
|
||||
| actualBeds | Integer | 实际床位数 |
|
||||
| roomArea | Double | 房间面积(平方米) |
|
||||
| roomStatus | String | 房间状态(0正常 1维修中 2停用) |
|
||||
| remark | String | 备注 |
|
||||
| createBy | Long | 创建者ID |
|
||||
| createTime | Date | 创建时间 |
|
||||
| updateBy | Long | 更新者ID |
|
||||
| updateTime | Date | 更新时间 |
|
||||
|
||||
#### 排序规则
|
||||
|
||||
房间列表按照以下顺序排序:
|
||||
1. 优先按楼层号(floorNum)升序排列
|
||||
2. 其次按房间名称(roomName)升序排列
|
||||
|
||||
这确保了在宿舍管理系统中房间按照从低楼层到高楼层的顺序展示,相同楼层的房间按照名称顺序排列,提供更直观的浏览体验。
|
||||
|
||||
#### 错误码
|
||||
|
||||
| 错误码 | 描述 |
|
||||
| ------ | -------------------- |
|
||||
| 401 | 未授权,需要登录 |
|
||||
| 403 | 无权限访问该接口 |
|
||||
| 500 | 服务器内部错误 |
|
||||
|
||||
#### 使用示例
|
||||
|
||||
```javascript
|
||||
// 前端代码示例(使用axios)
|
||||
import axios from 'axios';
|
||||
|
||||
// 获取宿舍房间列表
|
||||
async function getDormRoomList(params) {
|
||||
try {
|
||||
const response = await axios.get('/xgss/dormRoom/list', {
|
||||
params: {
|
||||
pageNum: 1,
|
||||
pageSize: 100,
|
||||
buildingId: buildingId,
|
||||
...params
|
||||
}
|
||||
});
|
||||
if (response.data.code === 200) {
|
||||
return response.data;
|
||||
}
|
||||
} catch (error) {
|
||||
console.error('获取宿舍房间列表失败:', error);
|
||||
}
|
||||
return { total: 0, rows: [] };
|
||||
}
|
||||
```
|
||||
@@ -109,6 +109,7 @@ create table `xg_dorm_bed` (
|
||||
`bed_status` char(1) default '0' comment '床位状态(0空闲 1已分配 2维修中)',
|
||||
`deleted` char(1) default '0' comment '删除标志(0代表存在 1代表删除)',
|
||||
`tenant_id` bigint(20) default '0' comment '租户编号',
|
||||
`create_dept` bigint(20) DEFAULT NULL COMMENT '创建部门',
|
||||
`create_by` bigint(20) default null comment '创建者',
|
||||
`create_time` datetime default null comment '创建时间',
|
||||
`update_by` bigint(20) default null comment '更新者',
|
||||
|
||||
Reference in new issue
Block a user