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/native/wndb/model/sources.py

@@ -0,0 +1,152 @@
+from typing import Any
+
+from ..core.database import (
+    ChangeSet,
+    DatabaseCommand,
+    execute_command,
+    g_add_prefix,
+    g_delete_prefix,
+    g_update_prefix,
+    read_all,
+    sql_literal,
+    try_read,
+)
+
+SOURCE_TYPE_CONCEN = 'CONCEN'
+SOURCE_TYPE_MASS = 'MASS'
+SOURCE_TYPE_FLOWPACED = 'FLOWPACED'
+SOURCE_TYPE_SETPOINT = 'SETPOINT'
+
+def get_source_schema(name: str) -> dict[str, dict[str, Any]]:
+    return { 'node'      : {'type': 'str'   , 'optional': False , 'readonly': True },
+             's_type'    : {'type': 'str'   , 'optional': False , 'readonly': False},
+             'strength'  : {'type': 'float' , 'optional': False , 'readonly': False},
+             'pattern'   : {'type': 'str'   , 'optional': True ,  'readonly': False} }
+
+
+def get_source(name: str, node: str) -> dict[str, Any]:
+    s = try_read(name, "select node_id as node, source_type as s_type, strength, pattern_id as pattern from network.sources where node_id = %s", (node,))
+    if s == None:
+        return {}
+    d = {}
+    d['node'] = str(s['node'])
+    d['s_type'] = str(s['s_type'])
+    d['strength'] = float(s['strength'])
+    d['pattern'] = str(s['pattern']) if s['pattern'] != None else None
+    return d
+
+
+class Source(object):
+    def __init__(self, input: dict[str, Any]) -> None:
+        self.type = 'source'
+        self.node = str(input['node'])
+        self.s_type = str(input['s_type'])
+        self.strength = float(input['strength'])
+        self.pattern = str(input['pattern']) if 'pattern' in input and input['pattern'] != None else None
+
+        self.f_type = sql_literal(self.type)
+        self.f_node = sql_literal(self.node)
+        self.f_s_type = sql_literal(self.s_type)
+        self.f_strength = sql_literal(self.strength)
+        self.f_pattern = sql_literal(self.pattern)
+
+    def as_dict(self) -> dict[str, Any]:
+        return { 'type': self.type, 'node': self.node, 's_type': self.s_type, 'strength': self.strength, 'pattern': self.pattern }
+
+def _set_source(name: str, cs: ChangeSet) -> DatabaseCommand:
+    raw_new = get_source(name, cs.operations[0]['node'])
+
+    new_dict = cs.operations[0]
+    schema = get_source_schema(name)
+    for key, value in schema.items():
+        if key in new_dict and not value['readonly']:
+            raw_new[key] = new_dict[key]
+    new = Source(raw_new)
+
+    statement = f"update network.sources set source_type = {new.f_s_type}, strength = {new.f_strength}, pattern_id = {new.f_pattern} where node_id = {new.f_node};"
+
+    change = g_update_prefix | new.as_dict()
+
+    return DatabaseCommand(statement, [change])
+
+
+def set_source(name: str, cs: ChangeSet) -> ChangeSet:
+    return execute_command(name, _set_source(name, cs))
+
+
+def _add_source(name: str, cs: ChangeSet) -> DatabaseCommand:
+    new = Source(cs.operations[0])
+
+    statement = f"insert into network.sources (node_id, source_type, strength, pattern_id) values ({new.f_node}, {new.f_s_type}, {new.f_strength}, {new.f_pattern});"
+
+    change = g_add_prefix | new.as_dict()
+
+    return DatabaseCommand(statement, [change])
+
+
+def add_source(name: str, cs: ChangeSet) -> ChangeSet:
+    return execute_command(name, _add_source(name, cs))
+
+
+def _delete_source(name: str, cs: ChangeSet) -> DatabaseCommand:
+    node = str(cs.operations[0]['node'])
+    f_node = sql_literal(node)
+
+    statement = f"delete from network.sources where node_id = {f_node};"
+
+    change = g_delete_prefix | {'type': 'source', 'node': node}
+
+    return DatabaseCommand(statement, [change])
+
+
+def delete_source(name: str, cs: ChangeSet) -> ChangeSet:
+    return execute_command(name, _delete_source(name, cs))
+
+
+#--------------------------------------------------------------
+# [EPA2][EPA3][IN][OUT]
+#   node  sourcetype  quality  (pattern)
+#--------------------------------------------------------------
+
+
+def inp_in_source(line: str) -> str:
+    tokens = line.split()
+
+    num = len(tokens)
+    has_desc = tokens[-1].startswith(';')
+    num_without_desc = (num - 1) if has_desc else num
+
+    node = str(tokens[0])
+    s_type = str(tokens[1].upper())
+    strength = float(tokens[2])
+    pattern = str(tokens[3]) if num_without_desc >= 4 else None
+    return str(f"insert into network.sources (node_id, source_type, strength, pattern_id) values ({sql_literal(node)}, {sql_literal(s_type)}, {sql_literal(strength)}, {sql_literal(pattern)});")
+
+
+def inp_out_source(name: str) -> list[str]:
+    lines = []
+    objs = read_all(name, 'select node_id as node, source_type as s_type, strength, pattern_id as pattern from network.sources order by node_id')
+    for obj in objs:
+        node = obj['node']
+        s_type = obj['s_type']
+        strength = obj['strength']
+        pattern = obj['pattern'] if obj['pattern'] != None else ''
+        lines.append(f'{node} {s_type} {strength} {pattern}')
+    return lines
+
+
+def delete_source_by_node(name: str, node: str) -> ChangeSet:
+    row = try_read(name, "select 1 from network.sources where node_id = %s", (node,))
+    if row == None:
+        return ChangeSet()
+    return ChangeSet(g_delete_prefix | {'type' : 'source', 'node': node})
+
+
+def unset_source_by_pattern(name: str, pattern: str) -> ChangeSet:
+    cs = ChangeSet()
+
+    rows = read_all(name, "select node_id as node from network.sources where pattern_id = %s", (pattern,))
+    for row in rows:
+        cs.append(g_update_prefix | {'type': 'source', 'node': row['node'], 'pattern': None})
+
+    return cs