@liujitcn/kratos-admin-bi 0.0.0-stage → 0.1.6

package/README.md

@@ -1,3 +1,44 @@
-# Temporary Holding Version
+# @liujitcn/kratos-admin-bi
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+kratos-admin 管理端 BI 分析模块，提供数据源建模、智能问数、查询记录、数据卡片、仪表盘设计与个人工作台。
+
+## 安装与接入
+
+在 Vue 3 + Vite 管理端项目中安装，与 core、System 保持相同版本：
+
+```bash
+pnpm add @liujitcn/kratos-admin-core @liujitcn/kratos-admin-system @liujitcn/kratos-admin-bi
+```
+
+将模块加入宿主的模块加载清单，在 System 模块之后加载：
+
+```ts
+{
+  packageName: "@liujitcn/kratos-admin-bi",
+  load: async () => (await import("@liujitcn/kratos-admin-bi")).biAdminModule
+}
+```
+
+模块依赖 `@liujitcn/kratos-admin-core` 和 `@liujitcn/kratos-admin-system`。宿主需使用 core 的 Vite 配置扫描模块页面，并连接提供 BI API、菜单和权限的 kratos-admin 后端。
+
+## 目录与公开入口
+
+- `src/api/bi/admin/v1`：BI 请求封装，对应 `./api/*`。
+- `src/rpc`：由 Proto 生成的协议类型，对应 `./rpc/*`。
+- `src/views`：数据源、问数、卡片、仪表盘和工作台页面，对应 `./views/*`。
+- `src/components`：模块内部的图表、建模和仪表盘组件。
+- `src/locales`：zh-CN、zh-TW、en-US、ja-JP 语言包，对应 `./locales/*`。
+- `src/module.ts`：`biAdminModule` 定义，通过主入口或 `./module` 导出。
+- `tests`：查询、图表、布局与响应处理测试。
+
+## 验证与打包
+
+在 `frontend/admin` 目录执行：
+
+```bash
+pnpm --filter @liujitcn/kratos-admin-bi test
+pnpm --filter @liujitcn/kratos-admin-bi type:check
+pnpm --filter @liujitcn/kratos-admin-bi pack
+```
+
+打包自动执行现有 `build:package` 命令，生成 `dist/package` 中的源码和类型声明；发布时由 pnpm 将 workspace 依赖替换为对应版本。

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

@@ -0,0 +1 @@
+export * from "./src/index";

package/dist/package/declarations/src/api/bi/admin/v1/bi_card.d.ts

@@ -0,0 +1,18 @@
+import type { BiCard, BiCardService, BiWorkbench, DeleteBiCardRequest, DeleteBiCardResponse, GetBiCardDataRequest, GetBiWorkbenchRequest, PageBiCardRequest, PageBiCardResponse, SaveBiCardRequest, SaveBiWorkbenchRequest } from "../../../../rpc/bi/admin/v1/bi_card";
+import type { BiQueryResult } from "../../../../rpc/bi/admin/v1/bi_query";
+/** 数据卡片与个人工作台请求实现。 */
+export declare class BiCardServiceImpl implements BiCardService {
+    /** 分页查询当前用户可见的卡片。 */
+    PageBiCard(request: PageBiCardRequest): Promise<PageBiCardResponse>;
+    /** 保存当前用户的数据卡片。 */
+    SaveBiCard(request: SaveBiCardRequest): Promise<BiCard>;
+    /** 删除当前用户的数据卡片。 */
+    DeleteBiCard(request: DeleteBiCardRequest): Promise<DeleteBiCardResponse>;
+    /** 按访问者权限执行卡片查询。 */
+    GetBiCardData(request: GetBiCardDataRequest): Promise<BiQueryResult>;
+    /** 获取个人工作台。 */
+    GetBiWorkbench(request: GetBiWorkbenchRequest): Promise<BiWorkbench>;
+    /** 保存个人工作台与收藏。 */
+    SaveBiWorkbench(request: SaveBiWorkbenchRequest): Promise<BiWorkbench>;
+}
+export declare const defBiCardService: BiCardServiceImpl;

package/dist/package/declarations/src/api/bi/admin/v1/bi_card.js

