Portal Integration Service
Component Detail
Service Layer
high complexity
backend
2
Dependencies
2
Dependents
2
Entities
0
Integrations
Description
Core backend service managing the full integration lifecycle with the external Dynamics-based portal. Handles authentication, idempotent data sync for users, roles, and activities, inbound event processing, and audit logging of all operations.
portal-integration-service
Responsibilities
- Authenticate against the external Dynamics portal via OAuth 2.0 or API key
- Execute idempotent sync operations for users, roles, and activity records
- Route and process inbound events from webhook or polling mechanism
- Log all sync operations and errors to audit_logs for traceability
- Transform data between Meander and external portal schemas
Interfaces
authenticate(config: IntegrationConfig): Promise<AuthToken>
syncUsers(orgId: string): Promise<SyncResult>
syncRoles(orgId: string): Promise<SyncResult>
syncActivities(orgId: string, since: Date): Promise<SyncResult>
handleInboundEvent(event: PortalEvent): Promise<void>
testConnection(orgId: string): Promise<ConnectionStatus>
getLastSyncStatus(orgId: string): Promise<SyncStatus>
Relationships
Dependencies (2)
Components this component depends on
Dependents (2)
Components that depend on this component
Related Data Entities (2)
Data entities managed by this component