@liujitcn/kratos-admin-system 0.0.74 → 0.0.75

package/README.md

@@ -48,7 +48,9 @@ packages/modules/system
 | `src/components/log/log.ts` | 日志列表列和查询辅助函数。 |
 | `src/components/notification/Notification.vue` | System 提供的站内信顶部工具入口。 |
 | `src/components/tenant-project/TenantProjectSelect.vue` | 租户项目树选择器，默认租户显示“租户 / 项目”，普通租户显示当前租户项目。 |
-| `src/components/tenant-project/TenantProjectText.vue` | 租户项目列表展示组件，按当前租户身份自动组合名称。 |
+| `src/components/tenant-project/TenantProjectText.vue` | 租户项目列表展示组件，按当前租户身份自动组合名称；支持仅传项目 ID 并从公共目录解析名称。 |
+| `src/components/tenant-project/tenant-project-catalog.ts` | 租户项目公共目录缓存，按账号加载树或项目选项并维护 ID 到租户/项目名称的映射。 |
+| `src/components/tenant-project/tenant-project-scope.ts` | 租户项目范围组合状态，提供与搜索条件配套的 ProTable 列、范围归一化和展示文本解析。 |
 | `src/components/tenant-project/TenantProjectManager.vue` | 可复用的租户项目管理组件，支持追加列、业务数据加载、操作和作用域插槽。 |
 | `src/components/tenant-project/tenant-project-manager.ts` | 租户项目管理组件的扩展类型、双键上下文和数据合并辅助函数。 |
 | `src/components/tenant-project-grant/ProjectGrantDialog.vue` | 岗位、角色、部门和用户的项目授权弹窗。 |
@@ -168,6 +170,8 @@ export const adminModules = [systemAdminModule];
 
 跨模块跳转使用 Vue Router；复用 System 代码时只引用 `package.json#exports` 公开的 npm 子路径。
 
+业务列表需要“租户 / 二级资源”查询条件与所属列时，使用根入口导出的 `useTenantProjectScope`：它按当前账号加载公共项目目录（默认租户为租户树，普通租户为项目选项），维护项目 ID 到“租户名 / 项目名”的映射，并返回 `column`（同时包含表格渲染和 `search.render`，列与查询条件天然共用同一份范围状态）和 `normalizeParams`、`projectSelections` 等范围工具。二级资源名称通过 `resourceLabelKey`、`allResourceLabelKey` 指定国际化键，默认使用项目文案，换成门店等资源时只需替换加载目录与国际化键。列表行只需提供项目 ID（可选租户 ID），单元格由 `TenantProjectText` 自动解析为两级文本；导出可复用 `resolveTenantProjectLabel`。
+
 租户项目管理组件通过 `TenantProjectManager` 公开。默认租户创建项目时在表单中选择目标租户，普通租户由服务端自动使用当前租户；默认租户查询全部项目，普通租户按项目授权范围查询。外部业务模块可以传入 `extraColumns`、`extraActions` 和 `loadExtraData`：扩展列可通过 `after` 指定插入到哪个基础字段后面，列的同名表格插槽会沿用该位置，未配置时默认插入备注后面，例如 `{ prop: "address", after: "name" }` 配合 `#address` 插槽即可把内容放到项目名称后面；数据加载器接收当前页的 `tenant_id + project_id` 集合，单条操作回调接收同一组双键以及项目基础数据。组件也会透传表格具名插槽，并向行插槽增加 `tenantProject` 上下文；保存业务配置后可通过组件实例的 `refresh()` 刷新列表。按外部业务字段搜索或排序时，应由外部接口参与分页查询，不能只在当前页加载后过滤。
 
 外部项目可以在自己的页面中包装该组件，并通过菜单将项目管理页面的 `component` 指向包装页面：

package/dist/package/declarations/src/components/tenant-project/TenantProjectText.vue.d.ts

