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

package/dist/package/src/rpc/bi/admin/v1/bi_source.ts

@@ -0,0 +1,338 @@
+// Code generated by protoc-gen-ts_proto. DO NOT EDIT.
+// versions:
+//   protoc-gen-ts_proto  v2.12.1
+//   protoc               unknown
+// source: bi/admin/v1/bi_source.proto
+
+/* eslint-disable */
+import type { SecretCrypto } from "../../../common/v1/types";
+
+/** BI 数据源分页查询条件。 */
+export interface PageBiSourceRequest {
+  /** 数据源编码 */
+  code: string;
+  /** 数据源名称 */
+  name: string;
+  /** 服务端数据库客户端名称 */
+  source_name: string;
+  /** 状态：1启用，2禁用 */
+  status?:
+    | number
+    | undefined;
+  /** 页码 */
+  page_num: number;
+  /** 每页数量 */
+  page_size: number;
+}
+
+/** BI 数据源分页响应。 */
+export interface PageBiSourceResponse {
+  /** 数据源配置列表 */
+  sources: BiSource[];
+  /** 总数 */
+  total: number;
+}
+
+/** 查询 BI 数据源请求。 */
+export interface GetBiSourceRequest {
+  /** 数据源ID */
+  id: number;
+}
+
+/** 创建 BI 数据源请求。 */
+export interface CreateBiSourceRequest {
+  /** 数据源配置 */
+  source: BiSourceForm | undefined;
+}
+
+/** 更新 BI 数据源请求。 */
+export interface UpdateBiSourceRequest {
+  /** 数据源配置 */
+  source: BiSourceForm | undefined;
+}
+
+/** 删除 BI 数据源请求。 */
+export interface DeleteBiSourceRequest {
+  /** 数据源ID */
+  id: number;
+}
+
+/** 删除 BI 数据源响应。 */
+export interface DeleteBiSourceResponse {
+}
+
+/** 修改 BI 数据源状态请求。 */
+export interface SetBiSourceStatusRequest {
+  /** 数据源ID */
+  id: number;
+  /** 状态：1启用，2禁用 */
+  status: number;
+}
+
+/** 查询服务端数据库客户端请求。 */
+export interface OptionBiSourceDatabaseRequest {
+}
+
+/** 查询服务端数据库客户端响应。 */
+export interface OptionBiSourceDatabaseResponse {
+  /** 服务端数据库客户端列表 */
+  databases: BiSourceDatabase[];
+}
+
+/** 服务端数据库客户端选项。 */
+export interface BiSourceDatabase {
+  /** 客户端名称 */
+  name: string;
+  /** 数据库驱动 */
+  driver: string;
+}
+
+/** 测试 BI 数据源请求。 */
+export interface TestBiSourceRequest {
+  /** 待测试数据源 */
+  source: BiSourceForm | undefined;
+}
+
+/** 测试 BI 数据源响应。 */
+export interface TestBiSourceResponse {
+  /** 是否可访问 */
+  success: boolean;
+  /** 测试结果说明 */
+  message: string;
+}
+
+/** 查询数据源数据库表结构的请求。 */
+export interface ListBiSourceTablesRequest {
+  /** 数据源ID */
+  id: number;
+}
+
+/** 数据库表字段的结构信息。 */
+export interface BiSourceSchemaColumn {
+  /** 字段名称 */
+  name: string;
+  /** 数据库字段类型 */
+  data_type: string;
+  /** 是否允许为空 */
+  nullable: boolean;
+  /** 是否为主键 */
+  primary_key: boolean;
+  /** 是否有单列唯一约束 */
+  unique: boolean;
+  /** 字段注释 */
+  comment: string;
+}
+
+/** 数据库中的表或视图结构。 */
+export interface BiSourceSchemaTable {
+  /** 表结构标识 */
+  key: string;
+  /** 数据库Schema */
+  schema_name: string;
+  /** 表或视图名称 */
+  name: string;
+  /** 表类型 */
+  table_type: string;
+  /** 字段列表 */
+  columns: BiSourceSchemaColumn[];
+  /** 表或视图注释 */
+  comment: string;
+}
+
+/** 查询数据源表结构的响应。 */
+export interface ListBiSourceTablesResponse {
+  /** 数据库表结构 */
+  tables: BiSourceSchemaTable[];
+}
+
+/** 保存数据源语义模型的请求。 */
+export interface SaveBiSourceModelRequest {
+  /** 数据源ID */
+  id: number;
+  /** 数据源语义模型 */
+  model: BiSourceModel | undefined;
+}
+
+/** 数据源可用的表、关联关系和业务语义。 */
+export interface BiSourceModel {
+  /** 事实表标识 */
+  base_table: string;
+  /** 选中的表结构 */
+  tables: BiSourceModelTable[];
+  /** 表关联关系 */
+  relations: BiSourceRelation[];
+  /** 语义维度 */
+  dimensions: BiSourceDimension[];
+  /** 语义指标 */
+  measures: BiSourceMeasure[];
+}
+
+/** 语义模型中的表节点。 */
+export interface BiSourceModelTable {
+  /** 表结构标识 */
+  key: string;
+  /** 租户隔离字段，为空表示连接级隔离或共享表 */
+  tenant_column: string;
+  /** 画布横坐标 */
+  x: number;
+  /** 画布纵坐标 */
+  y: number;
+}
+
+/** 两张表之间经过确认的多对一关系。 */
+export interface BiSourceRelation {
+  /** 已连接表标识 */
+  left_table: string;
+  /** 已连接表字段 */
+  left_column: string;
+  /** 维度表标识 */
+  right_table: string;
+  /** 维度表唯一字段 */
+  right_column: string;
+  /** 连接类型 */
+  join_type: string;
+}
+
+/** 数据源语义维度。 */
+export interface BiSourceDimension {
+  /** 语义编码 */
+  code: string;
+  /** 展示名称 */
+  name: string;
+  /** BI字段类型 */
+  type: string;
+  /** 所属表标识 */
+  table: string;
+  /** 数据库字段 */
+  column: string;
+  /** 是否允许过滤 */
+  filterable: boolean;
+}
+
+/** 数据源语义指标。 */
+export interface BiSourceMeasure {
+  /** 语义编码 */
+  code: string;
+  /** 展示名称 */
+  name: string;
+  /** BI字段类型 */
+  type: string;
+  /** 所属表标识 */
+  table: string;
+  /** 数据库字段 */
+  column: string;
+  /** 允许的聚合函数 */
+  aggregations: string[];
+}
+
+/** BI 数据源配置表单。 */
+export interface BiSourceForm {
+  /** 数据源ID */
+  id: number;
+  /** 数据源编码 */
+  code: string;
+  /** 数据源名称 */
+  name: string;
+  /** 数据源说明 */
+  description: string;
+  /** 服务端数据库客户端名称 */
+  source_name: string;
+  /** 数据库驱动 */
+  driver: string;
+  /** 数据库主机 */
+  host: string;
+  /** 数据库端口 */
+  port: number;
+  /** 数据库名称 */
+  database_name: string;
+  /** 数据库用户名 */
+  username: string;
+  /** 数据库密码密文 */
+  password:
+    | SecretCrypto
+    | undefined;
+  /** PostgreSQL SSL模式 */
+  ssl_mode: string;
+  /** 数据库 Schema */
+  schema_name: string;
+  /** 最大结果行数 */
+  max_rows: number;
+  /** 状态：1启用，2禁用 */
+  status: number;
+}
+
+/** BI 数据源配置。 */
+export interface BiSource {
+  /** 数据源ID */
+  id: number;
+  /** 租户ID */
+  tenant_id: number;
+  /** 数据源编码 */
+  code: string;
+  /** 数据源名称 */
+  name: string;
+  /** 数据源说明 */
+  description: string;
+  /** 服务端数据库客户端名称 */
+  source_name: string;
+  /** 数据库驱动 */
+  driver: string;
+  /** 数据库主机 */
+  host: string;
+  /** 数据库端口 */
+  port: number;
+  /** 数据库名称 */
+  database_name: string;
+  /** 数据库用户名 */
+  username: string;
+  /** 是否已保存数据库密码 */
+  password_configured: boolean;
+  /** PostgreSQL SSL模式 */
+  ssl_mode: string;
+  /** 数据库 Schema */
+  schema_name: string;
+  /** 数据库表或视图名称 */
+  table_name: string;
+  /** 租户列 */
+  tenant_column: string;
+  /** 维度和指标语义配置 JSON */
+  schema_json: string;
+  /** 状态：1启用，2禁用 */
+  status: number;
+  /** 语义版本 */
+  version: number;
+  /** 最大结果行数 */
+  max_rows: number;
+  /** 创建时间 */
+  created_at: string;
+  /** 更新时间 */
+  updated_at: string;
+  /** 是否已配置语义模型 */
+  model_configured: boolean;
+  /** 模型选中的表数量 */
+  table_count: number;
+}
+
+/** BI 数据源配置管理服务。 */
+export interface 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>;
+}

