提交

docs/开发文档/API/API.md.backup-20250701-163220

@@ -1447,6 +1447,8 @@ admin 用户具有系统最高权限 `*:*:*`，可以访问所有功能模块和
 
 **权限要求**: `pm:repairOrder:assign`
 
+**排序规则**: 返回的维修人员选项按用户名（`user_name`）升序排列，便于快速定位目标用户
+
 **请求参数**: 无
 
 **响应示例**:

docs/开发文档/API/API文档基础规范.md

@@ -198,6 +198,8 @@
 4. **单条数据接口必须使用 R 类型包装返回结果**
 5. **操作类接口必须使用 R 类型包装返回结果**
 6. **必须包含 clientid、Content-Type 等必要请求头**
+7. **查询类接口默认按创建时间倒序排列，若已有排序字段则在末尾追加 `create_time DESC` 保证新增数据优先展示**
+7. **所有列表查询接口默认按 `create_time` 倒序排列；如接口自定义其他排序字段，必须在末尾追加 `create_time desc` 作为稳定排序项**
 
 ---
 

docs/开发文档/API/API文档总览.md

@@ -121,9 +121,17 @@
   - `student_status = '1'` (在籍状态)
   - `class_id = 入参的classId` (班级ID)
   - `name LIKE '%入参的name%'` (姓名模糊查询，可选)
-- **排序方式**: 按创建时间倒序排列
+- **排序方式**: 按学号降序排列
+- **最新变更**（2025-11-13）: 所有学生信息列表接口默认按学号降序排序，便于优先查看学号靠后的学生
 - **权限要求**: `studentMsg:studentMsg:query`
 
+### 2025-11-13 - 学生列表排序策略统一
+- **心理健康测评**: `GET /xljk/evaluation/detail/students/{classId}` 现在按学号降序返回班级学生，满足最新业务要求
+- **学生考核奖励**: 学生候选下拉接口默认按学号降序排列，保持后台与移动端行为一致
+- **心理咨询预约**: 预约记录列表接口默认按学号降序，随后按ID降序排序，并以创建时间倒序兜底保证顺序稳定
+- **预约限制功能**: 未到访记录分页默认先按学号降序，再按未到访日期、创建时间倒序
+- **学生信息批次收集**: 批次学生列表默认按学号降序，当学号一致时以创建时间倒序作为补充
+
 ### 2025-07-24 - 学生信息管理界面重构
 - **界面重构**: 学生信息管理新增弹窗调整为多tab页形式
 - **功能增强**: 新增照片上传功能，支持完整的学生信息录入

docs/开发文档/API/出国申请管理API.md

@@ -90,6 +90,7 @@
   - `rs:overseas:approve3` - 第3级：纪委审批权限
   - `rs:overseas:approve4` - 第4级：学院分管领导审批权限
   - `rs:overseas:approve5` - 第5级：学院党委书记审批权限
+- **数据返回顺序**：审批人下拉接口（`/system/user/list-by-permission`）默认按用户名（`user_name`）升序排序，确保审批人选择器顺序一致（2025-11-13）
 
 - **权限使用说明**：
   - 审批接口采用 **OR模式**，用户拥有以上任一权限即可调用接口

docs/开发文档/API/后勤满意度调查API.md

@@ -63,6 +63,7 @@ Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
 | `/hq/satSurvey/{ids}` | DELETE | 删除问卷 | hq:satSurvey:remove |
 | `/hq/satSurvey/publish/{id}` | PUT | 发布问卷 | hq:satSurvey:publish |
 | `/hq/satQuestion/list` | GET | 查询题目列表 | hq:satQuestion:list |
+> 📌 **排序策略更新（2025-11-13）**：题目列表在按指定字段排序时，会额外追加 `createTime DESC` 作为最后一位兜底排序，确保返回结果顺序稳定。
 | `/hq/satQuestion/{id}` | GET | 获取题目详情 | hq:satQuestion:query |
 | `/hq/satQuestion` | POST | 新增题目 | hq:satQuestion:add |
 | `/hq/satQuestion` | PUT | 修改题目 | hq:satQuestion:edit |
