@gadmin2n/schematics 0.0.55

package/dist/lib/application/files/gadmin2-game-angle-demo/web/src/components/agentPanel/skills.ts

@@ -0,0 +1,464 @@
+/**
+ * Gadmin2 Skills Metadata
+ * Generated from gadmin2-llm-coding-plugin/skills/
+ */
+
+export interface SubSkill {
+  id: string;
+  name: string;
+  description: string;
+}
+
+export interface Skill {
+  id: string;
+  name: string;
+  description: string;
+  category: 'page' | 'project';
+  /** Page types this skill applies to */
+  pageTypes?: ('list' | 'create' | 'edit' | 'show')[];
+  /** Sub-skills (references) */
+  subSkills?: SubSkill[];
+}
+
+export const skills: Skill[] = [
+  // ==================== 页面级技能 ====================
+
+  // 列表页定制
+  {
+    id: 'list-customization',
+    name: '列表页定制',
+    description:
+      '定制 Gadmin2 列表页 (web/src/pages/{model}/list.tsx)。适用场景：添加永久筛选器、自定义表格列、添加行操作、自定义导入/导出、添加批量操作、渲染 JSON 字段、转换为树形结构、添加外部链接、创建自定义页面（仪表盘、统计）、应用设计模式、添加弹窗调用 API、筛选关联选择器选项、搜索时重置分页、跨资源查询，或修改列表页行为。',
+    category: 'page',
+    pageTypes: ['list'],
+    subSkills: [
+      {
+        id: 'permanent-filter',
+        name: '添加永久数据筛选器',
+        description: '基于 Context 值（如 gameId）为列表页添加永久筛选器。',
+      },
+      {
+        id: 'filter-transform',
+        name: '筛选值类型转换',
+        description: '将筛选值从字符串转换为数字，以兼容 Prisma。',
+      },
+      {
+        id: 'relation-select-filter',
+        name: '自定义关联选择器筛选',
+        description: '根据当前上下文，用筛选后的数据覆盖默认的关联选择器选项。',
+      },
+      {
+        id: 'search-reset-pagination',
+        name: '搜索时重置分页',
+        description: '执行搜索筛选时，将表格分页重置到第一页。',
+      },
+      {
+        id: 'export-customization',
+        name: '自定义 CSV 导出',
+        description: '自定义导出 CSV 的字段名称、顺序和值格式化。',
+      },
+      {
+        id: 'import-customization',
+        name: '自定义 CSV 导入（含错误弹窗）',
+        description: '自定义导入字段映射，并为导入失败显示错误弹窗。',
+      },
+      {
+        id: 'batch-modify-modal',
+        name: '添加批量修改弹窗',
+        description: '添加弹窗，批量修改选中行的某个字段。',
+      },
+      {
+        id: 'batch-delete-promise',
+        name: '自定义批量删除（Promise 循环）',
+        description: '用 Promise 循环替代默认批量删除，提供详细反馈。',
+      },
+      {
+        id: 'column-render',
+        name: '自定义表格列渲染',
+        description: '使用 TagField、BooleanField、颜色、图标等自定义列显示。',
+      },
+      {
+        id: 'json-badge-render',
+        name: '将 JSON 字段渲染为 Badge 状态',
+        description: '解析 JSON 字符串并渲染为带状态指示器的 Badge。',
+      },
+      {
+        id: 'row-action-link',
+        name: '添加行操作跳转链接',
+        description: '在行操作中添加链接，跳转到带筛选条件的关联资源列表。',
+      },
+      {
+        id: 'row-action-external',
+        name: '添加外部系统链接',
+        description: '在行操作中添加外部系统链接（如云日志、监控）。',
+      },
+      {
+        id: 'row-action-modal-api',
+        name: '行操作弹窗调用 API',
+        description: '添加自定义行操作，打开弹窗并调用外部 API。',
+      },
+      {
+        id: 'custom-row-actions',
+        name: '通过配置添加自定义行操作',
+        description: '使用 rowActions 配置添加自定义行操作。',
+      },
+      {
+        id: 'tree-structure',
+        name: '扁平数据转树形结构',
+        description: '将层级数据显示为可展开的树形表格。',
+      },
+      {
+        id: 'extend-prisma-select',
+        name: '扩展 Prisma Select 字段',
+        description: '添加默认 select 中没有的额外查询字段。',
+      },
+      {
+        id: 'conditional-create-button',
+        name: '条件显示/隐藏创建按钮',
+        description: '仅在满足特定条件时显示 CreateButton。',
+      },
+      {
+        id: 'readonly-mode',
+        name: '简化为只读模式',
+        description: '移除创建/编辑/删除操作，仅保留查看功能。',
+      },
+      {
+        id: 'cross-resource-query',
+        name: '跨资源数据查询',
+        description: '通过名称或字段查询其他资源，获取 ID 用于 API 调用。',
+      },
+      {
+        id: 'custom-page',
+        name: '添加自定义页面',
+        description: '在模型目录中创建新的自定义页面（统计、仪表盘等）。',
+      },
+      {
+        id: 'design-patterns',
+        name: '定制化设计模式',
+        description: '组织自定义代码的常用 React 模式。',
+      },
+      {
+        id: 'column-visibility',
+        name: '列显示/隐藏控制',
+        description: '通过 UI Config 或自定义实现（含 localStorage 持久化）控制表格列的显示/隐藏。',
+      },
+      {
+        id: 'conditional-row-style',
+        name: '条件行样式',
+        description: '根据记录数据（如状态颜色、优先级指示器）为表格行应用条件样式。',
+      },
+      {
+        id: 'fixed-column',
+        name: '固定列',
+        description: '将表格列固定在左侧或右侧，支持水平滚动。',
+      },
+      {
+        id: 'inline-edit',
+        name: '行内编辑',
+        description: '启用表格单元格的行内编辑（Input、Select、Switch、点击编辑）。',
+      },
+    ],
+  },
+
+  // 表单页定制
+  {
+    id: 'form-customization',
+    name: '表单页定制',
+    description:
+      '定制 Gadmin2 创建/编辑表单页 (web/src/pages/{model}/create.tsx 和 edit.tsx)。适用场景：添加级联选择器、添加字段提示、添加自定义校验器、添加帮助提示、自定义表单组件、提交时转换表单数据、添加字段依赖（条件显示/隐藏字段）、添加业务隔离（studio_id）、创建单例表单（自动创建/编辑）、添加自动补全搜索、加载关联数据、添加外部帮助链接、添加保存后提示，或修改表单行为。',
+    category: 'page',
+    pageTypes: ['create', 'edit'],
+    subSkills: [
+      {
+        id: 'cascader-component',
+        name: '用级联选择器替换下拉框',
+        description: '使用 Cascader 进行层级选择（如 来源 -> 类型）。',
+      },
+      {
+        id: 'field-tooltip',
+        name: '为表单字段标签添加提示',
+        description: '在表单字段标签旁添加带 tooltip 的帮助图标。',
+      },
+      {
+        id: 'custom-validator',
+        name: '添加自定义表单校验器',
+        description: '添加自定义校验规则，如 cron 表达式、URL 格式等。',
+      },
+      {
+        id: 'help-alert',
+        name: '在表单上方添加帮助提示',
+        description: '在表单上方添加带说明的 Alert 组件。',
+      },
+      {
+        id: 'form-field-dependencies',
+        name: '添加表单字段依赖',
+        description: '根据其他字段的值显示/隐藏表单字段。',
+      },
+      {
+        id: 'form-data-transform',
+        name: '提交前转换数据',
+        description: '在发送到 API 之前转换表单值。',
+      },
+      {
+        id: 'business-isolation',
+        name: '业务隔离（多租户）',
+        description: '在表单提交时添加 studio_id 或 tenant_id 实现数据隔离。',
+      },
+      {
+        id: 'singleton-form',
+        name: '单例表单（动态创建/编辑）',
+        description: '根据已有记录自动判断是创建还是编辑。',
+      },
+      {
+        id: 'autocomplete-search',
+        name: '自动补全搜索',
+        description: '用 AutoComplete + Search 替换默认输入框，支持外部 API 查询。',
+      },
+      {
+        id: 'load-related-data',
+        name: '加载关联数据',
+        description: '从其他资源获取数据用于表单（选项、校验等）。',
+      },
+      {
+        id: 'external-help-links',
+        name: '外部帮助链接',
+        description: '在表单下方添加文档链接和帮助文本。',
+      },
+      {
+        id: 'post-save-alert',
+        name: '保存后提示与引导',
+        description: '保存成功后显示提示，引导用户进行下一步操作。',
+      },
+    ],
+  },
+
+  // 详情页定制
+  {
+    id: 'show-customization',
+    name: '详情页定制',
+    description:
+      '定制 Gadmin2 详情页 (web/src/pages/{model}/show.tsx)。适用场景：自定义字段显示、将 JSON 渲染为 Badge、添加自定义字段渲染、格式化字段值、简化为只读模式（移除编辑/删除按钮），或修改详情页布局。',
+    category: 'page',
+    pageTypes: ['show'],
+    subSkills: [
+      {
+        id: 'field-render',
+        name: '自定义字段显示',
+        description: '自定义详情页上字段的显示方式。',
+      },
+      {
+        id: 'json-field-render',
+        name: '将 JSON 字段渲染为结构化显示',
+        description: '解析并以合适的格式显示 JSON 字段。',
+      },
+      {
+        id: 'readonly-header',
+        name: '只读头部按钮',
+        description: '简化只读资源的详情页头部。',
+      },
+    ],
+  },
+
+  // ==================== 项目级技能 ====================
+
+  // 后端定制
+  {
+    id: 'backend-customization',
+    name: '后端定制',
+    description:
+      '定制 Gadmin2 NestJS 后端代码。适用场景：多数据库连接、级联创建/更新/删除、禁用/添加自定义接口、字段加密、API Key 认证、创建者权限检查、公开接口、强制分页、返回实体、聚合查询、Swagger 增强、业务状态机、乐观锁。适用于 server/src/modules/。',
+    category: 'project',
+    subSkills: [
+      {
+        id: 'multi-database',
+        name: '多数据库连接',
+        description: '使用 CustomPrismaService 连接多个数据库。',
+      },
+      {
+        id: 'cascade-create',
+        name: '级联创建',
+        description: '创建主记录时同时创建关联记录。',
+      },
+      {
+        id: 'cascade-update',
+        name: '级联更新',
+        description: '更新主记录时同时更新关联记录。',
+      },
+      {
+        id: 'cascade-delete',
+        name: '级联删除',
+        description: '删除主记录时同时删除关联记录。',
+      },
+      {
+        id: 'disable-endpoint',
+        name: '禁用接口',
+        description: '移除或禁用默认的 CRUD 接口。',
+      },
+      {
+        id: 'custom-endpoint',
+        name: '添加自定义接口',
+        description: '添加业务相关的 API 接口。',
+      },
+      {
+        id: 'field-encryption',
+        name: '字段加密',
+        description: '存储前对敏感字段进行加密。',
+      },
+      {
+        id: 'api-key-auth',
+        name: 'API Key 认证',
+        description: '除用户登录外，还支持通过 API Key 访问 API。',
+      },
+      {
+        id: 'owner-permission',
+        name: '创建者权限检查',
+        description: '仅允许创建者或管理员修改/删除记录。',
+      },
+      {
+        id: 'public-endpoint',
+        name: '公开接口（免认证）',
+        description: '使接口无需认证即可公开访问。',
+      },
+      {
+        id: 'force-pagination',
+        name: '强制分页参数',
+        description: '覆盖或修正分页参数。',
+      },
+      {
+        id: 'return-entity',
+        name: '返回实体而非计数',
+        description: '更新操作返回完整实体数据。',
+      },
+      {
+        id: 'aggregation-endpoint',
+        name: '聚合查询接口',
+        description: '添加 groupBy/aggregate 查询接口。',
+      },
+      {
+        id: 'swagger-enhancement',
+        name: 'Swagger 文档增强',
+        description: '添加包含示例的详细 API 文档。',
+      },
+      {
+        id: 'business-state-machine',
+        name: '业务状态机',
+        description: '基于状态变更触发操作。',
+      },
+      {
+        id: 'optimistic-lock',
+        name: '乐观锁',
+        description: '使用版本字段防止并发更新冲突。',
+      },
+    ],
+  },
+
+  // 国际化
+  {
+    id: 'i18n',
+    name: '国际化',
+    description:
+      '为 React 应用添加国际化（i18n）支持。适用场景：添加多语言支持、翻译菜单/资源、翻译页面内容标签/图例/提示、重构组件以支持 i18n、添加语言切换，或实现 react-i18next 翻译。',
+    category: 'project',
+    subSkills: [
+      {
+        id: 'menu-i18n',
+        name: '菜单国际化实现',
+        description: '在 Refine resources 配置中翻译菜单标签。',
+      },
+      {
+        id: 'page-i18n',
+        name: '图表/数据国际化实现',
+        description: '翻译图表图例、提示、系列名称、表格和表单标签。',
+      },
+    ],
+  },
+
+  // Prisma Schema
+  {
+    id: 'prisma-schema',
+    name: 'Prisma Schema 编写',
+    description:
+      '编写带 Gadmin2 注解的 Prisma schema。适用场景：定义模型、添加字段、创建/编辑 schema.prisma、使用 @FormItem（Select、Boolean、Text、JSON、Image 等）、@IgnoreAutoField、@IgnoreReactCode、@IgnoreNestCode、添加校验器（@Min、@Max、@Length、@IsByteLength、@IsEmail、@IsPhoneNumber）、添加索引（@@index、@@unique），或在 config/prisma/*.prisma 或 config/schema.prisma 文件中配置数据模型。',
+    category: 'project',
+  },
+
+  // UI 配置
+  {
+    id: 'ui-config',
+    name: 'UI 配置',
+    description:
+      '通过 config/ui.config.ts 配置 Gadmin2 UI。适用场景：配置表格列、设置表单字段、自定义列表/详情页、编辑 ui.config.ts、使用字段选择 glob 模式、配置表格操作、筛选器、排序器、批量操作、行操作，或表单联动。',
+    category: 'project',
+  },
+
+  // 使用指南
+  {
+    id: 'guide',
+    name: 'Gadmin2 使用指南',
+    description:
+      'Gadmin2 低代码管理面板生成器通用指南。适用场景：了解 gadmin2、如何使用 gadmin、创建管理面板、低代码工具、生成 CRUD、项目结构、快速开始流程、添加模型，或获取 Gadmin2 通用指导。',
+    category: 'project',
+  },
+];
+
+/**
+ * Get skills by category
+ */
+export function getSkillsByCategory(category: 'page' | 'project'): Skill[] {
+  return skills.filter((s) => s.category === category);
+}
+
+/**
+ * Get page skills filtered by current page type
+ */
+export function getPageSkills(
+  pageType?: 'list' | 'create' | 'edit' | 'show',
+): Skill[] {
+  const pageSkills = getSkillsByCategory('page');
+  if (!pageType) return pageSkills;
+  return pageSkills.filter((s) => s.pageTypes?.includes(pageType));
+}
+
+/**
+ * Get project-level skills
+ */
+export function getProjectSkills(): Skill[] {
+  return getSkillsByCategory('project');
+}
+
+/**
+ * Get all sub-skills from a skill
+ */
+export function getSubSkills(skillId: string): SubSkill[] {
+  const skill = skills.find((s) => s.id === skillId);
+  return skill?.subSkills || [];
+}
+
+/**
+ * Find a skill or sub-skill by ID
+ */
+export function findSkillById(id: string): Skill | SubSkill | undefined {
+  // First check main skills
+  const mainSkill = skills.find((s) => s.id === id);
+  if (mainSkill) return mainSkill;
+
+  // Then check sub-skills
+  for (const skill of skills) {
+    const subSkill = skill.subSkills?.find((sub) => sub.id === id);
+    if (subSkill) return subSkill;
+  }
+
+  return undefined;
+}
+
+/**
+ * Get parent skill ID for a sub-skill
+ */
+export function getParentSkillId(subSkillId: string): string | undefined {
+  for (const skill of skills) {
+    if (skill.subSkills?.some((sub) => sub.id === subSkillId)) {
+      return skill.id;
+    }
+  }
+  return undefined;
+}

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

