feat(orm): add entity for number assessment events

#2236

Author: jo-elimu

src/main/java/ai/elimu/entity/analytics/NumberAssessmentEvent.java

@@ -0,0 +1,30 @@
+package ai.elimu.entity.analytics;
+
+import jakarta.persistence.Entity;
+import jakarta.validation.constraints.NotNull;
+import lombok.Getter;
+import lombok.Setter;
+
+@Getter
+@Setter
+@Entity
+public class NumberAssessmentEvent extends AssessmentEvent {
+
+    /**
+     * The number represented as an Integer. E.g. <code>10</code>.
+     */
+    @NotNull
+    private Integer numberValue;
+
+    /**
+     * The number represented as a symbol specific to the language. E.g. <code>"१०"</code>.
+     */
+    private String numberSymbol;
+
+    /**
+     * This field might not be included, e.g. if the assessment task was done in a 
+     * 3rd-party app that did not load the content from the elimu.ai Content Provider. 
+     * In that case, this field will be {@code null}.
+     */
+    private Long numberId;
+}

src/main/resources/META-INF/jpa-schema-export.sql

@@ -55,6 +55,8 @@
 
     drop table if exists Number_Word;
 
+    drop table if exists NumberAssessmentEvent;
+
     drop table if exists NumberContributionEvent;
 
     drop table if exists NumberLearningEvent;
@@ -377,6 +379,23 @@
         primary key (Number_id, words_ORDER)
     ) type=MyISAM;
 
+    create table NumberAssessmentEvent (
+       id bigint not null auto_increment,
+        additionalData text,
+        androidId varchar(255),
+        experimentGroup smallint,
+        masteryScore float(23),
+        packageName varchar(255),
+        researchExperiment smallint,
+        timeSpentMs bigint,
+        timestamp datetime,
+        numberId bigint,
+        numberSymbol varchar(255),
+        numberValue integer,
+        application_id bigint,
+        primary key (id)
+    ) type=MyISAM;
+
     create table NumberContributionEvent (
        id bigint not null auto_increment,
         comment text,
@@ -863,6 +882,11 @@
        foreign key (Number_id) 
        references Number (id);
 
+    alter table NumberAssessmentEvent 
+       add constraint FKec7ikjyqnxjnkcmjfcv9iy67r 
+       foreign key (application_id) 
+       references Application (id);
+
     alter table NumberContributionEvent 
        add constraint FK8tr84kkqmavan1jxfmc1pq8h6 
        foreign key (contributor_id)