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

2026-09-20 10:38:10 +08:00
parent acddc8a237
commit 3edba99d2d
227 changed files with 122871 additions and 839 deletions
@@ -0,0 +1,71 @@
+class DbCommandPresenter:
+    """
+    数据库命令文本渲染器。
+
+    该渲染器负责将 `db` 命令组产生的结构化 payload 转换为稳定的文本摘要，
+    同时保持 JSON 输出仍由控制器直接返回，不在此处做契约变形。
+    """
+
+    @staticmethod
+    def build_current_revision_text(payload: dict[str, object]) -> str:
+        """
+        将数据库当前迁移版本结果渲染为文本摘要。
+
+        :param payload: 当前迁移版本结果字典
+        :return: 文本摘要
+        """
+        return '\n'.join(
+            [
+                f'ok: {str(payload.get("ok", False)).lower()}',
+                f'env: {payload.get("env", "")}',
+                f'current_revision: {payload.get("currentRevision", "-")}',
+            ]
+        )
+
+    def build_alembic_revisions_text(self, payload: dict[str, object]) -> str:
+        """
+        将 Alembic 修订版本结果渲染为文本摘要。
+
+        :param payload: 修订版本结果字典
+        :return: 文本摘要
+        """
+        items = payload.get('items')
+        lines = [
+            f'ok: {str(payload.get("ok", False)).lower()}',
+            f'env: {payload.get("env", "")}',
+            f'message: {payload.get("message", "-")}',
+            f'count: {payload.get("count", 0)}',
+        ]
+        if 'totalCount' in payload:
+            lines.append(f'total_count: {payload.get("totalCount", 0)}')
+        if 'limit' in payload:
+            lines.append(f'limit: {payload.get("limit", 0)}')
+        if not isinstance(items, list) or not items:
+            lines.append('items: none')
+            return '\n'.join(lines)
+
+        lines.append('items:')
+        for item in items:
+            if isinstance(item, dict):
+                lines.extend([f'  {line}' for line in self._build_alembic_revision_item_lines(item)])
+        return '\n'.join(lines)
+
+    @staticmethod
+    def _build_alembic_revision_item_lines(revision_item: dict[str, object]) -> list[str]:
+        """
+        构建单个 Alembic 修订版本的文本行。
+
+        :param revision_item: 修订版本结果字典
+        :return: 文本行列表
+        """
+        down_revisions = revision_item.get('downRevisions')
+        branch_labels = revision_item.get('branchLabels')
+        depends_on = revision_item.get('dependsOn')
+        return [
+            f'- revision: {revision_item.get("revision", "-")}',
+            f'  down_revisions: {",".join(down_revisions) if isinstance(down_revisions, list) and down_revisions else "-"}',
+            f'  branch_labels: {",".join(branch_labels) if isinstance(branch_labels, list) and branch_labels else "-"}',
+            f'  depends_on: {",".join(depends_on) if isinstance(depends_on, list) and depends_on else "-"}',
+            f'  doc: {revision_item.get("doc", "") or "-"}',
+            f'  path: {revision_item.get("path", "-")}',
+        ]