@jiangood/open-admin 1.0.0-beta.5

package/src/framework/utils/system/FormRegistryUtils.ts

@@ -0,0 +1,77 @@
+import * as React from 'react';
+
+/**
+ * 💡 类型定义同上
+ */
+type FormComponent = React.ComponentType<any>;
+
+/**
+ * 🛠️ FormRegistryUtils
+ * 一个静态工具类，用于注册、获取和管理表单组件。
+ * 调用时无需实例化，直接使用 FormRegistryUtils.methodName()。
+ */
+export class FormRegistryUtils {
+  // 静态私有属性：存储表单组件的 Map
+  private static forms: Map<string, FormComponent> = new Map<string, FormComponent>();
+
+  /**
+   * 注意：
+   * 1. 私有构造函数可以防止该类被外部实例化（可选，但推荐用于纯静态类）。
+   * 2. 如果不定义构造函数，TypeScript 默认允许实例化，但因为所有成员都是静态的，实例化没有意义。
+   */
+  private constructor() {
+    // 阻止外部实例化
+  }
+
+  /**
+   * 静态方法：注册表单组件
+   * @param formKey - 表单唯一标识
+   * @param formComponent - React 表单组件
+   */
+  public static register(formKey: string, formComponent: FormComponent): void {
+    if (!formKey || !formComponent) {
+      throw new Error("【FormRegistryUtils】表单 Key 和组件不能为空！");
+    }
+
+    // 访问静态属性需要使用 'FormRegistryUtils.'
+    if (FormRegistryUtils.forms.has(formKey)) {
+      console.warn(`⚠️ 【FormRegistryUtils】表单 "${formKey}" 已存在，将被覆盖！`);
+    }
+
+    FormRegistryUtils.forms.set(formKey, formComponent);
+    console.log(`✅ 【FormRegistryUtils】表单 "${formKey}" 注册成功`);
+  }
+
+  /**
+   * 静态方法：获取表单组件
+   * @param formKey - 表单唯一标识
+   * @returns React 表单组件，如果不存在则返回 null
+   */
+  public static get(formKey: string): FormComponent | null {
+    const formComponent = FormRegistryUtils.forms.get(formKey);
+
+    if (!formComponent) {
+      console.warn(`⚠️ 【FormRegistryUtils】表单 "${formKey}" 未注册！`);
+    }
+
+    return formComponent ?? null;
+  }
+
+  /**
+   * 静态方法：检查表单是否已注册
+   * @param formKey - 表单唯一标识
+   * @returns boolean
+   */
+  public static has(formKey: string): boolean {
+    return FormRegistryUtils.forms.has(formKey);
+  }
+
+  /**
+   * 静态方法：获取所有已注册的表单 Key
+   * @returns string[] - 所有表单 Key 的数组
+   */
+  public static getAllKeys(): string[] {
+    return Array.from(FormRegistryUtils.forms.keys());
+  }
+}
+

package/src/framework/utils/system/HttpUtils.ts

