调整部分前端布局和后端增删改逻辑

2026-09-20 10:38:10 +08:00
parent acddc8a237
commit 3edba99d2d
227 changed files with 122871 additions and 839 deletions
@@ -0,0 +1,103 @@
+from __future__ import annotations
+
+from dataclasses import dataclass
+from typing import TYPE_CHECKING
+
+if TYPE_CHECKING:
+    from cli.tui.actions.builders import TuiActionSpecFactory, TuiActionTemplate
+    from cli.tui.actions.models import ActionSlot, TuiActionSpec
+    from cli.tui.adapters.models import BrowserRecordSnapshot
+
+
+@dataclass(frozen=True)
+class TuiActionRegistry:
+    """
+    TUI 动作注册表。
+
+    该注册表负责集中维护浏览页和详情页的动作解析器，从而将
+    原本散落的条件分发收敛为可声明的映射关系。
+
+    :param browser_resolvers: 浏览页动作槽位解析器映射
+    :param detail_resolvers: 详情页动作槽位解析器映射
+    """
+
+    browser_resolvers: dict[str, TuiActionSlotResolver]
+    detail_resolvers: dict[str, TuiActionSlotResolver]
+
+    def resolve_browser_action(
+        self,
+        *,
+        view_key: str,
+        slot: ActionSlot,
+        record: BrowserRecordSnapshot | None,
+        env: str,
+    ) -> TuiActionSpec | None:
+        """
+        解析浏览页动作。
+
+        :param view_key: 当前页面视图标识
+        :param slot: 动作槽位
+        :param record: 当前选中记录
+        :param env: 当前运行环境
+        :return: 动作定义
+        """
+        resolver = self.browser_resolvers.get(view_key)
+        if resolver is None:
+            return None
+        return resolver.resolve(slot=slot, record=record, env=env)
+
+    def resolve_detail_action(
+        self,
+        *,
+        view_key: str,
+        slot: ActionSlot,
+        env: str,
+    ) -> TuiActionSpec | None:
+        """
+        解析详情页动作。
+
+        :param view_key: 当前页面视图标识
+        :param slot: 动作槽位
+        :param env: 当前运行环境
+        :return: 动作定义
+        """
+        resolver = self.detail_resolvers.get(view_key)
+        if resolver is None:
+            return None
+        return resolver.resolve(slot=slot, record=None, env=env)
+
+
+@dataclass(frozen=True)
+class TuiActionSlotResolver:
+    """
+    TUI 动作槽位解析器。
+
+    该对象将一个页面支持的槽位动作集中定义为映射关系，避免继续在
+    `resolve_*_action` 中堆叠条件分支。
+
+    :param slot_templates: 槽位到动作模板的映射
+    :param spec_factory: 动作规格构建器
+    """
+
+    slot_templates: dict[ActionSlot, TuiActionTemplate]
+    spec_factory: TuiActionSpecFactory
+
+    def resolve(
+        self,
+        *,
+        slot: ActionSlot,
+        record: BrowserRecordSnapshot | None,
+        env: str,
+    ) -> TuiActionSpec | None:
+        """
+        解析指定槽位的动作定义。
+
+        :param slot: 动作槽位
+        :param record: 当前选中记录
+        :param env: 当前运行环境
+        :return: 动作定义
+        """
+        template = self.slot_templates.get(slot)
+        if template is None:
+            return None
+        return template.build(record=record, env=env, spec_factory=self.spec_factory)