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/project.py

@@ -10,8 +10,6 @@ from app.auth.permissions import (
 )
 from app.domain.schemas.metadata import ProjectMetaResponse
 import app.services.project_info as project_info
-from app.infra.db.postgresql.database import get_database_instance as get_pg_db
-from app.infra.db.timescaledb.database import get_database_instance as get_ts_db
 from app.services.tjnetwork import (
     ChangeSet,
     list_project,
@@ -26,11 +24,7 @@ from app.services.tjnetwork import (
     read_inp,
     dump_inp,
     get_all_vertices,
-    get_all_scada_elements,
-    get_all_district_metering_areas,
-    get_all_service_areas,
-    get_all_virtual_districts,
-    get_extension_data,
+    get_all_scada_info,
     convert_inp_v3_to_v2,
 )
 
@@ -137,27 +131,6 @@ async def open_project_endpoint(
     """
     open_project(network)
     
-    # 尝试连接指定数据库
-    try:
-        # 初始化 PostgreSQL 连接池
-        pg_instance = await get_pg_db(network)
-        async with pg_instance.get_connection() as conn:
-            async with conn.cursor() as cur:
-                await cur.execute("SELECT 1")
-        
-        # 初始化 TimescaleDB 连接池
-        ts_instance = await get_ts_db(network)
-        async with ts_instance.get_connection() as conn:
-            async with conn.cursor() as cur:
-                await cur.execute("SELECT 1")
-                
-    except Exception as e:
-        # 记录错误但不阻断项目打开，或者根据需求决定是否阻断
-        # 这里选择打印错误，因为 open_project 原本只负责原生部分
-        print(f"Failed to connect to databases for {network}: {str(e)}")
-        # 如果数据库连接是必须的，可以抛出异常:
-        # raise HTTPException(status_code=500, detail=f"Database connection failed: {str(e)}")
-
     return network
 
 @router.delete("/projects/current", summary="关闭项目", description="将指定项目从内存中卸载，释放资源。")
@@ -202,24 +175,11 @@ async def export_inp_endpoint(
     op = cs.operations[0]
     open_project(network)
     op["vertex"] = json.dumps(get_all_vertices(network))
-    op["scada"] = json.dumps(get_all_scada_elements(network))
-    op["dma"] = json.dumps(get_all_district_metering_areas(network))
-    op["sa"] = json.dumps(get_all_service_areas(network))
-    op["vd"] = json.dumps(get_all_virtual_districts(network))
-    op["legend"] = get_extension_data(network, "legend")
-
-    db = get_extension_data(network, "scada_db")
-    print(db)
-    scada_db = ""
-    if db:
-        scada_db = db
-    print(scada_db)
-    op["scada_db"] = scada_db
+    op["scada"] = json.dumps(get_all_scada_info(network))
 
     close_project(network)
 
     return cs
-
 @router.post("/projects/current/imports", summary="读取 INP 文件到项目", description="从服务器文件系统中读取指定的 INP 文件并加载到项目中。")
 async def read_inp_endpoint(
     network: str = Query(..., description="管网名称（或数据库名称）"),
@@ -353,19 +313,7 @@ async def fastapi_convert_v3_to_v2(
     op = cs.operations[0]
     open_project(network)
     op["vertex"] = json.dumps(get_all_vertices(network))
-    op["scada"] = json.dumps(get_all_scada_elements(network))
-    op["dma"] = json.dumps(get_all_district_metering_areas(network))
-    op["sa"] = json.dumps(get_all_service_areas(network))
-    op["vd"] = json.dumps(get_all_virtual_districts(network))
-    op["legend"] = get_extension_data(network, "legend")
-
-    db = get_extension_data(network, "scada_db")
-    print(db)
-    scada_db = ""
-    if db:
-        scada_db = db
-    print(scada_db)
-    op["scada_db"] = scada_db
+    op["scada"] = json.dumps(get_all_scada_info(network))
 
     close_project(network)
 
@@ -496,19 +444,7 @@ async def fastapi_convert_v3_to_v2(
     op = cs.operations[0]
     open_project(network)
     op["vertex"] = json.dumps(get_all_vertices(network))
-    op["scada"] = json.dumps(get_all_scada_elements(network))
-    op["dma"] = json.dumps(get_all_district_metering_areas(network))
-    op["sa"] = json.dumps(get_all_service_areas(network))
-    op["vd"] = json.dumps(get_all_virtual_districts(network))
-    op["legend"] = get_extension_data(network, "legend")
-
-    db = get_extension_data(network, "scada_db")
-    print(db)
-    scada_db = ""
-    if db:
-        scada_db = db
-    print(scada_db)
-    op["scada_db"] = scada_db
+    op["scada"] = json.dumps(get_all_scada_info(network))
 
     close_project(network)