@@ -2,7 +2,13 @@ import type { SelectOptionResponse_Option } from "@liujitcn/kratos-admin-core/rp
 /** 租户项目展示组件属性。 */
 interface TenantProjectTextProps {
     /** 包含租户和项目字段的列表行。 */
-    row: Record<string, any>;
+    row?: Record<string, any>;
+    /** 仅传项目 ID 时使用的项目 ID。 */
+    projectId?: number;
+    /** 仅传项目 ID 时使用的租户 ID。 */
+    tenantId?: number;
+    /** 二级资源名称国际化键，默认使用项目。 */
+    resourceLabelKey?: string;
     /** 项目名称字段。 */
     projectField?: string;
     /** 租户名称字段。 */
@@ -11,6 +17,10 @@ interface TenantProjectTextProps {
     tenantOptions?: SelectOptionResponse_Option[];
 }
 declare const __VLS_export: import("vue").DefineComponent<TenantProjectTextProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<TenantProjectTextProps> & Readonly<{}>, {
+    tenantId: number;
+    projectId: number;
+    row: Record<string, any>;
+    resourceLabelKey: string;
     projectField: string;
     tenantField: string;
     tenantOptions: SelectOptionResponse_Option[];

package/dist/package/declarations/src/components/tenant-project/tenant-project-catalog.d.ts

@@ -0,0 +1,42 @@
+import type { SelectOptionResponse_Option } from "@liujitcn/kratos-admin-core/rpc/common/v1/common";
+import type { TreeBaseTenantProjectResponse_Option } from "@liujitcn/kratos-admin-system/rpc/system/admin/v1/base_tenant_project";
+/** 租户项目范围。 */
+export type TenantProjectScopeSelection = {
+    /** 租户 ID。 */
+    tenant_id: number;
+    /** 项目 ID。 */
+    project_id: number;
+};
+/** 租户项目名称信息。 */
+export type TenantProjectDisplayInfo = {
+    /** 租户名称。 */
+    tenantName: string;
+    /** 项目名称。 */
+    projectName: string;
+};
+/** 租户项目表格行范围字段。 */
+export type TenantProjectScopeRow = {
+    /** 租户 ID。 */
+    tenant_id?: number;
+    /** 项目 ID。 */
+    project_id?: number;
+    /** 租户名称。 */
+    tenant_name?: string;
+    /** 项目名称。 */
+    project_name?: string;
+};
+/** 当前账号租户项目目录。 */
+export type TenantProjectCatalog = {
+    /** 租户项目树。 */
+    treeOptions: TreeBaseTenantProjectResponse_Option[];
+    /** 普通租户项目选项。 */
+    projectOptions: SelectOptionResponse_Option[];
+};
+/** 读取当前共享租户项目名称映射。 */
+export declare function getTenantProjectDisplayMap(): Map<string, TenantProjectDisplayInfo>;
+/** 读取项目目录中的名称信息。 */
+export declare function resolveTenantProjectDisplay(tenantId?: number, projectId?: number): TenantProjectDisplayInfo | undefined;
+/** 根据租户项目 ID 生成展示文本。 */
+export declare function resolveTenantProjectLabel(row: TenantProjectScopeRow, isDefaultTenant: boolean): string;
+/** 加载并缓存当前账号可见的租户项目目录。 */
+export declare function loadTenantProjectOptions(isDefaultTenant: boolean, force?: boolean): Promise<TenantProjectCatalog>;

package/dist/package/declarations/src/components/tenant-project/tenant-project-manager-data.d.ts

@@ -19,6 +19,15 @@ export declare function arrangeTenantProjectColumns<T extends TenantProjectColum
 }>): T[];
 /** 创建租户项目扩展数据的稳定键。 */
 export declare function tenantProjectKey(tenantId: number, projectId: number): string;
+/** 租户项目树节点解析结果。 */
+export type TenantProjectValueSelection = {
+    /** 租户 ID，选中租户节点或项目节点时返回。 */
+    tenant_id?: number;
+    /** 项目 ID，仅选中项目节点时返回。 */
+    project_id?: number;
+};
+/** 解析租户项目树节点值，租户节点返回租户 ID，项目节点返回租户和项目 ID。 */
+export declare function parseTenantProjectValue(value?: string): TenantProjectValueSelection;
 /** 将外部业务字段合并到项目行，同时保护公共项目字段。 */
 export declare function mergeTenantProjectExtraData(project: BaseTenantProject, extra?: Record<string, unknown>): BaseTenantProject & Record<string, unknown>;
 export {};

