Overview

The BFFASCP Service is the Backend for Frontend service that powers the Agent Servicing Claims Portal (ASCP). It provides a unified API layer that orchestrates communication between the ASCP frontend and various Capstone domain services.

Architecture

The service follows a clean/hexagonal architecture pattern:

• Domain Layer: Command definitions, handlers, and business logic
• Application Layer: Use case orchestration and request handling
• Infrastructure Layer: HTTP clients, SQS dispatchers, and Lambda functions

ASCP Frontend
     |
     v
BFFASCP Service (API Gateway + Lambda)
     |
     +---> Quote Domain
     +---> Policy Domain
     +---> Claims Domain
     +---> Customer Domain
     +---> Partner Domain
     +---> Pricing Service
     +---> File Upload Service

Capabilities

Quote Management

• Create and configure quotes with products and beneficiaries
• Capture policyholder and collection details
• Set terms and conditions acceptance
• Finalise and accept quotes

Policy Servicing

• Manage beneficiaries on existing policies
• Update personal and contact details
• Generate and refresh policy schedules
• Cancel policies
• Record deceased notifications

Claims Processing

• Create claims for main life and covered life deaths
• Update claim details and documentation
• Calculate claim payouts
• Process claim payments
• Handle claim repudiation and overrides

File Management

• Generate pre-signed URLs for document uploads
• Download uploaded files
• Delete files
• Track file upload status

Query Operations

• Retrieve quotes, policies, claims, and customer data
• Get partner and package configuration
• Perform pricing calculations
• Track command processing status

Technical Stack

• Runtime: Java 21 on AWS Lambda
• Framework: Custom clean architecture
• Messaging: AWS SQS for command dispatching
• HTTP Client: Java HTTP Client for domain service calls
• Serialization: Jackson for JSON processing
• Resilience: Resilience4j for fault tolerance