Archived

This repository has been archived on 2026-07-19. You can view files and clone it. You cannot open issues or pull requests or push a commit.

Files

T

chaim cf10db00a3 chore: scaffold Outlook VSTO Add-in for EspoCRM

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>

2026-05-11 09:05:07 +00:00

2.1 KiB

Raw Permalink Blame History

OutlookAddin — תוסף EspoCRM ל-Outlook Desktop

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

פיצ'רים

תיוק מייל קיים לתיק/לקוח — Ribbon button "File to EspoCRM" עם דיאלוג חיפוש (Case/Contact/Lead/Account).
חיפוש לקוח/תיק על מייל נכנס — Reading-pane sidebar שמזהה את השולח ומציג את התיקים הקיימים.
כתיבת מייל חדש מתוך תיק — מ-Outlook (Ribbon ב-compose) או מ-EspoCRM (URL protocol outlookaddin://compose?caseId=...).
סנכרון אוטומטי של תיקיות נבחרות — 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 ועקוב אחר ההוראות. Outlook יעלה מחדש אוטומטית.

ארכיטקטורה

Server-side: MailRouter v1.2.0 חושף 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.

פיתוח

# ב-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.

רישיון

Internal use only — Marcus-Law.

2.1 KiB Raw Permalink Blame History