package/dist/package/src/rpc/common/v1/types.ts

@@ -0,0 +1,77 @@
+// Code generated by protoc-gen-ts_proto. DO NOT EDIT.
+// versions:
+//   protoc-gen-ts_proto  v2.12.1
+//   protoc               unknown
+// source: common/v1/types.proto
+
+/* eslint-disable */
+
+/** double 类型数组包装消息。 */
+export interface DoubleValues {
+  /** 值列表。 */
+  value: number[];
+}
+
+/** float 类型数组包装消息。 */
+export interface FloatValues {
+  /** 值列表。 */
+  value: number[];
+}
+
+/** int64 类型数组包装消息。 */
+export interface Int64Values {
+  /** 值列表。 */
+  value: number[];
+}
+
+/** uint64 类型数组包装消息。 */
+export interface UInt64Values {
+  /** 值列表。 */
+  value: number[];
+}
+
+/** int32 类型数组包装消息。 */
+export interface Int32Values {
+  /** 值列表。 */
+  value: number[];
+}
+
+/** uint32 类型数组包装消息。 */
+export interface UInt32Values {
+  /** 值列表。 */
+  value: number[];
+}
+
+/** bool 类型数组包装消息。 */
+export interface BoolValues {
+  /** 值列表。 */
+  value: boolean[];
+}
+
+/** string 类型数组包装消息。 */
+export interface StringValues {
+  /** 值列表。 */
+  value: string[];
+}
+
+/** bytes 类型数组包装消息。 */
+export interface BytesValues {
+  /** 值列表。 */
+  value: Uint8Array[];
+}
+
+/** 敏感字段密文，密码与各类密钥字段统一使用。 */
+export interface SecretCrypto {
+  /** 临时密钥ID */
+  key_id: string;
+  /** 随机值 */
+  nonce: string;
+  /** 加密算法 */
+  algorithm: string;
+  /** 加密后的对称密钥 */
+  encrypted_key: string;
+  /** 初始化向量 */
+  iv: string;
+  /** 传输时为密文，服务端解密后回填明文 */
+  text: string;
+}

