@liujitcn/kratos-admin-core 0.0.1

package/dist/package/src/utils/passwordStrength.ts

@@ -0,0 +1,86 @@
+/** 密码强度等级。 */
+export type PasswordStrengthLevel = "empty" | "low" | "medium" | "high";
+
+/** 密码强度分析结果。 */
+export interface PasswordStrengthResult {
+  /** 命中的复杂度条件数量。 */
+  ruleScore: number;
+  /** 强度条得分。 */
+  strengthScore: number;
+  /** 强度等级。 */
+  level: PasswordStrengthLevel;
+  /** 强度文案。 */
+  text: string;
+  /** 是否达到允许提交的最高强度。 */
+  isValid: boolean;
+}
+
+/** 密码强度错误提示。 */
+export const PASSWORD_STRENGTH_ERROR_MESSAGE = "密码需同时包含大小写字母、数字、特殊字符，且长度不少于 8 位";
+
+/** 密码强度说明文案。 */
+export const PASSWORD_STRENGTH_TIP = "需同时包含大小写字母、数字、特殊字符，且长度不少于 8 位，达到最高强度后才可提交。";
+
+/**
+ * 计算密码强度结果，供表单展示和校验统一复用。
+ *
+ * @param password 当前密码
+ * @returns 密码强度分析结果
+ */
+export function getPasswordStrength(password?: string): PasswordStrengthResult {
+  if (!password) {
+    return {
+      ruleScore: 0,
+      strengthScore: 0,
+      level: "empty",
+      text: "未输入",
+      isValid: false
+    };
+  }
+
+  let ruleScore = 0;
+  if (password.length >= 8) ruleScore += 1;
+  if (/[a-z]/.test(password) && /[A-Z]/.test(password)) ruleScore += 1;
+  if (/\d/.test(password)) ruleScore += 1;
+  if (/[^A-Za-z0-9]/.test(password)) ruleScore += 1;
+
+  if (ruleScore >= 4) {
+    return {
+      ruleScore,
+      strengthScore: 3,
+      level: "high",
+      text: "高",
+      isValid: true
+    };
+  }
+  if (ruleScore === 3) {
+    return {
+      ruleScore,
+      strengthScore: 2,
+      level: "medium",
+      text: "中",
+      isValid: false
+    };
+  }
+  return {
+    ruleScore,
+    strengthScore: 1,
+    level: "low",
+    text: "低",
+    isValid: false
+  };
+}
+
+/**
+ * 校验密码是否达到最高强度，便于表单规则直接复用。
+ *
+ * @param password 当前密码
+ * @returns 校验结果
+ */
+export function validatePasswordStrengthValue(password?: string) {
+  const result = getPasswordStrength(password);
+  return {
+    valid: result.isValid,
+    message: result.isValid ? "" : PASSWORD_STRENGTH_ERROR_MESSAGE
+  };
+}

package/dist/package/src/utils/proTable.ts

