Croupier 系统函数管理架构分析报告

// 功能
- 全文搜索 (by name, description, category)
- 高级过滤 (category, version, assigned_to_game, health_status)
- 列表/卡片/详情三视图切换
- 批量操作 (enable/disable for game, export)
- 版本选择和对比

// 数据结构扩展
interface FunctionDescriptor {
  id: string;
  version: string;
  category: string;                // 分类
  description?: string;            // 描述
  params?: JSONSchema;
  auth?: Record<string, any>;
  outputs?: ViewDefinitions;
  metadata?: {
    created_at: string;
    created_by: string;
    updated_at: string;
    updated_by: string;
    tags?: string[];               // 标签
    deprecated?: boolean;          // 弃用标志
  };
}

// 当前：简单白名单
// 改进：细粒度权限模型

interface FunctionAssignment {
  game_id: string;
  env: string;
  functions: string[];                    // 白名单
  
  // 新增：细粒度权限
  role_assignments?: {                    // 按角色分配
    [role: string]: string[];
  };
  
  // 新增：时间控制
  time_windows?: {
    enabled: string[];                    // 仅在指定时间可用的函数
    disabled: string[];                   // 禁用时间段
  };
  
  // 新增：审计
  change_history?: Array<{
    timestamp: string;
    actor: string;
    operation: 'add' | 'remove' | 'enable' | 'disable';
    function_id: string;
    reason?: string;
  }>;
}

// 统一函数参数表单渲染
export interface FormRenderConfig {
  schema: JSONSchema;
  uiSchema?: UISchema;
  mode?: 'simple' | 'advanced';     // 简化/高级模式
  readOnly?: boolean;
  onSubmit?: (values: any) => void;
}

// 使用场处：
// - GmFunctions: 函数调用表单
// - Assignments: 参数预设配置
// - Approvals: 审批时的参数验证

// 提取 Registry 的表格和统计逻辑
export interface RegistryViewProps {
  agents?: Agent[];
  functions?: Function[];
  coverage?: Coverage[];
  loading?: boolean;
  groupBy?: 'prefix' | 'none';
  filter?: {
    gameId?: string;
    env?: string;
    uncovered?: boolean;
    partial?: boolean;
  };
  onExport?: (type: 'csv' | 'json') => void;
}

// 使用场景：
// - Operations/Registry: 完整视图
// - Instances: 部分视图
// - Dashboards: 嵌入式组件

// 支持多种展示模式
export interface FunctionListProps {
  descriptors: FunctionDescriptor[];
  mode?: 'list' | 'grid' | 'table';
  search?: string;
  filters?: FunctionFilter;
  selectable?: boolean;
  selected?: string[];
  onSelect?: (id: string, selected: boolean) => void;
  onInvoke?: (id: string) => void;
}

// 使用场景：
// - Catalog: 主列表视图
// - Assignments: 函数选择
// - Approvals: 函数搜索

// 后端应该提供的新数据结构

interface EnrichedFunctionDescriptor {
  // 原有字段
  id: string;
  version: string;
  params?: JSONSchema;
  
  // 元数据
  metadata?: {
    category: string;
    tags: string[];
    description: string;
    creator: string;
    created_at: string;
    updated_at: string;
    deprecation_notice?: string;
  };
  
  // 运行时信息
  runtime?: {
    instances: number;                    // 有多少个实例
    agents: string[];                     // 哪些 Agent 上有
    last_called?: string;                 // 最后调用时间
    success_rate?: number;                // 成功率
    avg_latency_ms?: number;              // 平均延迟
  };
  
  // 权限信息
  permissions?: {
    assigned_games: string[];             // 分配给哪些游戏
    required_role?: string;               // 所需角色
  };
}

// 新的路由结构
{
  path: '/functions',
  name: 'FunctionManagement',
  icon: 'code',
  routes: [
    { path: '/functions', redirect: '/functions/catalog' },
    
    // 主页面
    { path: '/functions/catalog', name: 'Catalog', component: './Functions/Catalog' },
    { path: '/functions/invoke', name: 'Invoke', component: './Functions/Invoke' },
    { path: '/functions/invoke/:id', hideInMenu: true, component: './Functions/InvokeDetail' },
    { path: '/functions/assignments', name: 'Assignments', component: './Functions/Assignments' },
    { path: '/functions/instances', name: 'Instances', component: './Functions/Instances' },
    { path: '/functions/packs', name: 'Packs', component: './Functions/Packs' },
    
    // 详情页
    { path: '/functions/:id', hideInMenu: true, component: './Functions/Detail' },
    { path: '/functions/:id/history', hideInMenu: true, component: './Functions/History' },
    { path: '/functions/:id/compare', hideInMenu: true, component: './Functions/Compare' },
  ]
}

// 后向兼容重定向
{ path: '/game/functions', redirect: '/functions/invoke' },
{ path: '/game/assignments', redirect: '/functions/assignments' },
{ path: '/game/packs', redirect: '/functions/packs' },
{ path: '/operations/registry', redirect: '/functions/instances' },