Architecture Overview

System Overview

The UBI Beneficiary system enables beneficiaries to manage their benefit applications through UBI / ONEST Network protocol. It consists of four main parts:

1. Beneficiary UI: React frontend for beneficiaries to register, upload documents, and manage benefit application

2. Beneficiary Backend: NestJS backend handling business logic, authentication, and data management

3. External Services: UBI / ONEST Network , Verification and Eligibility SDKs for document processing and benefit eligibility checking

1. High Level Architecture Diagram

2. Sequence Diagrams

2.1 Registration Flow : Registration with OTR certificate

2.2 Document Upload Flow Based

For each document type, the admin panel defines:

• Issuer – Issuer of the document

• Document Has OR Code – Yes/No, whether the document contains QR code

• Required fields and validation rules in JSON mapping

Based on these configurations, there are three main flows for uploading documents:

1. IssueVC = Yes

2. IssueVC = No, Document Has OR Code = No

3. IssueVC = No, Document Has OR Code = Yes

Flow 1: IssueVC = Yes

Flow 2: IssueVC = No, Document Has OR Code = No

Flow 3: IssueVC = No, Document Has OR Code = Yes

2.3 Benefit application submission flow