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

2026-09-20 10:38:10 +08:00
parent acddc8a237
commit 3edba99d2d
227 changed files with 122871 additions and 839 deletions
@@ -0,0 +1,69 @@
+from typing import Any
+
+from cli.runtime.base import RUNTIME_ENVIRONMENT, RuntimeEnvironmentService
+
+from .gateway import AppInfrastructureGateway
+from .support import AppSnapshotSupport
+
+
+class AppRuntimeService:
+    """
+    应用运行时服务。
+
+    该服务作为应用运行时 facade，对外统一暴露应用实例构建、
+    应用配置快照与环境信息快照入口。
+
+    :param runtime_environment: 运行时环境服务
+    :param infrastructure_gateway: 应用基础设施网关
+    :param snapshot_support: 应用快照支持对象
+    """
+
+    def __init__(
+        self,
+        *,
+        runtime_environment: RuntimeEnvironmentService | None = None,
+        infrastructure_gateway: AppInfrastructureGateway | None = None,
+        snapshot_support: AppSnapshotSupport | None = None,
+    ) -> None:
+        """
+        初始化应用运行时服务。
+
+        :param runtime_environment: 运行时环境服务
+        :param infrastructure_gateway: 应用基础设施网关
+        :param snapshot_support: 应用快照支持对象
+        :return: None
+        """
+        self.runtime_environment = runtime_environment or RUNTIME_ENVIRONMENT
+        self.infrastructure_gateway = infrastructure_gateway or AppInfrastructureGateway()
+        self.snapshot_support = snapshot_support or AppSnapshotSupport(
+            self.infrastructure_gateway,
+            self.runtime_environment,
+        )
+
+    def build_app_instance(self) -> Any:
+        """
+        构建当前环境下的 FastAPI 应用实例。
+
+        :return: FastAPI 应用实例
+        """
+        server_module = self.infrastructure_gateway.get_server_module()
+        return server_module.create_app()
+
+    def get_app_config_snapshot(self) -> dict[str, Any]:
+        """
+        读取当前运行环境的应用配置快照。
+
+        :return: 应用配置快照
+        """
+        return self.snapshot_support.build_app_config_snapshot()
+
+    def get_app_env_snapshot(self) -> dict[str, Any]:
+        """
+        读取当前 CLI 进程的环境解析结果快照。
+
+        :return: 环境解析结果快照
+        """
+        return self.snapshot_support.build_app_env_snapshot()
+
+
+APP_RUNTIME = AppRuntimeService()