Service Layer high complexity backend
1
Dependencies
1
Dependents
0
Entities
0
Integrations

Description

Stateless service that translates between the external portal's data schema and Meander's internal user and organization model. Applies the per-organization field mappings configured in the Portal Integration Config Page. Handles type coercion, null-safety, and unknown-field passthrough so that schema mismatches produce warnings rather than hard failures.

Feature: External Portal Integration

schema-translation-service

Responsibilities

  • Apply per-organization field mapping rules to transform external portal records into Meander entity shapes
  • Perform type coercion and value normalization (dates, identifiers, enum values)
  • Emit structured warnings for unmapped or unrecognized fields without failing the entire sync
  • Validate translated records against Meander's schema before they are persisted

Interfaces

translate(rawRecord: ExternalPortalRecord, mappings: FieldMappingConfig): TranslationResult
validateTranslation(record: MeanderRecord): ValidationResult
listUnmappedFields(rawRecord: ExternalPortalRecord, mappings: FieldMappingConfig): string[]

Relationships

Dependencies (1)

Components this component depends on

Dependents (1)

Components that depend on this component