@@ -0,0 +1,124 @@
+import type { ColumnProps, EnumProps, TypeProps } from "../components/ProTable/interface";
+import type { OptionBaseDictResponse_BaseDictItem } from "../rpc/system/admin/v1/base_dict";
+import { useDictStoreHook } from "../stores/modules/dict";
+import { isRef } from "vue";
+
+/** 字典值输出给表格枚举时的目标类型。 */
+type DictValueType = "number" | "string";
+/** 表格批量操作支持的主键类型。 */
+type SelectedId = string | number;
+
+/** 表格单元格支持的对齐方式。 */
+export type TableAlign = "left" | "center" | "right";
+
+/** 表格分页入参。 */
+type PageRequestParams = Record<string, any> & {
+  /** 当前页码。 */
+  page_num?: string | number;
+  /** 每页条数。 */
+  page_size?: string | number;
+};
+
+/** 归一化后的分页请求。 */
+type NormalizedPageRequest<T extends PageRequestParams> = T & {
+  /** 接口请求当前页码。 */
+  page_num: number;
+  /** 接口请求每页条数。 */
+  page_size: number;
+};
+
+/**
+ * 获取表格行的列值，支持点号分隔的多级字段。
+ */
+function getTableCellValue(row: Record<string, any>, prop: string) {
+  return prop.split(".").reduce((value, key) => (value == null ? undefined : value[key]), row as any);
+}
+
+/**
+ * 判断值是否为可用于数值对齐的 Number 类型。
+ */
+function isPureNumber(value: unknown) {
+  return typeof value === "number" && Number.isFinite(value);
+}
+
+/**
+ * 判断枚举是否来自数据表映射，远程函数和响应式选项都属于动态数据映射。
+ */
+function isDataTableEnum(enumValue: ColumnProps["enum"]) {
+  return typeof enumValue === "function" || isRef(enumValue);
+}
+
+/**
+ * 根据列语义和当前表格数据解析单元格对齐方式。
+ *
+ * 显式 align 始终优先；数据表映射按文本左对齐，字典、静态枚举及预置状态列居中，
+ * 金额列和纯数字列右对齐，其余内容左对齐。空表时会先按列语义返回默认值，
+ * 数据加载后由响应式表格重新解析。
+ */
+export function resolveTableColumnAlign(column: ColumnProps, rows: Record<string, any>[] = []): TableAlign {
+  if (column.align === "left" || column.align === "center" || column.align === "right") return column.align;
+
+  const centeredTypes: TypeProps[] = ["selection", "radio", "index", "expand", "sort"];
+  if (centeredTypes.includes(column.type as TypeProps)) return "center";
+  if (column.cellType === "actions" || column.cellType === "status" || column.cellType === "image") return "center";
+  if (column.cellType === "money") return "right";
+  if (column.dictCode || column.tag) return "center";
+  if (column.enum) return isDataTableEnum(column.enum) ? "left" : "center";
+
+  if (column.prop) {
+    const values = rows
+      .map(row => getTableCellValue(row, column.prop as string))
+      .filter(value => value !== undefined && value !== null && value !== "");
+    if (values.length && values.every(isPureNumber)) return "right";
+  }
+
+  return "left";
+}
+
+/**
+ * 按配置将字典值转换为表格枚举可识别的类型。
+ */
+function transformDictValue(dictItem: OptionBaseDictResponse_BaseDictItem, valueType: DictValueType) {
+  if (valueType === "number") return Number(dictItem.value);
+  return dictItem.value;
+}
+
+/**
+ * 将字典缓存转换为 ProTable 搜索枚举数据。
+ */
+export async function buildDictEnum(code: string, valueType: DictValueType = "number") {
+  const dictStore = useDictStoreHook();
+  const dictList = await dictStore.ensureDictionary(code);
+
+  const data: EnumProps[] = dictList.map(dictItem => ({
+    label: dictItem.label,
+    value: transformDictValue(dictItem, valueType),
+    tagType: dictItem.tag_type
+  }));
+
+  return { data };
+}
+
+/**
+ * 统一补齐分页请求参数，避免组件透传时出现字符串页码。
+ */
+export function buildPageRequest<T extends PageRequestParams>(params: T): NormalizedPageRequest<T> {
+  const pageNum = Number(params.page_num ?? 1);
+  const pageSize = Number(params.page_size ?? 10);
+  return {
+    ...params,
+    page_num: pageNum,
+    page_size: pageSize
+  } as NormalizedPageRequest<T>;
+}
+
+/**
+ * 统一整理表格多选和单条操作产生的 ID 集合。
+ */
+export function normalizeSelectedIds(selected?: SelectedId | SelectedId[]) {
+  if (Array.isArray(selected)) {
+    return selected.filter(item => item !== undefined && item !== null && item !== "");
+  }
+  if (selected === undefined || selected === null || selected === "") return [];
+  return [selected];
+}

package/dist/package/src/utils/request.ts

