Clean Architecture ב-src

summary:: ארכיטקטורה זו מפרידה בין לוגיקה עסקית, תזמור יישומי ותשתיות כך שניתן לבדוק יחידות קוד בנפרד, להחליף מקורות נתונים בלי לשבור את שאר המערכת ולרוץ גם בסביבות ללא MongoDB.

תרשים שכבות

        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.