2026-07-05 16:02:29 +08:00
|
|
|
"""Lightweight SQL table metadata for ImageStudio."""
|
|
|
|
|
|
|
|
|
|
from __future__ import annotations
|
|
|
|
|
|
|
|
|
|
from dataclasses import dataclass, field
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
@dataclass(frozen=True)
|
|
|
|
|
class ColumnSpec:
|
|
|
|
|
name: str
|
|
|
|
|
nullable: bool = True
|
|
|
|
|
sensitive: bool = False
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
@dataclass(frozen=True)
|
|
|
|
|
class TableSpec:
|
|
|
|
|
name: str
|
|
|
|
|
primary_key: str
|
|
|
|
|
columns: tuple[ColumnSpec, ...] = field(default_factory=tuple)
|
|
|
|
|
|
|
|
|
|
def column_names(self) -> list[str]:
|
|
|
|
|
return [column.name for column in self.columns]
|
|
|
|
|
|
|
|
|
|
def sensitive_columns(self) -> list[str]:
|
|
|
|
|
return [column.name for column in self.columns if column.sensitive]
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
TABLES: tuple[TableSpec, ...] = (
|
|
|
|
|
TableSpec(
|
|
|
|
|
"character_profiles",
|
|
|
|
|
"profile_id",
|
|
|
|
|
(
|
|
|
|
|
ColumnSpec("profile_id", nullable=False),
|
|
|
|
|
ColumnSpec("owner_user_id"),
|
|
|
|
|
ColumnSpec("name", nullable=False),
|
|
|
|
|
ColumnSpec("status", nullable=False),
|
|
|
|
|
ColumnSpec("metadata_json"),
|
|
|
|
|
),
|
|
|
|
|
),
|
|
|
|
|
TableSpec(
|
|
|
|
|
"profile_workflows",
|
|
|
|
|
"workflow_id",
|
|
|
|
|
(
|
|
|
|
|
ColumnSpec("workflow_id", nullable=False),
|
|
|
|
|
ColumnSpec("profile_id", nullable=False),
|
|
|
|
|
ColumnSpec("workflow_type", nullable=False),
|
|
|
|
|
ColumnSpec("status", nullable=False),
|
|
|
|
|
ColumnSpec("current_node_id"),
|
|
|
|
|
),
|
|
|
|
|
),
|
|
|
|
|
TableSpec(
|
|
|
|
|
"workflow_nodes",
|
|
|
|
|
"node_id",
|
|
|
|
|
(
|
|
|
|
|
ColumnSpec("node_id", nullable=False),
|
|
|
|
|
ColumnSpec("workflow_id", nullable=False),
|
|
|
|
|
ColumnSpec("node_key", nullable=False),
|
|
|
|
|
ColumnSpec("status", nullable=False),
|
|
|
|
|
ColumnSpec("metadata_json"),
|
|
|
|
|
),
|
|
|
|
|
),
|
|
|
|
|
TableSpec(
|
|
|
|
|
"generation_tasks",
|
|
|
|
|
"task_id",
|
|
|
|
|
(
|
|
|
|
|
ColumnSpec("task_id", nullable=False),
|
|
|
|
|
ColumnSpec("workflow_id"),
|
|
|
|
|
ColumnSpec("node_id"),
|
|
|
|
|
ColumnSpec("status", nullable=False),
|
|
|
|
|
ColumnSpec("request_json"),
|
|
|
|
|
ColumnSpec("result_json"),
|
|
|
|
|
),
|
|
|
|
|
),
|
|
|
|
|
TableSpec(
|
|
|
|
|
"material_categories",
|
|
|
|
|
"category_id",
|
|
|
|
|
(
|
|
|
|
|
ColumnSpec("category_id", nullable=False),
|
|
|
|
|
ColumnSpec("name", nullable=False),
|
|
|
|
|
ColumnSpec("parent_id"),
|
|
|
|
|
ColumnSpec("category_type", nullable=False),
|
|
|
|
|
ColumnSpec("sort_order", nullable=False),
|
|
|
|
|
),
|
|
|
|
|
),
|
|
|
|
|
TableSpec(
|
|
|
|
|
"materials",
|
|
|
|
|
"material_id",
|
|
|
|
|
(
|
|
|
|
|
ColumnSpec("material_id", nullable=False),
|
|
|
|
|
ColumnSpec("category_id"),
|
|
|
|
|
ColumnSpec("display_name", nullable=False),
|
|
|
|
|
ColumnSpec("image_uri"),
|
|
|
|
|
ColumnSpec("recognition_status", nullable=False),
|
|
|
|
|
),
|
|
|
|
|
),
|
|
|
|
|
TableSpec(
|
|
|
|
|
"audit_logs",
|
|
|
|
|
"audit_id",
|
|
|
|
|
(
|
|
|
|
|
ColumnSpec("audit_id", nullable=False),
|
|
|
|
|
ColumnSpec("actor_id"),
|
|
|
|
|
ColumnSpec("action", nullable=False),
|
|
|
|
|
ColumnSpec("target_type", nullable=False),
|
|
|
|
|
ColumnSpec("target_id"),
|
|
|
|
|
),
|
|
|
|
|
),
|
|
|
|
|
TableSpec(
|
|
|
|
|
"config_snapshots",
|
|
|
|
|
"snapshot_id",
|
|
|
|
|
(
|
|
|
|
|
ColumnSpec("snapshot_id", nullable=False),
|
|
|
|
|
ColumnSpec("reason", nullable=False),
|
|
|
|
|
ColumnSpec("actor_id"),
|
|
|
|
|
ColumnSpec("config_json", nullable=False, sensitive=True),
|
|
|
|
|
),
|
|
|
|
|
),
|
2026-07-06 01:53:03 +08:00
|
|
|
TableSpec(
|
|
|
|
|
"model_providers",
|
|
|
|
|
"provider_id",
|
|
|
|
|
(
|
|
|
|
|
ColumnSpec("provider_id", nullable=False),
|
|
|
|
|
ColumnSpec("display_name", nullable=False),
|
|
|
|
|
ColumnSpec("provider_type", nullable=False),
|
|
|
|
|
ColumnSpec("base_url", nullable=False),
|
|
|
|
|
ColumnSpec("api_key_secret_ref", sensitive=True),
|
|
|
|
|
),
|
|
|
|
|
),
|
|
|
|
|
TableSpec(
|
|
|
|
|
"model_routes",
|
|
|
|
|
"route_id",
|
|
|
|
|
(
|
|
|
|
|
ColumnSpec("route_id", nullable=False),
|
|
|
|
|
ColumnSpec("route_name", nullable=False),
|
|
|
|
|
ColumnSpec("provider_id", nullable=False),
|
|
|
|
|
ColumnSpec("model_id", nullable=False),
|
|
|
|
|
ColumnSpec("modality", nullable=False),
|
|
|
|
|
),
|
|
|
|
|
),
|
2026-07-05 16:02:29 +08:00
|
|
|
)
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
def table_spec(table_name: str) -> TableSpec | None:
|
|
|
|
|
normalized = str(table_name or "").strip()
|
|
|
|
|
return next((table for table in TABLES if table.name == normalized), None)
|