| | | 1 | | using Intentum.Core.Behavior; |
| | | 2 | | using Intentum.Core.Models; |
| | | 3 | | |
| | | 4 | | namespace Intentum.Core.Education; |
| | | 5 | | |
| | | 6 | | public static class EducationRules |
| | | 7 | | { |
| | | 8 | | public static Func<BehaviorSpace, RuleMatch?> StudentDropoutRisk( |
| | 3 | 9 | | double confidence = 0.85) => space => |
| | 2 | 10 | | { |
| | 2 | 11 | | var signals = space.Events.Count(e => |
| | 4 | 12 | | e.Action.Contains("engagement.declining", StringComparison.OrdinalIgnoreCase) || |
| | 4 | 13 | | e.Action.Contains("assignment.missed", StringComparison.OrdinalIgnoreCase) || |
| | 4 | 14 | | e.Action.Contains("attendance.issue", StringComparison.OrdinalIgnoreCase) || |
| | 4 | 15 | | e.Action.Contains("grade.declining", StringComparison.OrdinalIgnoreCase)); |
| | 3 | 16 | | |
| | 2 | 17 | | if (signals >= 2) |
| | 1 | 18 | | return new RuleMatch("StudentDropoutRisk", confidence, |
| | 1 | 19 | | $"Risk signals: {signals}"); |
| | 1 | 20 | | return null; |
| | 5 | 21 | | }; |
| | | 22 | | |
| | | 23 | | public static Func<BehaviorSpace, RuleMatch?> AcademicIntegrityViolation( |
| | 3 | 24 | | double confidence = 0.9) => space => |
| | 2 | 25 | | { |
| | 2 | 26 | | var signals = space.Events.Count(e => |
| | 4 | 27 | | e.Action.Contains("submission.rapid", StringComparison.OrdinalIgnoreCase) || |
| | 4 | 28 | | e.Action.Contains("submission.multiple.attempts", StringComparison.OrdinalIgnoreCase) || |
| | 4 | 29 | | e.Action.Contains("access.off.hours", StringComparison.OrdinalIgnoreCase) || |
| | 4 | 30 | | e.Action.Contains("copy.paste.excessive", StringComparison.OrdinalIgnoreCase)); |
| | 3 | 31 | | |
| | 2 | 32 | | if (signals >= 2) |
| | 1 | 33 | | return new RuleMatch("AcademicIntegrityViolation", confidence, |
| | 1 | 34 | | $"Integrity signals: {signals}"); |
| | 1 | 35 | | return null; |
| | 5 | 36 | | }; |
| | | 37 | | |
| | | 38 | | public static Func<BehaviorSpace, RuleMatch?> CourseRecommendation( |
| | | 39 | | int minViews = 2, |
| | 3 | 40 | | double confidence = 0.75) => space => |
| | 2 | 41 | | { |
| | 2 | 42 | | var distinctCourseViews = space.Events |
| | 3 | 43 | | .Where(e => e.Action.StartsWith("course.view.", StringComparison.OrdinalIgnoreCase)) |
| | 3 | 44 | | .Select(e => e.Action) |
| | 2 | 45 | | .Distinct(StringComparer.OrdinalIgnoreCase) |
| | 2 | 46 | | .Count(); |
| | 3 | 47 | | |
| | 2 | 48 | | if (distinctCourseViews >= minViews) |
| | 1 | 49 | | return new RuleMatch("CourseRecommendation", confidence, |
| | 1 | 50 | | $"Distinct course views: {distinctCourseViews}"); |
| | 1 | 51 | | return null; |
| | 5 | 52 | | }; |
| | | 53 | | |
| | | 54 | | public static Func<BehaviorSpace, RuleMatch?> LearningResourceNeeds( |
| | 3 | 55 | | double confidence = 0.8) => space => |
| | 2 | 56 | | { |
| | 2 | 57 | | var signals = space.Events.Count(e => |
| | 5 | 58 | | e.Action.StartsWith("help.requested.", StringComparison.OrdinalIgnoreCase)); |
| | 3 | 59 | | |
| | 2 | 60 | | if (signals >= 2) |
| | 1 | 61 | | return new RuleMatch("LearningResourceNeeds", confidence, |
| | 1 | 62 | | $"Help requests: {signals}"); |
| | 1 | 63 | | return null; |
| | 5 | 64 | | }; |
| | | 65 | | |
| | | 66 | | public static Func<BehaviorSpace, RuleMatch?> EarlyWarning( |
| | 3 | 67 | | double confidence = 0.85) => space => |
| | 2 | 68 | | { |
| | 2 | 69 | | var signals = space.Events.Count(e => |
| | 3 | 70 | | e.Action.Contains("grade.declining", StringComparison.OrdinalIgnoreCase) || |
| | 3 | 71 | | e.Action.Contains("behavioral.flag", StringComparison.OrdinalIgnoreCase) || |
| | 3 | 72 | | e.Action.Contains("performance.drop", StringComparison.OrdinalIgnoreCase) || |
| | 3 | 73 | | e.Action.Contains("teacher.concern", StringComparison.OrdinalIgnoreCase)); |
| | 3 | 74 | | |
| | 2 | 75 | | if (signals >= 1) |
| | 1 | 76 | | return new RuleMatch("EarlyWarning", confidence, |
| | 1 | 77 | | $"Warning signals: {signals}"); |
| | 1 | 78 | | return null; |
| | 5 | 79 | | }; |
| | | 80 | | |
| | | 81 | | public static Func<BehaviorSpace, RuleMatch?> InterventionRequired( |
| | 3 | 82 | | double confidence = 0.9) => space => |
| | 2 | 83 | | { |
| | 2 | 84 | | var signals = space.Events.Count(e => |
| | 4 | 85 | | e.Action.Contains("intervention.declined", StringComparison.OrdinalIgnoreCase) || |
| | 4 | 86 | | e.Action.Contains("performance.sustained_low", StringComparison.OrdinalIgnoreCase) || |
| | 4 | 87 | | e.Action.Contains("support.resistant", StringComparison.OrdinalIgnoreCase) || |
| | 4 | 88 | | e.Action.Contains("progress.stagnant", StringComparison.OrdinalIgnoreCase)); |
| | 3 | 89 | | |
| | 2 | 90 | | if (signals >= 2) |
| | 1 | 91 | | return new RuleMatch("InterventionRequired", confidence, |
| | 1 | 92 | | $"Intervention signals: {signals}"); |
| | 1 | 93 | | return null; |
| | 5 | 94 | | }; |
| | | 95 | | |
| | | 96 | | public static Func<BehaviorSpace, RuleMatch?> GiftedStudent( |
| | | 97 | | int minAdvancedActivities = 2, |
| | 3 | 98 | | double confidence = 0.7) => space => |
| | 2 | 99 | | { |
| | 2 | 100 | | var signals = space.Events.Count(e => |
| | 5 | 101 | | e.Action.Contains("course.advanced.completed", StringComparison.OrdinalIgnoreCase) || |
| | 5 | 102 | | e.Action.Contains("enrichment.requested", StringComparison.OrdinalIgnoreCase) || |
| | 5 | 103 | | e.Action.Contains("grade.exceeds", StringComparison.OrdinalIgnoreCase) || |
| | 5 | 104 | | e.Action.Contains("acceleration.recommended", StringComparison.OrdinalIgnoreCase)); |
| | 3 | 105 | | |
| | 2 | 106 | | if (signals >= minAdvancedActivities) |
| | 1 | 107 | | return new RuleMatch("GiftedStudent", confidence, |
| | 1 | 108 | | $"Advanced activity signals: {signals}"); |
| | 1 | 109 | | return null; |
| | 5 | 110 | | }; |
| | | 111 | | |
| | | 112 | | public static Func<BehaviorSpace, RuleMatch?> CareerPathInterest( |
| | 3 | 113 | | double confidence = 0.75) => space => |
| | 2 | 114 | | { |
| | 2 | 115 | | var signals = space.Events.Count(e => |
| | 4 | 116 | | e.Action.Contains("course.career_focused", StringComparison.OrdinalIgnoreCase) || |
| | 4 | 117 | | e.Action.Contains("extracurricular.career", StringComparison.OrdinalIgnoreCase) || |
| | 4 | 118 | | e.Action.Contains("internship.interested", StringComparison.OrdinalIgnoreCase) || |
| | 4 | 119 | | e.Action.Contains("mentorship.requested", StringComparison.OrdinalIgnoreCase)); |
| | 3 | 120 | | |
| | 2 | 121 | | if (signals >= 2) |
| | 1 | 122 | | return new RuleMatch("CareerPathInterest", confidence, |
| | 1 | 123 | | $"Career signals: {signals}"); |
| | 1 | 124 | | return null; |
| | 5 | 125 | | }; |
| | | 126 | | |
| | | 127 | | public static IReadOnlyList<Func<BehaviorSpace, RuleMatch?>> AllRules() => |
| | 1 | 128 | | [ |
| | 1 | 129 | | StudentDropoutRisk(), |
| | 1 | 130 | | AcademicIntegrityViolation(), |
| | 1 | 131 | | CourseRecommendation(), |
| | 1 | 132 | | LearningResourceNeeds(), |
| | 1 | 133 | | EarlyWarning(), |
| | 1 | 134 | | InterventionRequired(), |
| | 1 | 135 | | GiftedStudent(), |
| | 1 | 136 | | CareerPathInterest() |
| | 1 | 137 | | ]; |
| | | 138 | | } |