package/dist/package/src/schema/layout.ts

@@ -0,0 +1,54 @@
+/** 流式放置只修改栅格坐标，浅拷贝卡片以支持响应式查询快照。 */
+export function flowPlace<T extends { x?: number; y?: number; w: number; h: number }>(charts: T[], columns: number): T[] {
+  if (
+    !Number.isInteger(columns) ||
+    columns < 1 ||
+    charts.some(
+      item =>
+        !Number.isInteger(item.w) ||
+        !Number.isInteger(item.h) ||
+        (item.w ?? 6) < 1 ||
+        (item.w ?? 6) > columns ||
+        (item.h ?? 4) < 1
+    )
+  )
+    throw new Error("卡片栅格尺寸无效");
+  const placed = charts.map(item => ({ ...item }));
+  const occupied = new Set<string>();
+  const mark = (c: T) => {
+    const w = c.w ?? 6;
+    const h = c.h ?? 4;
+    for (let dx = 0; dx < w; dx++) {
+      for (let dy = 0; dy < h; dy++) occupied.add(`${(c.x ?? 0) + dx},${(c.y ?? 0) + dy}`);
+    }
+  };
+  placed.forEach(c => {
+    if (c.x !== undefined && c.y !== undefined) {
+      mark(c);
+    }
+  });
+  for (const c of placed) {
+    if (c.x !== undefined && c.y !== undefined) continue;
+    const w = c.w ?? 6;
+    const h = c.h ?? 4;
+    let found = false;
+    for (let y = 0; !found; y++) {
+      for (let x = 0; x + w <= columns; x++) {
+        let free = true;
+        for (let dx = 0; dx < w && free; dx++) {
+          for (let dy = 0; dy < h && free; dy++) {
+            if (occupied.has(`${x + dx},${y + dy}`)) free = false;
+          }
+        }
+        if (free) {
+          c.x = x;
+          c.y = y;
+          mark(c);
+          found = true;
+          break;
+        }
+      }
+    }
+  }
+  return placed;
+}

