@gadmin2n/schematics 0.0.63 → 0.0.65

package/dist/lib/application/files/gadmin2-game-angle-demo/web/src/components/text.tsx

@@ -0,0 +1,74 @@
+import React from "react";
+
+import { ConfigProvider, Typography } from "antd";
+
+export type TextProps = {
+  size?:
+    | "xs"
+    | "sm"
+    | "md"
+    | "lg"
+    | "xl"
+    | "xxl"
+    | "xxxl"
+    | "huge"
+    | "xhuge"
+    | "xxhuge";
+} & React.ComponentProps<typeof Typography.Text>;
+
+const sizes = {
+  xs: {
+    fontSize: 12,
+    lineHeight: 20 / 12,
+  },
+  sm: {
+    fontSize: 14,
+    lineHeight: 22 / 14,
+  },
+  md: {
+    fontSize: 16,
+    lineHeight: 24 / 16,
+  },
+  lg: {
+    fontSize: 20,
+    lineHeight: 28 / 20,
+  },
+  xl: {
+    fontSize: 24,
+    lineHeight: 32 / 24,
+  },
+  xxl: {
+    fontSize: 30,
+    lineHeight: 38 / 30,
+  },
+  xxxl: {
+    fontSize: 38,
+    lineHeight: 46 / 38,
+  },
+  huge: {
+    fontSize: 46,
+    lineHeight: 54 / 46,
+  },
+  xhuge: {
+    fontSize: 56,
+    lineHeight: 64 / 56,
+  },
+  xxhuge: {
+    fontSize: 68,
+    lineHeight: 76 / 68,
+  },
+};
+
+export const Text: React.FC<TextProps> = ({ size = "sm", children, ...rest }) => {
+  return (
+    <ConfigProvider
+      theme={{
+        token: {
+          ...sizes[size],
+        },
+      }}
+    >
+      <Typography.Text {...rest}>{children}</Typography.Text>
+    </ConfigProvider>
+  );
+};

package/dist/lib/application/files/gadmin2-game-angle-demo/web/src/config/routeRegistry.tsx

