Structure the tech specs directory (#836)

Tech spec some subdirectories for different languages

docs/tech-specs/he/schema-refactoring-proposal.he.md

@@ -0,0 +1,99 @@
+---
+layout: default
+title: "הצעה לשחזור תיקיית הסכימה"
+parent: "Hebrew (Beta)"
+---
+
+# הצעה לשחזור תיקיית הסכימה
+
+> **Beta Translation:** This document was translated via Machine Learning and as such may not be 100% accurate. All non-English languages are currently classified as Beta.
+
+## בעיות נוכחיות
+
+1. **מבנה שטוח** - כל הסכימות במקום אחד מקשות על הבנת הקשרים
+2. **שילוב דאגות** - סוגי ליבה, אובייקטים של תחום, וחוזים של API משולבים יחד
+3. **שמות לא ברורים** - קבצים כמו "object.py", "types.py", "topic.py" לא מציינים בבירור את מטרתם
+4. **ללא שכבות ברורות** - קשה לראות מה תלוי במה
+
+## מבנה מוצע
+
+```
+trustgraph-base/trustgraph/schema/
+├── __init__.py
+├── core/              # סוגי ליבה בסיסיים המשמשים בכל מקום
+│   ├── __init__.py
+│   ├── primitives.py  # שגיאה, ערך, טריפל, שדה, סכימת שורה
+│   ├── metadata.py    # רשומת מטא-דאטה
+│   └── topic.py       # כלי לטיפול בנושאים
+│
+├── knowledge/         # מודלים של תחום ידע ואיסוף
+│   ├── __init__.py
+│   ├── graph.py       # EntityContext, EntityEmbeddings, Triples
+│   ├── document.py    # מסמך, TextDocument, חתיכה
+│   ├── knowledge.py   # סוגי איסוף ידע
+│   ├── embeddings.py  # כל סוגי הסתמכות הקשורים (הועברו מקבצים רבים)
+│   └── nlp.py         # סוגי הגדרה, נושא, קשר, עובדה
+│
+└── services/          # חוזים של בקשות/תגובות שירות
+    ├── __init__.py
+    ├── llm.py         # TextCompletion, Embeddings, בקשות/תגובות של כלי
+    ├── retrieval.py   # שאילתות/תגובות של GraphRAG, DocumentRAG
+    ├── query.py       # בקשות/תגובות של GraphEmbeddings, DocumentEmbeddings
+    ├── agent.py       # בקשות/תגובות של סוכן
+    ├── flow.py        # בקשות/תגובות של זרימה
+    ├── prompt.py      # בקשות/תגובות של שירות בקשות
+    ├── config.py      # שירות תצורה
+    ├── library.py     # שירות ספרייה
+    └── lookup.py      # שירות חיפוש
+```
+
+## שינויים מרכזיים
+
+1. **ארגון היררכי** - הפרדה ברורה בין סוגים ליבה, מודלים של ידע, וחוזים של שירות
+2. **שמות טובים יותר**:
+   - `types.py` → `core/primitives.py` (מטרה ברורה יותר)
+   - `object.py` → פירוק בין קבצים מתאימים בהתאם לתוכן
+   - `documents.py` → `knowledge/document.py` (יחיד, עקבי)
+   - `models.py` → `services/llm.py` (סוגי מודלים ברורים יותר)
+   - `prompt.py` → פירוק: חלקי שירות ל- `services/prompt.py`, סוגי נתונים ל- `knowledge/nlp.py`
+
+3. **קבוצות לוגיות**:
+   - כל סוגי ההסתמכות הועברו ל- `knowledge/embeddings.py`
+   - כל חוזי השירות הקשורים ל-LLM ב- `services/llm.py`
+   - הפרדה ברורה של זוגות בקשות/תגובות בספריית השירותים
+   - סוגי איסוף ידע מקובצים עם מודלים אחרים של תחום ידע
+
+4. **בהירות תלות**:
+   - סוגים ליבה אין תלות
+   - מודלים של ידע תלויים רק בסוגים ליבה
+   - חוזי שירות יכולים להיות תלויים בשני סוגים ליבה ומודלים של ידע
+
+## יתרונות המעבר
+
+1. **ניווט קל יותר** - מפתחים יכולים למצוא במהירות את מה שהם צריכים
+2. **מודולריות טובה יותר** - גבולות ברורים בין דאגות שונות
+3. **ייבוא פשוט יותר** - מסלולי ייבוא אינטואיטיביים יותר
+4. **עתידי** - קל להוסיף סוגי ידע חדשים או שירותים ללא בלבול
+
+## שינויים דוגמה לייבוא
+
+```python
+# לפני
+from trustgraph.schema import Error, Triple, GraphEmbeddings, TextCompletionRequest
+
+# אחרי
+from trustgraph.schema.core import Error, Triple
+from trustgraph.schema.knowledge import GraphEmbeddings
+from trustgraph.schema.services import TextCompletionRequest
+```
+
+## הערות ליישום
+
+1. שמירה על תאימות אחורה על ידי שמירה על ייבוא ב- `__init__.py`
+2. העברת קבצים בהדרגה, תוך עדכון ייבוא לפי הצורך
+3. שקול להוסיף קובץ `legacy.py` שיבוא הכל עבור תקופת המעבר
+4. עדכון תיעוד כדי לשקף את המבנה החדש
+
+<function_calls>
+<invoke name="TodoWrite">
+<parameter name="todos">[{"id": "1", "content": "להעריך את מבנה תיקיית הסכימה הנוכחי", "status": "completed", "priority": "high"}, {"id": "2", "content": "לנתח את הקבצים של הסכימה ולמטרות שלהם", "status": "completed", "priority": "high"}, {"id": "3", "content": "להציע מבנה ושמות טובים יותר", "status": "completed", "priority": "high"}]