package/dist/package/src/schema/types.ts

@@ -0,0 +1,103 @@
+export type BiRow = Record<string, any>;
+
+export type BiChartType =
+  | "bar"
+  | "line"
+  | "area"
+  | "pie"
+  | "donut"
+  | "scatter"
+  | "radar"
+  | "gauge"
+  | "funnel"
+  | "treemap"
+  | "sunburst"
+  | "sankey"
+  | "heatmap"
+  /** 引擎适配器注册的扩展图型（如 s2 的 "pivot"、g6 的 "graph"） */
+  | (string & {});
+
+export interface BiChartEncoding {
+  /** 类目轴 / 饼名 / 雷达指标名字段 */
+  dimension?: string;
+  /** 值轴 / 饼值 / 雷达值 / 仪表值字段（单度量） */
+  measure?: string;
+  /** 宽表多度量：每个字段各成一个系列（与 measure/series 互斥，优先级最高） */
+  measures?: string[];
+  /** 系列拆分字段（长表格式，可选） */
+  series?: string;
+}
+
+/** 聚合函数：dimension 分组后对 measure 施加；"none" 不聚合 */
+export type BiAggFn = "sum" | "avg" | "count" | "max" | "min" | "none";
+
+export type BiFilterOp = "eq" | "ne" | "gt" | "gte" | "lt" | "lte" | "contains" | "in";
+
+export interface BiChartFilter {
+  field: string;
+  op: BiFilterOp;
+  /** eq/ne/比较/contains：标量；in：数组（UI 以逗号分隔输入） */
+  value: string | number | (string | number)[];
+}
+
+export interface BiChartSort {
+  /** 按维度（类目名）或度量（聚合值）排序 */
+  by: "dimension" | "measure";
+  order: "asc" | "desc";
+  /** 取前 N 项（排序后截断；不传 = 全量） */
+  topN?: number;
+}
+
+export interface BiNumberFormat {
+  /** 小数位数（缺省不处理） */
+  decimals?: number;
+  /** 千分位 */
+  thousand?: boolean;
+  prefix?: string;
+  suffix?: string;
+}
+
+export interface BiChartStyle {
+  /** 柱状图堆叠 */
+  stack?: boolean;
+  /** 显式开关图例（缺省：多系列自动显示） */
+  showLegend?: boolean;
+  /** 系列上的数值标签 */
+  showLabel?: boolean;
+  /** 数据缩放（区域缩放滑块，柱/线/面/散点） */
+  dataZoom?: boolean;
+  /** 色盘 key，见 BI_PALETTES */
+  palette?: string;
+  /** 数值格式化（轴标签/标签/提示） */
+  format?: BiNumberFormat;
+}
+
+export interface BiChartSchema {
+  id: string;
+  title?: string;
+  datasetId: string;
+  /** 图表引擎，默认 "echarts" */
+  engine?: string;
+  type: BiChartType;
+  /** 12 列网格坐标（栅格单位）；x/y 缺省自动流式放置 */
+  x?: number;
+  y?: number;
+  w?: number;
+  h?: number;
+  encoding: BiChartEncoding;
+  /** 聚合函数（dimension 分组 + measure 聚合），缺省 "sum"（设 "none" 关闭） */
+  aggregation?: BiAggFn;
+  /** 排序 + TopN */
+  sort?: BiChartSort;
+  /** 图表级过滤器（作用于数据集行） */
+  filters?: BiChartFilter[];
+  /** 样式选项（堆叠/图例/标签/数据缩放/色盘/数字格式） */
+  style?: BiChartStyle;
+  /**
+   * 下钻路径（维度层级，如 ["category","city"]）：点击图表逐层下钻，
+   * 父层级值作为隐式过滤器携带；渲染器提供返回上一层的面包屑。
+   */
+  drill?: { path: string[] };
+  /** 引擎原生透传覆盖（深合并到编译产物） */
+  options?: Record<string, any>;
+}

