Quellcode durchsuchen

更新引航计划需求文档,添加船公司搜索下拉框的详细说明

- 更新船公司查询条件说明为可搜索的下拉选择
- 添加船公司列表接口的详细参数说明
- 添加分页查询和远程搜索的功能说明
- 说明前端实现的瀑布式加载和远程搜索功能
heyiwen vor 6 Stunden
Ursprung
Commit
eeacdcf14d
1 geänderte Dateien mit 33 neuen und 11 gelöschten Zeilen
  1. 33 11
      引航计划和用户管理功能需求文档.md

+ 33 - 11
引航计划和用户管理功能需求文档.md

@@ -27,7 +27,7 @@
 | 港口 | 港口名称 | 下拉选择 | 否 |
 | 英文船名 | 船舶英文名称 | 文本输入 | 否 |
 | 状态 | 未调度/已调度 | 下拉选择 | 否 |
-| 船公司 | 船舶所属公司 | 下拉选择 | 否 |
+| 船公司 | 船舶所属公司 | 可搜索的下拉选择(支持远程搜索和分页加载) | 否 |
 | 吃水 | 船舶吃水范围(最小值-最大值) | 数值范围 | 否 |
 | 交通船 | 交通船名称 | 文本输入 | 否 |
 
@@ -412,21 +412,43 @@
 
 **接口地址**:`GET /api/ship-company/list`
 
+**请求参数**:
+
+| 参数名 | 类型 | 必填 | 说明 |
+|--------|------|------|------|
+| companyName | String | 否 | 船公司名称(支持模糊搜索) |
+| page | Integer | 是 | 页码(从1开始) |
+| pageSize | Integer | 是 | 每页数量(建议10-20) |
+
 **响应示例**:
 
 ```json
-[
-  {
-    "companyId": "company-id-1",
-    "companyName": "船公司A"
-  },
-  {
-    "companyId": "company-id-2",
-    "companyName": "船公司B"
-  }
-]
+{
+  "content": [
+    {
+      "companyId": "company-id-1",
+      "companyName": "船公司A"
+    },
+    {
+      "companyId": "company-id-2",
+      "companyName": "船公司B"
+    }
+  ],
+  "totalElements": 100,
+  "totalPages": 10,
+  "number": 0,
+  "size": 10
+}
 ```
 
+**功能说明**:
+
+- 支持按船公司名称进行模糊搜索
+- 支持分页查询,避免一次性加载过多数据
+- 前端实现可搜索的下拉框,支持远程搜索和瀑布式加载
+- 当用户输入搜索关键词时,触发远程搜索
+- 当下拉列表滚动到底部时,自动加载下一页数据
+
 ## 权限控制
 
 ### 功能权限代码