Brushed up the backend, added writing task 1 academic prompt gen and grading ENCOA-274

ielts_be/services/abc/exam/__init__.py

@@ -0,0 +1,17 @@
+from .level import ILevelService
+from .listening import IListeningService
+from .writing import IWritingService
+from .speaking import ISpeakingService
+from .reading import IReadingService
+from .grade import IGradeService
+from .exercises import IExerciseService
+
+__all__ = [
+    "ILevelService",
+    "IListeningService",
+    "IWritingService",
+    "ISpeakingService",
+    "IReadingService",
+    "IGradeService",
+    "IExerciseService"
+]

ielts_be/services/abc/exam/exercises.py

@@ -0,0 +1,33 @@
+from abc import ABC, abstractmethod
+from typing import Dict, Any
+
+
+class IExerciseService(ABC):
+
+    @abstractmethod
+    async def generate_multiple_choice(self, args: Dict, exercise_id: int) -> Dict[str, Any]:
+        pass
+
+    @abstractmethod
+    async def generate_blank_space_text(self, args: Dict, exercise_id: int) -> Dict[str, Any]:
+        pass
+
+    @abstractmethod
+    async def generate_reading_passage_utas(self, args: Dict, exercise_id: int) -> Dict[str, Any]:
+        pass
+
+    @abstractmethod
+    async def generate_writing_task(self, args: Dict, exercise_id: int) -> Dict[str, Any]:
+        pass
+
+    @abstractmethod
+    async def generate_speaking_task(self, args: Dict, exercise_id: int) -> Dict[str, Any]:
+        pass
+
+    @abstractmethod
+    async def generate_reading_task(self, args: Dict, exercise_id: int) -> Dict[str, Any]:
+        pass
+
+    @abstractmethod
+    async def generate_listening_task(self, args: Dict, exercise_id: int) -> Dict[str, Any]:
+        pass

ielts_be/services/abc/exam/grade.py

@@ -0,0 +1,13 @@
+from abc import ABC, abstractmethod
+from typing import Dict, List
+
+
+class IGradeService(ABC):
+
+    @abstractmethod
+    async def grade_short_answers(self, data: Dict):
+        pass
+
+    @abstractmethod
+    async def calculate_grading_summary(self, extracted_sections: List):
+        pass

ielts_be/services/abc/exam/level.py

@@ -0,0 +1,46 @@
+from abc import ABC, abstractmethod
+from typing import Dict, Optional
+from fastapi import UploadFile
+
+
+class ILevelService(ABC):
+
+    @abstractmethod
+    async def generate_exercises(self, dto):
+        pass
+
+    @abstractmethod
+    async def get_level_exam(
+            self, number_of_exercises: int = 25, min_timer: int = 25, diagnostic: bool = False
+    ) -> Dict:
+        pass
+
+    @abstractmethod
+    async def get_level_utas(self):
+        pass
+
+    @abstractmethod
+    async def get_custom_level(self, data: Dict):
+        pass
+
+    @abstractmethod
+    async def upload_level(self, upload: UploadFile, solutions: Optional[UploadFile] = None) -> Dict:
+        pass
+
+    @abstractmethod
+    async def gen_multiple_choice(
+            self, mc_variant: str, quantity: int, start_id: int = 1 #, *, utas: bool = False, all_exams=None
+    ):
+        pass
+
+    @abstractmethod
+    async def gen_blank_space_text_utas(
+            self, quantity: int, start_id: int, size: int, topic: str
+    ):
+        pass
+
+    @abstractmethod
+    async def gen_reading_passage_utas(
+            self, start_id, mc_quantity: int, topic: Optional[str] #sa_quantity: int,
+    ):
+        pass

ielts_be/services/abc/exam/listening.py

@@ -0,0 +1,31 @@
+import queue
+from abc import ABC, abstractmethod
+from queue import Queue
+from typing import Dict, List, Any
+
+from fastapi import UploadFile
+
+
+class IListeningService(ABC):
+
+    @abstractmethod
+    async def generate_listening_dialog( self, section_id: int, topic: str, difficulty: str):
+        pass
+
+    @abstractmethod
+    async def get_listening_question(self, dto):
+        pass
+
+    @abstractmethod
+    async def generate_mp3(self, dto) -> bytes:
+        pass
+
+    @abstractmethod
+    async def get_dialog_from_audio(self, upload: UploadFile):
+        pass
+
+    @abstractmethod
+    async def import_exam(
+            self, exercises: UploadFile, solutions: UploadFile = None
+    ) -> Dict[str, Any] | None:
+        pass

ielts_be/services/abc/exam/reading.py

@@ -0,0 +1,17 @@
+from abc import ABC, abstractmethod
+from fastapi import UploadFile
+
+
+class IReadingService(ABC):
+
+    @abstractmethod
+    async def import_exam(self, exercises: UploadFile, solutions: UploadFile = None):
+        pass
+
+    @abstractmethod
+    async def generate_reading_exercises(self, dto):
+        pass
+
+    @abstractmethod
+    async def generate_reading_passage(self, part: int, topic: str, word_count: int = 800):
+        pass

ielts_be/services/abc/exam/speaking.py

@@ -0,0 +1,16 @@
+from abc import ABC, abstractmethod
+from typing import List, Dict, Optional
+
+
+class ISpeakingService(ABC):
+
+    @abstractmethod
+    async def get_speaking_part(
+            self, part: int, topic: str, second_topic: str, difficulty: str
+    ) -> Dict:
+        pass
+
+    @abstractmethod
+    async def grade_speaking_task(self, task: int, items: any) -> Dict:
+        pass
+

ielts_be/services/abc/exam/writing.py

@@ -0,0 +1,19 @@
+from abc import ABC, abstractmethod
+from typing import Optional
+
+from fastapi import UploadFile
+
+
+class IWritingService(ABC):
+
+    @abstractmethod
+    async def get_writing_task_general_question(self, task: int, topic: str, difficulty: str):
+        pass
+
+    @abstractmethod
+    async def get_writing_task_academic_question(self, task: int, attachment: UploadFile, difficulty: str):
+        pass
+
+    @abstractmethod
+    async def grade_writing_task(self, task: int, question: str, answer: str, attachment: Optional[str]):
+        pass