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

shierfeng-fastapi-backend/build/lib/cli/groups/app/presenter.py

@@ -0,0 +1,210 @@
+from typing import Any
+
+from cli.utils import SHELL_TEXT_FORMATTER
+
+
+class AppCommandPresenter:
+    """
+    应用命令文本渲染器。
+
+    该渲染器负责将 `app` 命令组产生的结构化 payload 转换为稳定的文本摘要，
+    同时保持 JSON 输出仍由控制器直接返回，不在此处做契约变形。
+    """
+
+    def build_routes_text(self, payload: dict[str, Any]) -> str:
+        """
+        将路由列表结果渲染为文本摘要。
+
+        :param payload: 路由列表结果字典
+        :return: 文本摘要
+        """
+        lines = [
+            f'ok: {str(payload.get("ok", False)).lower()}',
+            f'env: {payload.get("env", "")}',
+            f'count: {payload.get("count", 0)}',
+        ]
+        filters = payload.get('filters')
+        if isinstance(filters, dict):
+            lines.extend(self._build_route_filter_lines(filters))
+
+        grouped_routes = payload.get('groupedRoutes')
+        if filters and filters.get('groupBy') == 'tag' and isinstance(grouped_routes, dict):
+            lines.extend(self._build_grouped_routes_text(grouped_routes))
+            return '\n'.join(lines)
+
+        routes = payload.get('routes')
+        if not isinstance(routes, list) or not routes:
+            lines.append('routes: none')
+            return '\n'.join(lines)
+
+        lines.append('routes:')
+        for route in routes:
+            if isinstance(route, dict):
+                lines.extend([f'  {line}' for line in self._build_route_item_lines(route)])
+        return '\n'.join(lines)
+
+    def build_app_config_text(self, payload: dict[str, Any]) -> str:
+        """
+        将应用配置快照渲染为文本摘要。
+
+        :param payload: 应用配置结果字典
+        :return: 文本摘要
+        """
+        config = payload.get('config')
+        if not isinstance(config, dict):
+            return '\n'.join(
+                [
+                    f'ok: {str(payload.get("ok", False)).lower()}',
+                    f'env: {payload.get("env", "")}',
+                    'config: none',
+                ]
+            )
+
+        lines = [
+            f'ok: {str(payload.get("ok", False)).lower()}',
+            f'env: {payload.get("env", "")}',
+            'application:',
+            f'  name: {config.get("name", "-")}',
+            f'  host: {config.get("host", "-")}:{config.get("port", "-")}',
+            f'  root_path: {config.get("rootPath", "-") or "/"}',
+            f'  reload: {str(config.get("reload", False)).lower()}',
+            f'  workers: {config.get("workers", "-")}',
+            f'  disable_swagger: {str(config.get("disableSwagger", False)).lower()}',
+            f'  disable_redoc: {str(config.get("disableRedoc", False)).lower()}',
+            'database:',
+            f'  type: {config.get("dbType", "-")}',
+            f'  host: {config.get("dbHost", "-")}:{config.get("dbPort", "-")}',
+            f'  name: {config.get("dbDatabase", "-")}',
+            'redis:',
+            f'  host: {config.get("redisHost", "-")}:{config.get("redisPort", "-")}',
+            'logging:',
+            f'  level: {config.get("logLevel", "-")}',
+            'transport_crypto:',
+            f'  enabled: {str(config.get("transportCryptoEnabled", False)).lower()}',
+            f'  mode: {config.get("transportCryptoMode", "-")}',
+        ]
+        return '\n'.join(lines)
+
+    def build_app_env_text(self, payload: dict[str, Any]) -> str:
+        """
+        将应用环境解析结果渲染为文本摘要。
+
+        :param payload: 应用环境结果字典
+        :return: 文本摘要
+        """
+        runtime = payload.get('runtime')
+        if not isinstance(runtime, dict):
+            return '\n'.join(
+                [
+                    f'ok: {str(payload.get("ok", False)).lower()}',
+                    f'env: {payload.get("env", "")}',
+                    'runtime: none',
+                ]
+            )
+
+        return '\n'.join(
+            [
+                f'ok: {str(payload.get("ok", False)).lower()}',
+                f'env: {payload.get("env", "")}',
+                'runtime:',
+                f'  cli_env: {runtime.get("cliEnv", "-")}',
+                f'  config_env: {runtime.get("configEnv", "-")}',
+                f'  app_env: {runtime.get("appEnv", "-")}',
+                f'  env_file: {runtime.get("envFile", "-")}',
+                f'  env_file_exists: {str(runtime.get("envFileExists", False)).lower()}',
+                f'  backend_dir: {runtime.get("backendDir", "-")}',
+                f'  python_executable: {runtime.get("pythonExecutable", "-")}',
+            ]
+        )
+
+    def build_doctor_text(self, payload: dict[str, Any]) -> str:
+        """
+        将应用启动前检查结果渲染为文本摘要。
+
+        :param payload: 启动前检查结果字典
+        :return: 文本摘要
+        """
+        return '\n'.join(
+            [
+                f'ok: {str(payload.get("ok", False)).lower()}',
+                f'env: {payload.get("env", "")}',
+                'checks:',
+                self._build_check_status_line('database', payload.get('database')),
+                self._build_check_status_line('redis', payload.get('redis')),
+                self._build_check_status_line('crypto', payload.get('crypto')),
+            ]
+        )
+
+    @staticmethod
+    def _build_route_filter_lines(filters: dict[str, object]) -> list[str]:
+        """
+        构建路由过滤条件文本行。
+
+        :param filters: 过滤条件字典
+        :return: 过滤条件文本行列表
+        """
+        active_filters = []
+        for key, value in filters.items():
+            if value in (None, '', False, 'none'):
+                continue
+            active_filters.append(f'{SHELL_TEXT_FORMATTER.to_snake_case(key)}={value}')
+        if not active_filters:
+            return ['filters: none']
+        return ['filters:', *[f'  - {item}' for item in active_filters]]
+
+    @staticmethod
+    def _build_route_item_lines(route_item: dict[str, Any]) -> list[str]:
+        """
+        构建单条路由记录的文本行。
+
+        :param route_item: 单条路由记录
+        :return: 文本行列表
+        """
+        methods = ','.join(route_item.get('methods', [])) or '-'
+        path = SHELL_TEXT_FORMATTER.truncate_text(route_item.get('path', ''), 72)
+        tags = ','.join(route_item.get('tags', [])) or '-'
+        summary = SHELL_TEXT_FORMATTER.truncate_text(route_item.get('summary', ''), 60)
+        name = SHELL_TEXT_FORMATTER.truncate_text(route_item.get('name', ''), 40)
+        return [
+            f'- [{methods}] {path}',
+            f'  name: {name or "-"} | tags: {tags}',
+            f'  summary: {summary or "-"}',
+        ]
+
+    def _build_grouped_routes_text(self, grouped_routes: dict[str, Any]) -> list[str]:
+        """
+        将按标签分组后的路由结果渲染为文本行。
+
+        :param grouped_routes: 按标签分组后的路由映射
+        :return: 文本行列表
+        """
+        if not grouped_routes:
+            return ['groups: none']
+
+        lines = [f'groups: {len(grouped_routes)}']
+        for tag, routes in grouped_routes.items():
+            route_items = routes if isinstance(routes, list) else []
+            lines.append(f'  {tag}: {len(route_items)}')
+            for route in route_items:
+                if isinstance(route, dict):
+                    lines.extend([f'    {line}' for line in self._build_route_item_lines(route)])
+        return lines
+
+    @staticmethod
+    def _build_check_status_line(name: str, status_payload: dict[str, Any] | None) -> str:
+        """
+        构建单项检查结果摘要行。
+
+        :param name: 检查项名称
+        :param status_payload: 检查结果字典
+        :return: 摘要行文本
+        """
+        if not isinstance(status_payload, dict):
+            return f'  {name}: unknown'
+
+        ok = str(status_payload.get('ok', False)).lower()
+        message = status_payload.get('message', '-') or '-'
+        error = status_payload.get('error')
+        if error:
+            return f'  {name}: {ok} | {message} | error: {SHELL_TEXT_FORMATTER.truncate_text(error, 120)}'
+        return f'  {name}: {ok} | {message}'