Clean Architecture ב-src
תרשים שכבות
graph TD
U[Handlers / WebApp] --> A[Application Layer]
A --> D[Domain Layer]
A --> I[Infrastructure Layer]
I --> DB[(MongoDB)]
I --> Files[(Legacy DB Facade)]
מבנה תיקיות
src/
domain/
entities/snippet.py
services/code_normalizer.py
services/language_detector.py
interfaces/snippet_repository_interface.py
application/
dto/create_snippet_dto.py
services/snippet_service.py
infrastructure/
database/mongodb/repositories/snippet_repository.py
composition/container.py
composition/files_facade.py
שכבת הדומיין (Domain)
domain/entities/snippet.py מגדיר ישות קלה (dataclass) שאינה תלויה ב-DB או ב-Telegram.
domain/services/code_normalizer.py מגדיר את הניקוי המינימלי לקוד שמודבק בבוט (clean_pasted_code). רק זרימות ההדבקה בבוט קוראות לו; שכבות השמירה, הוובאפ וה-MCP שומרים את התוכן כמו שהגיע — ראו ניקוי קוד מודבק (Pasted-code cleanup).
domain/services/language_detector.py מזהה שפה באמצעות שם קובץ ותוכן, כולל Shebangs, קבצי Markdown/YAML ועוד.
domain/interfaces/snippet_repository_interface.py מצהיר על API לשכבת נתונים (save/get/search) כדי שהדומיין לא יכיר MongoDB.
שכבת היישום (Application)
application/dto/create_snippet_dto.py מרכז ולידציה בסיסית עבור פקודות יצירת סניפט.
application/services/snippet_service.py מתזמר את התהליך: מקבל DTO, מבצע זיהוי שפה, בונה Snippet ושומר דרך הממשק הדומייני. התוכן עובר כמו שהגיע.
הלוגיקה כאן ”דקה“ – אין קריאות Telegram או MongoDB, רק שימוש באובייקטים שהוזרקו.
שכבת התשתית (Infrastructure)
infrastructure/database/mongodb/repositories/snippet_repository.py מממש את הממשק הדומייני באמצעות DatabaseManager ו-CodeSnippet הקיימים.
infrastructure/composition/container.py הוא Composition Root שמבנה Singleton של SnippetService, מזריק Detector ומחבר ל-Repository.
infrastructure/composition/files_facade.py מספק שכבת מעבר עבור מודולים שעדיין נשענים על מנגנון ה-DB הישן.
דוגמת זרימה: יצירת סניפט
Handler קורא ל-get_snippet_service() מה-Container.
הקריאה create_snippet(dto) מזהה שפה ומייצרת Entity. היא לא משנה את הקוד — ה-handler כבר ניקה אותו לפני שקרא לה.
ה-Repository מתרגם את ה-Entity ל-CodeSnippet ושומר ב-MongoDB.
התוצאה שחזרה לשכבות העליונות היא אובייקט דומיין עקבי (כולל גרסה ומטא-דאטה מעודכן).
הנחיות עבודה
להוספת Use Case חדש – התחילו ב-Domain (ישות/שירות), צרו Service/Application שירכיב את הזרימה ואז חברו דרך התשתית.
בדיקות יחידה מומלצות לרוץ על שכבת הדומיין והיישום עם Doubles (ללא DB אמיתי).
בחיבור לפיצ’רים קיימים, העדיפו להשתמש ב-container.get_snippet_service() על פני יבוא ישיר של Database Manager.