package/dist/package/src/styles.scss

@@ -0,0 +1 @@
+/* BI 页面和组件使用现有 Element Plus 与管理端主题变量。 */

package/dist/package/src/theme/index.ts

@@ -0,0 +1,108 @@
+/**
+ * BI 主题 token：亮/暗两套图表配色，对齐 EP 语义色与 go-wind 设计语言暗色底。
+ * 主题在编译期写进引擎 option（backgroundColor 恒为 transparent，宿主背景透出）。
+ */
+
+export interface BiResolvedTheme {
+  mode: "light" | "dark";
+  /** 系列色盘（10 色） */
+  palette: string[];
+  /** 主文本（标题/图例） */
+  text: string;
+  /** 次文本（轴标签/饼标签） */
+  subText: string;
+  /** 轴线 */
+  axisLine: string;
+  /** 分隔线 */
+  splitLine: string;
+  /** tooltip 底色 */
+  tooltipBg: string;
+}
+
+const PALETTE = [
+  "#409eff",
+  "#67c23a",
+  "#e6a23c",
+  "#f56c6c",
+  "#909399",
+  "#36cfc9",
+  "#722ed1",
+  "#fa8c16",
+  "#13c2c2",
+  "#eb2f96",
+];
+
+export const BI_THEME_LIGHT: BiResolvedTheme = {
+  mode: "light",
+  palette: PALETTE,
+  text: "#1f2937",
+  subText: "#6b7280",
+  axisLine: "#e5e7eb",
+  splitLine: "#f3f4f6",
+  tooltipBg: "#ffffff",
+};
+
+export const BI_THEME_DARK: BiResolvedTheme = {
+  mode: "dark",
+  palette: PALETTE,
+  // 对齐 EP 暗色文本阶（--el-text-color-* 的暗色值）
+  text: "#e5eaf3",
+  subText: "#a3a6ad",
+  axisLine: "#4c4d4f",
+  splitLine: "#414243",
+  tooltipBg: "#1d1e1f",
+};
+
+export function resolveTheme(mode: "light" | "dark"): BiResolvedTheme {
+  return mode === "dark" ? BI_THEME_DARK : BI_THEME_LIGHT;
+}
+
+// ============ 宿主无关的暗色探测（渲染器缺省跟随） ============
+
+/** 非响应式读取当前是否暗色：html.dark class 优先，其次系统偏好 */
+export function detectDark(): boolean {
+  if (typeof document !== "undefined" && document.documentElement.classList.contains("dark")) {
+    return true;
+  }
+  if (typeof window !== "undefined" && window.matchMedia?.("(prefers-color-scheme: dark)").matches) {
+    return true;
+  }
+  return false;
+}
+
+/**
+ * 监听暗色翻转（模块级共享一份 MutationObserver + matchMedia listener）。
+ * 返回解绑函数。渲染器各端订阅它实现缺省主题跟随。
+ */
+export function watchDark(cb: (dark: boolean) => void): () => void {
+  if (typeof document === "undefined") return () => undefined;
+  let bound = false;
+  const subs = new Set<(dark: boolean) => void>();
+  let observer: MutationObserver | null = null;
+  let mq: MediaQueryList | null = null;
+
+  const sync = () => {
+    const dark = detectDark();
+    subs.forEach((s) => s(dark));
+  };
+
+  const ensure = () => {
+    if (bound) return;
+    bound = true;
+    observer = new MutationObserver(sync);
+    observer.observe(document.documentElement, { attributes: true, attributeFilter: ["class"] });
+    if (typeof window !== "undefined" && window.matchMedia) {
+      mq = window.matchMedia("(prefers-color-scheme: dark)");
+      mq.addEventListener("change", sync);
+    }
+  };
+
+  ensure();
+  subs.add(cb);
+  cb(detectDark());
+
+  return () => {
+    subs.delete(cb);
+    // 观察器常驻（模块级单例），不逐订阅者拆除
+  };
+}