1/**
2 * Learning Journey Feature Module Specification
3 *
4 * Defines the feature module for learning, onboarding, and gamification.
5 */
6import { defineFeature } from '@lssm-tech/lib.contracts-spec';
7
8/**
9 * Learning Journey feature module that bundles course enrollment,
10 * onboarding tracks, flashcard review, and gamification capabilities.
11 */
12export const LearningJourneyFeature = defineFeature({
13	meta: {
14		key: 'learning-journey',
15		version: '1.0.0',
16		title: 'Learning Journey',
17		description:
18			'Learning platform with courses, onboarding, flashcards, and gamification',
19		domain: 'learning',
20		owners: ['@platform.learning-journey'],
21		tags: ['learning', 'onboarding', 'courses', 'flashcards', 'gamification'],
22		stability: 'stable',
23	},
24
25	// All contract operations included in this feature
26	operations: [
27		// Onboarding operations
28		{ key: 'learning.journey.recordEvent', version: '1.0.0' },
29		{ key: 'learning.journey.listTracks', version: '1.0.0' },
30		{ key: 'learning.journey.getProgress', version: '1.0.0' },
31
32		// Core learning operations
33		{ key: 'learning.enroll', version: '1.0.0' },
34		{ key: 'learning.completeLesson', version: '1.0.0' },
35		{ key: 'learning.submitCardReview', version: '1.0.0' },
36		{ key: 'learning.getDueCards', version: '1.0.0' },
37		{ key: 'learning.getDashboard', version: '1.0.0' },
38	],
39
40	// Events emitted by this feature
41	events: [
42		// Course events
43		{ key: 'course.published', version: '1.0.0' },
44		{ key: 'course.completed', version: '1.0.0' },
45
46		// Enrollment events
47		{ key: 'enrollment.created', version: '1.0.0' },
48
49		// Progress events
50		{ key: 'lesson.completed', version: '1.0.0' },
51
52		// Onboarding events
53		{ key: 'onboarding.started', version: '1.0.0' },
54		{ key: 'onboarding.step_completed', version: '1.0.0' },
55		{ key: 'onboarding.completed', version: '1.0.0' },
56
57		// Flashcard events
58		{ key: 'flashcard.reviewed', version: '1.0.0' },
59
60		// Quiz events
61		{ key: 'quiz.started', version: '1.0.0' },
62		{ key: 'quiz.completed', version: '1.0.0' },
63
64		// Gamification events
65		{ key: 'xp.earned', version: '1.0.0' },
66		{ key: 'level.up', version: '1.0.0' },
67		{ key: 'streak.updated', version: '1.0.0' },
68		{ key: 'achievement.unlocked', version: '1.0.0' },
69		{ key: 'daily_goal.completed', version: '1.0.0' },
70
71		// Certificate events
72		{ key: 'certificate.issued', version: '1.0.0' },
73	],
74
75	// No presentations for this module feature
76	presentations: [],
77	opToPresentation: [],
78	presentationsTargets: [],
79
80	// Capability definitions
81	capabilities: {
82		provides: [
83			{ key: 'learning-journey', version: '1.0.0' },
84			{ key: 'onboarding', version: '1.0.0' },
85			{ key: 'gamification', version: '1.0.0' },
86		],
87		requires: [{ key: 'identity', version: '1.0.0' }],
88	},
89});
90