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/infra/db/postgresql/scada.py

@@ -11,6 +11,10 @@ def _optional_float(value: Any) -> float | None:
     return float(value) if value is not None else None
 
 
+def _optional_int(value: Any) -> int | None:
+    return int(value) if value is not None else None
+
+
 class ScadaInfoRepository:
     """Read SCADA metadata from the current project's business database."""
 
@@ -19,33 +23,34 @@ class ScadaInfoRepository:
         async with conn.cursor() as cur:
             await cur.execute(
                 """
-                SELECT id,
-                       type,
-                       associated_element_id,
+                SELECT id AS device_id,
+                       device_type,
+                       node_id,
+                       link_id,
                        api_query_id,
                        transmission_mode,
                        transmission_frequency,
                        reliability,
-                       x_coor,
-                       y_coor
-                FROM public.scada_info
+                       x,
+                       y
+                FROM gis.scada_devices
+                ORDER BY id
                 """
             )
             records = await cur.fetchall()
 
         return [
             {
-                "id": str(record["id"]).strip(),
-                "type": str(record["type"]).strip().lower(),
-                "associated_element_id": _optional_text(
-                    record["associated_element_id"]
-                ),
-                "api_query_id": record["api_query_id"],
+                "device_id": str(record["device_id"]).strip(),
+                "device_type": str(record["device_type"]).strip().lower(),
+                "node_id": _optional_text(record["node_id"]),
+                "link_id": _optional_text(record["link_id"]),
+                "api_query_id": _optional_text(record["api_query_id"]),
                 "transmission_mode": record["transmission_mode"],
                 "transmission_frequency": record["transmission_frequency"],
-                "reliability": _optional_float(record["reliability"]),
-                "x": _optional_float(record["x_coor"]),
-                "y": _optional_float(record["y_coor"]),
+                "reliability": _optional_int(record["reliability"]),
+                "x": _optional_float(record["x"]),
+                "y": _optional_float(record["y"]),
             }
             for record in records
         ]