primedocs ist eine mehrschichtige Plattform aus mehreren Server-Diensten, einer zentralen Authentifizierung, mehreren Datenbanken und verschiedenen Clients. Die folgende Übersicht zeigt, wie diese Komponenten zusammenspielen und welche Rolle jede einzelne übernimmt.
Clients
| Komponente | Rolle |
|---|
| primedocs Web (React Web App) | Haupt-UI ausserhalb von Office. Kommuniziert über die Web API mit dem Server. |
| Office Web Add-Ins (Office.js) | In-Office-Integration für Word, Excel, PowerPoint und Outlook (im Browser, auf macOS und Windows). |
| primedocs Desktop (WPF Windows Client) | Windows-Client mit lokalem Offline-Cache (ESENT) und Address-/Data-Providern. Meldet sich per OIDC am Identity Server an und synchronisiert über den Sync-Service. |
| Office COM Add-Ins (VSTO) | Legacy-Integration in Office unter Windows, die durch die Web Add-Ins abgelöst wird. |
| Web-Admin | Web-Oberfläche für die laufende Administration: Benutzer, Gruppen, Rollen, Organisationseinheiten, Einstellungen der Datasource, Paket-Export und -Import, Auswertungen. |
| DataSourceAdminApp | Web-Oberfläche für Vorlagen, Snippets, Felder, globale Konfigurationen und die Datasource-Verwaltung. |
Server-Komponenten (primedocs Server Apps)
| Komponente | Rolle |
|---|
Web API (PrimeDocs.Web.WebApi) | Versionierte REST-Schnittstelle, zentrale HTTP-API für die webbasierten Clients (primedocs Web, Office Web Add-Ins und Web-Admin) und für Drittsysteme. Ohne Breaking Changes versioniert. |
Sync-Service (PrimeDocs.Service.Host) | Synchronisiert Daten für den Desktop-Client (Offline-Cache). Die Abwärtskompatibilität ist zwingend. |
| Data Service | Liefert Adress- und Stammdaten über die konfigurierten Address Provider an Client und Server. |
| Document Creation Server (DCS) | Serverseitige Dokumentgenerierung. Erzeugt Dokumente ohne Client-Beteiligung, z. B. aus Drittsystemen über die Connect-Schnittstelle. |
| JobHost | Führt Hintergrundjobs aus: Provisionierung/Synchronisierung, Import/Export, geplante Aufgaben. |
| Document Engine | Generierungs-Pipeline (Chain of Responsibility) für Word, Excel, PowerPoint und Outlook. Läuft sowohl serverseitig als auch im Client. Siehe Dokumentgenerierung. |
MCP-Server (PrimeDocs.Web.Mcp) | Model-Context-Protocol-Server, über den KI-Agenten (z. B. Microsoft 365 Copilot) primedocs-Funktionen aufrufen können. Siehe MCP-Integration. |
Authentifizierung
| Komponente | Rolle |
|---|
Identity Server (IdS) (PrimeDocs.IdentityServer.CustomerHost) | Zentrale Authentifizierung über OIDC/OAuth 2.0 und JWT. Bindet externe Identitätsquellen (Microsoft Entra ID, Active Directory, Microsoft 365) an. Alle Clients und Server-Dienste authentifizieren sich gegen den IdS. Siehe Authentifizierung. |
Datenbanken (SQL Server)
primedocs unterscheidet zwischen mandantenspezifischen und instanzweiten Daten:
| Datenbank | Inhalt |
|---|
Datasource-Datenbank (PrimeDocsContext) | Pro Datasource (Mandant) eine Instanz: Vorlagen, Snippets, Benutzer, Profile, Organisationseinheiten und Rechte. |
Operations-Datenbank (OperationContext) | Instanzweite Daten: Tokens, Logging sowie SCIM-Provisionierungsdaten (Benutzer, Gruppen, Requests). Umfasst auch den Identity-Server-Store (Konfiguration und Persisted Grants). Physisch dieselbe Datenbank, mit getrennter Migrationsverwaltung. |
Datenquellen und Synchronisierung
| Komponente | Rolle |
|---|
| Address Provider (AP) | Pluggable Datenquellen für Adress- und Stammdaten (LDAP, CRM, SharePoint, HTTP, SQL, u. a.) über die Select-Schnittstelle. |
| Benutzer-Synchronisierung | Provisionierung der Benutzer aus AD, SQL oder eigenen Quellen über LDAP/SQL/HTTP sowie SCIM. |
Externe Systeme (LOB-Apps)
Drittsysteme (Win32-Anwendungen, Office-Add-Ins oder beliebige Dienste) binden primedocs über zwei Wege an: die Connect-Schnittstelle (XML-basiert, zur Automatisierung der Dokumentgenerierung) und die Web API (REST). Ergänzend steht der SharePoint Connector zur Verfügung. Der Zugriff ist plattformübergreifend möglich (Browser, Windows, macOS, Android).
In diesem Abschnitt