Infrastructure high complexity backend
0
Dependencies
1
Dependents
1
Entities
0
Integrations

Description

Core adapter framework defining the IntegrationAdapter interface and adapter registry. All external system adapters implement this interface, enabling new integrations to be added without modifying business logic. Handles adapter registration per organization, credential encryption at rest, and webhook receiver routing.

Feature: External Portal & Accounting System Integration

integration-adapter-infrastructure

Responsibilities

  • Define and enforce the IntegrationAdapter interface contract
  • Maintain adapter registry keyed by integration type
  • Route inbound webhook HTTP requests to the appropriate adapter handler
  • Encrypt and decrypt integration credentials for secure storage

Interfaces

registerAdapter(integrationType, adapterClass)
resolveAdapter(integrationType)
getRegisteredAdapterTypes()
encryptCredentials(credentials)
decryptCredentials(encryptedCredentials)
routeWebhook(source, headers, body)
validateWebhookSignature(source, headers, body)

Relationships

Dependents (1)

Components that depend on this component

Sub-Components (1)

OAuth2 Credential Store
component medium

Manages OAuth2 token storage, refresh, and expiry tracking for integrations that use OAuth2 authentication such as HLF Dynamics. Tokens are stored encrypted and refreshed automatically before expiry.

  • Store OAuth2 access and refresh tokens securely
  • Automatically refresh tokens before expiry
  • Invalidate tokens on integration disconnect

Related Data Entities (1)

Data entities managed by this component