banking-domain-model

What problem does it solve?

This unit solves the complexity of modeling and orchestrating customer onboarding in banking systems by providing a cohesive domain model for customer profiles, parties/households, account opening workflows, KYC ingestion, document management, and consent tracking so teams can deliver compliant, auditable account creation and identity verification flows.

Core Features & Use Cases

• Customer Profile Aggregate: Centralized PII-aware CustomerProfile with encrypted sensitive fields, multi-address/contact support, and party relationships for households and joint accounts.
• Account Opening & Eligibility: EligibilityEngine and AccountOpeningService to enforce age, SSN, and credit checks, produce idempotent account creation, and capture product snapshots.
• KYC & Document Workflows: KycService with S3 presigned upload URLs, document tracking, pluggable identity verification adapters (Socure/Persona), and strict KYC state-machine transitions.
• Compliance & Consent: Immutable consent audit records, customer preferences, Flyway migrations for schema control, and rules for encryption, auditing, and transactional consistency.
• Use Case Example: Implement end-to-end onboarding that validates eligibility, initiates KYC, accepts S3 uploads for identity docs, delegates verification to an adapter, and transitions KYC state to approved or rejected while preserving audit trails.

Quick Start

Provide a complete data model and sequence diagram for customer onboarding including KYC state transitions and S3 document upload flow.