@@ -0,0 +1,62 @@
+import React from "react";
+import { UseQueryResult } from "@tanstack/react-query";
+import {
+  List as AntdList,
+  Button,
+  Badge,
+  Typography,
+} from "antd";
+import { ILog, ILogData } from "@refinedev/core";
+import dayjs from "dayjs";
+
+const { Text } = Typography;
+
+interface EventListProps {
+  logQueryResult?: UseQueryResult<ILogData>;
+  showModal: () => void;
+  setSelectedLog: React.Dispatch<React.SetStateAction<ILog | undefined>>;
+  selectedLog: ILog | undefined;
+}
+
+export const EventList: React.FC<EventListProps> = ({
+  logQueryResult,
+  showModal,
+  setSelectedLog,
+  selectedLog,
+}) => {
+  return (
+    <AntdList
+      dataSource={logQueryResult?.data}
+      renderItem={(log: any) => {
+        const { creator, action, timestamp } = log;
+
+        return (
+          <AntdList.Item
+            style={{
+              alignItems: "flex-start",
+              padding: "8px 0px 8px 8px",
+            }}
+          >
+            <Button
+              type="text"
+              style={{
+                display: "flex",
+                flexDirection: "column",
+                height: "100%",
+              }}
+              onClick={() => {
+                showModal();
+                setSelectedLog(log);
+              }}
+            > 
+              <Badge color={selectedLog?.id === log.id ? "blue" : "gray"} text={`${action} by ${creator}`} />
+              <Text>
+                Date: {dayjs(timestamp).format("MM/DD/YYYY, hh:mm")}
+              </Text>
+            </Button>
+          </AntdList.Item>
+        );
+      }}
+    />
+  );
+};

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