@@ -0,0 +1,247 @@
+import axios, {AxiosRequestConfig, AxiosResponse, Method} from "axios";
+import { Modal} from "antd";
+import qs from 'qs';
+import {PageUtils} from "./PageUtils";
+import {MessageUtils} from "../MessageUtils";
+
+
+const axiosInstance = axios.create({
+    withCredentials: true,
+    headers: {
+        'Content-Type': 'application/json'
+    },
+    // 解决get请求时，数组参数的问题
+    paramsSerializer: (params) => {
+        return qs.stringify(params, {indices: false});
+    }
+})
+
+
+/**
+ * @description HTTP请求工具类
+ */
+export class HttpUtils {
+
+
+    /**
+     * 核心请求函数，处理请求发送、加载状态、响应解析和错误捕获
+     * @param config AxiosRequestConfig & RequestOptions
+     * @param transformData 是否返回最总的data字段
+     * @returns Promise<any>
+     */
+    // ... existing code ...
+    private static coreRequest(config: AxiosRequestConfig, transformData: boolean = true): Promise<any> {
+        const url = config.url;
+        config.url = url.startsWith('admin') ? '/' + url : url;
+
+        return new Promise((resolve, reject) => {
+            axios(config).then((response: AxiosResponse) => {
+                const body = response.data;
+                // 假设后端响应结构为 { success: boolean | null, message: string, data: any, code: number }
+                let {success, message, data} = body;
+                if (success == undefined) { // 如果没有success字段，说明非标准接口
+                    resolve(response);
+                    return ;
+                }
+
+                if (!success) {
+                    MessageUtils.error(message || '操作失败');
+                    reject('操作失败');
+                    return
+                }
+
+                // 自动消息提示
+                if (message) {
+                    MessageUtils.success(message);
+                }
+                resolve(transformData ? data : response);
+            }).catch((e: unknown) => {
+                // 统一异常处理
+                let msg = '操作失败';
+
+                if (axios.isAxiosError(e)) {
+                    const status = e.response?.status;
+                    const responseData = e.response?.data;
+
+                    if (status === 401) {
+                        // 登录过期处理
+                        MessageUtils.confirm('登录已过期，请重新登录').then(() => {
+                            PageUtils.redirectToLogin();
+                        });
+                        // 阻止后续的错误提示，返回一个特殊 Promise.reject
+                         reject('登录过期');
+                        return
+                    }
+                    if (status === 504) {
+                        msg = '504 请求后端服务失败';
+                    } else if (responseData && responseData.message) {
+                        msg = responseData.message;
+                    } else if (e.message) {
+                        msg = e.message;
+                    }
+                } else if (e instanceof Error) {
+                    // 可能是后端success=false抛出的自定义错误
+                    msg = e.message;
+                }
+
+                MessageUtils.error(msg);
+
+                // 将原始错误或处理后的错误信息向外抛出
+                reject(e);
+            });
+        })
+
+    }
+
+
+    /**
+     * 处理文件下载后的blob流
+     * @param res AxiosResponse 文件下载响应
+     */
+    private static handleDownloadBlob(res: AxiosResponse): Promise<void> {
+        return new Promise((resolve, reject) => {
+            const {data: blob, headers} = res;
+
+            // 1. 检查是否为错误JSON
+            if (blob.type === 'application/json') {
+                const reader = new FileReader();
+                reader.readAsText(blob, 'utf-8');
+                reader.onload = function () {
+                    try {
+                        let rs = JSON.parse(reader.result as string);
+                        Modal.error({
+                            title: '下载文件失败',
+                            content: rs.message || '不支持下载'
+                        });
+                        reject(new Error(rs.message || '下载错误'));
+                    } catch (e) {
+                        Modal.error({title: '下载文件失败', content: '解析错误响应失败'});
+                        reject(e);
+                    }
+                };
+                return;
+            }
+
+            // 2. 获取文件名称
+            const contentDisposition = headers['content-disposition'] || headers['Content-Disposition'];
+            if (!contentDisposition) {
+                Modal.error({title: '获取文件名称失败', content: "缺少Content-Disposition响应头"});
+                reject(new Error("缺少Content-Disposition响应头"));
+                return;
+            }
+
+            const match = /filename\*?=(?:['"]?)(?:UTF-8''|)(.+?)(?:['"]?$|;)/i.exec(contentDisposition);
+            let filename = match && match[1] ? match[1].trim() : 'download.file';
+
+            try {
+                // 尝试进行URI解码
+                filename = decodeURIComponent(filename.replace(/"/g, ''));
+            } catch (e) {
+                // 如果解码失败，保持原样
+                filename = filename.replace(/"/g, '');
+            }
+
+            // 3. 开始下载
+            const url = window.URL.createObjectURL(new Blob([blob]));
+            const link = document.createElement('a');
+            link.style.display = 'none';
+
+            link.href = url;
+            link.download = filename;
+
+            document.body.appendChild(link);
+            link.click();
+
+            document.body.removeChild(link);
+            window.URL.revokeObjectURL(url);
+            resolve();
+        });
+    }
+
+
+    /**
+     * 发送GET请求
+     * @param url 请求地址
+     * @param params URL参数
+     * @param options 自定义配置 (transformData等)
+     * @returns Promise<any> 后端返回的 data 字段
+     */
+    public static get(url: string, params: any = null, options: Partial<AxiosRequestConfig> = {}): Promise<any> {
+        return HttpUtils.coreRequest({
+            ...options,
+            url,
+            method: 'GET',
+            params,
+        });
+    }
+
+    /**
+     * 发送POST请求 (Content-Type: application/json)
+     * @param url 请求地址
+     * @param data 请求体数据
+     * @param params URL参数
+     * @param options 自定义配置
+     * @returns Promise<any> 后端返回的 data 字段
+     */
+    public static post(url: string, data: any = null, params: any = null, options: Partial<RequestOptions> = {}): Promise<any> {
+        return HttpUtils.coreRequest({
+            ...options,
+            url,
+            method: 'POST',
+            data,
+            params,
+        });
+    }
+
+    /**
+     * 发送POST表单请求 (Content-Type: application/x-www-form-urlencoded)
+     * @param url 请求地址
+     * @param data 表单数据
+     * @param options 自定义配置
+     * @returns Promise<any> 后端返回的 data 字段
+     */
+    public static postForm(url: string, data: any, options: Partial<AxiosRequestConfig> = {}): Promise<any> {
+        return HttpUtils.coreRequest({
+            ...options,
+            url,
+            method: 'POST',
+            data: qs.stringify(data), // 转换为表单格式
+            headers: {
+                'Content-Type': 'application/x-www-form-urlencoded'
+            },
+        });
+    }
+
+    /**
+     * 下载文件
+     * @param url 请求地址
+     * @param data 请求体数据 (POST时使用)
+     * @param params URL参数
+     * @param method 请求方法，默认为GET
+     * @param options 自定义配置
+     * @returns Promise<void>
+     */
+    public static async downloadFile(url: string, data: any = null, params: any = null, method: Method = 'GET', options: Partial<AxiosRequestConfig> = {}): Promise<void> {
+
+        // 下载请求默认设置：不转换数据，响应类型为 blob
+        const downloadConfig: AxiosRequestConfig = {
+            responseType: 'blob', // 关键设置
+            ...options,
+            url,
+            method,
+            params,
+            data,
+        };
+
+        try {
+            // coreRequest返回的是完整的 AxiosResponse，因此需要类型断言
+            const response = await HttpUtils.coreRequest(downloadConfig, false) as AxiosResponse;
+            await HttpUtils.handleDownloadBlob(response);
+        } catch (error) {
+            // coreRequest已经处理了401、504和通用的错误提示
+            return Promise.reject(error);
+        }
+    }
+
+
+}

package/src/framework/utils/system/PageUtils.ts

@@ -0,0 +1,163 @@
+import {history} from "umi";
+import {StringUtils} from "../StringUtils";
+import {UrlUtils} from "../UrlUtils";
+import {MessageUtils} from "../MessageUtils";
+
+/**
+ * 页面相关的工具类，主要用于路由、URL参数和页面跳转操作。
+ */
+export class PageUtils {
+
+    /**
+     * 重定向到登录页，并携带当前页面的URL作为回跳参数。
+     */
+    static redirectToLogin(): void {
+        const url = PageUtils.currentUrl();
+        // 对URL进行编码，确保参数安全传递
+        const encodedUrl = encodeURIComponent(url);
+        history.push(`/login?redirect=${encodedUrl}`);
+    }
+
+    /**
+     * @deprecated 请使用 currentParams() 代替。
+     * 获取当前 URL 的查询参数对象。
+     * @returns {Record<string, string | undefined>} 包含查询参数的键值对对象。
+     */
+    static currentLocationQuery(): Record<string, string | undefined> {
+        return this.currentParams();
+    }
+
+    /**
+     * 获取当前 URL 的查询参数对象。
+     * @returns {Record<string, string | undefined>} 包含查询参数的键值对对象。
+     */
+    static currentParams(): Record<string, string | undefined> {
+        const url = window.location.href;
+
+        // 检查是否存在查询参数
+        const hasQuery = url.indexOf('?') > 0;
+        if (!hasQuery) {
+            return {};
+        }
+
+        // 提取问号后面的查询字符串
+        const search = url.substring(url.indexOf('?') + 1);
+        const kvs = search.split('&');
+
+        const rs: Record<string, string | undefined> = {};
+        for (const kv of kvs) {
+            const kvArr = kv.split('=');
+            const k = kvArr[0];
+            let v = kvArr[1];
+
+            // 值存在时才进行解码
+            if (v) {
+                // 使用 decodeURIComponent 更安全地处理 URL 编码的值
+                try {
+                    v = decodeURIComponent(v);
+                } catch (e) {
+                    console.error("Failed to decode URL parameter value:", v, e);
+                    // 解码失败时保留原值
+                }
+            } else {
+                v = undefined; // 如果值为空，设置为 undefined
+            }
+            rs[k] = v;
+        }
+
+        return rs;
+    }
+
+    /**
+     * 获取当前 URL 的路径名（不带查询参数和 Hash 符号 #）。
+     * 例如："http://localhost:8000/#/login?id=1" -> "/login"
+     * @returns {string} 不带参的路径。
+     */
+    static currentPathname(): string {
+        // window.location.hash.substring(1) 得到 "/login?id=1"
+        const path = window.location.hash.substring(1);
+        return StringUtils.subBefore(path, '?');
+    }
+
+    /**
+     * @deprecated 请使用 currentUrl() 代替。
+     * 获取 hash 后的完整路径 (带参数)。
+     * @returns {string} 例如："/login?id=1"
+     */
+    static currentPath(): string {
+        // window.location.hash.substring(1) 得到 "/login?id=1"
+        return window.location.hash.substring(1);
+    }
+
+    /**
+     * 获取 hash 后的完整路径 (带参数)。
+     * @returns {string} 例如："/login?id=1"
+     */
+    static currentUrl(): string {
+        return window.location.hash.substring(1);
+    }
+
+    /**
+     * 当前路由的最后一个斜杠后面的单词，通常用于基于路径的路由。
+     * 例如："/user/detail/123" -> "123"
+     * @returns {string | undefined} 路径的最后一部分或 undefined。
+     */
+    static currentPathnameLastPart(): string | undefined {
+        const path = this.currentPathname();
+        return StringUtils.subAfterLast(path, '/') || undefined;
+    }
+
+    /**
+     * 打开一个新页面，可选择添加一个 '_label' 参数。
+     * @param path 要跳转的路径。
+     * @param label 可选，用于在 URL 中添加一个 '_label' 参数。
+     */
+    static open(path: string, label: string = '临时'): void {
+        let targetPath = path;
+        if (label) {
+            // 假设 UrlUtil.setParam(url, key, value) 存在并返回设置参数后的 URL
+            targetPath = UrlUtils.setParam(targetPath, '_label', label);
+        }
+        history.push(targetPath);
+    }
+
+
+    /**
+     * 打开一个不带菜单、Header 等布局元素的页面。
+     * 通过在 URL 中添加 '_noLayout=true' 参数实现。
+     * @param path 要跳转的路径。
+     */
+    static openNoLayout(path: string): void {
+        // 假设 UrlUtil.setParam(url, key, value) 存在
+        const targetPath = UrlUtils.setParam(path, '_noLayout', true);
+        history.push(targetPath);
+    }
+
+    /**
+     * 获取当前 URL 参数中名为 '_label' 的值。
+     * @returns {string | undefined} '_label' 参数的值。
+     */
+    static currentLabel(): string | undefined {
+        // currentParams 返回 Record<string, string | undefined>
+        return this.currentParams()['_label'];
+    }
+
+    /**
+     * 发送一个自定义事件来关闭当前页面。
+     * 依赖外部监听 'close-page-event' 事件的处理机制。
+     */
+    static closeCurrent() {
+        const event = new CustomEvent<{ url: string }>('close-page-event', {
+            detail: {url: PageUtils.currentUrl()}
+        });
+        document.dispatchEvent(event);
+    }
+
+    static closeCurrentAndOpenPage(alertMessage:string,path:string,label:string){
+        MessageUtils.alert(alertMessage).then(()=>{
+            this.closeCurrent()
+            this.open(path,label)
+        })
+    }
+
+}

package/src/framework/utils/system/PermUtils.ts

@@ -0,0 +1,79 @@
+import {SysUtils} from "./SysUtils";
+import {ArrUtils} from "../ArrUtils";
+
+/**
+ * 登录用户信息接口，
+ */
+interface LoginInfo {
+  // ... 其他登录信息字段
+  permissions: string[];
+}
+
+/**
+ * 权限控制工具类
+ */
+export class PermUtils {
+
+  /**
+   * 获取当前用户的权限列表信息。
+   * @private
+   * @returns {string[]} 权限码数组。
+   */
+  private static getPermissions(): string[] {
+    // 假设 SysUtil.getLoginInfo() 返回 LoginInfo 类型的对象
+    const info: LoginInfo = SysUtils.getLoginInfo();
+    const { permissions } = info;
+
+    if (permissions == null || permissions.length === 0) {
+      return [];
+    }
+
+    return permissions;
+  }
+
+  /**
+   * 是否拥有权限
+   * * @param perm 权限码 (string)
+   * @returns {boolean} 如果拥有权限则为 true，否则为 false。
+   */
+  public static hasPermission(perm: string | null | undefined): boolean {
+    if (perm === null || perm === undefined || perm === '') {
+      return false;
+    }
+
+    const permissions: string[] = PermUtils.getPermissions();
+
+    if (permissions.length === 0) {
+      return false;
+    }
+
+    // 检查是否拥有超级权限 '*'
+    // 假设 ArrUtils.contains(array, item) 存在且返回 boolean
+    if (ArrUtils.contains(permissions, "*")) {
+      return true;
+    }
+
+    // 检查是否包含指定的权限码
+    return permissions.indexOf(perm) > -1;
+  }
+
+  /**
+   * 是否授权，功能上与 hasPermission 相同。
+   * * @param p 权限码 (string)
+   * @returns {boolean} 如果拥有权限则为 true，否则为 false。
+   */
+  public static isPermitted(p: string | null | undefined): boolean {
+    // 直接调用内部方法
+    return PermUtils.hasPermission(p);
+  }
+
+  /**
+   * 是否没有权限。
+   * * @param p 权限码 (string)
+   * @returns {boolean} 如果没有权限则为 true，否则为 false。
+   */
+  public static notPermitted(p: string | null | undefined): boolean {
+    // 使用!取反，并确保方法返回布尔值
+    return !PermUtils.isPermitted(p);
+  }
+}

package/src/framework/utils/system/SysUtils.ts

@@ -0,0 +1,97 @@
+
+// --- 常量定义 ---
+import {StorageUtils} from "../StorageUtils";
+
+const SITE_INFO_KEY = "siteInfo";
+const LOGIN_INFO_KEY = "loginInfo";
+const DICT_INFO_KEY = "dictInfo";
+
+// 假设 SiteInfo, LoginInfo, DictInfo 是工具类操作的数据结构。
+// 请根据你的实际情况替换为正确的接口或类型。
+interface SiteInfo {
+    // 示例属性
+    name: string;
+    version: string;
+}
+
+interface LoginInfo {
+    // 示例属性
+    token: string;
+    userId: number;
+}
+
+// 字典数据通常是键值对或数组，这里假设是 Record<string, any>
+type DictInfo = Record<string, any> | null;
+
+/**
+ * 系统工具类 (Utils Pattern)
+ */
+export class SysUtils {
+
+    /**
+     * 获取请求头信息。
+     * @returns 一个包含请求头键值对的对象。
+     */
+    public static getHeaders(): Record<string, string> {
+        const headers: Record<string, string> = {};
+        // 实际的 headers 逻辑（如添加认证 token 等）应在此处实现
+        return headers;
+    }
+
+    /**
+     * 设置站点信息。
+     * @param data 要存储的站点信息数据。
+     * @returns StorageUtil.set 的返回值 (通常是 void 或 Promise<void>)
+     */
+    public static setSiteInfo(data: SiteInfo): void {
+        // 假设 StorageUtil.set 返回 void
+        // 请根据实际 StorageUtil 的实现调整返回值类型
+        StorageUtils.set(SITE_INFO_KEY, data);
+    }
+
+    /**
+     * 获取站点信息。
+     * @returns 站点信息对象，如果不存在则返回一个空对象。
+     */
+    public static getSiteInfo(): SiteInfo {
+        // 假设 StorageUtil.getDefinition 内部处理了 JSON.parse，并返回对应类型或 null
+        return StorageUtils.get(SITE_INFO_KEY) || {} as SiteInfo;
+    }
+
+    /**
+     * 设置登录信息。
+     * @param data 要存储的登录信息数据。
+     */
+    public static setLoginInfo(data: LoginInfo): void {
+        StorageUtils.set(LOGIN_INFO_KEY, data);
+    }
+
+    /**
+     * 获取登录信息。
+     * @returns 登录信息对象，如果不存在则返回一个空对象。
+     */
+    public static getLoginInfo(): LoginInfo {
+        return StorageUtils.get(LOGIN_INFO_KEY) || {} as LoginInfo;
+    }
+
+    /**
+     * 设置字典信息。
+     * @param data 要存储的字典信息数据。
+     */
+    public static setDictInfo(data: DictInfo): void {
+        StorageUtils.set(DICT_INFO_KEY, data);
+    }
+
+    /**
+     * 获取字典信息。
+     * @returns 字典信息对象，如果不存在则返回 null。
+     */
+    public static getDictInfo(): DictInfo {
+        return StorageUtils.get(DICT_INFO_KEY);
+    }
+}
+
+// 导出常量（保持不变，但通常将常量放在类内部作为 static readonly 属性更符合 class 模式，
+// 不过为了兼容性，我先保留外部导出，同时建议在类中使用常量）
+
+export { SITE_INFO_KEY, LOGIN_INFO_KEY, DICT_INFO_KEY };

package/src/framework/utils/system/ThemeUtils.ts

@@ -0,0 +1,27 @@
+/**
+ * 主题相关的工具类
+ */
+export class ThemeUtils {
+    // 使用 readonly 属性来定义主题常量，保持其不可变性
+    public static readonly theme = {
+        "primary-color": "#1961AC",
+        "success-color": "#52c41a",
+        "warning-color": "#faad14",
+        "error-color": "#ff4d4f",
+        "background-color": "#f5f5f5",
+
+        "primary-color-hover": "#4990CD",
+        "primary-color-click": "#124B93"
+    };
+
+    /**
+     * @description 可选：提供一个获取主题颜色的静态方法，增强工具类的可用性
+     * @param key 主题颜色键名
+     * @returns 对应的颜色值，如果键名不存在则返回undefined
+     */
+    public static getColor(key: keyof typeof ThemeUtils.theme): string | undefined {
+        return ThemeUtils.theme[key];
+    }
+}
+
+

package/src/framework/utils/system/index.ts

@@ -0,0 +1,7 @@
+export * from './DictUtils'
+export * from './PermUtils'
+export * from './PageUtils'
+export * from "./SysUtils"
+export * from './HttpUtils'
+export * from './FormRegistryUtils'
+export * from './ThemeUtils'