From babb4c80ef91c15fe2fe7f2607dc519e8c205d11 Mon Sep 17 00:00:00 2001
From: linwumingshi <linwumingshi@gmail.com>
Date: Thu, 6 Nov 2025 19:38:13 +0800
Subject: [PATCH] feat(admin): :sparkles:  add nickname search field in user
 management

- Added nickname input field in user search form
- Adjusted input field widths for better UI layout
- Added nickname property in UserSearch parameter class
- Updated server-side logic to support nickname search
- Included nickname field in user search API request
- Added documentation for user page API endpoint
---
 front/src/views/admin/user/index.vue                   | 10 +++++++---
 .../cn/torna/web/controller/admin/UserController.java  |  6 ++++++
 .../torna/web/controller/admin/param/UserSearch.java   |  6 ++++++
 3 files changed, 19 insertions(+), 3 deletions(-)

diff --git a/front/src/views/admin/user/index.vue b/front/src/views/admin/user/index.vue
index b38c3777..00e50b6e 100644
--- a/front/src/views/admin/user/index.vue
+++ b/front/src/views/admin/user/index.vue
@@ -2,20 +2,23 @@
   <div class="app-container">
     <el-form :inline="true" :model="searchFormData" class="demo-form-inline" size="mini">
       <el-form-item label="UserId">
-        <el-input v-model="searchFormData.id" :clearable="true" style="width: 250px;"/>
+        <el-input v-model="searchFormData.id" :clearable="true" style="width: 120px;"/>
       </el-form-item>
       <el-form-item :label="$t('loginAccount')">
         <el-input v-model="searchFormData.username" :clearable="true" style="width: 250px;"/>
       </el-form-item>
+      <el-form-item :label="$t('nickname')">
+        <el-input v-model="searchFormData.nickname" :clearable="true" style="width: 250px;"/>
+      </el-form-item>
       <el-form-item :label="$t('status')">
-        <el-select v-model="searchFormData.status" :clearable="true">
+        <el-select v-model="searchFormData.status" :clearable="true" style="width: 120px;">
           <el-option v-for="item in statusOptions" :key="item.value" :label="item.label" :value="item.value">
             {{ item.label }}
           </el-option>
         </el-select>
       </el-form-item>
       <el-form-item :label="$t('isSuperAdmin')">
-        <el-select v-model="searchFormData.isSuperAdmin" :clearable="true">
+        <el-select v-model="searchFormData.isSuperAdmin" :clearable="true" style="width: 120px;">
           <el-option v-for="item in isSuperAdminOptions" :key="item.value" :label="item.label" :value="item.value">
             {{ item.label }}
           </el-option>
@@ -240,6 +243,7 @@ export default {
       searchFormData: {
         id: '',
         username: '',
+        nickname: '',
         status: '',
         isSuperAdmin: '',
         pageIndex: 1,
diff --git a/server/server-web/src/main/java/cn/torna/web/controller/admin/UserController.java b/server/server-web/src/main/java/cn/torna/web/controller/admin/UserController.java
index cb3ee898..9a21ad38 100644
--- a/server/server-web/src/main/java/cn/torna/web/controller/admin/UserController.java
+++ b/server/server-web/src/main/java/cn/torna/web/controller/admin/UserController.java
@@ -59,6 +59,12 @@ public class UserController {
     @Value("${torna.user.initial-password}")
     private String initPassword;
 
+    /**
+     * 分页查询用户
+     *
+     * @param userSearch 查询参数
+     * @return 用户列表
+     */
     @PostMapping("page")
     public Result<PageInfo<UserInfoDTO>> page(@RequestBody UserSearch userSearch) {
         LambdaQuery<UserInfo> query = userSearch.toLambdaQuery(UserInfo.class);
diff --git a/server/server-web/src/main/java/cn/torna/web/controller/admin/param/UserSearch.java b/server/server-web/src/main/java/cn/torna/web/controller/admin/param/UserSearch.java
index 9b7ad947..3c6dd909 100644
--- a/server/server-web/src/main/java/cn/torna/web/controller/admin/param/UserSearch.java
+++ b/server/server-web/src/main/java/cn/torna/web/controller/admin/param/UserSearch.java
@@ -13,9 +13,11 @@ import lombok.Setter;
 @Setter
 public class UserSearch extends PageParam {
 
+    /**  数据库字段：id */
     @Condition(ignore = true)
     private String id;
 
+    /** 登录账号/邮箱, 数据库字段：username */
     @Condition(ignoreEmptyString = true, operator = Operator.like)
     private String username;
 
@@ -26,4 +28,8 @@ public class UserSearch extends PageParam {
     /** 是否是超级管理员, 数据库字段：is_super_admin */
     @Condition(operator = Operator.eq)
     private Byte isSuperAdmin;
+
+    /** 昵称, 数据库字段：nickname */
+    @Condition(ignoreEmptyString = true, operator = Operator.like)
+    private String nickname;
 }
-- 
Gitee