1/**
2 * Analytics Dashboard Feature Module
3 *
4 * Comprehensive analytics and dashboarding solution for data visualization
5 * and reporting across the platform.
6 *
7 * This feature module bundles all dashboard and query operations, events,
8 * and presentations into an installable feature following FeatureModuleSpec.
9 */
10
11import { defineFeature } from '@lssm-tech/lib.contracts-spec';
12import { AnalyticsVisualizationRefs } from './visualizations';
13
14// ============ Feature Definition ============
15
16export const AnalyticsDashboardFeature = defineFeature({
17	meta: {
18		key: 'analytics-dashboard',
19		version: '1.0.0',
20		title: 'Analytics Dashboard',
21		description: 'Analytics dashboards with customizable widgets and queries',
22		domain: 'analytics',
23		owners: ['@analytics-dashboard'],
24		tags: ['analytics', 'dashboards', 'widgets', 'queries'],
25		stability: 'experimental',
26	},
27
28	// ============ Contract Operations ============
29	// All contract operations included in this feature (OpRef[])
30	operations: [
31		// Dashboard operations
32		{ key: 'analytics.dashboard.create', version: '1.0.0' },
33		{ key: 'analytics.dashboard.list', version: '1.0.0' },
34		{ key: 'analytics.dashboard.get', version: '1.0.0' },
35
36		// Widget operations
37		{ key: 'analytics.widget.add', version: '1.0.0' },
38
39		// Query operations
40		{ key: 'analytics.query.create', version: '1.0.0' },
41		{ key: 'analytics.query.execute', version: '1.0.0' },
42	],
43
44	// ============ Events ============
45	// Events emitted by this feature (EventRef[])
46	events: [
47		// Dashboard events
48		{ key: 'analytics.dashboard.created', version: '1.0.0' },
49
50		// Widget events
51		{ key: 'analytics.widget.added', version: '1.0.0' },
52
53		// Query events
54		{ key: 'analytics.query.created', version: '1.0.0' },
55	],
56
57	// ============ Presentations ============
58	// Presentations associated with this feature (PresentationRef[])
59	presentations: [
60		// Dashboard presentations
61		{ key: 'analytics.dashboard.viewList', version: '1.0.0' },
62		{ key: 'analytics.dashboard.view', version: '1.0.0' },
63		{ key: 'analytics.dashboard.editor', version: '1.0.0' },
64
65		// Query presentations
66		{ key: 'analytics.query.list', version: '1.0.0' },
67		{ key: 'analytics.query.builder', version: '1.0.0' },
68	],
69
70	visualizations: [...AnalyticsVisualizationRefs],
71
72	// ============ Op-to-Presentation Links ============
73	// Links operations to their primary presentations
74	opToPresentation: [
75		{
76			op: { key: 'analytics.dashboard.list', version: '1.0.0' },
77			pres: { key: 'analytics.dashboard.viewList', version: '1.0.0' },
78		},
79		{
80			op: { key: 'analytics.dashboard.get', version: '1.0.0' },
81			pres: { key: 'analytics.dashboard.view', version: '1.0.0' },
82		},
83		{
84			op: { key: 'analytics.dashboard.create', version: '1.0.0' },
85			pres: { key: 'analytics.dashboard.editor', version: '1.0.0' },
86		},
87		{
88			op: { key: 'analytics.query.create', version: '1.0.0' },
89			pres: { key: 'analytics.query.builder', version: '1.0.0' },
90		},
91	],
92
93	// ============ Presentation Targets ============
94	// Target requirements for multi-surface rendering
95	presentationsTargets: [
96		{
97			key: 'analytics.dashboard.viewList',
98			version: '1.0.0',
99			targets: ['react', 'markdown', 'application/json'],
100		},
101		{
102			key: 'analytics.dashboard.view',
103			version: '1.0.0',
104			targets: ['react', 'markdown'],
105		},
106		{
107			key: 'analytics.dashboard.editor',
108			version: '1.0.0',
109			targets: ['react'],
110		},
111		{
112			key: 'analytics.query.builder',
113			version: '1.0.0',
114			targets: ['react'],
115		},
116	],
117
118	// ============ Capabilities ============
119	// Capability requirements for this feature
120	capabilities: {
121		requires: [
122			{ key: 'identity', version: '1.0.0' },
123			{ key: 'metering', version: '1.0.0' },
124			{ key: 'audit-trail', version: '1.0.0' },
125		],
126	},
127
128	telemetry: [{ key: 'analytics-dashboard.telemetry', version: '1.0.0' }],
129
130	docs: [
131		'docs.examples.analytics-dashboard',
132		'docs.examples.analytics-dashboard.goal',
133		'docs.examples.analytics-dashboard.usage',
134		'docs.examples.analytics-dashboard.constraints',
135	],
136});
137