chaim
cf10db00a3
Initial repo scaffold for a Windows VSTO/COM Outlook Add-in (C#/.NET FW 4.8) that integrates Outlook desktop with EspoCRM via the existing MailRouter v1.2.0 endpoint (POST /api/v1/MailRouter/file). Includes: - Solution + 4 csproj projects (host, Core, UI, Tests) under src/ - VSTO host project stub (ThisAddIn.cs, requires VS 2022 + Office workload to fully resolve) - Core/UI/Tests as SDK-style net48 projects (NuGet: Polly, System.Text.Json, Serilog, CommunityToolkit.Mvvm, xUnit, Moq, FluentAssertions) - .gitea/workflows/build.yml for Windows runner CI (publish/sign placeholders) - docs/ARCHITECTURE.md (component diagram, threading model, per-feature flow) - docs/ONBOARDING.md (Hebrew lawyer-facing install guide) Server-side already in place: MailRouter v1.2.0 — see plan ~/.claude/plans/resilient-sauteeing-feather.md for the 6-week implementation plan. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
47 lines
2.1 KiB
Markdown
47 lines
2.1 KiB
Markdown
# 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.
|