Fastapi refactor update

app/services/abc/exam/__init__.py

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

app/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

app/services/abc/exam/level.py

@@ -0,0 +1,47 @@
+from abc import ABC, abstractmethod
+import random
+
+from typing import Dict
+
+from fastapi import UploadFile
+
+from app.configs.constants import EducationalContent
+
+
+class ILevelService(ABC):
+
+    @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) -> 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=random.choice(EducationalContent.MTI_TOPICS)
+    ):
+        pass
+
+    @abstractmethod
+    async def gen_reading_passage_utas(
+            self, start_id, sa_quantity: int, mc_quantity: int, topic=random.choice(EducationalContent.MTI_TOPICS)
+    ):
+        pass

app/services/abc/exam/listening.py

@@ -0,0 +1,18 @@
+import queue
+from abc import ABC, abstractmethod
+from queue import Queue
+from typing import Dict, List
+
+
+class IListeningService(ABC):
+
+    @abstractmethod
+    async def get_listening_question(
+            self, section_id: int, topic: str, req_exercises: List[str], difficulty: str,
+            number_of_exercises_q=queue.Queue(), start_id=-1
+    ):
+        pass
+
+    @abstractmethod
+    async def save_listening(self, parts: list[dict], min_timer: int, difficulty: str, listening_id: str) -> Dict:
+        pass

app/services/abc/exam/reading.py

@@ -0,0 +1,22 @@
+from abc import ABC, abstractmethod
+from queue import Queue
+from typing import List
+
+
+class IReadingService(ABC):
+
+    @abstractmethod
+    async def gen_reading_passage(
+            self,
+            passage_id: int,
+            topic: str,
+            req_exercises: List[str],
+            number_of_exercises_q: Queue,
+            difficulty: str,
+            start_id: int
+    ):
+        pass
+
+    @abstractmethod
+    async def generate_reading_passage(self, part: int, topic: str, word_count: int = 800):
+        pass

app/services/abc/exam/speaking.py

@@ -0,0 +1,29 @@
+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, difficulty: str, second_topic: Optional[str] = None
+    ) -> Dict:
+        pass
+
+    @abstractmethod
+    async def grade_speaking_task(self, task: int, answers: List[Dict]) -> Dict:
+        pass
+
+    @abstractmethod
+    async def create_videos_and_save_to_db(self, exercises: List[Dict], template: Dict, req_id: str):
+        pass
+
+    @abstractmethod
+    async def generate_video(
+            self, part: int, avatar: str, topic: str, questions: list[str],
+            *,
+            second_topic: Optional[str] = None,
+            prompts: Optional[list[str]] = None,
+            suffix: Optional[str] = None,
+    ):
+        pass

app/services/abc/exam/writing.py

@@ -0,0 +1,11 @@
+from abc import ABC, abstractmethod
+
+class IWritingService(ABC):
+
+    @abstractmethod
+    async def get_writing_task_general_question(self, task: int, topic: str, difficulty: str):
+        pass
+
+    @abstractmethod
+    async def grade_writing_task(self, task: int, question: str, answer: str):
+        pass