refactor(api): unify scheme query endpoints

cli/tjwater_cli/commands_analysis.py

@@ -306,8 +306,11 @@ def analysis_leakage_schemes_list(ctx: typer.Context) -> None:
         ctx,
         summary="读取漏损方案列表成功",
         method="GET",
-        path="/leakage/schemes/",
-        params={"network": require_network(runtime)},
+        path="/schemes",
+        params={
+            "network": require_network(runtime),
+            "scheme_type": "dma_leak_identification",
+        },
         require_auth=True,
         require_network_ctx=True,
     )
@@ -323,8 +326,11 @@ def analysis_leakage_schemes_get(
         ctx,
         summary="读取漏损方案详情成功",
         method="GET",
-        path=f"/leakage/schemes/{scheme_name}",
-        params={"network": require_network(runtime)},
+        path=f"/schemes/{scheme_name}",
+        params={
+            "network": require_network(runtime),
+            "scheme_type": "dma_leak_identification",
+        },
         require_auth=True,
         require_network_ctx=True,
     )
@@ -362,8 +368,11 @@ def analysis_burst_detection_schemes_list(ctx: typer.Context) -> None:
         ctx,
         summary="读取爆管检测方案列表成功",
         method="GET",
-        path="/burst-detection/schemes/",
-        params={"network": require_network(runtime)},
+        path="/schemes",
+        params={
+            "network": require_network(runtime),
+            "scheme_type": "burst_detection",
+        },
         require_auth=True,
         require_network_ctx=True,
     )
@@ -379,8 +388,11 @@ def analysis_burst_detection_schemes_get(
         ctx,
         summary="读取爆管检测方案详情成功",
         method="GET",
-        path=f"/burst-detection/schemes/{scheme_name}",
-        params={"network": require_network(runtime)},
+        path=f"/schemes/{scheme_name}",
+        params={
+            "network": require_network(runtime),
+            "scheme_type": "burst_detection",
+        },
         require_auth=True,
         require_network_ctx=True,
     )
@@ -438,8 +450,11 @@ def analysis_burst_location_schemes_list(ctx: typer.Context) -> None:
         ctx,
         summary="读取爆管定位方案列表成功",
         method="GET",
-        path="/burst-location/schemes/",
-        params={"network": require_network(runtime)},
+        path="/schemes",
+        params={
+            "network": require_network(runtime),
+            "scheme_type": "burst_location",
+        },
         require_auth=True,
         require_network_ctx=True,
     )
@@ -455,8 +470,11 @@ def analysis_burst_location_schemes_get(
         ctx,
         summary="读取爆管定位方案详情成功",
         method="GET",
-        path=f"/burst-location/schemes/{scheme_name}",
-        params={"network": require_network(runtime)},
+        path=f"/schemes/{scheme_name}",
+        params={
+            "network": require_network(runtime),
+            "scheme_type": "burst_location",
+        },
         require_auth=True,
         require_network_ctx=True,
     )

cli/tjwater_cli/registry.py