package/dist/package/declarations/src/components/tenant-project/tenant-project-scope.d.ts

@@ -0,0 +1,63 @@
+import type { ComputedRef, Ref } from "vue";
+import type { ColumnProps } from "@liujitcn/kratos-admin-core/components/ProTable/interface";
+import type { SelectOptionResponse_Option } from "@liujitcn/kratos-admin-core/rpc/common/v1/common";
+import type { TreeBaseTenantProjectResponse_Option } from "@liujitcn/kratos-admin-system/rpc/system/admin/v1/base_tenant_project";
+import { type TenantProjectDisplayInfo, type TenantProjectScopeSelection } from "./tenant-project-catalog";
+export type { TenantProjectDisplayInfo, TenantProjectScopeRow, TenantProjectScopeSelection } from "./tenant-project-catalog";
+export { getTenantProjectDisplayMap, resolveTenantProjectLabel } from "./tenant-project-catalog";
+export { parseTenantProjectValue } from "./tenant-project-manager-data";
+/** 租户项目范围参数。 */
+export type TenantProjectScopeParams = {
+    /** 租户项目树值。 */
+    tenant_project_tree_value?: string;
+    /** 租户 ID。 */
+    tenant_id?: number;
+    /** 项目 ID。 */
+    project_id?: number;
+};
+/** 租户二级资源范围配置。 */
+export interface TenantProjectScopeOptions {
+    /** 二级资源名称国际化键，默认使用 common.field.project。 */
+    resourceLabelKey?: string;
+    /** 全部二级资源名称国际化键。 */
+    allResourceLabelKey?: string;
+    /** 搜索参数键。 */
+    searchKey?: string;
+    /** 搜索项排序。 */
+    order?: number;
+    /** 表格列最小宽度。 */
+    minWidth?: number;
+    /** 表格列绑定的项目 ID 字段。 */
+    projectField?: string;
+    /** 表格列绑定的租户 ID 字段。 */
+    tenantField?: string;
+}
+/** 租户项目范围状态。 */
+export interface TenantProjectScope {
+    /** 当前账号是否为默认租户。 */
+    isDefaultTenant: ComputedRef<boolean>;
+    /** 当前范围列标题。 */
+    scopeLabel: ComputedRef<string>;
+    /** 当前范围选择器占位文案。 */
+    allLabel: ComputedRef<string>;
+    /** 当前账号可见的树选项。 */
+    treeOptions: Ref<TreeBaseTenantProjectResponse_Option[]>;
+    /** 当前账号可见的普通项目选项。 */
+    projectOptions: Ref<SelectOptionResponse_Option[]>;
+    /** 当前目录名称映射。 */
+    displayMap: ComputedRef<Map<string, TenantProjectDisplayInfo>>;
+    /** 加载当前账号可见范围。 */
+    loadOptions: (force?: boolean) => Promise<TreeBaseTenantProjectResponse_Option[] | SelectOptionResponse_Option[]>;
+    /** 当前范围的全部项目。 */
+    projectSelections: (tenantId?: number) => TenantProjectScopeSelection[];
+    /** 归一化搜索参数。 */
+    normalizeParams: <T extends TenantProjectScopeParams>(params: T) => T & TenantProjectScopeParams;
+    /** 创建与搜索条件配套的表格列。 */
+    column: ComputedRef<ColumnProps>;
+}
+/** 创建租户项目范围状态。 */
+export declare function useTenantProjectScope(options?: TenantProjectScopeOptions): TenantProjectScope;
+/** 创建项目范围列。 */
+export declare function createTenantProjectColumn(scope: TenantProjectScope): ComputedRef<ColumnProps<{
+    [x: string]: any;
+}>>;

package/dist/package/declarations/src/index.d.ts

@@ -1,5 +1,8 @@
 export { ADMIN_AI_EXTENSION, getAdminAiExtension } from "./ai";
 export type { AdminAiExtension } from "./ai";
 export { default as TenantProjectManager } from "./components/tenant-project/TenantProjectManager.vue";