@@ -452,6 +453,7 @@ await Promise.all(promises);
 | 1.0.3 | 2025-07-17 | 添加选项保存防重复提交机制，解决幂等性控制冲突 | wuzilong |
 | 1.0.4 | 2025-07-18 | 优化问答题文本回答展示功能，提高Vue渲染稳定性 | wuzilong |
 | 1.0.5 | 2025-07-18 | 增强问卷答题记录接口功能，返回答题详情数据 | wuzilong |
+| 1.0.6 | 2025-11-13 | 调整题目列表排序策略，追加创建时间倒序兜底，避免排序不稳定 | Cursor |
 
 ## 附录
 

docs/开发文档/API/学生信息批次收集API.md

@@ -187,6 +187,8 @@
 }
 ```
 
+> 📌 **排序说明**：分页列表默认按照学号 `studentNo` 降序排序；若学号相同，则继续按照 `createTime` 降序排列，确保最新学号优先展示。
+
 ### 2. 导出学生信息批次收集列表
 
 - **接口路径**: POST `/studentMsgBatch/studentMsgBatch/export`

docs/开发文档/API/心理健康测评API.md

@@ -489,6 +489,7 @@
 - **接口URL**：/xljk/evaluation/detail/students/{classId}
 - **请求方式**：GET
 - **接口权限**：xljk:evaluation:query
+- **排序方式**：按学号 `studentNo` 降序返回，确保默认展示最新学号
 - **请求参数**：
 
 | 参数名 | 类型 | 是否必须 | 描述 |

docs/开发文档/API/用户认证登录API.md

@@ -731,7 +731,7 @@ methods: {
 1. 该接口需要用户登录后才能访问
 2. 返回的用户信息已过滤敏感字段
 3. 建议前端对结果进行缓存，避免频繁请求
-4. 返回结果按照用户ID升序排序
+4. 返回结果按照用户名（`user_name`）升序排序
 
 ### 使用示例
 ```typescript
@@ -750,3 +750,66 @@ async function getAuditors() {
   }
 }
 ```
+
+## 根据部门获取用户列表
+
+### 基本信息
+- **接口URL**: `/system/user/list/dept/{deptId}`
+- **请求方式**: GET
+- **接口描述**: 根据部门ID获取该部门下所有启用状态的用户，用于部门人员选择器
+- **权限标识**: `system:user:list`
+
+### 路径参数
+| 参数名 | 类型 | 是否必须 | 说明 | 示例值 |
+|--------|------|----------|------|--------|
+| deptId | number | 是 | 部门ID | 1001 |
+
+### 响应参数
+```typescript
+{
+  code: number;
+  msg: string;
+  data: {
+    userId: number;
+    userName: string;
+    nickName: string;
+    phonenumber: string;
+  }[];
+}
+```
+
+### 注意事项
+1. 只返回未删除且状态为正常的用户
+2. 返回结果按照用户名（`user_name`）升序排序，便于快速定位
+
+## 批量获取用户基础信息
+
+### 基本信息
+- **接口URL**: `/system/user/optionselect`
+- **请求方式**: GET
+- **接口描述**: 根据用户ID集合（可选）和部门ID（可选）批量获取基础用户信息
+- **权限标识**: `system:user:query`
+
+### Query参数
+| 参数名 | 类型 | 是否必须 | 说明 | 示例值 |
+|--------|------|----------|------|--------|
+| userIds | string | 否 | 逗号分隔的用户ID集合 | 1,2,3 |
+| deptId | number | 否 | 指定部门ID时仅返回该部门用户 | 1001 |
+
+### 响应参数
+```typescript
+{
+  code: number;
+  msg: string;
+  data: {
+    userId: number;
+    userName: string;
+    nickName: string;
+    phonenumber: string;
+  }[];
+}
+```
+
+### 注意事项
+1. 用户ID集合为空时返回有权限范围内的全部用户
+2. 返回结果默认按照用户名（`user_name`）升序排序，保持前端下拉展示一致性

docs/开发文档/API/预约限制功能API.md

@@ -57,6 +57,8 @@
 }
 ```
 
+> 📌 **排序说明**：列表结果默认按照学号 `studentNo` 降序排列；当学号相同或为空时，继续按照未到访日期、创建时间倒序展示。
+
 ### 3.2 获取未到访记录详情
 
 #### 接口信息