@@ -0,0 +1,46 @@
+import service from "@liujitcn/kratos-admin-core/request";
+import { normalizeBiCard, normalizeBiWorkbench, normalizeBiQueryResult } from "../../../../bi-response";
+const BI_CARD_URL = "/v1/admin/bi/card";
+const BI_WORKBENCH_URL = "/v1/admin/bi/workbench";
+/** 数据卡片与个人工作台请求实现。 */
+export class BiCardServiceImpl {
+    /** 分页查询当前用户可见的卡片。 */
+    PageBiCard(request) {
+        return service({ url: BI_CARD_URL, method: "get", params: request }).then(result => ({
+            cards: (result.cards ?? []).map(normalizeBiCard),
+            total: result.total ?? 0,
+            counts: {
+                all: result.counts?.all ?? 0,
+                system: result.counts?.system ?? 0,
+                mine: result.counts?.mine ?? 0,
+                favorite: result.counts?.favorite ?? 0,
+                shared: result.counts?.shared ?? 0
+            }
+        }));
+    }
+    /** 保存当前用户的数据卡片。 */
+    SaveBiCard(request) {
+        return service({ url: BI_CARD_URL, method: "post", data: request }).then(normalizeBiCard);
+    }
+    /** 删除当前用户的数据卡片。 */
+    DeleteBiCard(request) {
+        return service({ url: `${BI_CARD_URL}/${request.id}`, method: "delete" });
+    }
+    /** 按访问者权限执行卡片查询。 */
+    GetBiCardData(request) {
+        return service({
+            url: `${BI_CARD_URL}/${request.id}/data`,
+            method: "get",
+            params: { range_days: request.range_days }
+        }).then(normalizeBiQueryResult);
+    }
+    /** 获取个人工作台。 */
+    GetBiWorkbench(request) {
+        return service({ url: BI_WORKBENCH_URL, method: "get", params: request }).then(normalizeBiWorkbench);
+    }
+    /** 保存个人工作台与收藏。 */
+    SaveBiWorkbench(request) {
+        return service({ url: BI_WORKBENCH_URL, method: "put", data: request }).then(normalizeBiWorkbench);
+    }
+}
+export const defBiCardService = new BiCardServiceImpl();

package/dist/package/declarations/src/api/bi/admin/v1/bi_dashboard.d.ts

@@ -0,0 +1,17 @@
+import type { BiDashboard, BiDashboardService, DeleteBiDashboardRequest, DeleteBiDashboardResponse, BiDashboardDataResponse, GetBiDashboardDataRequest, GetBiDashboardRequest, PageBiDashboardRequest, PageBiDashboardResponse, PublishBiDashboardRequest, SaveBiDashboardRequest } from "../../../../rpc/bi/admin/v1/bi_dashboard";
+/** BI 仪表盘管理服务实现。 */
+export declare class BiDashboardServiceImpl implements BiDashboardService {
+    /** 分页查询仪表盘。 */
+    PageBiDashboard(request: PageBiDashboardRequest): Promise<PageBiDashboardResponse>;
+    /** 查询仪表盘详情。 */
+    GetBiDashboard(request: GetBiDashboardRequest): Promise<BiDashboard>;
+    /** 保存仪表盘草稿。 */
+    SaveBiDashboard(request: SaveBiDashboardRequest): Promise<BiDashboard>;
+    /** 发布仪表盘草稿。 */
+    PublishBiDashboard(request: PublishBiDashboardRequest): Promise<BiDashboard>;
+    /** 删除仪表盘。 */
+    DeleteBiDashboard(request: DeleteBiDashboardRequest): Promise<DeleteBiDashboardResponse>;
+    /** 执行已发布仪表盘中的图表查询。 */
+    GetBiDashboardData(request: GetBiDashboardDataRequest): Promise<BiDashboardDataResponse>;
+}
+export declare const defBiDashboardService: BiDashboardServiceImpl;

package/dist/package/declarations/src/api/bi/admin/v1/bi_dashboard.js

