Add aggregate diversity (avg/max), cross-object order widget, rendering tests + edge cases

Copilot · hotlong · Copilot · commit 3ec060bc72bc · 2026-02-24T14:18:37.000Z
- Add 2 new dashboard widgets: "Avg Deal Size by Stage" (line, avg),
  "Orders by Status" (bar, max, order object — cross-object)
- Add i18n keys for new widgets across all 10 locales
- Add 6 new DashboardRenderer rendering tests: area/donut/line/cross-object
  provider:'object' schema validation + empty widgets + null data edge cases
- Update CRM metadata test for avg/max diversity + cross-object validation
- Update ROADMAP entry with full scope

Co-authored-by: hotlong &lt;50353452+hotlong@users.noreply.github.com&gt;
diff --git a/ROADMAP.md b/ROADMAP.md
@@ -863,7 +863,7 @@ The `FlowDesigner` is a canvas-based flow editor that bridges the gap between th
 - [x] **P2: Dashboard Widget Spec Alignment** — Added `id`, `title`, `object`, `categoryField`, `valueField`, `aggregate` to all dashboard widgets across CRM, Todo, and Kitchen Sink examples (5 new spec-compliance tests)
 - [x] **P2: i18n (10 locales)** — Full CRM metadata translations for en, zh, ja, ko, de, fr, es, pt, ru, ar — objects, fields, fieldOptions, navigation, actions, views, formSections, dashboard, reports, pages (24 tests)
 - [x] **P2: Full Examples Metadata Audit** — Systematic spec compliance audit across all 4 examples: added `type: 'dashboard'` + `description` to todo/kitchen-sink dashboards, refactored msw-todo to use `ObjectSchema.create` + `Field.*` with snake_case field names, added explicit views to kitchen-sink and msw-todo, added missing `successMessage` on CRM opportunity action, 21 automated compliance tests
-- [x] **P2: CRM Dashboard Full provider:'object' Adaptation** — Converted all chart and table widgets in CRM dashboard from static `provider: 'value'` to dynamic `provider: 'object'` with aggregation configs. Revenue Trends (sum expected_revenue by stage), Lead Source (count by lead_source), Pipeline by Stage (sum amount by stage), Top Products (sum price by category), Recent Opportunities table (dynamic fetch), Revenue by Account (already dynamic). Fixed table `close_date` field alignment. Added 7 new provider:'object' validation tests covering aggregate config, field alignment, and function diversity.
+- [x] **P2: CRM Dashboard Full provider:'object' Adaptation** — Converted all chart and table widgets in CRM dashboard from static `provider: 'value'` to dynamic `provider: 'object'` with aggregation configs. 12 widgets total: 4 KPI metrics (static), 7 charts (sum/count/avg/max aggregation across opportunity, product, order objects), 1 table (dynamic fetch). Cross-object coverage (order), diverse aggregate functions (sum, count, avg, max). Fixed table `close_date` field alignment. Added i18n for 2 new widgets (10 locales). 9 new CRM metadata tests, 6 new DashboardRenderer rendering tests (area/donut/line/cross-object + edge cases). All provider:'object' paths covered.
 
 ### Ecosystem & Marketplace
 - Plugin marketplace website with search, ratings, and install count
diff --git a/examples/crm/src/__tests__/crm-metadata.test.ts b/examples/crm/src/__tests__/crm-metadata.test.ts
@@ -272,12 +272,22 @@ describe('CRM Metadata Spec Compliance', () => {
       }
     });
 
-    it('dashboard covers diverse aggregate functions (sum, count)', () => {
+    it('dashboard covers diverse aggregate functions (sum, count, avg, max)', () => {
       const chartTypes = ['bar', 'area', 'donut', 'line', 'pie'];
       const charts = CrmDashboard.widgets.filter((w) => chartTypes.includes(w.type));
       const aggFns = new Set(charts.map((w) => (w.options as any)?.data?.aggregate?.function));
       expect(aggFns.has('sum')).toBe(true);
       expect(aggFns.has('count')).toBe(true);
+      expect(aggFns.has('avg')).toBe(true);
+      expect(aggFns.has('max')).toBe(true);
+    });
+
+    it('dashboard includes cross-object widgets (order)', () => {
+      const orderWidgets = CrmDashboard.widgets.filter((w) => w.object === 'order');
+      expect(orderWidgets.length).toBeGreaterThanOrEqual(1);
+      const data = (orderWidgets[0].options as any)?.data;
+      expect(data.provider).toBe('object');
+      expect(data.object).toBe('order');
     });
   });
 
