# OutlookAddin — תוסף EspoCRM ל-Outlook Desktop

תוסף VSTO/COM ל-Outlook ל-Windows שמאפשר לעו"ד לתייק מיילים ל-EspoCRM ישירות מ-Outlook, בלי הגדרת BCC.

## פיצ'רים

1. **תיוק מייל קיים לתיק/לקוח** — Ribbon button "File to EspoCRM" עם דיאלוג חיפוש (Case/Contact/Lead/Account).
2. **חיפוש לקוח/תיק על מייל נכנס** — Reading-pane sidebar שמזהה את השולח ומציג את התיקים הקיימים.
3. **כתיבת מייל חדש מתוך תיק** — מ-Outlook (Ribbon ב-compose) או מ-EspoCRM (URL protocol `outlookaddin://compose?caseId=...`).
4. **סנכרון אוטומטי של תיקיות נבחרות** — Auto-file למיילים שמגיעים לתיקיות שמוגדרות לניטור.

## דרישות

- Windows 10/11
- Outlook desktop: Microsoft 365 / Office 2021 / Office 2019 (לא 2016)
- .NET Framework 4.8 (מובנה ב-Win10/11)
- API key ב-EspoCRM (מקבלים מאדמין)

## התקנה

ClickOnce — לחץ על הלינק [https://platform.dev.marcus-law.co.il/outlook-addin/setup.exe](https://platform.dev.marcus-law.co.il/outlook-addin/setup.exe) ועקוב אחר ההוראות. Outlook יעלה מחדש אוטומטית.

## ארכיטקטורה

- **Server-side:** [MailRouter v1.2.0](https://gitea.dev.marcus-law.co.il/espocrm-extensions/MailRouter) חושף `POST /api/v1/MailRouter/file`.
- **Client-side:** ה-Add-in מדבר עם MailRouter (file) + EspoCRM REST API (search/lookup).
- **Auth:** `Espo-Authorization: <base64(username:apiKey)>` per-user.

מבנה ה-Solution: ראה [`docs/ARCHITECTURE.md`](docs/ARCHITECTURE.md).

## פיתוח

```bash
# ב-Windows machine עם VS 2022 + VSTO workload
git clone https://gitea.dev.marcus-law.co.il/espocrm-extensions/OutlookAddin.git
cd OutlookAddin
nuget restore
msbuild /t:Build /p:Configuration=Debug
# F5 ב-VS מפעיל Outlook עם ה-Add-in טעון לדיבאג
```

CI build על Windows runner ב-Gitea Actions — ראה [`.gitea/workflows/build.yml`](.gitea/workflows/build.yml).

## רישיון

Internal use only — Marcus-Law.