@@ -0,0 +1,296 @@
+import axios, { type InternalAxiosRequestConfig, type AxiosResponse, type AxiosError } from "axios";
+import qs from "qs";
+import { ElMessage, ElMessageBox } from "element-plus";
+import router from "../routers";
+import { LOGIN_URL } from "../config";
+import pinia from "../stores";
+import { useUserStore } from "../stores/modules/user";
+
+const apiBasePath = import.meta.env.VITE_APP_BASE_API || "";
+const apiTargetUrl = import.meta.env.VITE_API_URL || import.meta.env.VITE_APP_API_URL || "";
+export const requestBaseURL = `${apiTargetUrl}${apiBasePath}`;
+const SESSION_URL = "/v1/base/session";
+const TOKEN_URL = "/v1/base/token";
+const CAPTCHA_URL = "/v1/base/captcha";
+const CONFIG_URL = "/v1/base/config";
+const PASSWORD_PUBLIC_KEY_URL = "/v1/base/password-public-key";
+const OAUTH_PROVIDER_URL = "/v1/base/oauth/provider";
+const OAUTH_AUTHORIZATION_URL = "/v1/base/oauth/authorization";
+const OAUTH_TICKET_URL = "/v1/base/oauth/ticket";
+const LEGACY_AUTH_URL = "/auth";
+const LEGACY_REFRESH_TOKEN_URL = `${LEGACY_AUTH_URL}/token`;
+const LEGACY_CAPTCHA_URL = "/login/captcha";
+// 认证公共接口不携带旧 token，同时保留旧路径兼容迁移期间的灰度访问。
+const NO_AUTH_URL_SET = new Set([
+  SESSION_URL,
+  TOKEN_URL,
+  CAPTCHA_URL,
+  CONFIG_URL,
+  PASSWORD_PUBLIC_KEY_URL,
+  OAUTH_PROVIDER_URL,
+  OAUTH_AUTHORIZATION_URL,
+  OAUTH_TICKET_URL,
+  LEGACY_AUTH_URL,
+  LEGACY_CAPTCHA_URL,
+  LEGACY_REFRESH_TOKEN_URL
+]);
+const AUTH_EXPIRED_EXCLUDED_URL_SET = new Set([
+  SESSION_URL,
+  TOKEN_URL,
+  CAPTCHA_URL,
+  CONFIG_URL,
+  PASSWORD_PUBLIC_KEY_URL,
+  OAUTH_PROVIDER_URL,
+  OAUTH_AUTHORIZATION_URL,
+  OAUTH_TICKET_URL,
+  LEGACY_AUTH_URL,
+  LEGACY_REFRESH_TOKEN_URL,
+  LEGACY_CAPTCHA_URL
+]);
+
+/** 支持自动重试的 Axios 请求配置。 */
+type RetryableRequestConfig = InternalAxiosRequestConfig & {
+  /** 标记当前请求已经因认证失败重试过，避免刷新失败时递归重放。 */
+  _authRetried?: boolean;
+};
+
+// 创建 axios 实例
+const service = axios.create({
+  baseURL: requestBaseURL,
+  timeout: 50000,
+  headers: { "Content-Type": "application/json;charset=utf-8" },
+  paramsSerializer: params => qs.stringify(params)
+});
+
+// 刷新令牌请求使用独立实例，避免与主请求拦截器互相递归。
+const refreshService = axios.create({
+  baseURL: requestBaseURL,
+  timeout: 50000,
+  headers: { "Content-Type": "application/json;charset=utf-8" }
+});
+
+/** 获取用户状态仓库 */
+function getUserStore() {
+  return useUserStore(pinia);
+}
+
+/** 判断当前请求是否需要跳过认证头 */
+function shouldSkipAuth(config: InternalAxiosRequestConfig) {
+  if (config.headers.Authorization === "no-auth") return true;
+
+  const requestUrl = config.url ?? "";
+  return NO_AUTH_URL_SET.has(requestUrl);
+}
+
+/** 判断当前请求是否不应触发登录失效弹窗 */
+function shouldSkipAuthExpiredPrompt(config?: InternalAxiosRequestConfig) {
+  if (!config) return false;
+
+  const requestUrl = config.url ?? "";
+  return AUTH_EXPIRED_EXCLUDED_URL_SET.has(requestUrl);
+}
+
+/** 判断当前请求是否需要静默掉错误提示。 */
+function shouldSkipErrorMessage(config?: InternalAxiosRequestConfig) {
+  if (!config) return false;
+
+  const requestUrl = config.url ?? "";
+  const requestMethod = String(config.method ?? "").toLowerCase();
+  return (requestUrl === SESSION_URL || requestUrl === LEGACY_AUTH_URL) && requestMethod === "delete";
+}
+
+/** 读取访问令牌过期时间 */
+function getTokenExpiresAt() {
+  return getUserStore().tokenExpiresAt;
+}
+
+/** 判断当前访问令牌是否仍在有效期内。 */
+export function hasValidAccessToken() {
+  const userStore = getUserStore();
+  return Boolean(userStore.token.trim() && userStore.tokenExpiresAt > Date.now());
+}
+
+/** 读取最新可用访问令牌，必要时先串行刷新，供 axios、fetch 与 SSE 共用。 */
+export async function getRequestAccessToken(): Promise<string> {
+  const userStore = getUserStore();
+  if (!userStore.token && userStore.refreshToken) {
+    await handleTokenRefresh(false);
+  }
+
+  const expiresAt = getTokenExpiresAt();
+  const remainingTime = expiresAt - Date.now();
+  if (expiresAt && remainingTime <= 5 * 60 * 1000) {
+    await handleTokenRefresh(false);
+  }
+
+  return getUserStore().token.trim();
+}
+
+/** 尝试通过刷新令牌恢复访问令牌，供路由守卫进入页面前调用。 */
+export async function ensureAccessToken() {
+  if (hasValidAccessToken()) {
+    return true;
+  }
+
+  const userStore = getUserStore();
+  if (!userStore.refreshToken) {
+    return false;
+  }
+
+  try {
+    await handleTokenRefresh(false);
+    return hasValidAccessToken();
+  } catch {
+    userStore.clearAuthData();
+    return false;
+  }
+}
+
+// 防止并发 401 重复弹出认证失效确认框。
+let isHandlingAuthExpired = false;
+
+/** 统一处理认证失效 */
+export function handleAuthExpired() {
+  if (isHandlingAuthExpired) {
+    return;
+  }
+
+  isHandlingAuthExpired = true;
+  ElMessageBox.confirm("登录状态已失效，请重新登录", "提示", {
+    confirmButtonText: "重新登录",
+    cancelButtonText: "取消",
+    type: "warning",
+    closeOnClickModal: false,
+    closeOnPressEscape: false
+  })
+    .then(() => {
+      const userStore = getUserStore();
+      const currentRoute = router.currentRoute.value;
+      const redirect = currentRoute.path === LOGIN_URL ? undefined : currentRoute.fullPath;
+      userStore.clearAuthData();
+      return router.replace({
+        path: LOGIN_URL,
+        query: redirect ? { redirect } : undefined
+      });
+    })
+    .finally(() => {
+      isHandlingAuthExpired = false;
+    });
+}
+
+// 请求拦截器
+service.interceptors.request.use(
+  async (config: InternalAxiosRequestConfig) => {
+    const skipAuth = shouldSkipAuth(config);
+    const accessToken = skipAuth ? "" : await getRequestAccessToken();
+    // 登录、验证码、刷新令牌接口不携带旧 token，避免请求头污染。
+    if (!skipAuth && accessToken) {
+      config.headers.Authorization = accessToken;
+    } else {
+      delete config.headers.Authorization;
+    }
+    return config;
+  },
+  error => Promise.reject(error)
+);
+
+// 响应拦截器
+service.interceptors.response.use(
+  (response: AxiosResponse) => {
+    // 如果响应是二进制流，则直接返回，用于下载文件、Excel 导出等
+    if (response.config.responseType === "blob") {
+      return response;
+    }
+
+    const { code, message, reason, metadata } = response.data;
+    if (code === undefined || message === undefined || reason === undefined || metadata === undefined) {
+      return response.data;
+    }
+
+    ElMessage.error(message || "系统出错");
+    return Promise.reject(new Error(message || "Error"));
+  },
+  async (error: AxiosError) => {
+    const status = error.response?.status;
+    const data = error.response?.data as { code?: string | number; message?: string } | undefined;
+    const code = data?.code;
+    const message = data?.message;
+    const requestConfig = error.config as RetryableRequestConfig | undefined;
+
+    // 业务请求仅在 401 时尝试刷新并重放，403 直接展示后端权限错误。
+    if ((status === 401 || code === 401) && !shouldSkipAuthExpiredPrompt(requestConfig)) {
+      if (requestConfig && !requestConfig._authRetried && getUserStore().refreshToken) {
+        requestConfig._authRetried = true;
+        try {
+          await handleTokenRefresh(false);
+          requestConfig.headers.Authorization = getUserStore().token.trim();
+          return service(requestConfig);
+        } catch (refreshError) {
+          console.log("token 刷新失败", refreshError);
+        }
+      }
+      handleAuthExpired();
+    } else if (data) {
+      if (!shouldSkipErrorMessage(requestConfig)) {
+        if (message) {
+          ElMessage.error(message);
+        } else {
+          ElMessage.error("系统出错");
+        }
+      }
+    } else if (!shouldSkipErrorMessage(requestConfig)) {
+      ElMessage.error(error.message || "系统出错");
+    }
+    return Promise.reject(error.message);
+  }
+);
+
+export default service;
+
+// 刷新 Token 的锁
+let isRefreshing = false;
+let refreshPromise: Promise<void> | null = null;
+
+/** 刷新 Token 处理 */
+async function handleTokenRefresh(promptOnFailure = true) {
+  if (!isRefreshing) {
+    isRefreshing = true;
+    refreshPromise = refreshAccessToken()
+      .catch(error => {
+        if (promptOnFailure) {
+          console.log("token 刷新失败", error);
+          handleAuthExpired();
+        }
+        throw error;
+      })
+      .finally(() => {
+        isRefreshing = false;
+        refreshPromise = null;
+      });
+  }
+
+  if (refreshPromise) {
+    await refreshPromise;
+  }
+}
+
+/** 调用刷新令牌接口并回写最新认证信息 */
+async function refreshAccessToken() {
+  const userStore = getUserStore();
+  if (!userStore.refreshToken) {
+    return Promise.reject(new Error("refresh token 不存在"));
+  }
+
+  const response = await refreshService.post(
+    TOKEN_URL,
+    { refresh_token: userStore.refreshToken },
+    { headers: { Authorization: "no-auth" } }
+  );
+  const data = response.data;
+  userStore.updateTokenAuth(
+    data.access_token,
+    data.refresh_token ?? userStore.refreshToken,
+    data.token_type ?? "",
+    data.expires_in
+  );
+}

