# balaji1472/mobile-recharge-system---spring-boot architecture

> Architecture diagram of the GitHub repository balaji1472/mobile-recharge-system---spring-boot, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-22). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/balaji1472/mobile-recharge-system---spring-boot
- Repository: https://github.com/balaji1472/mobile-recharge-system---spring-boot

## Overview

This is a Spring-based mobile recharge management backend. Users authenticate, select a mobile connection and plan, then initiate a recharge; administrators maintain the catalog and review operational records. The tree also shows payment verification, invoices, refunds, notifications, saved numbers, analytics and audit logging. The sampled recharge interface establishes its operations, but its implementation was not shown, so downstream recharge/payment relationships are not asserted. Edges below are limited to controller-to-service calls visible in excerpts or SOURCE INDEX references.

Main entry points: [`src/main/java/com/mrs/enpoint/entity`](https://github.com/balaji1472/mobile-recharge-system---spring-boot/tree/main/src/main/java/com/mrs/enpoint/entity) (Application database), [`src/main/java/com/mrs/enpoint/feature/auth/controller/AuthController.java`](https://github.com/balaji1472/mobile-recharge-system---spring-boot/blob/main/src/main/java/com/mrs/enpoint/feature/auth/controller/AuthController.java) (Auth endpoints), [`src/main/java/com/mrs/enpoint/feature/operator/controller/OperatorController.java`](https://github.com/balaji1472/mobile-recharge-system---spring-boot/blob/main/src/main/java/com/mrs/enpoint/feature/operator/controller/OperatorController.java) (Operators), [`src/main/java/com/mrs/enpoint/feature/category/controller/CategoryController.java`](https://github.com/balaji1472/mobile-recharge-system---spring-boot/blob/main/src/main/java/com/mrs/enpoint/feature/category/controller/CategoryController.java) (Plan categories)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_identity["Identity and access"]
  node_auth_api["Auth endpoints"]
  node_auth_logic["Authentication<br/>[AuthService.java]"]
  node_user_admin["User administration"]
  node_roles["Role management"]
  node_saved_numbers["Saved numbers"]
end

subgraph group_catalog["Recharge catalog"]
  node_operators["Operators"]
  node_categories["Plan categories"]
  node_plans["Recharge plans"]
  node_offers["Offers"]
  node_plan_offers["Plan offers"]
end

subgraph group_recharge["Recharge operations"]
  node_recharge_api["Recharge endpoints"]
  node_recharge_logic["Recharge operations"]
  node_payments["Payment verification"]
end

subgraph group_records["Records and insights"]
  node_transactions["Transactions"]
  node_invoices["Invoices"]
  node_refunds["Refunds"]
  node_notifications["Notifications"]
  node_analytics["Analytics"]
  node_audit["Audit logging"]
end

subgraph group_platform["Shared services"]
  node_razorpay["Razorpay integration"]
  node_security["Security configuration"]
  node_database[("Application database")]
end

node_customer(("User"))

node_customer -->|"submits credentials"| node_auth_api
node_auth_api -->|"delegates auth"| node_auth_logic
node_customer -.->|"requests recharge"| node_recharge_api
node_recharge_api -->|"delegates recharge"| node_recharge_logic
node_customer -.->|"browses operators"| node_operators
node_operators -.->|"reads operator data"| node_database
node_customer -.->|"browses categories"| node_categories
node_categories -.->|"reads category data"| node_database
node_customer -.->|"browses plans"| node_plans
node_plans -.->|"reads plan data"| node_database
node_customer -.->|"views offers"| node_offers
node_customer -.->|"manages numbers"| node_saved_numbers
node_customer -.->|"verifies payment"| node_payments
node_payments -.->|"uses payment API"| node_razorpay

click node_auth_api "https://github.com/balaji1472/mobile-recharge-system---spring-boot/blob/main/src/main/java/com/mrs/enpoint/feature/auth/controller/AuthController.java"
click node_auth_logic "https://github.com/balaji1472/mobile-recharge-system---spring-boot/blob/main/src/main/java/com/mrs/enpoint/feature/auth/service/AuthService.java"
click node_user_admin "https://github.com/balaji1472/mobile-recharge-system---spring-boot/tree/main/src/main/java/com/mrs/enpoint/feature/user"
click node_roles "https://github.com/balaji1472/mobile-recharge-system---spring-boot/tree/main/src/main/java/com/mrs/enpoint/feature/role"
click node_saved_numbers "https://github.com/balaji1472/mobile-recharge-system---spring-boot/tree/main/src/main/java/com/mrs/enpoint/feature/savednumber"
click node_operators "https://github.com/balaji1472/mobile-recharge-system---spring-boot/blob/main/src/main/java/com/mrs/enpoint/feature/operator/controller/OperatorController.java"
click node_categories "https://github.com/balaji1472/mobile-recharge-system---spring-boot/blob/main/src/main/java/com/mrs/enpoint/feature/category/controller/CategoryController.java"
click node_plans "https://github.com/balaji1472/mobile-recharge-system---spring-boot/blob/main/src/main/java/com/mrs/enpoint/feature/plan/controller/PlanController.java"
click node_offers "https://github.com/balaji1472/mobile-recharge-system---spring-boot/blob/main/src/main/java/com/mrs/enpoint/feature/offer/controller/OfferController.java"
click node_plan_offers "https://github.com/balaji1472/mobile-recharge-system---spring-boot/tree/main/src/main/java/com/mrs/enpoint/feature/planoffer"
click node_recharge_api "https://github.com/balaji1472/mobile-recharge-system---spring-boot/blob/main/src/main/java/com/mrs/enpoint/feature/recharge/controller/RechargeController.java"
click node_recharge_logic "https://github.com/balaji1472/mobile-recharge-system---spring-boot/blob/main/src/main/java/com/mrs/enpoint/feature/recharge/service/RechargeService.java"
click node_payments "https://github.com/balaji1472/mobile-recharge-system---spring-boot/tree/main/src/main/java/com/mrs/enpoint/feature/payment"
click node_razorpay "https://github.com/balaji1472/mobile-recharge-system---spring-boot/blob/main/src/main/java/com/mrs/enpoint/shared/razorpay/RazorpayService.java"
click node_transactions "https://github.com/balaji1472/mobile-recharge-system---spring-boot/tree/main/src/main/java/com/mrs/enpoint/feature/transaction"
click node_invoices "https://github.com/balaji1472/mobile-recharge-system---spring-boot/tree/main/src/main/java/com/mrs/enpoint/feature/invoice"
click node_refunds "https://github.com/balaji1472/mobile-recharge-system---spring-boot/tree/main/src/main/java/com/mrs/enpoint/feature/refund"
click node_notifications "https://github.com/balaji1472/mobile-recharge-system---spring-boot/tree/main/src/main/java/com/mrs/enpoint/feature/notification"
click node_analytics "https://github.com/balaji1472/mobile-recharge-system---spring-boot/tree/main/src/main/java/com/mrs/enpoint/feature/analytics"
click node_audit "https://github.com/balaji1472/mobile-recharge-system---spring-boot/tree/main/src/main/java/com/mrs/enpoint/feature/auditlog"
click node_security "https://github.com/balaji1472/mobile-recharge-system---spring-boot/tree/main/src/main/java/com/mrs/enpoint/shared/security"
click node_database "https://github.com/balaji1472/mobile-recharge-system---spring-boot/tree/main/src/main/java/com/mrs/enpoint/entity"

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_api,node_auth_logic,node_user_admin,node_roles,node_saved_numbers,node_customer toneBlue
class node_operators,node_categories,node_plans,node_offers,node_plan_offers toneAmber
class node_recharge_api,node_recharge_logic,node_payments toneMint
class node_transactions,node_invoices,node_refunds,node_notifications,node_analytics,node_audit toneRose
class node_razorpay,node_security,node_database toneIndigo
```

## Components

### Identity and access

- [Auth endpoints](https://github.com/balaji1472/mobile-recharge-system---spring-boot/blob/main/src/main/java/com/mrs/enpoint/feature/auth/controller/AuthController.java): `src/main/java/com/mrs/enpoint/feature/auth/controller/AuthController.java`
- [Authentication](https://github.com/balaji1472/mobile-recharge-system---spring-boot/blob/main/src/main/java/com/mrs/enpoint/feature/auth/service/AuthService.java): `src/main/java/com/mrs/enpoint/feature/auth/service/AuthService.java`
- [User administration](https://github.com/balaji1472/mobile-recharge-system---spring-boot/tree/main/src/main/java/com/mrs/enpoint/feature/user): `src/main/java/com/mrs/enpoint/feature/user`
- [Role management](https://github.com/balaji1472/mobile-recharge-system---spring-boot/tree/main/src/main/java/com/mrs/enpoint/feature/role): `src/main/java/com/mrs/enpoint/feature/role`
- [Saved numbers](https://github.com/balaji1472/mobile-recharge-system---spring-boot/tree/main/src/main/java/com/mrs/enpoint/feature/savednumber): `src/main/java/com/mrs/enpoint/feature/savednumber`

### Recharge catalog

- [Operators](https://github.com/balaji1472/mobile-recharge-system---spring-boot/blob/main/src/main/java/com/mrs/enpoint/feature/operator/controller/OperatorController.java): `src/main/java/com/mrs/enpoint/feature/operator/controller/OperatorController.java`
- [Plan categories](https://github.com/balaji1472/mobile-recharge-system---spring-boot/blob/main/src/main/java/com/mrs/enpoint/feature/category/controller/CategoryController.java): `src/main/java/com/mrs/enpoint/feature/category/controller/CategoryController.java`
- [Recharge plans](https://github.com/balaji1472/mobile-recharge-system---spring-boot/blob/main/src/main/java/com/mrs/enpoint/feature/plan/controller/PlanController.java): `src/main/java/com/mrs/enpoint/feature/plan/controller/PlanController.java`
- [Offers](https://github.com/balaji1472/mobile-recharge-system---spring-boot/blob/main/src/main/java/com/mrs/enpoint/feature/offer/controller/OfferController.java): `src/main/java/com/mrs/enpoint/feature/offer/controller/OfferController.java`
- [Plan offers](https://github.com/balaji1472/mobile-recharge-system---spring-boot/tree/main/src/main/java/com/mrs/enpoint/feature/planoffer): `src/main/java/com/mrs/enpoint/feature/planoffer`

### Recharge operations

- [Recharge endpoints](https://github.com/balaji1472/mobile-recharge-system---spring-boot/blob/main/src/main/java/com/mrs/enpoint/feature/recharge/controller/RechargeController.java): `src/main/java/com/mrs/enpoint/feature/recharge/controller/RechargeController.java`
- [Recharge operations](https://github.com/balaji1472/mobile-recharge-system---spring-boot/blob/main/src/main/java/com/mrs/enpoint/feature/recharge/service/RechargeService.java): `src/main/java/com/mrs/enpoint/feature/recharge/service/RechargeService.java`
- [Payment verification](https://github.com/balaji1472/mobile-recharge-system---spring-boot/tree/main/src/main/java/com/mrs/enpoint/feature/payment): `src/main/java/com/mrs/enpoint/feature/payment`

### Records and insights

- [Transactions](https://github.com/balaji1472/mobile-recharge-system---spring-boot/tree/main/src/main/java/com/mrs/enpoint/feature/transaction): `src/main/java/com/mrs/enpoint/feature/transaction`
- [Invoices](https://github.com/balaji1472/mobile-recharge-system---spring-boot/tree/main/src/main/java/com/mrs/enpoint/feature/invoice): `src/main/java/com/mrs/enpoint/feature/invoice`
- [Refunds](https://github.com/balaji1472/mobile-recharge-system---spring-boot/tree/main/src/main/java/com/mrs/enpoint/feature/refund): `src/main/java/com/mrs/enpoint/feature/refund`
- [Notifications](https://github.com/balaji1472/mobile-recharge-system---spring-boot/tree/main/src/main/java/com/mrs/enpoint/feature/notification): `src/main/java/com/mrs/enpoint/feature/notification`
- [Analytics](https://github.com/balaji1472/mobile-recharge-system---spring-boot/tree/main/src/main/java/com/mrs/enpoint/feature/analytics): `src/main/java/com/mrs/enpoint/feature/analytics`
- [Audit logging](https://github.com/balaji1472/mobile-recharge-system---spring-boot/tree/main/src/main/java/com/mrs/enpoint/feature/auditlog): `src/main/java/com/mrs/enpoint/feature/auditlog`

### Shared services

- [Razorpay integration](https://github.com/balaji1472/mobile-recharge-system---spring-boot/blob/main/src/main/java/com/mrs/enpoint/shared/razorpay/RazorpayService.java): `src/main/java/com/mrs/enpoint/shared/razorpay/RazorpayService.java`
- [Security configuration](https://github.com/balaji1472/mobile-recharge-system---spring-boot/tree/main/src/main/java/com/mrs/enpoint/shared/security): `src/main/java/com/mrs/enpoint/shared/security`
- [Application database](https://github.com/balaji1472/mobile-recharge-system---spring-boot/tree/main/src/main/java/com/mrs/enpoint/entity): `src/main/java/com/mrs/enpoint/entity`

### Other components

- **User**

## Connections

- User → Auth endpoints: submits credentials (evidence: `src/main/java/com/mrs/enpoint/feature/auth/controller/AuthController.java`)
- Auth endpoints → Authentication: delegates auth (evidence: `src/main/java/com/mrs/enpoint/feature/auth/controller/AuthController.java`)
- User → Recharge endpoints: requests recharge
- Recharge endpoints → Recharge operations: delegates recharge (evidence: `src/main/java/com/mrs/enpoint/feature/recharge/controller/RechargeController.java`)
- User → Operators: browses operators
- Operators → Application database: reads operator data (evidence: `src/main/java/com/mrs/enpoint/feature/operator/controller/OperatorController.java`)
- User → Plan categories: browses categories
- Plan categories → Application database: reads category data (evidence: `src/main/java/com/mrs/enpoint/feature/category/controller/CategoryController.java`)
- User → Recharge plans: browses plans
- Recharge plans → Application database: reads plan data (evidence: `src/main/java/com/mrs/enpoint/feature/plan/controller/PlanController.java`)
- User → Offers: views offers
- User → Saved numbers: manages numbers
- User → Payment verification: verifies payment
- Payment verification → Razorpay integration: uses payment API