@@ -450,6 +460,8 @@ describe('CRM i18n Completeness', () => {
       expect(enLocale.dashboard.widgets.topProducts).toBeDefined();
       expect(enLocale.dashboard.widgets.recentOpportunities).toBeDefined();
       expect(enLocale.dashboard.widgets.revenueByAccount).toBeDefined();
+      expect(enLocale.dashboard.widgets.avgDealSizeByStage).toBeDefined();
+      expect(enLocale.dashboard.widgets.ordersByStatus).toBeDefined();
     });
   });
 });
diff --git a/examples/crm/src/dashboards/crm.dashboard.ts b/examples/crm/src/dashboards/crm.dashboard.ts
@@ -167,6 +167,44 @@ export const CrmDashboard = {
                 aggregate: { field: 'amount', function: 'sum' as const, groupBy: 'account' }
             }
         },
+    },
+
+    // --- Row 6: Additional aggregate functions (avg, max) + cross-object ---
+    {
+        title: 'Avg Deal Size by Stage',
+        type: 'line' as const,
+        object: 'opportunity',
+        categoryField: 'stage',
+        valueField: 'amount',
+        aggregate: 'avg',
+        layout: { x: 0, y: 9, w: 2, h: 2 },
+        options: {
+            xField: 'stage',
+            yField: 'amount',
+            data: {
+                provider: 'object' as const,
+                object: 'opportunity',
+                aggregate: { field: 'amount', function: 'avg' as const, groupBy: 'stage' }
+            }
+        },
+    },
+    {
+        title: 'Orders by Status',
+        type: 'bar' as const,
+        object: 'order',
+        categoryField: 'status',
+        valueField: 'amount',
+        aggregate: 'max',
+        layout: { x: 2, y: 9, w: 2, h: 2 },
+        options: {
+            xField: 'status',
+            yField: 'amount',
+            data: {
+                provider: 'object' as const,
+                object: 'order',
+                aggregate: { field: 'amount', function: 'max' as const, groupBy: 'status' }
+            }
+        },
     }
   ]
 };
diff --git a/examples/crm/src/i18n/ar.ts b/examples/crm/src/i18n/ar.ts
@@ -96,7 +96,7 @@ const ar = {
   },
   dashboard: {
     title: 'نظرة عامة على CRM',
-    widgets: { totalRevenue: 'إجمالي الإيرادات', activeDeals: 'الصفقات النشطة', winRate: 'معدل الفوز', avgDealSize: 'متوسط حجم الصفقة', revenueTrends: 'اتجاهات الإيرادات', leadSource: 'مصدر العملاء المحتملين', pipelineByStage: 'خط الأنابيب حسب المرحلة', topProducts: 'أفضل المنتجات', recentOpportunities: 'الفرص الأخيرة', revenueByAccount: 'الإيرادات حسب الحساب' },
+    widgets: { totalRevenue: 'إجمالي الإيرادات', activeDeals: 'الصفقات النشطة', winRate: 'معدل الفوز', avgDealSize: 'متوسط حجم الصفقة', revenueTrends: 'اتجاهات الإيرادات', leadSource: 'مصدر العملاء المحتملين', pipelineByStage: 'خط الأنابيب حسب المرحلة', topProducts: 'أفضل المنتجات', recentOpportunities: 'الفرص الأخيرة', revenueByAccount: 'الإيرادات حسب الحساب', avgDealSizeByStage: 'متوسط حجم الصفقة حسب المرحلة', ordersByStatus: 'الطلبات حسب الحالة' },
     trendLabel: 'مقارنة بالشهر الماضي',
     columns: { opportunityName: 'اسم الفرصة', amount: 'المبلغ', stage: 'المرحلة', closeDate: 'تاريخ الإغلاق' },
   },
diff --git a/examples/crm/src/i18n/de.ts b/examples/crm/src/i18n/de.ts
@@ -118,7 +118,7 @@ const de = {
   },
   dashboard: {
     title: 'CRM-Übersicht',
-    widgets: { totalRevenue: 'Gesamtumsatz', activeDeals: 'Aktive Geschäfte', winRate: 'Gewinnrate', avgDealSize: 'Ø Geschäftsgröße', revenueTrends: 'Umsatztrends', leadSource: 'Lead-Quelle', pipelineByStage: 'Pipeline nach Phase', topProducts: 'Top-Produkte', recentOpportunities: 'Aktuelle Chancen', revenueByAccount: 'Umsatz nach Konto' },
+    widgets: { totalRevenue: 'Gesamtumsatz', activeDeals: 'Aktive Geschäfte', winRate: 'Gewinnrate', avgDealSize: 'Ø Geschäftsgröße', revenueTrends: 'Umsatztrends', leadSource: 'Lead-Quelle', pipelineByStage: 'Pipeline nach Phase', topProducts: 'Top-Produkte', recentOpportunities: 'Aktuelle Chancen', revenueByAccount: 'Umsatz nach Konto', avgDealSizeByStage: 'Ø Geschäftsgröße nach Phase', ordersByStatus: 'Bestellungen nach Status' },
     trendLabel: 'ggü. Vormonat',
     columns: { opportunityName: 'Chancenname', amount: 'Betrag', stage: 'Phase', closeDate: 'Abschlussdatum' },
   },
