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,102 @@
+from typing import Any
+
+from ..core.database import (
+    ChangeSet,
+    DatabaseCommand,
+    execute_command,
+    g_update_prefix,
+    read_all,
+    sql_literal,
+    try_read,
+)
+
+
+def get_emitter_schema(name: str) -> dict[str, dict[str, Any]]:
+    return { 'junction'    : {'type': 'str'   , 'optional': False , 'readonly': True },
+             'coefficient' : {'type': 'float' , 'optional': True ,  'readonly': False} }
+
+
+def get_emitter(name: str, junction: str) -> dict[str, Any]:
+    e = try_read(name, "select junction_id as junction, coefficient from network.emitters where junction_id = %s", (junction,))
+    if e == None:
+        return { 'junction': junction, 'coefficient': None }
+    d = {}
+    d['junction'] = str(e['junction'])
+    d['coefficient'] = float(e['coefficient']) if e['coefficient'] != None else None
+    return d
+
+
+class Emitter(object):
+    def __init__(self, input: dict[str, Any]) -> None:
+        self.type = 'emitter'
+        self.junction = str(input['junction'])
+        self.coefficient = float(input['coefficient']) if 'coefficient' in input and input['coefficient'] != None else None
+
+        self.f_type = sql_literal(self.type)
+        self.f_junction = sql_literal(self.junction)
+        self.f_coefficient = sql_literal(self.coefficient)
+
+    def as_dict(self) -> dict[str, Any]:
+        return { 'type': self.type, 'junction': self.junction, 'coefficient': self.coefficient }
+
+
+def _set_emitter(name: str, cs: ChangeSet) -> DatabaseCommand:
+    raw_new = get_emitter(name, cs.operations[0]['junction'])
+
+    new_dict = cs.operations[0]
+    schema = get_emitter_schema(name)
+    for key, value in schema.items():
+        if key in new_dict and not value['readonly']:
+            raw_new[key] = new_dict[key]
+    new = Emitter(raw_new)
+
+    statement = f"delete from network.emitters where junction_id = {new.f_junction};"
+    if new.coefficient != None:
+        statement += f"\ninsert into network.emitters (junction_id, coefficient) values ({new.f_junction}, {new.f_coefficient});"
+
+    change = g_update_prefix | new.as_dict()
+
+    return DatabaseCommand(statement, [change])
+
+
+def set_emitter(name: str, cs: ChangeSet) -> ChangeSet:
+    return execute_command(name, _set_emitter(name, cs))
+
+
+#--------------------------------------------------------------
+# [EPA2][IN][OUT]
+#   node   Ke
+#--------------------------------------------------------------
+# [EPA3][IN][OUT]
+#   node   Ke  (exponent pattern)
+#--------------------------------------------------------------
+
+
+def inp_in_emitter(line: str) -> str:
+    tokens = line.split()
+
+    num = len(tokens)
+    has_desc = tokens[-1].startswith(';')
+    num_without_desc = (num - 1) if has_desc else num
+
+    junction = str(tokens[0])
+    coefficient = float(tokens[1])
+
+    return str(f"insert into network.emitters (junction_id, coefficient) values ({sql_literal(junction)}, {sql_literal(coefficient)});")
+
+
+def inp_out_emitter(name: str) -> list[str]:
+    lines = []
+    objs = read_all(name, 'select junction_id as junction, coefficient from network.emitters order by junction_id')
+    for obj in objs:
+        junction = obj['junction']
+        coefficient = obj['coefficient']
+        lines.append(f'{junction} {coefficient}')
+    return lines
+
+
+def delete_emitter_by_junction(name: str, junction: str) -> ChangeSet:
+    row = try_read(name, "select 1 from network.emitters where junction_id = %s", (junction,))
+    if row == None:
+        return ChangeSet()
+    return ChangeSet(g_update_prefix | {'type' : 'emitter', 'junction': junction, 'coefficient': None})