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

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

frontend/web/src/api/module_example/demo.ts

@@ -81,17 +81,14 @@ const DemoAPI = {
 
 export default DemoAPI;
 
-export interface DemoPageQuery extends PageQuery {
+export interface DemoPageQuery extends PageQuery, UserByQueryParams, TenantByQueryParams {
   name?: string;
-  status?: number;
-  created_time?: string[];
-  updated_time?: string[];
-  created_id?: number;
-  updated_id?: number;
 }
 
 export interface DemoTable extends BaseType {
   name?: string;
+  status?: number;
+  description?: string;
   int_val?: number;
   bigint_val?: number;
   float_val?: number;
@@ -105,6 +102,8 @@ export interface DemoTable extends BaseType {
 
 export interface DemoForm extends BaseFormType {
   name?: string;
+  status?: number;
+  description?: string;
   int_val?: number;
   bigint_val?: number;
   float_val?: number;

frontend/web/src/api/module_generator/gencode.ts

@@ -138,6 +138,7 @@ export interface GenTableSchema extends BaseType {
   pk_column?: GenTableColumnSchema;
   columns: GenTableColumnSchema[];
   sub_table?: GenTableSchema;
+  status?: number;
 }
 
 export interface GenTableColumnSchema extends BaseType {
@@ -161,10 +162,12 @@ export interface GenTableColumnSchema extends BaseType {
   is_list?: boolean | null;
   is_query?: boolean | null;
   query_type?: string | null;
+  status?: number;
+  description?: string;
 }
 
 /** 查询参数：生成表 */
-export interface GenTablePageQuery extends PageQuery {
+export interface GenTablePageQuery extends PageQuery, UserByQueryParams {
   table_name?: string;
   table_comment?: string;
 }

frontend/web/src/api/module_monitor/online.ts

@@ -32,7 +32,7 @@ const OnlineAPI = {
 
 export default OnlineAPI;
 
-export interface OnlineUserPageQuery extends PageQuery {
+export interface OnlineUserPageQuery extends PageQuery, UserByQueryParams, TenantByQueryParams {
   ipaddr?: string;
   name?: string;
   login_location?: string;

frontend/web/src/api/module_platform/email.ts

@@ -114,7 +114,7 @@ export default EmailAPI;
 
 // ─── EmailConfig 类型 ──────────────────────────────────────
 
-export interface EmailConfigPageQuery extends PageQuery {
+export interface EmailConfigPageQuery extends PageQuery, UserByQueryParams {
   name?: string;
   is_default?: boolean;
 }
@@ -128,6 +128,7 @@ export interface EmailConfigTable extends BaseType {
   use_tls: boolean;
   is_default: boolean;
   timeout: number;
+  status?: number;
   description?: string;
 }
 
@@ -141,6 +142,7 @@ export interface EmailConfigCreateForm {
   use_tls?: boolean;
   is_default?: boolean;
   timeout?: number;
+  status?: number;
   description?: string;
 }
 
@@ -154,6 +156,7 @@ export interface EmailConfigUpdateForm {
   use_tls?: boolean;
   is_default?: boolean;
   timeout?: number;
+  status?: number;
   description?: string;
 }
 
@@ -164,7 +167,7 @@ export interface EmailTestForm {
 
 // ─── EmailTemplate 类型 ──────────────────────────────────────
 
-export interface EmailTemplatePageQuery extends PageQuery {
+export interface EmailTemplatePageQuery extends PageQuery, UserByQueryParams {
   name?: string;
   template_code?: string;
 }
@@ -176,6 +179,7 @@ export interface EmailTemplateTable extends BaseType {
   body_html: string;
   body_text?: string;
   variables?: string;
+  status?: number;
   description?: string;
 }
 
@@ -201,10 +205,9 @@ export interface EmailTemplateUpdateForm {
 
 // ─── EmailLog 类型 ──────────────────────────────────────────
 
-export interface EmailLogPageQuery extends PageQuery {
+export interface EmailLogPageQuery extends PageQuery, UserByQueryParams {
   to_email?: string;
   biz_type?: string;
-  status?: number;
   template_code?: string;
 }
 

frontend/web/src/api/module_platform/invoice.ts

@@ -57,8 +57,7 @@ const InvoiceAPI = {
 
 export default InvoiceAPI;
 
-export interface InvoicePageQuery extends PageQuery {
-  tenant_id?: number;
+export interface InvoicePageQuery extends PageQuery, TenantByQueryParams {
   invoice_type?: string;
 }
 

frontend/web/src/api/module_platform/menu.ts

@@ -53,12 +53,8 @@ const MenuAPI = {
 
 export default MenuAPI;
 
-export interface MenuPageQuery {
+export interface MenuPageQuery extends BaseQueryParams {
   name?: string;
-  status?: string;
-  created_time?: string[];
-  updated_time?: string[];
-  /** 与后端 Query `menu_client` 一致：pc | app；菜单管理 Tab 切换时传入 */
   menu_client?: "pc" | "app";
 }
 
@@ -89,12 +85,15 @@ export interface MenuTable extends BaseType {
   show_badge?: boolean;
   show_text_badge?: string;
   scope?: "platform" | "tenant";
+  status?: number;
+  description?: string;
 }
 
 export interface MenuForm extends BaseFormType {
   name?: string;
   type?: number;
   icon?: string;
+  order?: number;
   permission?: string;
   route_name?: string;
   route_path?: string;
@@ -115,6 +114,8 @@ export interface MenuForm extends BaseFormType {
   show_badge?: boolean;
   show_text_badge?: string;
   scope?: "platform" | "tenant";
+  status?: number;
+  description?: string;
 }
 
 export interface KeyValue {

frontend/web/src/api/module_platform/order.ts

@@ -40,7 +40,9 @@ const OrderAPI = {
 
   // ─── 支付操作 ───
   payOrder(orderId: number, body?: { pay_method?: string }) {
-    return request<ApiResponse<{ pay_url?: string; qr_code?: string }>>({
+    return request<
+      ApiResponse<{ order_no: string; amount: number; qr_code_url?: string; pay_url?: string }>
+    >({
       url: `${PAYMENT_API}/pay/${orderId}`,
       method: "post",
       data: body,
@@ -48,7 +50,7 @@ const OrderAPI = {
   },
 
   queryPaymentStatus(orderId: number) {
-    return request<ApiResponse<{ status: number; message?: string }>>({
+    return request<ApiResponse<{ paid: boolean; order_no?: string; amount?: number }>>({
       url: `${PAYMENT_API}/status/${orderId}`,
       method: "get",
     });
@@ -123,9 +125,7 @@ export default OrderAPI;
 
 // ─── Order 类型 ──────────────────────────────────────────
 
-export interface OrderPageQuery extends PageQuery {
-  tenant_id?: number;
-  status?: number;
+export interface OrderPageQuery extends PageQuery, TenantByQueryParams {
   order_type?: string;
 }
 
@@ -168,8 +168,7 @@ export interface PaymentRecordTable {
 
 // ─── Refund 类型 ─────────────────────────────────────────
 
-export interface RefundPageQuery extends PageQuery {
-  status?: number;
+export interface RefundPageQuery extends PageQuery, UserByQueryParams, TenantByQueryParams {
 }
 
 export interface RefundTable {

frontend/web/src/api/module_platform/package.ts

@@ -83,7 +83,7 @@ const PackageAPI = {
 
 export default PackageAPI;
 
-export interface PackagePageQuery extends PageQuery {
+export interface PackagePageQuery extends PageQuery, UserByQueryParams, TenantByQueryParams {
   name?: string;
   code?: string;
 }
@@ -100,6 +100,8 @@ export interface PackageTable extends BaseType {
   max_depts: number;
   max_storage_mb: number;
   rate_limit: number;
+  status?: number;
+  description?: string;
 }
 
 export interface PackageForm extends BaseFormType {
@@ -114,6 +116,8 @@ export interface PackageForm extends BaseFormType {
   max_depts?: number;
   max_storage_mb?: number;
   rate_limit?: number;
+  status?: number;
+  description?: string;
 }
 
 export interface PackageCreateForm {

frontend/web/src/api/module_platform/plugin.ts

@@ -102,10 +102,9 @@ const PluginAPI = {
 
 export default PluginAPI;
 
-export interface PluginQueryParam {
+export interface PluginQueryParam extends PageQuery, UserByQueryParams, TenantByQueryParams {
   name?: string;
   category?: string;
-  status?: string;
 }
 
 export interface PluginTable extends BaseType {
@@ -121,6 +120,8 @@ export interface PluginTable extends BaseType {
   permission_prefix?: string;
   dependencies?: string;
   sort?: number;
+  status?: number;
+  description?: string;
 }
 
 export interface PluginForm extends BaseFormType {
@@ -135,4 +136,6 @@ export interface PluginForm extends BaseFormType {
   menu_path?: string;
   permission_prefix?: string;
   dependencies?: string;
+  status?: number;
+  description?: string;
 }

frontend/web/src/api/module_platform/self_service.ts

@@ -5,7 +5,7 @@ const API_PATH = "/platform/tenant";
 const SelfServiceAPI = {
   /** 可选购的套餐列表 */
   getAvailablePackages() {
-    return request<ApiResponse<AvailablePackage[]>>({
+    return request<ApiResponse<{ packages: AvailablePackage[] }>>({
       url: `${API_PATH}/package/available`,
       method: "get",
     });
@@ -22,7 +22,7 @@ const SelfServiceAPI = {
 
   /** 创建自助订单 */
   createOrder(body: SelfServiceOrderForm) {
-    return request<ApiResponse<{ id: number; order_no: string }>>({
+    return request<ApiResponse<{ order_id: number; amount: number }>>({
       url: `${API_PATH}/order/create`,
       method: "post",
       data: body,

frontend/web/src/api/module_platform/tenant.ts

@@ -130,10 +130,9 @@ const TenantAPI = {
 
 export default TenantAPI;
 
-export interface TenantPageQuery extends PageQuery {
+export interface TenantPageQuery extends PageQuery, UserByQueryParams, TenantByQueryParams {
   name?: string;
   code?: string;
-  created_time?: string[];
 }
 
 export interface TenantTable extends BaseType {
@@ -158,12 +157,13 @@ export interface TenantTable extends BaseType {
   privacy?: string;
   clause?: string;
   git_code?: string;
+  status?: number;
+  description?: string;
 }
 
 export interface TenantForm extends BaseFormType {
   name?: string;
   code?: string;
-  description?: string;
   package_id?: number;
   start_time?: string;
   end_time?: string;
@@ -183,6 +183,8 @@ export interface TenantForm extends BaseFormType {
   privacy?: string;
   clause?: string;
   git_code?: string;
+  status?: number;
+  description?: string;
 }
 
 export interface TenantCreateForm extends BaseFormType {
@@ -207,6 +209,8 @@ export interface TenantCreateForm extends BaseFormType {
   privacy?: string;
   clause?: string;
   git_code?: string;
+  status?: number;
+  description?: string;
 }
 
 export interface TenantUpdateForm extends BaseFormType {
@@ -231,6 +235,8 @@ export interface TenantUpdateForm extends BaseFormType {
   privacy?: string;
   clause?: string;
   git_code?: string;
+  status?: number;
+  description?: string;
 }
 
 /** 套餐变更影响预览 */

frontend/web/src/api/module_system/dept.ts

@@ -53,10 +53,8 @@ const DeptAPI = {
 
 export default DeptAPI;
 
-export interface DeptPageQuery {
+export interface DeptPageQuery extends UserByQueryParams {
   name?: string;
-  status?: string;
-  created_time?: string[];
 }
 
 export interface DeptTable extends BaseType {
@@ -69,6 +67,8 @@ export interface DeptTable extends BaseType {
   parent_id?: number;
   parent_name?: string;
   children?: DeptTable[];
+  status?: number;
+  description?: string;
 }
 
 export interface DeptForm extends BaseFormType {
@@ -78,4 +78,7 @@ export interface DeptForm extends BaseFormType {
   phone?: string;
   email?: string;
   parent_id?: number;
+  order?: number;
+  status?: number;
+  description?: string;
 }

frontend/web/src/api/module_system/dict.ts

@@ -132,12 +132,12 @@ const DictAPI = {
 
 export default DictAPI;
 
-export interface DictPageQuery extends PageQuery {
+export interface DictPageQuery extends PageQuery, UserByQueryParams {
   dict_name?: string;
   dict_type?: string;
 }
 
-export interface DictDataPageQuery extends PageQuery {
+export interface DictDataPageQuery extends PageQuery, UserByQueryParams {
   dict_label?: string;
   dict_type?: string;
   dict_type_id?: number;
@@ -146,11 +146,15 @@ export interface DictDataPageQuery extends PageQuery {
 export interface DictTable extends BaseType {
   dict_name?: string;
   dict_type?: string;
+  status?: number;
+  description?: string;
 }
 
 export interface DictForm extends BaseFormType {
   dict_name?: string;
   dict_type?: string;
+  status?: number;
+  description?: string;
 }
 
 export interface DictDataTable extends BaseType {
@@ -162,6 +166,8 @@ export interface DictDataTable extends BaseType {
   css_class?: string;
   list_class?: string;
   is_default?: boolean;
+  status?: number;
+  description?: string;
 }
 
 export interface DictDataForm extends BaseFormType {
@@ -173,4 +179,6 @@ export interface DictDataForm extends BaseFormType {
   css_class?: string;
   list_class?: string;
   is_default?: boolean;
+  status?: number;
+  description?: string;
 }

frontend/web/src/api/module_system/log.ts

@@ -27,6 +27,15 @@ const OperationLogAPI = {
       data: body,
     });
   },
+
+  export(query?: OperationLogPageQuery) {
+    return request<Blob>({
+      url: `${OP_API}/export`,
+      method: "post",
+      data: query,
+      responseType: "blob",
+    });
+  },
 };
 
 export default OperationLogAPI;
@@ -34,7 +43,6 @@ export default OperationLogAPI;
 export interface OperationLogPageQuery extends PageQuery {
   request_path?: string;
   creator_name?: string;
-  created_time?: string[];
 }
 
 export interface OperationLogTable {
@@ -42,7 +50,9 @@ export interface OperationLogTable {
   tenant_id: number;
   request_path?: string;
   request_method?: string;
+  request_payload?: Record<string, unknown> | string;
   response_code?: number;
+  response_json?: Record<string, unknown> | string;
   process_time?: string;
   created_time?: string;
 }
@@ -77,7 +87,6 @@ export const LoginLogAPI = {
 };
 
 export interface LoginLogPageQuery extends PageQuery {
-  status?: number;
   username?: string;
 }
 

frontend/web/src/api/module_system/notice.ts

@@ -97,7 +97,7 @@ const NoticeAPI = {
 
 export default NoticeAPI;
 
-export interface NoticePageQuery extends PageQuery {
+export interface NoticePageQuery extends PageQuery, UserByQueryParams {
   notice_title?: string;
   notice_type?: string;
 }
@@ -106,15 +106,16 @@ export interface NoticeTable extends BaseType {
   notice_title?: string;
   notice_type?: string;
   notice_content?: string;
-  created_by?: CommonType;
-  updated_by?: CommonType;
-  deleted_by?: CommonType;
+  status?: number;
+  description?: string;
 }
 
 export interface NoticeForm extends BaseFormType {
   notice_title?: string;
   notice_type?: string;
   notice_content?: string;
+  status?: number;
+  description?: string;
 }
 
 export interface NotificationPanelMessage {

frontend/web/src/api/module_system/params.ts

@@ -82,7 +82,7 @@ const ParamsAPI = {
 
 export default ParamsAPI;
 
-export interface ConfigPageQuery extends PageQuery {
+export interface ConfigPageQuery extends PageQuery, UserByQueryParams {
   config_name?: string;
   config_key?: string;
   config_type?: boolean;
@@ -93,6 +93,8 @@ export interface ConfigTable extends BaseType {
   config_key?: string;
   config_value?: string;
   config_type?: boolean;
+  status?: number;
+  description?: string;
 }
 
 export interface ConfigForm extends BaseFormType {
@@ -100,4 +102,6 @@ export interface ConfigForm extends BaseFormType {
   config_key?: string;
   config_value?: string;
   config_type?: boolean;
+  status?: number;
+  description?: string;
 }

frontend/web/src/api/module_system/position.ts

@@ -62,7 +62,7 @@ const PositionAPI = {
 
 export default PositionAPI;
 
-export interface PositionPageQuery extends PageQuery {
+export interface PositionPageQuery extends PageQuery, UserByQueryParams {
   name?: string;
 }
 
@@ -70,13 +70,14 @@ export interface PositionTable extends BaseType {
   name?: string;
   code?: string;
   order?: number;
-  created_by?: CommonType;
-  updated_by?: CommonType;
-  deleted_by?: CommonType;
+  status?: number;
+  description?: string;
 }
 
 export interface PositionForm extends BaseFormType {
   name?: string;
   code?: string;
   order?: number;
+  status?: number;
+  description?: string;
 }

frontend/web/src/api/module_system/role.ts

@@ -70,7 +70,7 @@ const RoleAPI = {
 
 export default RoleAPI;
 
-export interface TablePageQuery extends PageQuery {
+export interface TablePageQuery extends PageQuery, UserByQueryParams {
   name?: string;
 }
 
@@ -81,6 +81,8 @@ export interface RoleTable extends BaseType {
   data_scope?: number;
   menus?: permissionMenuType[];
   depts?: permissionDeptType[];
+  status?: number;
+  description?: string;
 }
 
 export interface RoleForm extends BaseFormType {
@@ -88,6 +90,8 @@ export interface RoleForm extends BaseFormType {
   order?: number;
   code: string;
   data_scope?: number;
+  status?: number;
+  description?: string;
 }
 
 export interface permissionDataType {

frontend/web/src/api/module_system/ticket.ts

@@ -37,7 +37,7 @@ const TicketAPI = {
 
 export default TicketAPI;
 
-export interface TicketPageQuery extends PageQuery {
+export interface TicketPageQuery extends PageQuery, UserByQueryParams {
   title?: string;
   ticket_type?: string;
   assigned_id?: number;
@@ -52,8 +52,8 @@ export interface TicketTable extends BaseType {
   reply?: string;
   assigned_id?: number;
   assigned_by?: { id: number; name: string; avatar?: string };
-  created_by?: { id: number; name: string; avatar?: string };
-  updated_by?: { id: number; name: string; avatar?: string };
+  status?: number;
+  description?: string;
 }
 
 export interface TicketCreateForm {
@@ -77,7 +77,6 @@ export interface TicketUpdateForm {
 }
 
 export interface TicketForm extends BaseFormType {
-  id?: number;
   title: string;
   ticket_content?: string;
   summary?: string;
@@ -85,4 +84,6 @@ export interface TicketForm extends BaseFormType {
   images?: string;
   reply?: string;
   assigned_id?: number;
+  status?: number;
+  description?: string;
 }

frontend/web/src/api/module_system/user.ts

@@ -152,7 +152,7 @@ export interface RegisterForm {
   email?: string;
 }
 
-export interface UserPageQuery extends PageQuery {
+export interface UserPageQuery extends PageQuery, UserByQueryParams, TenantByQueryParams {
   username?: string;
   name?: string;
   mobile?: string;
@@ -162,7 +162,7 @@ export interface UserPageQuery extends PageQuery {
 
 export interface searchSelectDataType {
   name?: string;
-  status?: string;
+  status?: number;
 }
 
 export interface UserInfo extends BaseType {
@@ -194,6 +194,7 @@ export interface UserInfo extends BaseType {
   github_login?: string;
   wx_login?: string;
   qq_login?: string;
+  status?: number;
   description?: string;
 }
 
@@ -208,7 +209,7 @@ export interface roleSelectorType {
   id?: number;
   name?: string;
   code?: string;
-  status?: string;
+  status?: number;
   description?: string;
   menus?: MenuForm[];
 }
@@ -216,7 +217,7 @@ export interface roleSelectorType {
 export interface positionSelectorType {
   id?: number;
   name?: string;
-  status?: string;
+  status?: number;
   description?: string;
 }
 
@@ -263,6 +264,8 @@ export interface UserForm extends BaseFormType {
   is_superuser?: boolean;
   avatar?: string;
   tenant_id?: number;
+  status?: number;
+  description?: string;
 }
 
 export interface CurrentUserFormState {

frontend/web/src/api/module_task/cronjob/job.ts

@@ -131,10 +131,10 @@ export interface SchedulerJob {
   name: string;
   trigger: string;
   next_run_time?: string;
-  status: string;
+  status: number;
 }
 
-export interface JobLogPageQuery extends PageQuery {
+export interface JobLogPageQuery extends PageQuery, UserByQueryParams {
   job_id?: string;
   job_name?: string;
   trigger_type?: string;
@@ -148,4 +148,6 @@ export interface JobLogTable extends BaseType {
   job_state?: string;
   result?: string;
   error?: string;
+  status?: number;
+  description?: string;
 }

frontend/web/src/api/module_task/cronjob/node.ts

@@ -75,7 +75,7 @@ const NodeAPI = {
 
 export default NodeAPI;
 
-export interface NodePageQuery extends PageQuery {
+export interface NodePageQuery extends PageQuery, UserByQueryParams {
   name?: string;
   code?: string;
 }
@@ -112,10 +112,11 @@ export interface NodeTable extends BaseType {
   created_by?: CommonType;
   updated_by?: CommonType;
   deleted_by?: CommonType;
+  status?: number;
+  description?: string;
 }
 
-export interface NodeForm {
-  id?: number;
+export interface NodeForm extends BaseFormType {
   name: string;
   code?: string;
   jobstore?: string;
@@ -127,6 +128,8 @@ export interface NodeForm {
   max_instances?: number;
   start_date?: string;
   end_date?: string;
+  status?: number;
+  description?: string;
 }
 
 export interface NodeType {

frontend/web/src/api/module_task/workflow/definition.ts

@@ -63,7 +63,7 @@ const WorkflowDefinitionAPI = {
 export default WorkflowDefinitionAPI;
 export { WorkflowDefinitionAPI };
 
-export interface WorkflowPageQuery extends PageQuery {
+export interface WorkflowPageQuery extends PageQuery, UserByQueryParams {
   name?: string;
   code?: string;
 }
@@ -73,9 +73,8 @@ export interface WorkflowTable extends BaseType {
   code?: string;
   nodes?: any[];
   edges?: any[];
-  created_by?: CommonType;
-  updated_by?: CommonType;
-  deleted_by?: CommonType;
+  status?: number;
+  description?: string;
 }
 
 export interface WorkflowForm extends BaseFormType {
@@ -83,6 +82,8 @@ export interface WorkflowForm extends BaseFormType {
   code?: string;
   nodes?: any[];
   edges?: any[];
+  status?: number;
+  description?: string;
 }
 
 export interface WorkflowPublishForm {

frontend/web/src/api/module_task/workflow/node-type.ts

@@ -71,7 +71,7 @@ export interface WorkflowNodeTypeOption {
   kwargs?: string;
 }
 
-export interface WorkflowNodeTypePageQuery extends PageQuery {
+export interface WorkflowNodeTypePageQuery extends PageQuery, UserByQueryParams {
   name?: string;
   code?: string;
   category?: string;
@@ -90,9 +90,11 @@ export interface WorkflowNodeTypeTable extends BaseType {
   created_by?: CommonType;
   updated_by?: CommonType;
   deleted_by?: CommonType;
+  status?: number;
+  description?: string;
 }
 
-export interface WorkflowNodeTypeForm {
+export interface WorkflowNodeTypeForm extends BaseFormType {
   name: string;
   code: string;
   category?: string;
@@ -101,4 +103,6 @@ export interface WorkflowNodeTypeForm {
   kwargs?: string;
   sort_order?: number;
   is_active?: boolean;
+  status?: number;
+  description?: string;
 }