add

se-project-uuid-query.md

@@ -0,0 +1,120 @@
+---
+name: se-project-uuid-query
+description: 仅在根据项目名称/项目别名/五码查询项目基础信息时使用。
+---
+
+# se-project-uuid-query
+
+不要着急行动，请先思考**用户是否提供了项目信息？如果没有提供的话，请向用户询问项目名称/五码/项目别名**。
+
+## 工作流程
+
+```mermaid
+flowchart TD
+    S([开始]) --> S1[第1步：调用 debuggingProjectQuery<br/>根据 projectName 查询项目基础信息]
+
+    S1 --> C1{查询结果}
+    C1 -->|查不到| S2[第2步：调用 debuggingProjectQuery<br/>根据 modelCode 查询项目基础信息]
+    C1 -->|total > 1| S5[第5步：展示 rows 中的<br/>projectName 和 modelCode<br/>让用户选择其中 1 个]
+    C1 -->|total = 1| S6[第6步：使用响应的 projectName<br/>调用 queryProjectNameList<br/>获取 projectUuid]
+
+    S2 --> C2{查询结果}
+    C2 -->|查不到| S3[第3步：调用 debuggingProjectQuery<br/>根据 projectAlias 查询项目基础信息]
+    C2 -->|total > 1| S5
+    C2 -->|total = 1| S6
+
+    S3 --> C3{查询结果}
+    C3 -->|查不到| S4[第4步：告诉用户查不到项目信息<br/>让用户提供正确的项目信息]
+    C3 -->|total > 1| S5
+    C3 -->|total = 1| S6
+
+    S4 --> S1
+
+    S5 --> U[用户选择其中 1 个]
+    U --> S6
+    S6 --> E([结束])
+```
+
+
+## debuggingProjectQuery
+
+根据项目名称、项目别名、五码模糊检索项目基础信息。
+
+### 请求参数
+
+|参数名称|是否必传|参数描述|
+|---|---|---|
+|projectName|否|项目名称|
+|modelCode|否|五码|
+|projectAlias|否|项目别名|
+
+### 响应参数
+
+|参数名称|参数描述|
+|---|---|
+|projectName|项目名称|
+|modelCode|五码|
+|projectAlias|项目别名|
+
+#### 成功示例
+
+```json
+{
+  "total": 1,
+  "rows": [
+    {
+      "projectName": "IdeaPad 5 Pro 16ARP8",
+      "projectAlias": "LCP8",
+      "modelCode": "LT4EN"
+    }
+  ],
+  "code": 200,
+  "msg": "查询成功"
+}
+```
+
+#### 失败示例
+
+```json
+{
+  "code": 500,
+  "msg": "系统异常"
+}
+```
+
+## queryProjectNameList
+
+根据`projectName`查询`projectUuid`。
+
+### 请求参数
+
+|参数名称|是否必传|参数描述|示例|
+|---|---|---|---|
+|projectName|否|项目名称|`IdeaPad 5 Pro 16ARP8`|
+
+### 响应参数
+
+|参数名称|参数描述|示例|
+|---|---|---|
+|name|项目名称|`IdeaPad 5 Pro 16ARP8`|
+|projectUuid|项目的唯一标识|`1234567890`|
+
+#### 成功示例
+
+```
+[
+  {
+    "name": "IdeaPad 5 Pro 16ARP8",
+    "projectUuid": "1234567890"
+  }
+]
+```
+
+#### 失败示例
+
+```json
+{
+  "code": 500,
+  "msg": "系统异常"
+}
+```