Schema Translation Service
Component Detail
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.
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[]