chore: 完成多批次代码优化与重构

- 重构工作流模块目录结构，迁移代码文件
- 修复类型断言空值安全问题，添加 ! 操作符
- 优化样式类名，替换 flex-cc 为标准 flex 工具类
- 更新路由标签简化文案，移除冗余注释
- 调整 ruff 配置，放宽行长度限制
- 更新 README 与多语言文案，优化项目描述
- 修复表单、图表组件的类型与样式问题
- 简化搜索表单、数据卡片的布局代码

frontend/web/src/views/module_platform/invoice/index.vue

@@ -84,16 +84,15 @@
 </template>
 
 <script setup lang="ts">
-import { ref, reactive, computed, h } from "vue";
-import { ElMessageBox, ElButton, ElTabs, ElTabPane, ElTag } from "element-plus";
+import { ref, reactive, computed } from "vue";
+import { ElMessageBox, ElButton, ElTabs, ElTabPane } from "element-plus";
 import { useTable } from "@/hooks/core/useTable";
 import { useAuth } from "@/hooks/core/useAuth";
 import InvoiceAPI from "@/api/module_platform/invoice";
 import type { InvoiceTable } from "@/api/module_platform/invoice";
-import type { ColumnOption } from "@/types/component";
 import type { SearchFormItem } from "@/components/forms/fa-search-bar/index.vue";
 import type { FormItem } from "@/components/forms/fa-form/index.vue";
-import { renderTableOperationCell, type TableOperationAction } from "@utils";
+import { renderTableOperationCell, type TableOperationAction, resolveStatusColumns } from "@utils";
 
 defineOptions({ name: "Invoice" });
 
@@ -103,18 +102,6 @@ const activeTab = ref("my");
 const isSuperAdmin = ref(true);
 const platformShowSearchBar = ref(true);
 
-// ══════════════════ 标签函数 ════════════════════
-
-function invoiceStatusLabel(status: number): string {
-  const map: Record<number, string> = { 0: "待开具", 1: "已开具", 2: "开票失败", 3: "已作废" };
-  return map[status] || String(status);
-}
-
-function invoiceStatusType(status: number): string {
-  const map: Record<number, string> = { 0: "warning", 1: "success", 2: "danger", 3: "info" };
-  return map[status] || "info";
-}
-
 // ══════════════════ 平台端：全部发票 ════════════════════
 
 function buildPlatformRowActions(row: InvoiceTable): TableOperationAction[] {
@@ -196,7 +183,7 @@ const {
       page_no: 1,
       page_size: 50,
     },
-    columnsFactory: (): ColumnOption<InvoiceTable>[] => [
+    columnsFactory: resolveStatusColumns<InvoiceTable>(() => [
       { prop: "id", label: "ID", width: 60 },
       { prop: "tenant_id", label: "租户ID", width: 80 },
       { prop: "invoice_no", label: "发票号", width: 180, showOverflowTooltip: true },
@@ -217,11 +204,11 @@ const {
         prop: "status",
         label: "状态",
         width: 100,
-        formatter: (row) => {
-          const t = invoiceStatusType(row.status) as "warning" | "success" | "info" | "danger";
-          return h(ElTag, { type: t, size: "small" as const }, () =>
-            invoiceStatusLabel(row.status)
-          );
+        status: {
+          0: { type: "warning", text: "待开具" },
+          1: { type: "success", text: "已开具" },
+          2: { type: "danger", text: "开票失败" },
+          3: { type: "info", text: "已作废" },
         },
       },
       { prop: "address_info", label: "地址电话", width: 180, showOverflowTooltip: true },
@@ -233,7 +220,7 @@ const {
         align: "center",
         formatter: (row) => formatPlatformOpCell(row),
       },
-    ],
+    ]),
   },
 });
 
@@ -288,7 +275,7 @@ const {
       page_no: 1,
       page_size: 50,
     },
-    columnsFactory: (): ColumnOption<InvoiceTable>[] => [
+    columnsFactory: resolveStatusColumns<InvoiceTable>(() => [
       { prop: "id", label: "ID", width: 60 },
       { prop: "invoice_no", label: "发票号", width: 180, showOverflowTooltip: true },
       { prop: "title", label: "抬头", minWidth: 180, showOverflowTooltip: true },
@@ -308,11 +295,11 @@ const {
         prop: "status",
         label: "状态",
         width: 100,
-        formatter: (row) => {
-          const t = invoiceStatusType(row.status) as "warning" | "success" | "info" | "danger";
-          return h(ElTag, { type: t, size: "small" as const }, () =>
-            invoiceStatusLabel(row.status)
-          );
+        status: {
+          0: { type: "warning", text: "待开具" },
+          1: { type: "success", text: "已开具" },
+          2: { type: "danger", text: "开票失败" },
+          3: { type: "info", text: "已作废" },
         },
       },
       {
@@ -322,7 +309,7 @@ const {
         showOverflowTooltip: true,
         formatter: (row) => row.created_time || "—",
       },
-    ],
+    ]),
   },
 });