External Portal Connector
Component Detail
Service Layer
high complexity
backend
4
Dependencies
2
Dependents
1
Entities
0
Integrations
Description
Backend connector service that ingests events and data from HLF's Dynamics-based external portal via secure webhook or polling endpoint. Read-oriented at MVP - it receives membership updates and role changes from the external portal and maps them to Meander's internal user and organization model via the Schema Translation Service. Supports both OAuth 2.0 and API-key authentication depending on external portal capabilities.
external-portal-connector
Responsibilities
- Receive and authenticate incoming webhook payloads or poll the external portal endpoint on a configured schedule
- Validate and deserialize external portal event payloads before passing to the translation layer
- Invoke Schema Translation Service to map external field values to Meander user/organization records
- Write translated records to the database and emit sync log entries for each processed event
- Enforce read-only semantics at MVP - no write-back to the external portal to prevent circular update loops
Interfaces
handleWebhookEvent(payload: RawPortalEvent): ProcessingResult
pollExternalPortal(orgId: string): PollingResult
authenticate(credentials: PortalCredentials): AuthToken
scheduleSync(orgId: string, frequencyMinutes: number): void
getConnectorStatus(orgId: string): ConnectorStatus
Relationships
Dependencies (4)
Components this component depends on
Dependents (2)
Components that depend on this component