+export { default as TenantProjectSelect } from "./components/tenant-project/TenantProjectSelect.vue";
+export { default as TenantProjectText } from "./components/tenant-project/TenantProjectText.vue";
+export { createTenantProjectColumn, getTenantProjectDisplayMap, parseTenantProjectValue, resolveTenantProjectLabel, useTenantProjectScope, type TenantProjectDisplayInfo, type TenantProjectScope, type TenantProjectScopeOptions, type TenantProjectScopeParams, type TenantProjectScopeRow, type TenantProjectScopeSelection } from "./components/tenant-project/tenant-project-scope";
 export { mergeTenantProjectExtraData, arrangeTenantProjectColumns, tenantProjectKey, type TenantProjectAction, type TenantProjectContext, type TenantProjectExtraColumn, type TenantProjectExtraData, type TenantProjectExtraDataLoadContext, type TenantProjectExtraDataLoader, type TenantProjectKey, type TenantProjectManagerProps } from "./components/tenant-project/tenant-project-manager";
 export { systemAdminModule } from "./module";

package/dist/package/src/components/tenant-project/TenantProjectText.vue

@@ -6,13 +6,20 @@
 import { computed } from "vue";
 import { useTenantScope } from "@liujitcn/kratos-admin-core/tenant";
 import type { SelectOptionResponse_Option } from "@liujitcn/kratos-admin-core/rpc/common/v1/common";