@@ -0,0 +1,258 @@
+import React, { lazy, Suspense } from "react";
+import { Outlet, Route } from "react-router-dom";
+import { Spin } from "antd";
+import generatedResources from "generated/resources";
+
+// ─── Types ───────────────────────────────────────────────────────────────────
+
+type LazyComp = React.LazyExoticComponent<React.ComponentType<any>>;
+// Allow both lazy and eagerly-imported components (generated/resources uses the latter)
+type AnyComp = React.ComponentType<any>;
+
+interface RouteEntry {
+  path: string;
+  component?: LazyComp | AnyComp;
+  wrapper?: LazyComp | AnyComp;
+  index?: boolean;
+  children?: Record<string, RouteEntry>;
+}
+
+// ─── Data-Mngt dynamic route helpers ─────────────────────────────────────────
+
+/**
+ * Resource names already covered by the static registry entries below.
+ * These must NOT be auto-registered again under dataMngt.
+ */
+const SYSTEM_RESOURCE_NAMES = new Set([
+  "user", "role", "page", "resource", "audit",
+  "game", "roleResource", "pageResource", "rolePages",
+]);
+
+/** camelCase → PascalCase  (reverses toCamelCase in seedDataMngtPages) */
+function toPascalCase(str: string): string {
+  return str.charAt(0).toUpperCase() + str.slice(1);
+}
+
+/**
+ * PascalCase → kebab-case  (same algorithm as seedDataMngtPages.ts so the
+ * generated route path always matches the page.path stored in the DB).
+ *   "Event"         → "event"
+ *   "ITActivityDay" → "it-activity-day"
+ */
+function toKebabCase(str: string): string {
+  return str
+    .replace(/([a-z0-9])([A-Z])/g, "$1-$2")
+    .replace(/([A-Z]+)([A-Z][a-z])/g, "$1-$2")
+    .toLowerCase();
+}
+
+/**
+ * Build RouteEntry children for the dataMngt segment by scanning
+ * generated/resources.tsx (produced by gadmin2 on every `generate:dev`).
+ *
+ * Each business-model resource becomes:
+ *   <Route path="<slug>">
+ *     <Route index          element={<List   />} />
+ *     <Route path="show/:id"  element={<Show   />} />
+ *     <Route path="edit/:id"  element={<Edit   />} />
+ *     <Route path="create"    element={<Create />} />
+ *   </Route>
+ */
+function buildDataMngtChildren(): Record<string, RouteEntry> {
+  const children: Record<string, RouteEntry> = {};
+
+  for (const res of generatedResources) {
+    if (SYSTEM_RESOURCE_NAMES.has(res.name)) continue;
+
+    // generated/resources stores components in meta.components
+    const { list: ListComp, show: ShowComp, edit: EditComp, create: CreateComp } =
+      (res.meta as any).components ?? {};
+
+    if (!ListComp) continue;
+
+    // Derive the URL slug from the PascalCase model name so it matches
+    // what seedDataMngtPages.ts writes into page.path.
+    const slug = toKebabCase(toPascalCase(res.name));
+
+    children[res.name] = {
+      path: slug,
+      // No component on the parent — React Router renders <Outlet /> so that
+      // the index / show / edit / create children can each occupy the full view.
+      children: {
+        list:   { path: "",          index: true, component: ListComp   as AnyComp },
+        show:   { path: "show/:id",               component: ShowComp   as AnyComp },
+        edit:   { path: "edit/:id",               component: EditComp   as AnyComp },
+        create: { path: "create",                 component: CreateComp as AnyComp },
+      },
+    };
+  }
+
+  return children;
+}
+
+// ─── Suspense wrapper ────────────────────────────────────────────────────────
+
+const S = ({ children }: { children: React.ReactNode }) => (
+  <Suspense fallback={<Spin size="large" />}>{children}</Suspense>
+);
+
+// ─── Route Registry ──────────────────────────────────────────────────────────
+
+export const routeRegistry: Record<string, RouteEntry> = {
+  // ── Administration ─────────────────────────────────────────────────────────
+  admin: {
+    path: "/admin",
+    children: {
+      permission: {
+        path: "permission",
+        children: {
+          // 菜单指引 — sortOrder 1020, code: admin.permission.readme
+          permission_readme: {
+            path: "readme",
+            component: lazy(() =>
+              import("routes/permission-readme").then((m) => ({
+                default: m.PermissionReadmePage,
+              })),
+            ),
+          },
+          // 用户管理 — sortOrder 1030, code: admin.permission.user
+          user: {
+            path: "user",
+            component: lazy(() =>
+              import("routes/user").then((m) => ({ default: m.UserListPage })),
+            ),
+          },
+          // 角色管理 — sortOrder 1040, code: admin.permission.role
+          role: {
+            path: "role-list",
+            component: lazy(() =>
+              import("routes/role").then((m) => ({
+                default: m.RoleManagementListPage,
+              })),
+            ),
+          },
+          // 页面管理 — sortOrder 1050, code: admin.permission.page
+          page: {
+            path: "page-list",
+            component: lazy(() =>
+              import("routes/page/list").then((m) => ({
+                default: m.PageManagementListPage,
+              })),
+            ),
+          },
+          // 资源管理 — sortOrder 1060, code: admin.permission.resource
+          resource: {
+            path: "resource-list",
+            component: lazy(() =>
+              import("routes/resource").then((m) => ({
+                default: m.ResourceManagementListPage,
+              })),
+            ),
+          },
+        },
+      },
+      dataMngt: {
+        path: "data-mngt",
+        children: buildDataMngtChildren(),
+      },
+      game: {
+        path: "game-list",
+        children: {
+          list:   { path: "",          index: true, component: lazy(() => import("routes/game").then((m) => ({ default: m.GameList   }))) },
+          show:   { path: "show/:id",               component: lazy(() => import("routes/game").then((m) => ({ default: m.GameShow   }))) },
+          edit:   { path: "edit/:id",               component: lazy(() => import("routes/game").then((m) => ({ default: m.GameEdit   }))) },
+          create: { path: "create",                 component: lazy(() => import("routes/game").then((m) => ({ default: m.GameCreate }))) },
+        },
+      },
+      // 操作日志 — sortOrder 1070, code: admin.audit
+      audits: {
+        path: "audit-log-list",
+        component: lazy(() =>
+          import("routes/audit").then((m) => ({ default: m.AuditLogPage })),
+        ),
+      },
+    },
+  },
+};
+
+// ─── Path Index (getRoutePath) ────────────────────────────────────────────────
+
+function buildPathIndex(
+  entries: Record<string, RouteEntry>,
+  parentPath = "",
+): Record<string, string> {
+  const result: Record<string, string> = {};
+  for (const [key, entry] of Object.entries(entries)) {
+    const fullPath = entry.path.startsWith("/")
+      ? entry.path
+      : entry.path === ""
+        ? parentPath
+        : entry.path.startsWith("?")
+          ? parentPath + entry.path
+          : parentPath + "/" + entry.path;
+    result[key] = fullPath;
+    if (entry.children) {
+      Object.assign(result, buildPathIndex(entry.children, fullPath.split("?")[0]));
+    }
+  }
+  return result;
+}
+
+const pathIndex = buildPathIndex(routeRegistry);
+
+export function getRoutePath(pageCode: string): string | null {
+  return pathIndex[pageCode] ?? null;
+}
+
+// ─── renderRoutes() ──────────────────────────────────────────────────────────
+
+function renderEntry(key: string, entry: RouteEntry): React.ReactElement | null {
+  let element: React.ReactNode | undefined;
+  if (entry.component) {
+    const Comp = entry.component;
+    element = (
+      <S>
+        <Comp />
+      </S>
+    );
+  } else if (entry.wrapper) {
+    const W = entry.wrapper;
+    element = (
+      <S>
+        <W>
+          <Outlet />
+        </W>
+      </S>
+    );
+  }
+
+  if (entry.index) {
+    return <Route key={key} index element={element ?? null} />;
+  }
+
+  const routePath = entry.path.split("?")[0];
+
+  const childRoutes = Object.entries(entry.children ?? {})
+    .map(([k, e]) => renderEntry(k, e))
+    .filter(Boolean);
+
+  // Sidebar-only: no element, no renderable children
+  if (!element && childRoutes.length === 0) return null;
+
+  return childRoutes.length > 0 ? (
+    <Route key={key} path={routePath} element={element ?? <Outlet />}>
+      {childRoutes}
+    </Route>
+  ) : (
+    <Route key={key} path={routePath} element={element!} />
+  );
+}
+
+// Memoized at module level — registry is static, routes never change
+const cachedRoutes: React.ReactElement[] = Object.entries(routeRegistry)
+  .map(([key, entry]) => renderEntry(key, entry))
+  .filter(Boolean) as React.ReactElement[];
+
+export function renderRoutes(): React.ReactElement[] {
+  return cachedRoutes;
+}

