# ankitraj03711/credit-card-management-system architecture

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

- Interactive diagram: https://gitdiagram.com/ankitraj03711/credit-card-management-system
- Repository: https://github.com/ankitraj03711/credit-card-management-system

## Overview

CCMS is a credit-card management application with a React role-based portal and a Spring backend. Users authenticate, then access customer or staff workflows for profiles, card applications and card management, transactions, payments, and reports. The frontend routes pages through API services to backend controllers and domain services; repositories persist domain records. Sampled sources show application routing, API request handling, application-review calls, and payment validation. Most backend feature implementations were not sampled, so uncertain internal links are omitted.

Main entry points: [`frontend/src/App.jsx`](https://github.com/ankitraj03711/credit-card-management-system/blob/main/frontend/src/App.jsx) (Role-based routing), [`backend/src/main/java/com/nexturn/ccms/serviceimpl/PaymentServiceImpl.java`](https://github.com/ankitraj03711/credit-card-management-system/blob/main/backend/src/main/java/com/nexturn/ccms/serviceimpl/PaymentServiceImpl.java) (Payment processing), [`frontend/src/services`](https://github.com/ankitraj03711/credit-card-management-system/tree/main/frontend/src/services) (Feature API services), [`backend/src/main/java/com/nexturn/ccms/repository/CustomerRepository.java`](https://github.com/ankitraj03711/credit-card-management-system/blob/main/backend/src/main/java/com/nexturn/ccms/repository/CustomerRepository.java) (Customer repository)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Web portal"]
  node_app["Role-based routing<br/>[App.jsx]"]
  node_auth["Session and auth<br/>[AuthContext.jsx]"]
  node_portal["Customer portal<br/>[CustomerPortal.jsx]"]
  node_staff_pages["Staff workflows"]
  node_web_services["Feature API services"]
  node_api_client["HTTP and CSRF client<br/>[api.js]"]
end

subgraph group_backend_api["Backend API"]
  node_backend["Spring API"]
  node_application_api["Card application API"]
end

subgraph group_domain["Domain services"]
  node_domain_services["Domain services"]
  node_application_service["Application review"]
  node_payment_logic["Payment processing"]
  node_customer_access["Customer access checks"]
end

subgraph group_persistence["Persistence"]
  node_repositories["Data repositories"]
  node_customer_repository["Customer repository"]
  node_application_repository["Application repository"]
  node_payment_repository["Payment repository"]
end

node_user(("Customer or staff"))
node_database[("Relational database")]

node_user -->|"uses portal"| node_app
node_app -->|"checks session"| node_auth
node_app -->|"routes customer"| node_portal
node_app -->|"routes staff"| node_staff_pages
node_auth -->|"requests authentication"| node_web_services
node_portal -->|"loads account data"| node_web_services
node_web_services -->|"calls API client"| node_api_client
node_api_client -.->|"sends HTTP requests"| node_backend
node_backend -.->|"delegates operations"| node_domain_services
node_application_api -->|"calls review operations"| node_application_service
node_domain_services -.->|"uses persistence"| node_repositories
node_payment_logic -.->|"queries payments"| node_payment_repository
node_payment_logic -->|"checks customer"| node_customer_repository
node_payment_logic -->|"checks card records"| node_repositories
node_customer_access -->|"looks up account"| node_customer_repository
node_application_service -.->|"persists applications"| node_application_repository
node_customer_repository -.->|"reads customer records"| node_database
node_application_repository -.->|"stores applications"| node_database
node_payment_repository -.->|"stores payments"| node_database

click node_app "https://github.com/ankitraj03711/credit-card-management-system/blob/main/frontend/src/App.jsx"
click node_auth "https://github.com/ankitraj03711/credit-card-management-system/blob/main/frontend/src/context/AuthContext.jsx"
click node_portal "https://github.com/ankitraj03711/credit-card-management-system/blob/main/frontend/src/pages/CustomerPortal.jsx"
click node_staff_pages "https://github.com/ankitraj03711/credit-card-management-system/tree/main/frontend/src/pages"
click node_web_services "https://github.com/ankitraj03711/credit-card-management-system/tree/main/frontend/src/services"
click node_api_client "https://github.com/ankitraj03711/credit-card-management-system/blob/main/frontend/src/services/api.js"
click node_backend "https://github.com/ankitraj03711/credit-card-management-system/tree/main/backend/src/main/java/com/nexturn/ccms/controller"
click node_application_api "https://github.com/ankitraj03711/credit-card-management-system/blob/main/backend/src/main/java/com/nexturn/ccms/controller/CreditCardApplicationController.java"
click node_domain_services "https://github.com/ankitraj03711/credit-card-management-system/tree/main/backend/src/main/java/com/nexturn/ccms/service"
click node_application_service "https://github.com/ankitraj03711/credit-card-management-system/blob/main/backend/src/main/java/com/nexturn/ccms/service/CreditCardApplicationService.java"
click node_payment_logic "https://github.com/ankitraj03711/credit-card-management-system/blob/main/backend/src/main/java/com/nexturn/ccms/serviceimpl/PaymentServiceImpl.java"
click node_customer_access "https://github.com/ankitraj03711/credit-card-management-system/blob/main/backend/src/main/java/com/nexturn/ccms/service/CustomerAccessService.java"
click node_repositories "https://github.com/ankitraj03711/credit-card-management-system/tree/main/backend/src/main/java/com/nexturn/ccms/repository"
click node_customer_repository "https://github.com/ankitraj03711/credit-card-management-system/blob/main/backend/src/main/java/com/nexturn/ccms/repository/CustomerRepository.java"
click node_application_repository "https://github.com/ankitraj03711/credit-card-management-system/blob/main/backend/src/main/java/com/nexturn/ccms/repository/CreditCardApplicationRepository.java"
click node_payment_repository "https://github.com/ankitraj03711/credit-card-management-system/blob/main/backend/src/main/java/com/nexturn/ccms/repository/PaymentRepository.java"

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_app,node_auth,node_portal,node_staff_pages,node_web_services,node_api_client toneBlue
class node_backend,node_application_api,node_database toneAmber
class node_domain_services,node_application_service,node_payment_logic,node_customer_access toneMint
class node_repositories,node_customer_repository,node_application_repository,node_payment_repository toneRose
class node_user toneIndigo
```

## Components

### Web portal

- [Role-based routing](https://github.com/ankitraj03711/credit-card-management-system/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Session and auth](https://github.com/ankitraj03711/credit-card-management-system/blob/main/frontend/src/context/AuthContext.jsx): `frontend/src/context/AuthContext.jsx`
- [Customer portal](https://github.com/ankitraj03711/credit-card-management-system/blob/main/frontend/src/pages/CustomerPortal.jsx): `frontend/src/pages/CustomerPortal.jsx`
- [Staff workflows](https://github.com/ankitraj03711/credit-card-management-system/tree/main/frontend/src/pages): `frontend/src/pages`
- [Feature API services](https://github.com/ankitraj03711/credit-card-management-system/tree/main/frontend/src/services): `frontend/src/services`
- [HTTP and CSRF client](https://github.com/ankitraj03711/credit-card-management-system/blob/main/frontend/src/services/api.js): `frontend/src/services/api.js`

### Backend API

- [Spring API](https://github.com/ankitraj03711/credit-card-management-system/tree/main/backend/src/main/java/com/nexturn/ccms/controller): `backend/src/main/java/com/nexturn/ccms/controller`
- [Card application API](https://github.com/ankitraj03711/credit-card-management-system/blob/main/backend/src/main/java/com/nexturn/ccms/controller/CreditCardApplicationController.java): `backend/src/main/java/com/nexturn/ccms/controller/CreditCardApplicationController.java`

### Domain services

- [Domain services](https://github.com/ankitraj03711/credit-card-management-system/tree/main/backend/src/main/java/com/nexturn/ccms/service): `backend/src/main/java/com/nexturn/ccms/service`
- [Application review](https://github.com/ankitraj03711/credit-card-management-system/blob/main/backend/src/main/java/com/nexturn/ccms/service/CreditCardApplicationService.java): `backend/src/main/java/com/nexturn/ccms/service/CreditCardApplicationService.java`
- [Payment processing](https://github.com/ankitraj03711/credit-card-management-system/blob/main/backend/src/main/java/com/nexturn/ccms/serviceimpl/PaymentServiceImpl.java): `backend/src/main/java/com/nexturn/ccms/serviceimpl/PaymentServiceImpl.java`
- [Customer access checks](https://github.com/ankitraj03711/credit-card-management-system/blob/main/backend/src/main/java/com/nexturn/ccms/service/CustomerAccessService.java): `backend/src/main/java/com/nexturn/ccms/service/CustomerAccessService.java`

### Persistence

- [Data repositories](https://github.com/ankitraj03711/credit-card-management-system/tree/main/backend/src/main/java/com/nexturn/ccms/repository): `backend/src/main/java/com/nexturn/ccms/repository`
- [Customer repository](https://github.com/ankitraj03711/credit-card-management-system/blob/main/backend/src/main/java/com/nexturn/ccms/repository/CustomerRepository.java): `backend/src/main/java/com/nexturn/ccms/repository/CustomerRepository.java`
- [Application repository](https://github.com/ankitraj03711/credit-card-management-system/blob/main/backend/src/main/java/com/nexturn/ccms/repository/CreditCardApplicationRepository.java): `backend/src/main/java/com/nexturn/ccms/repository/CreditCardApplicationRepository.java`
- [Payment repository](https://github.com/ankitraj03711/credit-card-management-system/blob/main/backend/src/main/java/com/nexturn/ccms/repository/PaymentRepository.java): `backend/src/main/java/com/nexturn/ccms/repository/PaymentRepository.java`

### Other components

- **Customer or staff**
- **Relational database**

## Connections

- Customer or staff → Role-based routing: uses portal (evidence: `frontend/src/App.jsx`)
- Role-based routing → Session and auth: checks session (evidence: `frontend/src/App.jsx`)
- Role-based routing → Customer portal: routes customer (evidence: `frontend/src/App.jsx`)
- Role-based routing → Staff workflows: routes staff (evidence: `frontend/src/App.jsx`)
- Session and auth → Feature API services: requests authentication (evidence: `frontend/src/context/AuthContext.jsx`)
- Customer portal → Feature API services: loads account data (evidence: `frontend/src/pages/CustomerPortal.jsx`)
- Feature API services → HTTP and CSRF client: calls API client (evidence: `frontend/src/services/customerService.js`)
- HTTP and CSRF client → Spring API: sends HTTP requests
- Spring API → Domain services: delegates operations (evidence: `backend/src/main/java/com/nexturn/ccms/controller/CreditCardApplicationController.java`)
- Card application API → Application review: calls review operations (evidence: `backend/src/main/java/com/nexturn/ccms/controller/CreditCardApplicationController.java`)
- Domain services → Data repositories: uses persistence (evidence: `backend/src/main/java/com/nexturn/ccms/service/CustomerAccessService.java`)
- Payment processing → Payment repository: queries payments (evidence: `backend/src/main/java/com/nexturn/ccms/serviceimpl/PaymentServiceImpl.java`)
- Payment processing → Customer repository: checks customer (evidence: `backend/src/main/java/com/nexturn/ccms/serviceimpl/PaymentServiceImpl.java`)
- Payment processing → Data repositories: checks card records (evidence: `backend/src/main/java/com/nexturn/ccms/serviceimpl/PaymentServiceImpl.java`)
- Customer access checks → Customer repository: looks up account (evidence: `backend/src/main/java/com/nexturn/ccms/service/CustomerAccessService.java`)
- Application review → Application repository: persists applications
- Customer repository → Relational database: reads customer records
- Application repository → Relational database: stores applications
- Payment repository → Relational database: stores payments