package/dist/package/src/utils/router.ts

@@ -0,0 +1,43 @@
+import type { RouteLocationRaw, Router } from "vue-router";
+import { initDynamicRouter } from "../routers/modules/dynamicRouter";
+
+/**
+ * 判断当前解析结果是否只命中了全局 404 占位路由。
+ */
+export function isUnmatchedRoute(router: Router, path: string) {
+  const resolved = router.resolve(path);
+  if (!resolved.matched.length) return true;
+  return resolved.matched.some(item => item.path === "/:pathMatch(.*)*");
+}
+
+/**
+ * 将前端路由地址转换为当前站点的绝对 URL，供后端 OAuth 回调重定向使用。
+ */
+export function resolveFrontendRouteURL(router: Router, location: RouteLocationRaw) {
+  const href = router.resolve(location).href;
+  if (href.startsWith("#")) {
+    return `${window.location.origin}${window.location.pathname}${window.location.search}${href}`;
+  }
+  const frontendHref = href.startsWith("/") ? href : `${window.location.pathname}${window.location.search}${href}`;
+  return new URL(frontendHref, window.location.origin).toString();
+}
+
+/**
+ * 统一处理站内页面跳转；若目标路由尚未注册，则补跑动态路由初始化后重试。
+ * 若路由实例已可解析但 push 失败，则降级为浏览器地址跳转。
+ */
+export async function navigateTo(router: Router, path: string, query?: Record<string, string | number>) {
+  const target = { path, query };
+
+  // 隐藏业务页依赖动态菜单注册，首次进入或权限刚调整后可能尚未挂载到路由实例。
+  if (isUnmatchedRoute(router, path)) {
+    await initDynamicRouter().catch(() => undefined);
+  }
+
+  if (isUnmatchedRoute(router, path)) return;
+
+  return router.push(target).catch(() => {
+    const fallbackResolved = router.resolve(target);
+    window.location.href = fallbackResolved.href;
+  });
+}