@@ -0,0 +1,30 @@
+import service from "@liujitcn/kratos-admin-core/request";
+const BI_DASHBOARD_URL = "/v1/admin/bi/dashboard";
+/** BI 仪表盘管理服务实现。 */
+export class BiDashboardServiceImpl {
+    /** 分页查询仪表盘。 */
+    PageBiDashboard(request) {
+        return service({ url: BI_DASHBOARD_URL, method: "get", params: request });
+    }
+    /** 查询仪表盘详情。 */
+    GetBiDashboard(request) {
+        return service({ url: `${BI_DASHBOARD_URL}/${request.id}`, method: "get" });
+    }
+    /** 保存仪表盘草稿。 */
+    SaveBiDashboard(request) {
+        return service({ url: BI_DASHBOARD_URL, method: "post", data: request });
+    }
+    /** 发布仪表盘草稿。 */
+    PublishBiDashboard(request) {
+        return service({ url: `${BI_DASHBOARD_URL}/${request.id}/publish`, method: "post", data: request });
+    }
+    /** 删除仪表盘。 */
+    DeleteBiDashboard(request) {
+        return service({ url: `${BI_DASHBOARD_URL}/${request.id}`, method: "delete" });
+    }
+    /** 执行已发布仪表盘中的图表查询。 */
+    GetBiDashboardData(request) {
+        return service({ url: `${BI_DASHBOARD_URL}/${request.id}/data`, method: "get", params: { version: request.version } });
+    }
+}
+export const defBiDashboardService = new BiDashboardServiceImpl();

package/dist/package/declarations/src/api/bi/admin/v1/bi_query.d.ts

@@ -0,0 +1,11 @@
+import type { AskBiQueryRequest, AskBiQueryResponse, BiQueryService, BiQueryResult, ListBiSourcesRequest, ListBiSourcesResponse, PreviewBiQueryRequest } from "../../../../rpc/bi/admin/v1/bi_query";
+/** BI 语义查询服务实现。 */
+export declare class BiQueryServiceImpl implements BiQueryService {
+    /** 查询当前用户可用的数据源目录。 */
+    ListBiSources(request: ListBiSourcesRequest): Promise<ListBiSourcesResponse>;
+    /** 预览一个语义查询。 */
+    PreviewBiQuery(request: PreviewBiQueryRequest): Promise<BiQueryResult>;
+    /** 根据自然语言生成语义查询并预览。 */
+    AskBiQuery(request: AskBiQueryRequest): Promise<AskBiQueryResponse>;
+}
+export declare const defBiQueryService: BiQueryServiceImpl;

package/dist/package/declarations/src/api/bi/admin/v1/bi_query.js

@@ -0,0 +1,41 @@
+import service from "@liujitcn/kratos-admin-core/request";
+import { normalizeBiQuerySpec, normalizeBiQueryResult } from "../../../../bi-response";
+const BI_QUERY_URL = "/v1/admin/bi";
+/** BI 语义查询服务实现。 */
+export class BiQueryServiceImpl {
+    /** 查询当前用户可用的数据源目录。 */
+    ListBiSources(request) {
+        return service({
+            url: `${BI_QUERY_URL}/sources`,
+            method: "get",
+            params: request
+        }).then(result => ({
+            sources: (result.sources ?? []).map(source => ({
+                ...source,
+                dimensions: source.dimensions ?? [],
+                measures: (source.measures ?? []).map(measure => ({ ...measure, aggregations: measure.aggregations ?? [] }))
+            }))
+        }));
+    }
+    /** 预览一个语义查询。 */
+    PreviewBiQuery(request) {
+        return service({
+            url: `${BI_QUERY_URL}/query/preview`,
+            method: "post",
+            data: request
+        }).then(normalizeBiQueryResult);
+    }
+    /** 根据自然语言生成语义查询并预览。 */
+    AskBiQuery(request) {
+        return service({
+            url: `${BI_QUERY_URL}/query/ask`,
+            method: "post",
+            data: request
+        }).then(response => ({
+            ...response,
+            query: response.query ? normalizeBiQuerySpec(response.query) : undefined,
+            result: response.result ? normalizeBiQueryResult(response.result) : undefined
+        }));
+    }
+}
+export const defBiQueryService = new BiQueryServiceImpl();

package/dist/package/declarations/src/api/bi/admin/v1/bi_query_record.d.ts

@@ -0,0 +1,10 @@
+import type { BiQueryRecordService, GetBiQueryRequest, PageBiQueryRequest, PageBiQueryResponse } from "../../../../rpc/bi/admin/v1/bi_query_record";
+import type { BiQueryRecord } from "../../../../rpc/bi/admin/v1/bi_query_record";
+/** 智能问数记录管理服务实现。 */
+export declare class BiQueryRecordServiceImpl implements BiQueryRecordService {
+    /** 分页查询智能问数记录。 */
+    PageBiQuery(request: PageBiQueryRequest): Promise<PageBiQueryResponse>;
+    /** 查询智能问数记录详情。 */
+    GetBiQuery(request: GetBiQueryRequest): Promise<BiQueryRecord>;
+}
+export declare const defBiQueryRecordService: BiQueryRecordServiceImpl;