@@ -247,13 +247,13 @@ COMMAND_DOCS: dict[tuple[str, ...], CommandDoc] = {
     ("analysis", "leakage", "schemes", "list"): CommandDoc(
         path=("analysis", "leakage", "schemes", "list"),
         summary="列出漏损方案",
-        description="调用 /leakage/schemes/。",
+        description="调用 /schemes，并传入 scheme_type=dma_leak_identification。",
         examples=("tjwater-cli analysis leakage schemes list",),
     ),
     ("analysis", "leakage", "schemes", "get"): CommandDoc(
         path=("analysis", "leakage", "schemes", "get"),
         summary="读取漏损方案详情",
-        description="调用 /leakage/schemes/{scheme_name}。",
+        description="调用 /schemes/{scheme_name}，并传入 scheme_type=dma_leak_identification。",
         examples=("tjwater-cli analysis leakage schemes get my_scheme",),
     ),
     ("analysis", "burst-detection", "detect"): CommandDoc(
@@ -270,13 +270,13 @@ COMMAND_DOCS: dict[tuple[str, ...], CommandDoc] = {
     ("analysis", "burst-detection", "schemes", "list"): CommandDoc(
         path=("analysis", "burst-detection", "schemes", "list"),
         summary="列出爆管检测方案",
-        description="调用 /burst-detection/schemes/。",
+        description="调用 /schemes，并传入 scheme_type=burst_detection。",
         examples=("tjwater-cli analysis burst-detection schemes list",),
     ),
     ("analysis", "burst-detection", "schemes", "get"): CommandDoc(
         path=("analysis", "burst-detection", "schemes", "get"),
         summary="读取爆管检测方案详情",
-        description="调用 /burst-detection/schemes/{scheme_name}。",
+        description="调用 /schemes/{scheme_name}，并传入 scheme_type=burst_detection。",
         examples=("tjwater-cli analysis burst-detection schemes get my_scheme",),
     ),
     ("analysis", "burst-location", "locate"): CommandDoc(
@@ -303,13 +303,13 @@ COMMAND_DOCS: dict[tuple[str, ...], CommandDoc] = {
     ("analysis", "burst-location", "schemes", "list"): CommandDoc(
         path=("analysis", "burst-location", "schemes", "list"),
         summary="列出爆管定位方案",
-        description="调用 /burst-location/schemes/。",
+        description="调用 /schemes，并传入 scheme_type=burst_location。",
         examples=("tjwater-cli analysis burst-location schemes list",),
     ),
     ("analysis", "burst-location", "schemes", "get"): CommandDoc(
         path=("analysis", "burst-location", "schemes", "get"),
         summary="读取爆管定位方案详情",
-        description="调用 /burst-location/schemes/{scheme_name}。",
+        description="调用 /schemes/{scheme_name}，并传入 scheme_type=burst_location。",
         examples=("tjwater-cli analysis burst-location schemes get my_scheme",),
     ),
     ("analysis", "risk", "pipe-now"): CommandDoc(

cli/tjwater_cli_endpoint_scope.md

@@ -202,11 +202,11 @@ app/api/v1/endpoints/risk.py
 | `tjwater-cli analysis contaminant --start-time TIME --duration SEC --source-node NODE --concentration VALUE --scheme SCHEME [--pattern PATTERN]` | `GET /contaminant-simulation` | 污染物模拟 |
 | `tjwater-cli analysis sensor-placement kmeans --count N` | `GET /pressuresensorplacementkmeans/` | 基于 kmeans 的传感器放置分析；不包含创建方案 |
 | `tjwater-cli analysis leakage identify --scheme SCHEME --start-time TIME --end-time TIME` | `POST /leakage/identify/` | 漏损识别 |
-| `tjwater-cli analysis leakage schemes list\|get` | `GET /leakage/schemes/`、`GET /leakage/schemes/{scheme_name}` | 漏损方案查询 |
+| `tjwater-cli analysis leakage schemes list\|get` | `GET /schemes?scheme_type=dma_leak_identification`、`GET /schemes/{scheme_name}?scheme_type=dma_leak_identification` | 漏损方案查询 |
 | `tjwater-cli analysis burst-detection detect --scheme SCHEME --start-time TIME --end-time TIME` | `POST /burst-detection/detect/` | 爆管检测 |
-| `tjwater-cli analysis burst-detection schemes list\|get` | `GET /burst-detection/schemes/`、`GET /burst-detection/schemes/{scheme_name}` | 爆管检测方案查询 |
+| `tjwater-cli analysis burst-detection schemes list\|get` | `GET /schemes?scheme_type=burst_detection`、`GET /schemes/{scheme_name}?scheme_type=burst_detection` | 爆管检测方案查询 |
 | `tjwater-cli analysis burst-location locate --scheme SCHEME --start-time TIME --end-time TIME` | `POST /burst-location/locate/` | 爆管定位 |
-| `tjwater-cli analysis burst-location schemes list\|get` | `GET /burst-location/schemes/`、`GET /burst-location/schemes/{scheme_name}` | 爆管定位方案查询 |
+| `tjwater-cli analysis burst-location schemes list\|get` | `GET /schemes?scheme_type=burst_location`、`GET /schemes/{scheme_name}?scheme_type=burst_location` | 爆管定位方案查询 |
 | `tjwater-cli analysis risk pipe-now --pipe PIPE` | `GET /getpiperiskprobabilitynow/` | 单条管道当前风险 |
 | `tjwater-cli analysis risk pipe-history --pipe PIPE` | `GET /getpiperiskprobability/` | 单条管道历史风险 |
 | `tjwater-cli analysis risk network` | `GET /getnetworkpiperiskprobabilitynow/`、`GET /getpiperiskprobabilitygeometries/` | 当前 project 全网风险 |