# maanrsa001/commonapiv1 architecture

> Architecture diagram of the GitHub repository maanrsa001/commonapiv1, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-07). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/maanrsa001/commonapiv1
- Repository: https://github.com/maanrsa001/commonapiv1

## Overview

This is a Java/Spring insurance platform backend. Its central workflow is user authentication followed by insurance quote data capture, premium calculation, and policy/endorsement handling; supporting modules cover administration, claims, documents, integrations, and notifications. The tree and source index establish these product areas, but the README is empty and most implementation files were not sampled, so many workflow links are shown as unverified rather than asserted. The sampled RealPay flow reads client, contract, and installment records to construct a response.

Main entry points: [`src/main/java/com/maan/eway/bean`](https://github.com/maanrsa001/commonapiv1/tree/main/src/main/java/com/maan/eway/bean) (Policy and risk data), [`src/main/java/com/maan/eway/auth`](https://github.com/maanrsa001/commonapiv1/tree/main/src/main/java/com/maan/eway/auth) (Authentication), [`src/main/java/com/maan/eway/common/service`](https://github.com/maanrsa001/commonapiv1/tree/main/src/main/java/com/maan/eway/common/service) (Quote search), [`src/main/java/com/maan/eway/service/impl/CalculatorEngineService.java`](https://github.com/maanrsa001/commonapiv1/blob/main/src/main/java/com/maan/eway/service/impl/CalculatorEngineService.java) (Premium calculation)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_access["Access and administration"]
  node_auth["Authentication"]
  node_admin["User administration"]
end

subgraph group_insurance["Insurance operations"]
  node_quote["Quote search"]
  node_rating["Premium calculation"]
  node_cover["Section covers"]
  node_policydata[("Policy and risk data")]
  node_endorsement["Endorsements"]
  node_claims["Claims"]
end

subgraph group_support["Policy support"]
  node_documents["Documents and reports"]
  node_notifications["Notifications"]
  node_renewal["Renewals"]
end

subgraph group_integrations["External integrations"]
  node_realpayapi["RealPay query API"]
  node_realpayservice["RealPay query service"]
  node_realpaydata[("RealPay records")]
  node_rtsa["Vehicle registry"]
  node_payments["Payment services"]
end

node_user(("Insurance user"))
node_external{{"External services"}}

node_user -.->|"authenticates"| node_auth
node_auth -.->|"authorizes access"| node_admin
node_user -.->|"searches quotes"| node_quote
node_quote -.->|"requests pricing"| node_rating
node_rating -.->|"reads policy data"| node_policydata
node_cover -.->|"configures coverage"| node_policydata
node_endorsement -.->|"uses policy records"| node_policydata
node_claims -.->|"uses policy records"| node_policydata
node_renewal -.->|"uses policy records"| node_policydata
node_documents -.->|"uses policy records"| node_policydata
node_notifications -.->|"sends notices"| node_external
node_payments -.->|"integrates payments"| node_external
node_rtsa -.->|"checks registration"| node_external
node_realpayapi -->|"delegates query"| node_realpayservice
node_realpayservice -->|"reads records"| node_realpaydata

click node_auth "https://github.com/maanrsa001/commonapiv1/tree/main/src/main/java/com/maan/eway/auth"
click node_admin "https://github.com/maanrsa001/commonapiv1/tree/main/src/main/java/com/maan/eway/admin"
click node_quote "https://github.com/maanrsa001/commonapiv1/tree/main/src/main/java/com/maan/eway/common/service"
click node_rating "https://github.com/maanrsa001/commonapiv1/blob/main/src/main/java/com/maan/eway/service/impl/CalculatorEngineService.java"
click node_cover "https://github.com/maanrsa001/commonapiv1/tree/main/src/main/java/com/maan/eway/SectionCoverMaster"
click node_policydata "https://github.com/maanrsa001/commonapiv1/tree/main/src/main/java/com/maan/eway/bean"
click node_endorsement "https://github.com/maanrsa001/commonapiv1/blob/main/src/main/java/com/maan/eway/endorsment/service/EndorsementService.java"
click node_claims "https://github.com/maanrsa001/commonapiv1/blob/main/src/main/java/com/maan/eway/claim/ClaimDetailsService.java"
click node_documents "https://github.com/maanrsa001/commonapiv1/blob/main/src/main/java/com/maan/eway/document/service/DocumentService.java"
click node_notifications "https://github.com/maanrsa001/commonapiv1/blob/main/src/main/java/com/maan/eway/notification/service/NotificationService.java"
click node_renewal "https://github.com/maanrsa001/commonapiv1/blob/main/src/main/java/com/maan/eway/renewal/service/RenewalService.java"
click node_realpayapi "https://github.com/maanrsa001/commonapiv1/blob/main/src/main/java/com/maan/eway/realpay/controller/RealPayQueryController.java"
click node_realpayservice "https://github.com/maanrsa001/commonapiv1/blob/main/src/main/java/com/maan/eway/realpay/service/RealPayQueryService.java"
click node_realpaydata "https://github.com/maanrsa001/commonapiv1/tree/main/src/main/java/com/maan/eway/realpay/repository"
click node_rtsa "https://github.com/maanrsa001/commonapiv1/tree/main/src/main/java/com/maan/eway/Rtsa"
click node_payments "https://github.com/maanrsa001/commonapiv1/tree/main/src/main/java/com/maan/eway/payment/service"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_auth,node_admin,node_user toneBlue
class node_quote,node_rating,node_cover,node_policydata,node_endorsement,node_claims toneAmber
class node_documents,node_notifications,node_renewal toneMint
class node_realpayapi,node_realpayservice,node_realpaydata,node_rtsa,node_payments toneRose
class node_external toneIndigo
```

## Components

### Access and administration

- [Authentication](https://github.com/maanrsa001/commonapiv1/tree/main/src/main/java/com/maan/eway/auth): `src/main/java/com/maan/eway/auth`
- [User administration](https://github.com/maanrsa001/commonapiv1/tree/main/src/main/java/com/maan/eway/admin): `src/main/java/com/maan/eway/admin`

### Insurance operations

- [Quote search](https://github.com/maanrsa001/commonapiv1/tree/main/src/main/java/com/maan/eway/common/service): `src/main/java/com/maan/eway/common/service`
- [Premium calculation](https://github.com/maanrsa001/commonapiv1/blob/main/src/main/java/com/maan/eway/service/impl/CalculatorEngineService.java): `src/main/java/com/maan/eway/service/impl/CalculatorEngineService.java`
- [Section covers](https://github.com/maanrsa001/commonapiv1/tree/main/src/main/java/com/maan/eway/SectionCoverMaster): `src/main/java/com/maan/eway/SectionCoverMaster`
- [Policy and risk data](https://github.com/maanrsa001/commonapiv1/tree/main/src/main/java/com/maan/eway/bean): `src/main/java/com/maan/eway/bean`
- [Endorsements](https://github.com/maanrsa001/commonapiv1/blob/main/src/main/java/com/maan/eway/endorsment/service/EndorsementService.java): `src/main/java/com/maan/eway/endorsment/service/EndorsementService.java`
- [Claims](https://github.com/maanrsa001/commonapiv1/blob/main/src/main/java/com/maan/eway/claim/ClaimDetailsService.java): `src/main/java/com/maan/eway/claim/ClaimDetailsService.java`

### Policy support

- [Documents and reports](https://github.com/maanrsa001/commonapiv1/blob/main/src/main/java/com/maan/eway/document/service/DocumentService.java): `src/main/java/com/maan/eway/document/service/DocumentService.java`
- [Notifications](https://github.com/maanrsa001/commonapiv1/blob/main/src/main/java/com/maan/eway/notification/service/NotificationService.java): `src/main/java/com/maan/eway/notification/service/NotificationService.java`
- [Renewals](https://github.com/maanrsa001/commonapiv1/blob/main/src/main/java/com/maan/eway/renewal/service/RenewalService.java): `src/main/java/com/maan/eway/renewal/service/RenewalService.java`

### External integrations

- [RealPay query API](https://github.com/maanrsa001/commonapiv1/blob/main/src/main/java/com/maan/eway/realpay/controller/RealPayQueryController.java): `src/main/java/com/maan/eway/realpay/controller/RealPayQueryController.java`
- [RealPay query service](https://github.com/maanrsa001/commonapiv1/blob/main/src/main/java/com/maan/eway/realpay/service/RealPayQueryService.java): `src/main/java/com/maan/eway/realpay/service/RealPayQueryService.java`
- [RealPay records](https://github.com/maanrsa001/commonapiv1/tree/main/src/main/java/com/maan/eway/realpay/repository): `src/main/java/com/maan/eway/realpay/repository`
- [Vehicle registry](https://github.com/maanrsa001/commonapiv1/tree/main/src/main/java/com/maan/eway/Rtsa): `src/main/java/com/maan/eway/Rtsa`
- [Payment services](https://github.com/maanrsa001/commonapiv1/tree/main/src/main/java/com/maan/eway/payment/service): `src/main/java/com/maan/eway/payment/service`

### Other components

- **Insurance user**
- **External services**

## Connections

- Insurance user → Authentication: authenticates
- Authentication → User administration: authorizes access
- Insurance user → Quote search: searches quotes
- Quote search → Premium calculation: requests pricing
- Premium calculation → Policy and risk data: reads policy data (evidence: `src/main/java/com/maan/eway/service/impl/CalculatorEngineService.java`)
- Section covers → Policy and risk data: configures coverage (evidence: `src/main/java/com/maan/eway/SectionCoverMaster/SectionService.java`)
- Endorsements → Policy and risk data: uses policy records (evidence: `src/main/java/com/maan/eway/endorsment/service/EndorsementService.java`)
- Claims → Policy and risk data: uses policy records
- Renewals → Policy and risk data: uses policy records
- Documents and reports → Policy and risk data: uses policy records
- Notifications → External services: sends notices
- Payment services → External services: integrates payments
- Vehicle registry → External services: checks registration
- RealPay query API → RealPay query service: delegates query (evidence: `src/main/java/com/maan/eway/realpay/controller/RealPayQueryController.java`)
- RealPay query service → RealPay records: reads records (evidence: `src/main/java/com/maan/eway/realpay/service/RealPayQueryService.java`)