package/dist/package/declarations/src/api/bi/admin/v1/bi_query_record.js

@@ -0,0 +1,14 @@
+import service from "@liujitcn/kratos-admin-core/request";
+const BI_QUERY_URL = "/v1/admin/bi/query-record";
+/** 智能问数记录管理服务实现。 */
+export class BiQueryRecordServiceImpl {
+    /** 分页查询智能问数记录。 */
+    PageBiQuery(request) {
+        return service({ url: BI_QUERY_URL, method: "get", params: request });
+    }
+    /** 查询智能问数记录详情。 */
+    GetBiQuery(request) {
+        return service({ url: `${BI_QUERY_URL}/${request.id}`, method: "get" });
+    }
+}
+export const defBiQueryRecordService = new BiQueryRecordServiceImpl();

package/dist/package/declarations/src/api/bi/admin/v1/bi_source.d.ts

@@ -0,0 +1,26 @@
+import type { BiSource, BiSourceForm, BiSourceService, ListBiSourceTablesRequest, ListBiSourceTablesResponse, CreateBiSourceRequest, DeleteBiSourceRequest, DeleteBiSourceResponse, GetBiSourceRequest, OptionBiSourceDatabaseRequest, OptionBiSourceDatabaseResponse, PageBiSourceRequest, PageBiSourceResponse, SetBiSourceStatusRequest, SaveBiSourceModelRequest, TestBiSourceRequest, TestBiSourceResponse, UpdateBiSourceRequest } from "../../../../rpc/bi/admin/v1/bi_source";
+/** BI 数据源配置服务实现。 */
+export declare class BiSourceServiceImpl implements BiSourceService {
+    /** 分页查询当前租户的数据源配置。 */
+    PageBiSource(request: PageBiSourceRequest): Promise<PageBiSourceResponse>;
+    /** 查询数据源配置详情。 */
+    GetBiSource(request: GetBiSourceRequest): Promise<BiSource>;
+    /** 创建数据源配置。 */
+    CreateBiSource(request: CreateBiSourceRequest): Promise<BiSource>;
+    /** 更新数据源配置。 */
+    UpdateBiSource(request: UpdateBiSourceRequest): Promise<BiSource>;
+    /** 删除数据源配置。 */
+    DeleteBiSource(request: DeleteBiSourceRequest): Promise<DeleteBiSourceResponse>;
+    /** 修改数据源启用状态。 */
+    SetBiSourceStatus(request: SetBiSourceStatusRequest): Promise<BiSource>;
+    /** 查询服务端已配置的数据库客户端选项。 */
+    OptionBiSourceDatabase(request: OptionBiSourceDatabaseRequest): Promise<OptionBiSourceDatabaseResponse>;
+    /** 测试数据源连接和表配置。 */
+    TestBiSource(request: TestBiSourceRequest): Promise<TestBiSourceResponse>;
+    /** 查询数据源中的表和字段结构。 */
+    ListBiSourceTables(request: ListBiSourceTablesRequest): Promise<ListBiSourceTablesResponse>;
+    /** 保存数据源语义模型。 */
+    SaveBiSourceModel(request: SaveBiSourceModelRequest): Promise<BiSource>;
+}
+export declare const defBiSourceService: BiSourceServiceImpl;
+export type { BiSourceForm };

package/dist/package/declarations/src/api/bi/admin/v1/bi_source.js