@@ -0,0 +1,4 @@
+export * from "./logButton";
+export * from "./logList";
+export * from "./modalDiffViewer";
+export * from "./eventList";

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

@@ -0,0 +1,96 @@
+import React, { useState } from "react";
+import { useModal } from "@refinedev/antd";
+import { Button, ButtonProps, ModalProps, message } from "antd";
+import * as Icons from "@ant-design/icons";
+import {
+  useRouterContext,
+  useTranslate,
+  ResourceRouterParams,
+  BaseKey,
+  useLogList,
+  ILog,
+  ILogData,
+  useResource,
+} from "@refinedev/core";
+import { ReactDiffViewerProps } from "react-diff-viewer";
+import { ModalDiffViewer } from "../modalDiffViewer";
+
+export type LogButtonProps = ButtonProps & {
+  recordItemId?: BaseKey;
+  resourceName?: string;
+  hideText?: boolean;
+  reactDiffViewerProps?: ReactDiffViewerProps;
+  modalProps?: ModalProps;
+};
+
+export const LogButton: React.FC<LogButtonProps> = ({
+  resourceName: propResourceName,
+  recordItemId,
+  hideText = false,
+  onClick,
+  reactDiffViewerProps,
+  modalProps: propModalProps,
+  children,
+  ...rest
+}) => {
+  const [selectedLog, setSelectedLog] = useState<ILog>();
+
+  const translate = useTranslate();
+  const { modalProps, show } = useModal();
+  const [messageApi, contextHolder] = message.useMessage();
+
+  const { useParams } = useRouterContext();
+  const { id: idFromRoute, } =
+    useParams<ResourceRouterParams>();
+
+  const resourceWithRoute = useResource();
+
+  const resourceName = propResourceName ?? resourceWithRoute?.resource?.name ?? "";
+  const id = recordItemId ?? idFromRoute;
+
+  const logQueryResult = useLogList<ILogData>({
+    resource: resourceName,
+    meta: { id },
+    queryOptions: {
+      enabled: modalProps.open,
+      onSuccess: (result) => {
+        if (result?.length) {
+          setSelectedLog(result[0]);
+        } else {
+          messageApi.open({
+            type: "warning",
+            content: "There is no history.",
+          });
+        }
+      },
+    },
+  });
+
+  return (
+    <>
+      <Button
+        onClick={(e): void =>
+          onClick
+            ? onClick(e as React.MouseEvent<HTMLButtonElement, MouseEvent>)
+            : show()
+        }
+        icon={<Icons.HistoryOutlined />}
+        {...rest}
+      >
+        {!hideText && (children ?? translate("buttons.logs", "History"))}
+      </Button>
+      {selectedLog ? (
+        <ModalDiffViewer
+          modalProps={{ ...modalProps, ...propModalProps }}
+          showModal={show}
+          selectedLog={selectedLog}
+          setSelectedLog={setSelectedLog}
+          logQueryResult={logQueryResult}
+          reactDiffViewerProps={reactDiffViewerProps}
+        />
+      ) : (
+        <>{contextHolder}</>
+      )}
+    </>
+  );
+};

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

