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

2026-09-20 10:38:10 +08:00
parent acddc8a237
commit 3edba99d2d
227 changed files with 122871 additions and 839 deletions
@@ -0,0 +1,137 @@
+from cli.core import (
+    DEFAULT_CORE_SERVICES,
+    CliContextFactory,
+    CliExecutionService,
+)
+from cli.exit_codes import DEPENDENCY_ERROR, SUCCESS
+from cli.runtime.db import DATABASE_RUNTIME, DatabaseRuntimeService
+from cli.runtime.ops import OPERATIONS_RUNTIME, OperationsRuntimeService
+
+from .presenter import OpsCommandPresenter
+
+
+class OpsCommandController:
+    """
+    运维命令控制器。
+
+    该控制器负责组织 `ops` 命令组的上下文准备、runtime 调用、
+    payload 注入，以及基于输出格式选择 presenter 或直接返回 JSON。
+
+    :param context_factory: CLI 上下文工厂
+    :param execution_service: CLI 执行服务
+    :param presenter: 运维命令文本渲染器
+    """
+
+    def __init__(
+        self,
+        *,
+        context_factory: CliContextFactory | None = None,
+        execution_service: CliExecutionService | None = None,
+        presenter: OpsCommandPresenter | None = None,
+        database_runtime: DatabaseRuntimeService | None = None,
+        operations_runtime: OperationsRuntimeService | None = None,
+    ) -> None:
+        """
+        初始化运维命令控制器。
+
+        :param context_factory: CLI 上下文工厂
+        :param execution_service: CLI 执行服务
+        :param presenter: 运维命令文本渲染器
+        :param database_runtime: 数据库运行时服务
+        :param operations_runtime: 运维运行时服务
+        :return: None
+        """
+        self.context_factory = context_factory or DEFAULT_CORE_SERVICES.context_factory
+        self.execution_service = execution_service or DEFAULT_CORE_SERVICES.execution_service
+        self.presenter = presenter or OpsCommandPresenter()
+        self.database_runtime = database_runtime or DATABASE_RUNTIME
+        self.operations_runtime = operations_runtime or OPERATIONS_RUNTIME
+
+    def ping_db(self, env: str, output: str) -> None:
+        """
+        检查数据库连接。
+
+        :param env: 当前命令运行环境
+        :param output: 输出格式
+        :return: None
+        """
+        ctx = self.context_factory.build_readonly(env, output)
+        self.execution_service.complete_payload(
+            ctx, self.execution_service.run_async(self.database_runtime.ping_database())
+        )
+
+    def ping_redis(self, env: str, output: str) -> None:
+        """
+        检查 Redis 连接。
+
+        :param env: 当前命令运行环境
+        :param output: 输出格式
+        :return: None
+        """
+        ctx = self.context_factory.build_readonly(env, output)
+        self.execution_service.complete_payload(
+            ctx,
+            self.execution_service.run_async(self.operations_runtime.ping_redis()),
+        )
+
+    def health(self, env: str, output: str) -> None:
+        """
+        输出基础健康检查结果。
+
+        :param env: 当前命令运行环境
+        :param output: 输出格式
+        :return: None
+        """
+        ctx = self.context_factory.build_readonly(env, output)
+        db_status = self.execution_service.run_async(self.database_runtime.ping_database())
+        redis_status = self.execution_service.run_async(self.operations_runtime.ping_redis())
+        payload = {
+            'env': ctx.env,
+            'database': db_status,
+            'redis': redis_status,
+            'ok': db_status.get('ok', False) and redis_status.get('ok', False),
+        }
+        exit_code = SUCCESS if payload['ok'] else DEPENDENCY_ERROR
+        self.execution_service.complete_payload_with_text(
+            ctx,
+            payload,
+            text_builder=self.presenter.build_health_text,
+            default_exit_code=exit_code,
+        )
+
+    def deps(self, env: str, output: str, *, include_dev: bool) -> None:
+        """
+        检查当前 CLI 和后端运行依赖版本。
+
+        :param env: 当前命令运行环境
+        :param output: 输出格式
+        :param include_dev: 是否附带输出开发依赖
+        :return: None
+        """
+        ctx = self.context_factory.build_readonly(env, output)
+        payload = self.operations_runtime.get_dependency_versions(include_dev=include_dev)
+        exit_code = SUCCESS if payload.get('ok', False) else DEPENDENCY_ERROR
+        self.execution_service.complete_payload_with_text(
+            ctx,
+            payload,
+            text_builder=self.presenter.build_dependencies_text,
+            default_exit_code=exit_code,
+        )
+
+    def server_info(self, env: str, output: str) -> None:
+        """
+        输出服务器运行时信息。
+
+        :param env: 当前命令运行环境
+        :param output: 输出格式
+        :return: None
+        """
+        ctx = self.context_factory.build_readonly(env, output)
+        payload = self.execution_service.run_async(self.operations_runtime.get_server_info())
+        self.execution_service.complete_payload_with_text(
+            ctx,
+            payload,
+            text_builder=self.presenter.build_server_info_text,
+            default_exit_code=SUCCESS,
+            text_condition=lambda data: data.get('ok', False),
+        )