@@ -0,0 +1,46 @@
+import service from "@liujitcn/kratos-admin-core/request";
+const BI_SOURCE_URL = "/v1/admin/bi/source";
+/** BI 数据源配置服务实现。 */
+export class BiSourceServiceImpl {
+    /** 分页查询当前租户的数据源配置。 */
+    PageBiSource(request) {
+        return service({ url: BI_SOURCE_URL, method: "get", params: request });
+    }
+    /** 查询数据源配置详情。 */
+    GetBiSource(request) {
+        return service({ url: `${BI_SOURCE_URL}/${request.id}`, method: "get", params: request });
+    }
+    /** 创建数据源配置。 */
+    CreateBiSource(request) {
+        return service({ url: BI_SOURCE_URL, method: "post", data: request.source });
+    }
+    /** 更新数据源配置。 */
+    UpdateBiSource(request) {
+        return service({ url: `${BI_SOURCE_URL}/${request.source?.id ?? 0}`, method: "put", data: request.source });
+    }
+    /** 删除数据源配置。 */
+    DeleteBiSource(request) {
+        return service({ url: `${BI_SOURCE_URL}/${request.id}`, method: "delete", data: request });
+    }
+    /** 修改数据源启用状态。 */
+    SetBiSourceStatus(request) {
+        return service({ url: `${BI_SOURCE_URL}/${request.id}/status`, method: "put", data: { status: request.status } });
+    }
+    /** 查询服务端已配置的数据库客户端选项。 */
+    OptionBiSourceDatabase(request) {
+        return service({ url: `${BI_SOURCE_URL}/options/databases`, method: "get", params: request });
+    }
+    /** 测试数据源连接和表配置。 */
+    TestBiSource(request) {
+        return service({ url: `${BI_SOURCE_URL}/test`, method: "post", data: request.source });
+    }
+    /** 查询数据源中的表和字段结构。 */
+    ListBiSourceTables(request) {
+        return service({ url: `${BI_SOURCE_URL}/${request.id}/tables`, method: "get", params: request });
+    }
+    /** 保存数据源语义模型。 */
+    SaveBiSourceModel(request) {
+        return service({ url: `${BI_SOURCE_URL}/${request.id}/model`, method: "put", data: request.model });
+    }
+}
+export const defBiSourceService = new BiSourceServiceImpl();

package/dist/package/declarations/src/bi-core.d.ts

@@ -0,0 +1,17 @@
+/** BI 图表内核：真实结果的字段映射、数据转换、图表引擎、布局与主题。 */
+export * from "./schema/types";
+export { flowPlace } from "./schema/layout";
+export { getColumns, toNumber, unique } from "./dataset";
+export { BI_THEME_DARK, BI_THEME_LIGHT, detectDark, resolveTheme, watchDark } from "./theme";
+export type { BiResolvedTheme } from "./theme";
+export { BI_PALETTES, BI_PALETTE_KEYS, resolvePalette } from "./theme/palettes";
+export { BI_DASHBOARD_THEMES, BI_SEMANTIC_COLORS, BI_THEME_PRESET_KEYS, getDashboardThemePreset, resolveDashboardTheme, resolveStageColors } from "./theme/presets";
+export type { BiDashboardThemePreset, BiStageColors } from "./theme/presets";
+export { applyFilters, aggregateRows, sortRows, transformRows, inferFieldType, formatNumber } from "./dataset/transform";
+export type { BiFieldType } from "./dataset/transform";
+export { createEchartsEngine, compileEcharts, installEchartsEngine } from "./engine/echarts";
+export type { BiEChartsOption } from "./engine/echarts";
+export { getEngine, hasEngine, registerEngine } from "./engine/types";
+export type { BiChartEvent, ChartEngine, ChartHandle } from "./engine/types";
+export { registerChartType, getChartTypes, getEngineForType } from "./engine/chart-types";
+export { BI_MESSAGES_ZH, BI_MESSAGES_EN } from "./bi-messages";

package/dist/package/declarations/src/bi-core.js

@@ -0,0 +1,22 @@
+/** BI 图表内核：真实结果的字段映射、数据转换、图表引擎、布局与主题。 */
+// Schema 与缺省
+export * from "./schema/types";
+export { flowPlace } from "./schema/layout";
+// 数据集解析
+export { getColumns, toNumber, unique } from "./dataset";
+// 主题
+export { BI_THEME_DARK, BI_THEME_LIGHT, detectDark, resolveTheme, watchDark } from "./theme";
+export { BI_PALETTES, BI_PALETTE_KEYS, resolvePalette } from "./theme/palettes";
+export { BI_DASHBOARD_THEMES, BI_SEMANTIC_COLORS, BI_THEME_PRESET_KEYS, getDashboardThemePreset, resolveDashboardTheme, resolveStageColors } from "./theme/presets";
+// 数据变换（过滤/聚合/排序/TopN + 字段类型推断 + 数值格式化）
+export { applyFilters, aggregateRows, sortRows, transformRows, inferFieldType, formatNumber } from "./dataset/transform";
+// 引擎
+export { createEchartsEngine, compileEcharts, installEchartsEngine } from "./engine/echarts";
+export { getEngine, hasEngine, registerEngine } from "./engine/types";
+// 图型注册表（引擎适配器包扩展设计器图型）
+export { registerChartType, getChartTypes, getEngineForType } from "./engine/chart-types";
+// 文案包（纯数据）
+export { BI_MESSAGES_ZH, BI_MESSAGES_EN } from "./bi-messages";
+import { installEchartsEngine } from "./engine/echarts";
+// 包加载即注册内置引擎
+installEchartsEngine();