@@ -0,0 +1,73 @@
+import React, { useState } from "react";
+import { useModal } from "@refinedev/antd";
+import { Card, ModalProps } from "antd";
+import {
+  BaseKey,
+  ILog,
+  ILogData,
+  pickNotDeprecated,
+  ResourceRouterParams,
+  useLogList,
+  useResourceWithRoute,
+  useRouterContext,
+} from "@refinedev/core";
+import { ReactDiffViewerProps } from "react-diff-viewer";
+
+import { ModalDiffViewer } from "../modalDiffViewer";
+import { EventList } from "../eventList";
+
+export interface LogListProps {
+  recordItemId?: BaseKey;
+  reactDiffViewerProps?: ReactDiffViewerProps;
+  modalProps?: ModalProps;
+  resource?: string;
+}
+
+export const LogList: React.FC<LogListProps> = ({
+  recordItemId,
+  reactDiffViewerProps,
+  modalProps: propModalProps,
+  resource: propResourceName,
+}) => {
+  const [selectedLog, setSelectedLog] = useState<ILog>();
+
+  const { modalProps, show } = useModal();
+
+  const { useParams } = useRouterContext();
+  const { resource: routeResourceName, id: idFromRoute } =
+    useParams<ResourceRouterParams>();
+
+  const resourceWithRoute = useResourceWithRoute();
+  const resource = resourceWithRoute(routeResourceName);
+
+  const resourceName = propResourceName ?? resource.name;
+  const id = recordItemId ?? idFromRoute;
+
+  const logQueryResult = useLogList<ILogData>({
+    resource: resourceName,
+    meta: { id },
+    metaData: pickNotDeprecated(resource.meta, resource.options),
+  });
+
+  return (
+    <>
+      <Card loading={logQueryResult?.isLoading} bodyStyle={{ padding: 0 }}>
+        <EventList
+          logQueryResult={logQueryResult}
+          setSelectedLog={setSelectedLog}
+          showModal={show}
+          selectedLog={selectedLog}
+        />
+      </Card>
+        <ModalDiffViewer
+          modalProps={{ ...modalProps, ...propModalProps }}
+          showModal={show}
+          selectedLog={selectedLog}
+          setSelectedLog={setSelectedLog}
+          logQueryResult={logQueryResult}
+          reactDiffViewerProps={reactDiffViewerProps}
+        />
+      
+    </>
+  );
+};