package/dist/package/src/utils/svg.ts

@@ -0,0 +1,13 @@
+/**
+ * @description Loading Svg
+ */
+export const loadingSvg = `
+<path class="path" d="
+	M 30 15
+	L 28 17
+	M 25.61 25.61
+	A 15 15, 0, 0, 1, 15 30
+	A 15 15, 0, 1, 1, 27.99 7.5
+	L 15 15
+" style="stroke-width: 4px; fill: rgba(0, 0, 0, 0)"/>
+`;

package/dist/package/src/utils/tenant.ts

@@ -0,0 +1,10 @@
+import { defBaseTenantService } from "../api/system/base_tenant";
+
+/** 默认租户编码。 */
+export const DEFAULT_TENANT_CODE = "0000";
+
+/** 读取租户列表筛选选项。 */
+export async function requestTenantOptions() {
+  const response = await defBaseTenantService.OptionBaseTenant({ keyword: "" });
+  return { data: response.list ?? [] };
+}

package/dist/package/src/utils/utils.ts

@@ -0,0 +1,40 @@
+/**
+ * JSON 格式化显示。
+ */
+export function formatJson(str: string) {
+  try {
+    return JSON.stringify(JSON.parse(str), null, 2);
+  } catch {
+    return str;
+  }
+}
+
+/**
+ * 将后端分单位金额转换为元字符串。
+ */
+export function formatPrice(price?: number) {
+  if (!price) return "0.00";
+  return (price / 100).toFixed(2);
+}
+
+/**
+ * 按静态资源域名补齐图片地址。
+ */
+export function formatSrc(src: string) {
+  const value = String(src ?? "").trim();
+  if (!value) return value;
+  if (/^(https?:)?\/\//.test(value) || value.startsWith("data:") || value.startsWith("blob:")) {
+    return value;
+  }
+
+  const configuredBase = String(import.meta.env.VITE_APP_STATIC_URL ?? "").trim();
+  if (value.startsWith("/admin/")) {
+    return new URL(value, `${window.location.origin}/`).toString();
+  }
+
+  const staticBase = configuredBase
+    ? new URL(`${configuredBase.replace(/\/$/, "")}/`, `${window.location.origin}/`).toString()
+    : `${window.location.origin}/admin/`;
+  const normalizedPath = value.replace(/^\/+/, "").replace(/^admin\/+/, "");
+  return new URL(normalizedPath, staticBase).toString();
+}