package/dist/package/declarations/src/bi-dashboard-schema.d.ts

@@ -0,0 +1,31 @@
+import type { BiCard } from "./rpc/bi/admin/v1/bi_card";
+import type { BiDashboardDataResponse } from "./rpc/bi/admin/v1/bi_dashboard";
+import type { BiQuerySpec } from "./rpc/bi/admin/v1/bi_query";
+/** 仪表盘只保存名称、卡片引用与栅格位置，外观跟随管理端主题。 */
+export interface DashboardLayout {
+    schemaVersion: 3;
+    name: string;
+    cards: DashboardCardLayout[];
+}
+/** 单张数据卡片的布局与服务端发布快照。 */
+export interface DashboardCardLayout {
+    id: string;
+    card_id: number;
+    query_record_id?: number;
+    x?: number;
+    y?: number;
+    w: number;
+    h: number;
+    name?: string;
+    chart_type?: string;
+    chart_json?: string;
+    query?: BiQuerySpec;
+}
+/** 读取当前协议的仪表盘布局，不接收旧图表与数据集结构。 */
+export declare function parseDashboardLayout(value: string): DashboardLayout;
+/** 将发布快照还原成只读数据卡片，保留当次图表配置。 */
+export declare function dashboardSnapshotCard(item: DashboardCardLayout): BiCard;
+/** 按发布快照匹配真实查询结果，并补齐 HTTP 省略的空集合。 */
+export declare function dashboardResults(data: BiDashboardDataResponse): Map<string, import("./rpc/bi/admin/v1/bi_query").BiQueryResult | undefined>;
+/** 复用现有栅格算法整理卡片位置，避免拖动排序后互相覆盖。 */
+export declare function reflowDashboardCards(cards: DashboardCardLayout[]): DashboardCardLayout[];

package/dist/package/declarations/src/bi-dashboard-schema.js

@@ -0,0 +1,39 @@
+import { flowPlace } from "./schema/layout";
+import { normalizeBiQueryResult, normalizeBiQuerySpec } from "./bi-response";
+/** 读取当前协议的仪表盘布局，不接收旧图表与数据集结构。 */
+export function parseDashboardLayout(value) {
+    if (!value)
+        return { schemaVersion: 3, name: "", cards: [] };
+    const layout = JSON.parse(value);
+    if (layout.schemaVersion !== 3 || !Array.isArray(layout.cards))
+        throw new Error("仪表盘布局格式无效");
+    return { schemaVersion: 3, name: layout.name, cards: layout.cards };
+}
+/** 将发布快照还原成只读数据卡片，保留当次图表配置。 */
+export function dashboardSnapshotCard(item) {
+    return {
+        id: item.card_id,
+        tenant_id: 0,
+        project_id: 0,
+        owner_id: 0,
+        query_record_id: item.query_record_id || 0,
+        name: item.name || "",
+        source_code: item.query?.source_code || "",
+        query: item.query ? normalizeBiQuerySpec(item.query) : undefined,
+        chart_type: item.chart_type || "bar",
+        chart_json: item.chart_json || "",
+        refresh_seconds: 0,
+        is_shared: false,
+        updated_at: "",
+        category: "shared",
+        can_edit: false
+    };
+}
+/** 按发布快照匹配真实查询结果，并补齐 HTTP 省略的空集合。 */
+export function dashboardResults(data) {
+    return new Map((data.cards ?? []).map(item => [item.item_id, item.result ? normalizeBiQueryResult(item.result) : undefined]));
+}
+/** 复用现有栅格算法整理卡片位置，避免拖动排序后互相覆盖。 */
+export function reflowDashboardCards(cards) {
+    return flowPlace(cards.map(item => ({ ...item, x: undefined, y: undefined })), 12).map(item => ({ ...item, x: item.x ?? 0, y: item.y ?? 0 }));
+}