refactor(db)!: adopt project-routed pooled databases

Reorganize WNDB by responsibility and remove legacy scheme endpoints.\n\nRoute analysis and time-series access through project pools, preserve transactional realtime replacement, and refresh GIS materialized views after writes.\n\nAdd database architecture documentation, live pooling coverage, API contract updates, and executable container verification.\n\nBREAKING CHANGE: legacy scheme APIs and flat app.native.wndb module imports are removed.

app/api/v1/endpoints/timeseries/composite.py

@@ -1,6 +1,7 @@
 from fastapi import APIRouter, Depends, HTTPException, Query
 from datetime import datetime
 from psycopg import AsyncConnection
+from uuid import UUID
 
 from app.infra.db.timescaledb.composite_queries import CompositeQueries
 from .dependencies import get_timescale_connection, get_postgres_connection
@@ -13,8 +14,7 @@ async def get_scada_associated_simulation_data(
     start_time: datetime = Query(..., description="查询开始时间"),
     end_time: datetime = Query(..., description="查询结束时间"),
     device_ids: str = Query(..., description="SCADA设备ID列表，逗号分隔"),
-    scheme_type: str = Query(None, description="方案类型，若为空则查询实时数据"),
-    scheme_name: str = Query(None, description="方案名称，若为空则查询实时数据"),
+    run_id: UUID | None = Query(None, description="分析运行 ID；为空时查询实时数据"),
     timescale_conn: AsyncConnection = Depends(get_timescale_connection),
     postgres_conn: AsyncConnection = Depends(get_postgres_connection),
 ):
@@ -22,14 +22,13 @@ async def get_scada_associated_simulation_data(
     获取SCADA关联的link/node模拟值
     
     根据传入的SCADA device_ids，找到关联的link/node，
-    并根据对应的type，查询对应的模拟数据。支持查询实时或方案数据。
+    并根据对应的type，查询对应的模拟数据。支持查询实时或分析运行数据。
 
     Args:
         start_time: 查询开始时间
         end_time: 查询结束时间
         device_ids: SCADA设备ID列表，用逗号分隔
-        scheme_type: 方案类型，若为空则查询实时数据
-        scheme_name: 方案名称，若为空则查询实时数据
+        run_id: 分析运行 ID，若为空则查询实时数据
         timescale_conn: TimescaleDB连接
         postgres_conn: PostgreSQL连接
         
@@ -46,15 +45,14 @@ async def get_scada_associated_simulation_data(
             else []
         )
 
-        if scheme_type and scheme_name:
-            result = await CompositeQueries.get_scada_associated_scheme_simulation_data(
+        if run_id is not None:
+            result = await CompositeQueries.get_scada_associated_analysis_simulation_data(
                 timescale_conn,
                 postgres_conn,
                 device_ids_list,
                 start_time,
                 end_time,
-                scheme_type,
-                scheme_name,
+                run_id,
             )
         else:
             result = (
@@ -80,23 +78,21 @@ async def get_feature_simulation_data(
     feature_infos: str = Query(
         ..., description="特征信息，格式: id1:type1,id2:type2，type为pipe（管道）或junction（节点）"
     ),
-    scheme_type: str = Query(None, description="方案类型，若为空则查询实时数据"),
-    scheme_name: str = Query(None, description="方案名称，若为空则查询实时数据"),
+    run_id: UUID | None = Query(None, description="分析运行 ID；为空时查询实时数据"),
     timescale_conn: AsyncConnection = Depends(get_timescale_connection),
 ):
     """
     获取link/node模拟值
     
     根据传入的featureInfos，找到关联的link/node，
-    并根据对应的type，查询对应的模拟数据。支持查询实时或方案数据。
+    并根据对应的type，查询对应的模拟数据。支持查询实时或分析运行数据。
 
     Args:
         start_time: 查询开始时间
         end_time: 查询结束时间
         feature_infos: 格式为 "element_id1:type1,element_id2:type2"
                       例如: "P1:pipe,J1:junction"
-        scheme_type: 方案类型，若为空则查询实时数据
-        scheme_name: 方案名称，若为空则查询实时数据
+        run_id: 分析运行 ID，若为空则查询实时数据
         timescale_conn: TimescaleDB连接
         
     Returns:
@@ -119,14 +115,13 @@ async def get_feature_simulation_data(
         if not feature_infos_list:
             raise HTTPException(status_code=400, detail="feature_infos cannot be empty")
 
-        if scheme_type and scheme_name:
-            result = await CompositeQueries.get_scheme_simulation_data(
+        if run_id is not None:
+            result = await CompositeQueries.get_analysis_simulation_data(
                 timescale_conn,
                 feature_infos_list,
                 start_time,
                 end_time,
-                scheme_type,
-                scheme_name,
+                run_id,
             )
         else:
             result = await CompositeQueries.get_realtime_simulation_data(