package/dist/package/src/views/error/403.vue

@@ -0,0 +1,8 @@
+<script setup lang="ts" name="403">
+import errorImage from "../../assets/images/403.png";
+import ErrorMessage from "../../components/ErrorMessage/index.vue";
+</script>
+
+<template>
+  <ErrorMessage code="403" :image="errorImage" message="抱歉，您无权访问该页面~🙅‍♂️🙅‍♀️" />
+</template>

package/dist/package/src/views/error/404.vue

@@ -0,0 +1,8 @@
+<script setup lang="ts" name="404">
+import errorImage from "../../assets/images/404.png";
+import ErrorMessage from "../../components/ErrorMessage/index.vue";
+</script>
+
+<template>
+  <ErrorMessage code="404" :image="errorImage" message="抱歉，您访问的页面不存在~🤷‍♂️🤷‍♀️" />
+</template>

package/dist/package/src/views/error/500.vue

@@ -0,0 +1,8 @@
+<script setup lang="ts" name="500">
+import errorImage from "../../assets/images/500.png";
+import ErrorMessage from "../../components/ErrorMessage/index.vue";
+</script>
+
+<template>
+  <ErrorMessage code="500" :image="errorImage" message="抱歉，您的网络不见了~🤦‍♂️🤦‍♀️" />
+</template>

package/dist/package/src/views/error/pending.vue

@@ -0,0 +1,16 @@
+<script setup lang="ts" name="Pending"></script>
+
+<template>
+  <div class="route-pending page-card">
+    <el-empty description="该页面暂不可用，请联系管理员检查菜单组件配置" />
+  </div>
+</template>
+
+<style scoped lang="scss">
+.route-pending {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  min-height: 360px;
+}
+</style>