package/dist/lib/application/files/gadmin2-game-angle-demo/web/src/constants/layout.ts

@@ -0,0 +1,16 @@
+/** List / Create 页面顶层组件的内容区样式 */
+export const LIST_CONTENT_PROPS = {
+  style: { marginTop: "1rem" },
+} as const;
+
+/** Show 页面顶层组件的内容区样式 */
+export const SHOW_CONTENT_PROPS = {
+  style: {
+    backgroundColor: "#f5f5f5",
+    padding: 0,
+    marginTop: "1rem",
+  },
+  bodyStyle: {
+    padding: 0,
+  },
+} as const;

package/dist/lib/application/files/gadmin2-game-angle-demo/web/src/enums/audit-log.enum.ts

@@ -0,0 +1,13 @@
+export enum AuditLogActionEnum {
+  create = "create",
+  update = "update",
+  delete = "delete",
+  download = "download",
+}
+
+export const auditLogActionOptions = [
+  { label: "Create", value: AuditLogActionEnum.create },
+  { label: "Update", value: AuditLogActionEnum.update },
+  { label: "Delete", value: AuditLogActionEnum.delete },
+  { label: "Download", value: AuditLogActionEnum.download },
+];

package/dist/lib/application/files/gadmin2-game-angle-demo/web/src/enums/index.ts

