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.
2026-08-25 18:35:05 +08:00
parent fdbcc5c033
commit fa188af0b1
181 changed files with 8446 additions and 33546 deletions
@@ -0,0 +1,110 @@
+from typing import Any
+
+from psycopg import sql
+
+from ..core.database import (
+    ChangeSet,
+    DatabaseCommand,
+    execute_command,
+    g_update_prefix,
+    read_all,
+    sql_literal,
+)
+
+TIME_STATISTIC_NONE = 'NONE'
+TIME_STATISTIC_AVERAGED = 'AVERAGED'
+TIME_STATISTIC_MINIMUM = 'MINIMUM'
+TIME_STATISTIC_MAXIMUM = 'MAXIMUM'
+TIME_STATISTIC_RANGE = 'RANGE'
+
+element_schema = {'type': 'str' , 'optional': True , 'readonly': False}
+
+def get_time_schema(name: str) -> dict[str, dict[str, Any]]:
+    return { 'DURATION'           : element_schema,
+             'HYDRAULIC TIMESTEP' : element_schema,
+             'QUALITY TIMESTEP'   : element_schema,
+             'RULE TIMESTEP'      : element_schema,
+             'PATTERN TIMESTEP'   : element_schema,
+             'PATTERN START'      : element_schema,
+             'REPORT TIMESTEP'    : element_schema,
+             'REPORT START'       : element_schema,
+             'START CLOCKTIME'    : element_schema,
+             'STATISTIC'          : element_schema}
+
+
+def get_time(name: str) -> dict[str, Any]:
+    ts = read_all(name, "select key, value from network.time_settings")
+    d = {}
+    for e in ts:
+        d[e['key']] = str(e['value'])
+    return d
+
+
+def _set_time(name: str, cs: ChangeSet) -> DatabaseCommand:
+    new = {}
+
+    new_dict = cs.operations[0]
+    schema = get_time_schema(name)
+    for key in schema.keys():
+        if key in new_dict:
+            new[key] = str(new_dict[key])
+
+    change = g_update_prefix | { 'type' : 'time' }
+
+    statement = ''
+    for key, value in new.items():
+        if statement != '':
+            statement += '\n'
+        statement += f"update network.time_settings set value = {sql_literal(value)} where key = {sql_literal(key)};"
+        change |= { key: value }
+
+    return DatabaseCommand(statement, [change])
+
+
+def set_time(name: str, cs: ChangeSet) -> ChangeSet:
+    return execute_command(name, _set_time(name, cs))
+
+
+#--------------------------------------------------------------
+# [EPA2][EPA3]
+#   STATISTIC                  {NONE/AVERAGE/MIN/MAX/RANGE}
+#   DURATION                   value   (units)
+#   HYDRAULIC TIMESTEP         value   (units)
+#   QUALITY TIMESTEP           value   (units)
+#   RULE TIMESTEP              value   (units)
+#   PATTERN TIMESTEP           value   (units)
+#   PATTERN START              value   (units)
+#   REPORT TIMESTEP            value   (units)
+#   REPORT START               value   (units)
+#   START CLOCKTIME            value   (AM PM)
+# [EPA3] supports [EPA2] keyword
+#--------------------------------------------------------------
+
+
+def inp_in_time(section: list[str]) -> str:
+    sql = ''
+    for s in section:
+        if s.startswith(';'):
+            continue
+
+        line = s.upper().strip()
+
+        # TOTAL DURATION => DURATION
+        if line.startswith('TOTAL DURATION'):
+            line = line.replace('TOTAL DURATION', 'DURATION')
+
+        for key in get_time_schema('').keys():
+            if line.startswith(key):
+                value = line.removeprefix(key).strip()
+                sql += f"update network.time_settings set value = {sql_literal(value)} where key = {sql_literal(key)};"
+    return sql
+
+
+def inp_out_time(name: str) -> list[str]:
+    lines = []
+    objs = read_all(name, "select key, value from network.time_settings order by key")
+    for obj in objs:
+        key = obj['key']
+        value = obj['value']
+        lines.append(f'{key} {value}')
+    return lines