+import { resolveTenantProjectDisplay } from "./tenant-project-catalog";
 
 defineOptions({ name: "TenantProjectText" });
 
 /** 租户项目展示组件属性。 */
 interface TenantProjectTextProps {
   /** 包含租户和项目字段的列表行。 */
-  row: Record<string, any>;
+  row?: Record<string, any>;
+  /** 仅传项目 ID 时使用的项目 ID。 */
+  projectId?: number;
+  /** 仅传项目 ID 时使用的租户 ID。 */
+  tenantId?: number;
+  /** 二级资源名称国际化键，默认使用项目。 */
+  resourceLabelKey?: string;
   /** 项目名称字段。 */
   projectField?: string;
   /** 租户名称字段。 */
@@ -22,6 +29,10 @@ interface TenantProjectTextProps {
 }
 
 const props = withDefaults(defineProps<TenantProjectTextProps>(), {
+  row: () => ({}),
+  projectId: undefined,
+  tenantId: undefined,
+  resourceLabelKey: "common.field.project",
   projectField: "project_name",
   tenantField: "tenant_name",
   tenantOptions: () => []
@@ -29,9 +40,11 @@ const props = withDefaults(defineProps<TenantProjectTextProps>(), {
 const { isDefaultTenant, resolveTenantLabel } = useTenantScope();
 
 const label = computed(() => {
-  const projectName = props.row[props.projectField] ?? props.row.project_name ?? props.row.name ?? props.row.project_id ?? "";
+  const projectId = props.projectId ?? props.row.project_id;
+  const displayInfo = resolveTenantProjectDisplay(props.tenantId ?? props.row.tenant_id, projectId);
+  const projectName = props.row[props.projectField] ?? props.row.project_name ?? props.row.name ?? displayInfo?.projectName ?? projectId ?? "";
   if (!isDefaultTenant.value) return String(projectName);
-  const tenantName = props.row[props.tenantField] ?? resolveTenantLabel(props.row, "tenant_id", props.tenantOptions);
+  const tenantName = props.row[props.tenantField] ?? resolveTenantLabel(props.row, "tenant_id", props.tenantOptions) ?? displayInfo?.tenantName;
   return tenantName ? `${tenantName} / ${projectName}` : String(projectName);
 });
 </script>

package/dist/package/src/components/tenant-project/tenant-project-catalog.ts

@@ -0,0 +1,139 @@
+import type { SelectOptionResponse_Option } from "@liujitcn/kratos-admin-core/rpc/common/v1/common";
+import { defBaseTenantProjectService } from "@liujitcn/kratos-admin-system/api/system/admin/v1/base_tenant_project";
+import type { TreeBaseTenantProjectResponse_Option } from "@liujitcn/kratos-admin-system/rpc/system/admin/v1/base_tenant_project";
+
+/** 租户项目范围。 */
+export type TenantProjectScopeSelection = {
+  /** 租户 ID。 */
+  tenant_id: number;
+  /** 项目 ID。 */
+  project_id: number;
+};
+
+/** 租户项目名称信息。 */
+export type TenantProjectDisplayInfo = {
+  /** 租户名称。 */
+  tenantName: string;
+  /** 项目名称。 */
+  projectName: string;
+};
+
+/** 租户项目表格行范围字段。 */
+export type TenantProjectScopeRow = {
+  /** 租户 ID。 */
+  tenant_id?: number;
+  /** 项目 ID。 */
+  project_id?: number;
+  /** 租户名称。 */
+  tenant_name?: string;
+  /** 项目名称。 */
+  project_name?: string;
+};
+
+/** 当前账号租户项目目录。 */
+export type TenantProjectCatalog = {
+  /** 租户项目树。 */
+  treeOptions: TreeBaseTenantProjectResponse_Option[];
+  /** 普通租户项目选项。 */
+  projectOptions: SelectOptionResponse_Option[];
+};
+
+type SharedCatalog = TenantProjectCatalog & {
+  mode?: boolean;
+  loaded: boolean;
+  request?: Promise<TenantProjectCatalog>;
+  displayMap: Map<string, TenantProjectDisplayInfo>;
+  projectMap: Map<string, TenantProjectDisplayInfo>;
+};
+
+const sharedCatalog: SharedCatalog = {
+  loaded: false,
+  treeOptions: [],
+  projectOptions: [],
+  displayMap: new Map(),
+  projectMap: new Map()
+};
+
+/** 创建租户项目键。 */
+function scopeKey(tenantId: number, projectId: number) {
+  return `${tenantId}:${projectId}`;
+}
+
+/** 清空共享项目目录缓存。 */
+function resetCatalog(mode: boolean) {
+  sharedCatalog.mode = mode;
+  sharedCatalog.loaded = false;
+  sharedCatalog.treeOptions = [];
+  sharedCatalog.projectOptions = [];
+  sharedCatalog.displayMap.clear();
+  sharedCatalog.projectMap.clear();
+}
+
+/** 将项目目录写入共享名称缓存。 */
+function indexProject(tenantId: number, projectId: number, projectName: string, tenantName: string) {
+  const info = { tenantName, projectName };
+  sharedCatalog.displayMap.set(scopeKey(tenantId, projectId), info);
+  sharedCatalog.projectMap.set(String(projectId), info);
+}
+
+function indexTree(options: TreeBaseTenantProjectResponse_Option[], tenantName = "") {
+  for (const option of options) {
+    if (option.type === "project") {
+      indexProject(option.tenant_id, option.project_id, option.label, tenantName);
+      continue;
+    }
+    indexTree(option.children ?? [], option.label);
+  }
+}
+
+/** 读取当前共享租户项目名称映射。 */
+export function getTenantProjectDisplayMap() {
+  return sharedCatalog.displayMap;
+}
+
+/** 读取项目目录中的名称信息。 */
+export function resolveTenantProjectDisplay(tenantId?: number, projectId?: number) {
+  if (!projectId) return undefined;
+  return sharedCatalog.displayMap.get(scopeKey(tenantId ?? 0, projectId)) ?? sharedCatalog.projectMap.get(String(projectId));
+}
+
+/** 根据租户项目 ID 生成展示文本。 */
+export function resolveTenantProjectLabel(row: TenantProjectScopeRow, isDefaultTenant: boolean) {
+  const displayInfo = resolveTenantProjectDisplay(row.tenant_id, row.project_id);
+  const projectName = row.project_name ?? displayInfo?.projectName ?? row.project_id ?? "-";
+  if (!isDefaultTenant) return String(projectName);
+  const tenantName = row.tenant_name ?? displayInfo?.tenantName;
+  return tenantName ? `${tenantName} / ${projectName}` : String(projectName);
+}
+
+/** 加载并缓存当前账号可见的租户项目目录。 */
+export async function loadTenantProjectOptions(isDefaultTenant: boolean, force = false): Promise<TenantProjectCatalog> {
+  if (sharedCatalog.mode !== isDefaultTenant) resetCatalog(isDefaultTenant);
+  if (sharedCatalog.loaded && !force) return sharedCatalog;
+  if (sharedCatalog.request && !force) return sharedCatalog.request;
+  sharedCatalog.request = (async () => {
+    if (isDefaultTenant) {
+      const response = await defBaseTenantProjectService.TreeBaseTenantProject({ keyword: "" });
+      sharedCatalog.treeOptions = response.list ?? [];
+      indexTree(sharedCatalog.treeOptions);
+    } else {
+      const response = await defBaseTenantProjectService.OptionBaseTenantProject({ tenant_id: 0 });
+      sharedCatalog.projectOptions = response.list ?? [];
+      for (const option of sharedCatalog.projectOptions) indexProject(0, Number(option.value), option.label, "");
+      sharedCatalog.treeOptions = sharedCatalog.projectOptions.map(option => ({
+        value: `project:0:${Number(option.value)}`,
+        label: option.label,
+        type: "project",
+        tenant_id: 0,
+        project_id: Number(option.value),
+        disabled: option.disabled,
+        children: []
+      }));
+    }
+    sharedCatalog.loaded = true;
+    return sharedCatalog;
+  })().finally(() => {
+    sharedCatalog.request = undefined;
+  });
+  return sharedCatalog.request;
+}

package/dist/package/src/components/tenant-project/tenant-project-manager-data.ts

@@ -51,6 +51,23 @@ export function tenantProjectKey(tenantId: number, projectId: number): string {
   return `${tenantId}:${projectId}`;
 }
 
+/** 租户项目树节点解析结果。 */
+export type TenantProjectValueSelection = {
+  /** 租户 ID，选中租户节点或项目节点时返回。 */
+  tenant_id?: number;
+  /** 项目 ID，仅选中项目节点时返回。 */
+  project_id?: number;
+};
+
+/** 解析租户项目树节点值，租户节点返回租户 ID，项目节点返回租户和项目 ID。 */
+export function parseTenantProjectValue(value?: string): TenantProjectValueSelection {
+  if (!value) return {};
+  const [type, tenantId, projectId] = value.split(":");
+  if (type === "tenant" && Number.isFinite(Number(tenantId))) return { tenant_id: Number(tenantId), project_id: 0 };
+  if (type === "project" && Number.isFinite(Number(tenantId)) && Number.isFinite(Number(projectId))) return { tenant_id: Number(tenantId), project_id: Number(projectId) };
+  return {};
+}
+
 /** 将外部业务字段合并到项目行，同时保护公共项目字段。 */
 export function mergeTenantProjectExtraData(
   project: BaseTenantProject,

package/dist/package/src/components/tenant-project/tenant-project-scope.ts

@@ -0,0 +1,156 @@
+import { computed, h, ref } from "vue";
+import type { ComputedRef, Ref } from "vue";
+import type { ColumnProps, SearchRenderScope } from "@liujitcn/kratos-admin-core/components/ProTable/interface";
+import { t } from "@liujitcn/kratos-admin-core";
+import { useTenantScope } from "@liujitcn/kratos-admin-core/tenant";
+import type { SelectOptionResponse_Option } from "@liujitcn/kratos-admin-core/rpc/common/v1/common";
+import type { TreeBaseTenantProjectResponse_Option } from "@liujitcn/kratos-admin-system/rpc/system/admin/v1/base_tenant_project";
+import TenantProjectSelect, { type TenantProjectSelection as TenantProjectNodeSelection } from "./TenantProjectSelect.vue";
+import TenantProjectText from "./TenantProjectText.vue";
+import { getTenantProjectDisplayMap, loadTenantProjectOptions, type TenantProjectDisplayInfo, type TenantProjectScopeSelection } from "./tenant-project-catalog";
+import { parseTenantProjectValue } from "./tenant-project-manager-data";
+
+export type { TenantProjectDisplayInfo, TenantProjectScopeRow, TenantProjectScopeSelection } from "./tenant-project-catalog";
+export { getTenantProjectDisplayMap, resolveTenantProjectLabel } from "./tenant-project-catalog";
+export { parseTenantProjectValue } from "./tenant-project-manager-data";
+
+/** 租户项目范围参数。 */
+export type TenantProjectScopeParams = {
+  /** 租户项目树值。 */
+  tenant_project_tree_value?: string;
+  /** 租户 ID。 */
+  tenant_id?: number;
+  /** 项目 ID。 */
+  project_id?: number;
+};
+
+/** 租户二级资源范围配置。 */
+export interface TenantProjectScopeOptions {
+  /** 二级资源名称国际化键，默认使用 common.field.project。 */
+  resourceLabelKey?: string;
+  /** 全部二级资源名称国际化键。 */
+  allResourceLabelKey?: string;
+  /** 搜索参数键。 */
+  searchKey?: string;
+  /** 搜索项排序。 */
+  order?: number;
+  /** 表格列最小宽度。 */
+  minWidth?: number;
+  /** 表格列绑定的项目 ID 字段。 */
+  projectField?: string;
+  /** 表格列绑定的租户 ID 字段。 */
+  tenantField?: string;
+}
+
+/** 租户项目范围状态。 */
+export interface TenantProjectScope {
+  /** 当前账号是否为默认租户。 */
+  isDefaultTenant: ComputedRef<boolean>;
+  /** 当前范围列标题。 */
+  scopeLabel: ComputedRef<string>;
+  /** 当前范围选择器占位文案。 */
+  allLabel: ComputedRef<string>;
+  /** 当前账号可见的树选项。 */
+  treeOptions: Ref<TreeBaseTenantProjectResponse_Option[]>;
+  /** 当前账号可见的普通项目选项。 */
+  projectOptions: Ref<SelectOptionResponse_Option[]>;
+  /** 当前目录名称映射。 */
+  displayMap: ComputedRef<Map<string, TenantProjectDisplayInfo>>;
+  /** 加载当前账号可见范围。 */
+  loadOptions: (force?: boolean) => Promise<TreeBaseTenantProjectResponse_Option[] | SelectOptionResponse_Option[]>;
+  /** 当前范围的全部项目。 */
+  projectSelections: (tenantId?: number) => TenantProjectScopeSelection[];
+  /** 归一化搜索参数。 */
+  normalizeParams: <T extends TenantProjectScopeParams>(params: T) => T & TenantProjectScopeParams;
+  /** 创建与搜索条件配套的表格列。 */
+  column: ComputedRef<ColumnProps>;
+}
+
+/** 创建租户项目范围状态。 */
+export function useTenantProjectScope(options: TenantProjectScopeOptions = {}): TenantProjectScope {
+  const { isDefaultTenant } = useTenantScope();
+  const treeOptions = ref<TreeBaseTenantProjectResponse_Option[]>([]);
+  const projectOptions = ref<SelectOptionResponse_Option[]>([]);
+  const resourceLabelKey = options.resourceLabelKey ?? "common.field.project";
+  const allResourceLabelKey = options.allResourceLabelKey ?? "system.base.tenant_project.all";
+  const scopeLabel = computed(() => isDefaultTenant.value ? `${t("common.field.tenant")} / ${t(resourceLabelKey)}` : t(resourceLabelKey));
+  const allLabel = computed(() => t(allResourceLabelKey));
+  const displayMap = computed(() => getTenantProjectDisplayMap());
+
+  async function loadOptions(force = false) {
+    const catalog = await loadTenantProjectOptions(isDefaultTenant.value, force);
+    treeOptions.value = catalog.treeOptions;
+    projectOptions.value = catalog.projectOptions;
+    return isDefaultTenant.value ? treeOptions.value : projectOptions.value;
+  }
+
+  function projectSelections(tenantId = 0) {
+    if (!isDefaultTenant.value) return projectOptions.value.map(option => ({ tenant_id: 0, project_id: Number(option.value) })).filter(item => item.project_id > 0);
+    const selections: TenantProjectScopeSelection[] = [];
+    const collect = (options: TreeBaseTenantProjectResponse_Option[]) => {
+      for (const option of options) {
+        if (option.type === "project" && option.project_id > 0 && (!tenantId || option.tenant_id === tenantId)) selections.push({ tenant_id: option.tenant_id, project_id: option.project_id });
+        if (option.children?.length) collect(option.children);
+      }
+    };
+    collect(treeOptions.value);
+    return selections;
+  }
+
+  function normalizeParams<T extends TenantProjectScopeParams>(params: T) {
+    const result = { ...params } as T & TenantProjectScopeParams;
+    const selection = parseTenantProjectValue(params.tenant_project_tree_value);
+    result.tenant_id = isDefaultTenant.value ? selection.tenant_id ?? 0 : 0;
+    result.project_id = selection.project_id ?? Number(params.project_id ?? 0);
+    delete result.tenant_project_tree_value;
+    return result;
+  }
+
+  const column = computed<ColumnProps>(() => ({
+    prop: options.projectField ?? "project_id",
+    label: scopeLabel.value,
+    minWidth: options.minWidth ?? (isDefaultTenant.value ? 220 : 160),
+    showOverflowTooltip: true,
+    render: ({ row }) => h(TenantProjectText, {
+      row,
+      projectId: row[options.projectField ?? "project_id"],
+      tenantId: row[options.tenantField ?? "tenant_id"],
+      resourceLabelKey
+    }),
+    search: {
+      key: options.searchKey ?? "tenant_project_tree_value",
+      order: options.order ?? 1,
+      render: (scope: SearchRenderScope) => renderTenantProjectSearch(scope, loadOptions, treeOptions, allLabel.value)
+    },
+    enum: async () => ({ data: await loadOptions() }),
+    isFilterEnum: false
+  }));
+
+  return { isDefaultTenant, scopeLabel, allLabel, treeOptions, projectOptions, displayMap, loadOptions, projectSelections, normalizeParams, column };
+}
+
+function renderTenantProjectSearch(
+  scope: SearchRenderScope,
+  loadOptions: (force?: boolean) => Promise<TreeBaseTenantProjectResponse_Option[] | SelectOptionResponse_Option[]>,
+  options: Ref<TreeBaseTenantProjectResponse_Option[]>,
+  placeholder: string
+) {
+  const value = scope.searchParam.tenant_project_tree_value;
+  return h(TenantProjectSelect, {
+    modelValue: value ? { value: String(value) } : undefined,
+    options: options.value,
+    clearable: scope.clearable,
+    filterable: true,
+    checkStrictly: true,
+    renderAfterExpand: false,
+    placeholder: scope.placeholder || placeholder,
+    style: { width: "100%" },
+    onVisibleChange: (visible: boolean) => { if (visible) void loadOptions(); },
+    "onUpdate:modelValue": (selection: TenantProjectNodeSelection | undefined) => { scope.searchParam.tenant_project_tree_value = selection?.value; }
+  });
+}
+
+/** 创建项目范围列。 */
+export function createTenantProjectColumn(scope: TenantProjectScope) {
+  return scope.column;
+}

package/dist/package/src/index.ts

@@ -1,6 +1,21 @@
 export { ADMIN_AI_EXTENSION, getAdminAiExtension } from "./ai";
 export type { AdminAiExtension } from "./ai";
 export { default as TenantProjectManager } from "./components/tenant-project/TenantProjectManager.vue";
+export { default as TenantProjectSelect } from "./components/tenant-project/TenantProjectSelect.vue";
+export { default as TenantProjectText } from "./components/tenant-project/TenantProjectText.vue";
+export {
+  createTenantProjectColumn,
+  getTenantProjectDisplayMap,
+  parseTenantProjectValue,
+  resolveTenantProjectLabel,
+  useTenantProjectScope,
+  type TenantProjectDisplayInfo,
+  type TenantProjectScope,
+  type TenantProjectScopeOptions,
+  type TenantProjectScopeParams,
+  type TenantProjectScopeRow,
+  type TenantProjectScopeSelection
+} from "./components/tenant-project/tenant-project-scope";
 export {
   mergeTenantProjectExtraData,
   arrangeTenantProjectColumns,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@liujitcn/kratos-admin-system",
   "private": false,
-  "version": "0.0.74",
+  "version": "0.0.75",
   "type": "module",
   "description": "kratos-admin system management module",
   "license": "MIT",
@@ -16,7 +16,7 @@
     "sortablejs": "^1.15.2",
     "swagger-ui-dist": "^5.32.15",
     "vue-element-plus-x": "^2.0.3",
-    "@liujitcn/kratos-admin-core": "0.0.74"
+    "@liujitcn/kratos-admin-core": "0.0.75"
   },
   "peerDependencies": {
     "@element-plus/icons-vue": "^2.3.1",