Initial STEP 3 study game and questions API

2026-07-09 20:50:33 -05:00
commit 277076a245
51 changed files with 2671 additions and 0 deletions
@@ -0,0 +1,6 @@
+namespace QuestionsApi.Models;
+
+public class BulkUpsertQuestionsRequest
+{
+    public List<UpsertQuestionRequest> Questions { get; set; } = [];
+}
@@ -0,0 +1,42 @@
+using MongoDB.Bson;
+using MongoDB.Bson.Serialization.Attributes;
+
+namespace QuestionsApi.Models;
+
+public class Question
+{
+    [BsonId]
+    [BsonRepresentation(BsonType.ObjectId)]
+    public string? Id { get; set; }
+
+    public string ExternalId { get; set; } = "";
+    public string Stem { get; set; } = "";
+    public string LeadIn { get; set; } = "";
+    public List<QuestionChoice> Choices { get; set; } = [];
+    public string CorrectChoiceId { get; set; } = "";
+    public string Explanation { get; set; } = "";
+    public Dictionary<string, string> ChoiceExplanations { get; set; } = [];
+    public string Discipline { get; set; } = "";
+    public string System { get; set; } = "";
+    public int Difficulty { get; set; } = 1;
+    public List<QuestionLab> Labs { get; set; } = [];
+    public List<string> Media { get; set; } = [];
+    public List<string> Tags { get; set; } = [];
+    public bool IsPublished { get; set; } = true;
+    public DateTime CreatedUtc { get; set; } = DateTime.UtcNow;
+    public DateTime UpdatedUtc { get; set; } = DateTime.UtcNow;
+}
+
+public class QuestionChoice
+{
+    public string Id { get; set; } = "";
+    public string Text { get; set; } = "";
+}
+
+public class QuestionLab
+{
+    public string Name { get; set; } = "";
+    public string Value { get; set; } = "";
+    public string Unit { get; set; } = "";
+    public string Reference { get; set; } = "";
+}
@@ -0,0 +1,29 @@
+namespace QuestionsApi.Models;
+
+public class QuestionSearchRequest
+{
+    public string? System { get; set; }
+    public string? Discipline { get; set; }
+    public List<string> Tags { get; set; } = [];
+    public int? DifficultyMin { get; set; }
+    public int? DifficultyMax { get; set; }
+    public int Limit { get; set; } = 40;
+}
+
+public class UpsertQuestionRequest
+{
+    public string ExternalId { get; set; } = "";
+    public string Stem { get; set; } = "";
+    public string LeadIn { get; set; } = "";
+    public List<QuestionChoice> Choices { get; set; } = [];
+    public string CorrectChoiceId { get; set; } = "";
+    public string Explanation { get; set; } = "";
+    public Dictionary<string, string> ChoiceExplanations { get; set; } = [];
+    public string Discipline { get; set; } = "";
+    public string System { get; set; } = "";
+    public int Difficulty { get; set; } = 1;
+    public List<QuestionLab> Labs { get; set; } = [];
+    public List<string> Media { get; set; } = [];
+    public List<string> Tags { get; set; } = [];
+    public bool IsPublished { get; set; } = true;
+}
@@ -0,0 +1,37 @@
+namespace QuestionsApi.Models;
+
+public class QuestionResponse
+{
+    public string Id { get; set; } = "";
+    public string ExternalId { get; set; } = "";
+    public string Stem { get; set; } = "";
+    public string LeadIn { get; set; } = "";
+    public List<QuestionChoice> Choices { get; set; } = [];
+    public string CorrectChoiceId { get; set; } = "";
+    public string Explanation { get; set; } = "";
+    public Dictionary<string, string> ChoiceExplanations { get; set; } = [];
+    public string Discipline { get; set; } = "";
+    public string System { get; set; } = "";
+    public int Difficulty { get; set; }
+    public List<QuestionLab> Labs { get; set; } = [];
+    public List<string> Media { get; set; } = [];
+    public List<string> Tags { get; set; } = [];
+
+    public static QuestionResponse FromModel(Question question) => new()
+    {
+        Id = question.Id ?? "",
+        ExternalId = question.ExternalId,
+        Stem = question.Stem,
+        LeadIn = question.LeadIn,
+        Choices = question.Choices,
+        CorrectChoiceId = question.CorrectChoiceId,
+        Explanation = question.Explanation,
+        ChoiceExplanations = question.ChoiceExplanations,
+        Discipline = question.Discipline,
+        System = question.System,
+        Difficulty = question.Difficulty,
+        Labs = question.Labs,
+        Media = question.Media,
+        Tags = question.Tags
+    };
+}