@@ -0,0 +1 @@
+export * from "./audit-log.enum";

package/dist/lib/application/files/gadmin2-game-angle-demo/web/src/helpers/form.tsx

@@ -127,6 +127,7 @@ function getElement(
   const hidden = !!fieldProps.hidden;
   const readonly = !!fieldProps.readonly;
   const showOptions = fieldProps.options;
+  const tooltip = field.uiType?.tooltip;
   const itemProps = {
     label: t(
       `resources.${resourceName}.fields.${fieldName}`,
@@ -153,6 +154,7 @@ function getElement(
       ...(field.rules || []),
     ],
     hidden,
+    ...(tooltip && { tooltip }),
   };
   if (field.component) {
     element = <Form.Item {...itemProps}>{field.component}</Form.Item>;

package/dist/lib/application/files/gadmin2-game-angle-demo/web/src/helpers/login.ts

@@ -34,7 +34,7 @@ axiosInstance.interceptors.response.use(
       console.log("login expired");
       login();
       // 返回pending状态的promise，以免后续代码出错
-      return new Promise(() => {});
+      return new Promise(() => { });
     }
     let message = error.response?.data?.message;
     if (message) {
@@ -42,9 +42,8 @@ axiosInstance.interceptors.response.use(
         message = message.join(" AND ");
       } else if (typeof message === "string") {
         if (message.includes("Unique constraint")) {
-          message = `Unique constraint ${
-            message.split("Unique constraint")[1]
-          }`;
+          message = `Unique constraint ${message.split("Unique constraint")[1]
+            }`;
         } else {
           let strings = message.split(")");
           message = strings[strings.length - 1];
@@ -122,3 +121,22 @@ export function requestHeaders() {
   };
   return headers;
 }
+
+type LowercaseMethod = 'get' | 'delete' | 'head' | 'options' | 'post' | 'put' | 'patch';
+
+export async function customRequest<T>(
+  urlPath: string,
+  method: string,
+  params?: Record<string, any>
+) {
+  const url = `${apiUrl}/${urlPath}`;
+  const headers = {
+    "Content-Type": "application/json",
+    ...requestHeaders(),
+  };
+  const httpMethod = method.toLowerCase() as LowercaseMethod;
+  const axiosOptions = { headers };
+  const res = await axiosInstance[httpMethod](url, params, axiosOptions);
+  const { data } = res;
+  return data as T;
+}

package/dist/lib/application/files/gadmin2-game-angle-demo/web/src/hooks/useDynamicResources.tsx

@@ -0,0 +1,211 @@
+import { useMemo, useRef } from "react";
+import type { IResourceItem, ResourceProps } from "@refinedev/core";
+import {
+  DashboardOutlined,
+  SettingOutlined,
+} from "@ant-design/icons";
+import { getRoutePath } from "config/routeRegistry";
+import { useUserPageAccess } from "./useUserPageAccess";
+import generatedResources from "generated/resources";
+
+/**
+ * Dynamic Resources Hook for erp-backend/web
+ *
+ * Features:
+ * 1. Get user accessible page resources from backend (via useUserPageAccess)
+ * 2. Convert backend data to Refine's IResourceItem[] format
+ * 3. Auto-generate show/edit/create paths for all pages
+ *
+ * Data Flow:
+ * useUserPageAccess → Accessible Pages → Resources → Sider Menu
+ *
+ * Performance:
+ * - Uses module-level cache - computed ONCE per page load
+ * - Returns same reference on every call after initial computation
+ * - Does NOT rebuild on route navigation or component re-renders
+ * - Permission changes require page refresh (handled by user)
+ */
+
+// Module-level cache - computed once per page load
+let cachedResources: IResourceItem[] | null = null;
+let isComputing = false;
+
+// 将 snake_case 转换为 camelCase
+function snakeToCamel(str: string): string {
+  return str.replace(/_([a-z])/g, (_, letter) => letter.toUpperCase());
+}
+
+// Icon 映射：page.code 到 React Icon 组件
+export const iconMapping: Record<string, React.ReactNode> = {
+  dashboard: <DashboardOutlined />,
+  administration: <SettingOutlined />,
+};
+
+// Pages whose children are tabs (not separate menu items)
+const PAGES_WITH_TABS: string[] = [];
+
+export const useDynamicResources = (): IResourceItem[] => {
+  // Use shared page access data (single call, reused below)
+  const { accessiblePageIds, pagesData, pageMap, isLoading, roleNames } = useUserPageAccess();
+
+  // If we already have cached resources, return immediately
+  if (cachedResources !== null) {
+    return cachedResources;
+  }
+
+  // Return empty array while loading (will retry on next render)
+  if (isLoading || !pagesData || isComputing) {
+    return [];
+  }
+
+  // Mark as computing to prevent concurrent computation
+  isComputing = true;
+
+  if (import.meta.env.DEV) {
+    console.log('[useDynamicResources] 🔨 Computing resources (first time)');
+  }
+
+  // Filter accessible pages and build hierarchical sorted list
+  const accessiblePages = pagesData.filter(page => accessiblePageIds.has(page.id));
+
+  // Group pages by parentId
+  const pagesByParent = new Map<number | null, typeof accessiblePages>();
+  accessiblePages.forEach(page => {
+    const parentId = page.parentId ?? null;
+    if (!pagesByParent.has(parentId)) {
+      pagesByParent.set(parentId, []);
+    }
+    pagesByParent.get(parentId)!.push(page);
+  });
+
+  // Sort each group by sortOrder
+  pagesByParent.forEach(pages => {
+    pages.sort((a, b) => (a.sortOrder ?? Infinity) - (b.sortOrder ?? Infinity));
+  });
+
+  // Build sorted list using depth-first traversal
+  const sortedAccessiblePages: typeof accessiblePages = [];
+  const visited = new Set<number>();
+
+  const addPageWithChildren = (parentId: number | null) => {
+    const children = pagesByParent.get(parentId) || [];
+    children.forEach(page => {
+      if (visited.has(page.id)) return;
+      visited.add(page.id);
+      sortedAccessiblePages.push(page);
+      addPageWithChildren(page.id);
+    });
+  };
+
+  // Start from root level (parentId = null)
+  addPageWithChildren(null);
+
+  // Add any orphaned pages
+  accessiblePages.forEach(page => {
+    if (!visited.has(page.id)) {
+      sortedAccessiblePages.push(page);
+    }
+  });
+
+  // 检测哪些父页面有"index 子页面"（子页面路径与父页面相同，即 path: "" 的 index 路由）
+  // 这类父页面应作为纯分组节点（不注册 list 路径），否则 Refine 会优先选中父节点
+  // 导致 "全部" 等 index 子菜单项无法高亮
+  const parentIdsWithIndexChild = new Set<number>();
+  accessiblePages.forEach(childPage => {
+    if (!childPage.parentId) return;
+    const childPath = getRoutePath(childPage.code);
+    if (!childPath) return;
+    const parentPage = pageMap.get(childPage.parentId);
+    if (!parentPage) return;
+    const parentPath = getRoutePath(parentPage.code);
+    if (childPath === parentPath) {
+      parentIdsWithIndexChild.add(childPage.parentId);
+    }
+  });
+
+  // Build resources
+  const resultResources: IResourceItem[] = [];
+  const addedResourceNames = new Set<string>();
+
+  sortedAccessiblePages.forEach(page => {
+    if (!page) return;
+
+    // Skip virtual pages
+    if (page.isVirtual) return;
+
+    // Skip children of pages that use tabs
+    if (page.parentId) {
+      const parentPage = pageMap.get(page.parentId);
+      if (parentPage && PAGES_WITH_TABS.includes(parentPage.code)) {
+        return;
+      }
+    }
+
+    const permissionRes = snakeToCamel(page.code);
+
+    // Avoid duplicates
+    if (addedResourceNames.has(permissionRes)) return;
+
+    let parentPermissionRes: string | undefined;
+    if (page.parentId) {
+      const parentPage = pageMap.get(page.parentId);
+      if (parentPage) {
+        parentPermissionRes = snakeToCamel(parentPage.code);
+      }
+    }
+
+    // 优先从 routeRegistry 获取路径
+    // fallback 到 page.path（用于 gadmin2 页面）
+    const registryPath = getRoutePath(page.code);
+    const dbPath = page.path
+      ? page.path.startsWith("/") ? page.path : `/${page.path}`
+      : undefined;
+    const normalizedPath = registryPath ?? dbPath;
+
+    // 如果该页面是"有 index 子页面的父节点"，则不注册 list/show/edit/create
+    // 使其成为纯分组节点（SubMenu），子页面（如"全部"）的路径才负责 URL 匹配与菜单高亮
+    const isGroupParent = parentIdsWithIndexChild.has(page.id);
+
+    // Build resource item with auto-generated CRUD paths
+    // Store both zhLabel/enLabel in meta; Sider resolves at render time
+    const resource: IResourceItem = {
+      name: permissionRes,
+      ...(!isGroupParent && normalizedPath && {
+        list: normalizedPath,
+        show: `${normalizedPath}/show/:id`,
+        edit: `${normalizedPath}/edit/:id`,
+        create: `${normalizedPath}/create`,
+      }),
+      meta: {
+        label: page.enName || page.code,
+        zhLabel: page.zhName || page.code,
+        enLabel: page.enName || page.code,
+        icon: iconMapping[page.code] || "",
+        parent: parentPermissionRes,
+        route: normalizedPath,
+        pageCode: page.code,
+        parentPageCode: page.parentId
+          ? pageMap.get(page.parentId)?.code
+          : undefined,
+      },
+    };
+
+    resultResources.push(resource);
+    addedResourceNames.add(permissionRes);
+  });
+
+  // Build final resources array with auto-crud if needed
+  const dynamicResources = resultResources;
+  const allResources = dynamicResources;
+
+  // Cache the result - will be used for all subsequent calls
+  cachedResources = allResources;
+  isComputing = false;
+
+  if (import.meta.env.DEV) {
+    console.log('[useDynamicResources] ✅ Resources cached. Count:', cachedResources.length);
+    console.log('[useDynamicResources] 📌 This reference will be reused for all future calls');
+  }
+
+  return cachedResources;
+};

package/dist/lib/application/files/gadmin2-game-angle-demo/web/src/hooks/useFetchData.ts

@@ -0,0 +1,33 @@
+import { useEffect, useState } from "react";
+
+import { customRequest } from "helpers/login";
+
+export const useFetchData = (
+  url: string,
+  type: "post" | "get",
+  defaultQuery?: any,
+  disableReq?: any,
+  errorCallBack?: () => void
+) => {
+  const [data, setData] = useState<any>();
+  const [reqQuery, setReqQuery] = useState<any>(defaultQuery);
+  const [loading, setLoading] = useState<boolean>(false);
+  const fetchData = async (query?: any) => {
+    if (!url) return;
+    setLoading(true);
+    try {
+      const res = await customRequest(url, type, query);
+      setData(res);
+      setReqQuery(query);
+    } catch (error) {
+      console.error(error);
+      errorCallBack && errorCallBack();
+    }
+    setLoading(false);
+  };
+
+  useEffect(() => {
+    !disableReq && url && fetchData(defaultQuery);
+  }, []);
+  return { data, loading, fetchData, reqQuery };
+};