diff --git a/examples/crm/src/i18n/en.ts b/examples/crm/src/i18n/en.ts
@@ -381,6 +381,8 @@ const en = {
       topProducts: 'Top Products',
       recentOpportunities: 'Recent Opportunities',
       revenueByAccount: 'Revenue by Account',
+      avgDealSizeByStage: 'Avg Deal Size by Stage',
+      ordersByStatus: 'Orders by Status',
     },
     trendLabel: 'vs last month',
     columns: {
diff --git a/examples/crm/src/i18n/es.ts b/examples/crm/src/i18n/es.ts
@@ -118,7 +118,7 @@ const es = {
   },
   dashboard: {
     title: 'Resumen CRM',
-    widgets: { totalRevenue: 'Ingresos totales', activeDeals: 'Negocios activos', winRate: 'Tasa de éxito', avgDealSize: 'Tamaño promedio', revenueTrends: 'Tendencias de ingresos', leadSource: 'Fuente de leads', pipelineByStage: 'Pipeline por etapa', topProducts: 'Productos principales', recentOpportunities: 'Oportunidades recientes', revenueByAccount: 'Ingresos por cuenta' },
+    widgets: { totalRevenue: 'Ingresos totales', activeDeals: 'Negocios activos', winRate: 'Tasa de éxito', avgDealSize: 'Tamaño promedio', revenueTrends: 'Tendencias de ingresos', leadSource: 'Fuente de leads', pipelineByStage: 'Pipeline por etapa', topProducts: 'Productos principales', recentOpportunities: 'Oportunidades recientes', revenueByAccount: 'Ingresos por cuenta', avgDealSizeByStage: 'Tamaño promedio por etapa', ordersByStatus: 'Pedidos por estado' },
     trendLabel: 'vs mes anterior',
     columns: { opportunityName: 'Nombre de oportunidad', amount: 'Monto', stage: 'Etapa', closeDate: 'Fecha de cierre' },
   },
diff --git a/examples/crm/src/i18n/fr.ts b/examples/crm/src/i18n/fr.ts
@@ -118,7 +118,7 @@ const fr = {
   },
   dashboard: {
     title: 'Aperçu CRM',
-    widgets: { totalRevenue: 'Chiffre d\'affaires total', activeDeals: 'Affaires actives', winRate: 'Taux de réussite', avgDealSize: 'Taille moyenne', revenueTrends: 'Tendances du CA', leadSource: 'Source des leads', pipelineByStage: 'Pipeline par étape', topProducts: 'Produits phares', recentOpportunities: 'Opportunités récentes', revenueByAccount: 'CA par compte' },
+    widgets: { totalRevenue: 'Chiffre d\'affaires total', activeDeals: 'Affaires actives', winRate: 'Taux de réussite', avgDealSize: 'Taille moyenne', revenueTrends: 'Tendances du CA', leadSource: 'Source des leads', pipelineByStage: 'Pipeline par étape', topProducts: 'Produits phares', recentOpportunities: 'Opportunités récentes', revenueByAccount: 'CA par compte', avgDealSizeByStage: 'Taille moyenne par étape', ordersByStatus: 'Commandes par statut' },
     trendLabel: 'vs mois précédent',
     columns: { opportunityName: 'Nom de l\'opportunité', amount: 'Montant', stage: 'Étape', closeDate: 'Date de clôture' },
   },
diff --git a/examples/crm/src/i18n/ja.ts b/examples/crm/src/i18n/ja.ts
@@ -378,6 +378,8 @@ const ja = {
       topProducts: '人気商品',
       recentOpportunities: '最近の商談',
       revenueByAccount: '取引先別売上',
+      avgDealSizeByStage: 'ステージ別平均取引規模',
+      ordersByStatus: 'ステータス別注文',
     },
     trendLabel: '前月比',
     columns: {
diff --git a/examples/crm/src/i18n/ko.ts b/examples/crm/src/i18n/ko.ts
@@ -118,7 +118,7 @@ const ko = {
   },
   dashboard: {
     title: 'CRM 개요',
-    widgets: { totalRevenue: '총 매출', activeDeals: '활성 거래', winRate: '수주율', avgDealSize: '평균 거래 규모', revenueTrends: '매출 추이', leadSource: '리드 소스', pipelineByStage: '단계별 파이프라인', topProducts: '인기 제품', recentOpportunities: '최근 영업기회', revenueByAccount: '거래처별 매출' },
+    widgets: { totalRevenue: '총 매출', activeDeals: '활성 거래', winRate: '수주율', avgDealSize: '평균 거래 규모', revenueTrends: '매출 추이', leadSource: '리드 소스', pipelineByStage: '단계별 파이프라인', topProducts: '인기 제품', recentOpportunities: '최근 영업기회', revenueByAccount: '거래처별 매출', avgDealSizeByStage: '단계별 평균 거래 규모', ordersByStatus: '상태별 주문' },
     trendLabel: '전월 대비',
     columns: { opportunityName: '영업기회명', amount: '금액', stage: '단계', closeDate: '종료일' },
   },
diff --git a/examples/crm/src/i18n/pt.ts b/examples/crm/src/i18n/pt.ts
@@ -96,7 +96,7 @@ const pt = {
   },
   dashboard: {
     title: 'Visão geral CRM',
-    widgets: { totalRevenue: 'Receita total', activeDeals: 'Negócios ativos', winRate: 'Taxa de sucesso', avgDealSize: 'Tamanho médio', revenueTrends: 'Tendências de receita', leadSource: 'Fonte de leads', pipelineByStage: 'Pipeline por etapa', topProducts: 'Principais produtos', recentOpportunities: 'Oportunidades recentes', revenueByAccount: 'Receita por conta' },
+    widgets: { totalRevenue: 'Receita total', activeDeals: 'Negócios ativos', winRate: 'Taxa de sucesso', avgDealSize: 'Tamanho médio', revenueTrends: 'Tendências de receita', leadSource: 'Fonte de leads', pipelineByStage: 'Pipeline por etapa', topProducts: 'Principais produtos', recentOpportunities: 'Oportunidades recentes', revenueByAccount: 'Receita por conta', avgDealSizeByStage: 'Tamanho médio por etapa', ordersByStatus: 'Pedidos por status' },
     trendLabel: 'vs mês anterior',
     columns: { opportunityName: 'Nome da oportunidade', amount: 'Valor', stage: 'Etapa', closeDate: 'Data de fechamento' },
   },
diff --git a/examples/crm/src/i18n/ru.ts b/examples/crm/src/i18n/ru.ts
@@ -96,7 +96,7 @@ const ru = {
   },
   dashboard: {
     title: 'Обзор CRM',
-    widgets: { totalRevenue: 'Общий доход', activeDeals: 'Активные сделки', winRate: 'Процент побед', avgDealSize: 'Средний размер сделки', revenueTrends: 'Тренды дохода', leadSource: 'Источник лидов', pipelineByStage: 'Воронка по стадиям', topProducts: 'Лучшие продукты', recentOpportunities: 'Последние сделки', revenueByAccount: 'Доход по клиентам' },
+    widgets: { totalRevenue: 'Общий доход', activeDeals: 'Активные сделки', winRate: 'Процент побед', avgDealSize: 'Средний размер сделки', revenueTrends: 'Тренды дохода', leadSource: 'Источник лидов', pipelineByStage: 'Воронка по стадиям', topProducts: 'Лучшие продукты', recentOpportunities: 'Последние сделки', revenueByAccount: 'Доход по клиентам', avgDealSizeByStage: 'Средний размер сделки по стадиям', ordersByStatus: 'Заказы по статусу' },
     trendLabel: 'по сравнению с прошлым месяцем',
     columns: { opportunityName: 'Название сделки', amount: 'Сумма', stage: 'Стадия', closeDate: 'Дата закрытия' },
   },
diff --git a/examples/crm/src/i18n/zh.ts b/examples/crm/src/i18n/zh.ts
@@ -378,6 +378,8 @@ const zh = {
       topProducts: '热销产品',
       recentOpportunities: '最近商机',
       revenueByAccount: '按客户营收',
+      avgDealSizeByStage: '按阶段平均交易规模',
+      ordersByStatus: '按状态订单',
     },
     trendLabel: '较上月',
     columns: {
diff --git a/packages/plugin-dashboard/src/__tests__/DashboardRenderer.widgetData.test.tsx b/packages/plugin-dashboard/src/__tests__/DashboardRenderer.widgetData.test.tsx
