feat: SmartAssistant v2.4.0 — create_call tool + behavioral rules system

- Add create_call tool: records phone calls as Call entity (not Meeting) - Add AssistantRule entity: persistent behavioral rules the AI follows - Add save_rule tool: AI can save new rules when user requests them - Add systemInstructions to webhook: call vs meeting guidance, open question tracking - Add recentCalls to case context for AI awareness - Add AssistantRuleContextProvider: injects active rules per mode into context Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-06 06:20:23 +00:00
parent ca04dd72f8
commit 0dc26f3b15
14 changed files with 391 additions and 2 deletions
@@ -0,0 +1,120 @@
+# SmartAssistant — פרומפט פריסה לסביבת פיתוח
+
+> **העתק את הפרומפט הבא כהודעה פותחת בשיחה חדשה של Claude Code, מתוך תיקיית הפרויקט.**
+
+---
+
+```
+## הקשר
+
+אני עובד על הרחבת SmartAssistant ל-EspoCRM — עוזר AI צף למשרד עורכי דין.
+הקוד מוכן (v1.0.3), וצריך להשלים את הפריסה בסביבת הפיתוח.
+
+קרא את DEPLOYMENT_REVIEW.md לסיכום מלא של מה בוצע, מה נבדק, ומה נשאר.
+
+## סביבת הפיתוח
+
+- EspoCRM Dev: https://espocrm.dev.marcus-law.co.il (Coolify UUID: c591uqmu49qa5kh7t2z7a2mp)
+- n8n: https://n8n.dev.marcus-law.co.il
+- Gitea: https://gitea.dev.marcus-law.co.il (repo: espocrm-extensions/SmartAssistant)
+- קרדנשיאלים ב-Infisical (תיקיות /espocrm, /n8n)
+
+## המשימות — שלב 1: הכנה לפריסה
+
+בצע את המשימות הבאות בסדר. לפני כל שלב — עדכן אותי מה אתה הולך לעשות וחכה לאישור.
+
+### 1. בדיקת תאימות סביבה
+- בדוק גרסת EspoCRM בסביבת dev (צריך >= 8.0.0)
+- בדוק גרסת PHP (צריך >= 8.1)
+- בדוק שאין שאריות של מודולים ישנים (CrmAssistant / OfficeAssistant הוסרו מהפרויקט)
+
+### 2. בדיקת אנטיטי AssistantConversation
+- המודול משתמש באנטיטי AssistantConversation לשמירת שיחות (ראה ConversationRepository.php)
+- בדוק אם האנטיטי הזה קיים ב-EspoCRM Dev
+- אם לא קיים — צריך ליצור אותו. בדוק את הקוד ב-ConversationRepository.php כדי להבין אילו שדות נדרשים, והכן entityDefs JSON
+
+### 3. בניית n8n Workflow לטיפול בצ'אט
+זה הרכיב הקריטי החסר. המודול שולח webhook ל-n8n ומצפה לתשובה.
+
+**Webhook Payload (נשלח מ-EspoCRM):**
+```json
+{
+  "message": "הודעת המשתמש",
+  "context": { ... הקשר תיק/משרד מלא ... },
+  "conversationId": "conv_xxx",
+  "conversationHistory": [{ "role": "user/assistant", "content": "..." }],
+  "mode": "office|case"
+}
+```
+
+**Response נדרש (חזרה ל-EspoCRM):**
+```json
+{
+  "text": "תשובת העוזר",
+  "actions": [
+    {
+      "tool": "create_task|add_note|change_status|create_meeting|schedule_hearing|list_documents|analyze_document|save_memory|rename_document",
+      "params": { ... },
+      "actionId": "action_xxx",
+      "displayText": "תיאור הפעולה למשתמש"
+    }
+  ]
+}
+```
+
+**הפעולות שהעוזר יכול לבקש:**
+
+| כלי | פרמטרים | דורש אישור |
+|------|----------|------------|
+| create_task | name, dateEnd, priority, description | כן |
+| add_note | text | כן |
+| change_status | status | כן |
+| create_meeting | name, dateStart, dateEnd, description | כן |
+| create_call | name, dateStart, dateEnd, description, direction, status | כן |
+| schedule_hearing | date, description | כן |
+| list_documents | — | לא (מיידי) |
+| analyze_document | documentId | כן |
+| save_memory | name, content, category, importance | לא (מיידי) |
+| save_rule | name, rule, scope (global/case/office) | לא (מיידי) |
+| rename_document | documentId, newName | כן |
+
+**דרישות ל-Workflow:**
+- Webhook trigger שמקבל POST
+- שליחת ההודעה + הקשר ל-LLM (Claude/GPT)
+- System prompt שמכיר את הכלים הזמינים ואת פורמט התשובה
+- החזרת JSON תקין בפורמט למעלה
+- שמירת היסטוריית שיחה (conversationId)
+- טיפול בשני המצבים (office/case) עם system prompts מתאימים
+
+### 4. הגדרת Integration ב-EspoCRM
+אחרי שה-workflow מוכן:
+- Admin > Integrations > Smart Assistant
+- webhookUrl = כתובת ה-webhook מ-n8n
+- apiKey = מפתח אימות (אם הגדרנו)
+- שאר הערכים: ברירת מחדל
+
+### 5. בדיקות ידניות ראשונות
+אחרי הפריסה:
+- [ ] האם ה-FAB (כפתור צ'אט) מופיע?
+- [ ] האם ניתן לשלוח הודעה במצב משרד ולקבל תשובה?
+- [ ] האם ניתן לנווט לתיק ולשלוח הודעה במצב תיק?
+- [ ] האם פעולות מוצגות לאישור?
+- [ ] האם ההתראות מופיעות ב-navbar?
+- [ ] האם הדשלט מציג נתונים?
+
+## הנחיות
+
+- השתמש ב-MCP tools (Coolify, Gitea, n8n, Infisical) לכל פעולה
+- אל תבצע פעולות הרסניות בלי אישור שלי
+- אם נתקלת בבעיה — תאר מה קרה ומה ניסית, ותשאל מה לעשות
+- עדכן את DEPLOYMENT_REVIEW.md עם כל ממצא חדש
+```
+
+---
+
+## הערות שימוש
+
+- **היכן להריץ:** בתיקיית `/home/chaim/espocrm-extensions/SmartAssistant`
+- **MCP נדרשים:** coolify-dev, gitea-dev, n8n-dev, infisical
+- **משך משוער:** השלב הקריטי הוא בניית ה-n8n workflow (#3) — זה ידרוש עיצוב system prompts ובדיקות
+- **מה הפרומפט לא כולל:** הסרת מודולים ישנים (תלוי בממצאי שלב 1), הוספת תרגום he_IL (שיפור עתידי)