# 47siva/vaultbill architecture

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

- Interactive diagram: https://gitdiagram.com/47siva/vaultbill
- Repository: https://github.com/47siva/vaultbill

## Overview

This is a Spring Boot authorization and customer-commerce API. Its principal workflow is user registration or login, token issuance, then authenticated user and customer actions such as product management and purchasing/invoicing. The tree also shows administration, address, and geographic data capabilities. Persistence is organized around JPA repositories and entities. The README supplies no meaningful product description, and source evidence is partial; uncertain controller dispatches and unsampled subsystem connections are therefore shown as unverified rather than asserted.

Main entry points: [`src/main/java/com/app/Authentication/Authorization/service/UserService.java`](https://github.com/47siva/vaultbill/blob/master/src/main/java/com/app/Authentication/Authorization/service/UserService.java) (User Service), [`src/main/java/com/app/Authentication/Authorization/service/InvoiceService.java`](https://github.com/47siva/vaultbill/blob/master/src/main/java/com/app/Authentication/Authorization/service/InvoiceService.java) (Invoice Service), [`src/main/java/com/app/Authentication/Authorization/service/AdminService.java`](https://github.com/47siva/vaultbill/blob/master/src/main/java/com/app/Authentication/Authorization/service/AdminService.java) (Admin Service), [`src/main/java/com/app/Authentication/Authorization/security/JwtService.java`](https://github.com/47siva/vaultbill/blob/master/src/main/java/com/app/Authentication/Authorization/security/JwtService.java) (JWT Service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_identity["Identity and Security"]
  node_auth_service["Authentication Service"]
  node_user_service["User Service<br/>[UserService.java]"]
  node_jwt["JWT Service<br/>[JwtService.java]"]
  node_security_filter["JWT Filter"]
  node_security_config["Security Configuration"]
  node_admin_service["Admin Service<br/>[AdminService.java]"]
end

subgraph group_commerce["Customer Commerce"]
  node_customer_service["Customer Service"]
  node_product_service["Product Service"]
  node_invoice_service["Invoice Service"]
  node_address_service["Address Service"]
end

subgraph group_api["API and Responses"]
  node_auth_controller["Authentication API"]
  node_admin_controller["Admin API"]
  node_customer_controller["Customer API"]
  node_product_controller["Product API"]
  node_invoice_controller["Invoice API"]
  node_address_controller["Address API"]
  node_response_support["Response Support"]
end

subgraph group_persistence["Persistence"]
  node_user_store["User Repository"]
  node_customer_store["Customer Repository"]
  node_product_store["Product Repository"]
  node_invoice_store["Purchase Repository"]
  node_domain_models["Domain Entities"]
  node_geo_repositories["Geographic Repositories"]
end

node_client(("API Client"))

node_client -.->|"sends requests"| node_auth_controller
node_auth_controller -.->|"dispatches auth"| node_auth_service
node_auth_service -->|"looks up users"| node_user_store
node_auth_service -->|"creates token"| node_jwt
node_user_service -->|"reads and saves"| node_user_store
node_user_service -->|"saves customer"| node_customer_store
node_user_service -.->|"uses products"| node_product_store
node_user_service -->|"validates token"| node_jwt
node_admin_service -->|"saves and reads"| node_user_store
node_admin_service -->|"checks token"| node_jwt
node_admin_service -->|"loads user"| node_user_service
node_product_service -->|"persists products"| node_product_store
node_invoice_service -->|"uses customer data"| node_customer_store
node_invoice_service -->|"uses product data"| node_product_store
node_invoice_service -->|"uses purchase data"| node_invoice_store
node_invoice_service -->|"builds invoice data"| node_domain_models
node_invoice_controller -.->|"dispatches purchases"| node_invoice_service
node_customer_controller -.->|"dispatches customer work"| node_customer_service
node_product_controller -.->|"dispatches product work"| node_product_service
node_address_controller -.->|"dispatches address work"| node_address_service
node_admin_controller -.->|"dispatches admin work"| node_admin_service
node_security_config -.->|"configures filter"| node_security_filter
node_security_filter -.->|"validates bearer token"| node_jwt

click node_auth_controller "https://github.com/47siva/vaultbill/blob/master/src/main/java/com/app/Authentication/Authorization/controller/AuthenticationController.java"
click node_auth_service "https://github.com/47siva/vaultbill/blob/master/src/main/java/com/app/Authentication/Authorization/service/AuthenticationService.java"
click node_user_service "https://github.com/47siva/vaultbill/blob/master/src/main/java/com/app/Authentication/Authorization/service/UserService.java"
click node_jwt "https://github.com/47siva/vaultbill/blob/master/src/main/java/com/app/Authentication/Authorization/security/JwtService.java"
click node_security_filter "https://github.com/47siva/vaultbill/blob/master/src/main/java/com/app/Authentication/Authorization/security/JwtAuthenticationFilter.java"
click node_security_config "https://github.com/47siva/vaultbill/blob/master/src/main/java/com/app/Authentication/Authorization/security/SecurityConfiguration.java"
click node_admin_controller "https://github.com/47siva/vaultbill/blob/master/src/main/java/com/app/Authentication/Authorization/controller/AdminController.java"
click node_admin_service "https://github.com/47siva/vaultbill/blob/master/src/main/java/com/app/Authentication/Authorization/service/AdminService.java"
click node_customer_controller "https://github.com/47siva/vaultbill/blob/master/src/main/java/com/app/Authentication/Authorization/controller/CustomerControler.java"
click node_customer_service "https://github.com/47siva/vaultbill/blob/master/src/main/java/com/app/Authentication/Authorization/service/CustomerServicee.java"
click node_product_controller "https://github.com/47siva/vaultbill/blob/master/src/main/java/com/app/Authentication/Authorization/controller/ProductController.java"
click node_product_service "https://github.com/47siva/vaultbill/blob/master/src/main/java/com/app/Authentication/Authorization/service/ProductService.java"
click node_invoice_controller "https://github.com/47siva/vaultbill/blob/master/src/main/java/com/app/Authentication/Authorization/controller/InvoiceController.java"
click node_invoice_service "https://github.com/47siva/vaultbill/blob/master/src/main/java/com/app/Authentication/Authorization/service/InvoiceService.java"
click node_address_controller "https://github.com/47siva/vaultbill/blob/master/src/main/java/com/app/Authentication/Authorization/controller/AddressControler.java"
click node_address_service "https://github.com/47siva/vaultbill/blob/master/src/main/java/com/app/Authentication/Authorization/service/AddressService.java"
click node_user_store "https://github.com/47siva/vaultbill/blob/master/src/main/java/com/app/Authentication/Authorization/repository/UserRepository.java"
click node_customer_store "https://github.com/47siva/vaultbill/blob/master/src/main/java/com/app/Authentication/Authorization/repository/CustomerRepository.java"
click node_product_store "https://github.com/47siva/vaultbill/blob/master/src/main/java/com/app/Authentication/Authorization/repository/ProductRepository.java"
click node_invoice_store "https://github.com/47siva/vaultbill/blob/master/src/main/java/com/app/Authentication/Authorization/repository/CustomerProductRepository.java"
click node_domain_models "https://github.com/47siva/vaultbill/tree/master/src/main/java/com/app/Authentication/Authorization/entity"
click node_geo_repositories "https://github.com/47siva/vaultbill/tree/master/src/main/java/com/app/Authentication/Authorization/repository"
click node_response_support "https://github.com/47siva/vaultbill/blob/master/src/main/java/com/app/Authentication/Authorization/response/ResponseGenerator.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_auth_service,node_user_service,node_jwt,node_security_filter,node_security_config,node_admin_service,node_client toneBlue
class node_customer_service,node_product_service,node_invoice_service,node_address_service toneAmber
class node_auth_controller,node_admin_controller,node_customer_controller,node_product_controller,node_invoice_controller,node_address_controller,node_response_support toneMint
class node_user_store,node_customer_store,node_product_store,node_invoice_store,node_domain_models,node_geo_repositories toneRose
```

## Components

### Identity and Security

- [Authentication Service](https://github.com/47siva/vaultbill/blob/master/src/main/java/com/app/Authentication/Authorization/service/AuthenticationService.java): `src/main/java/com/app/Authentication/Authorization/service/AuthenticationService.java`
- [User Service](https://github.com/47siva/vaultbill/blob/master/src/main/java/com/app/Authentication/Authorization/service/UserService.java): `src/main/java/com/app/Authentication/Authorization/service/UserService.java`
- [JWT Service](https://github.com/47siva/vaultbill/blob/master/src/main/java/com/app/Authentication/Authorization/security/JwtService.java): `src/main/java/com/app/Authentication/Authorization/security/JwtService.java`
- [JWT Filter](https://github.com/47siva/vaultbill/blob/master/src/main/java/com/app/Authentication/Authorization/security/JwtAuthenticationFilter.java): `src/main/java/com/app/Authentication/Authorization/security/JwtAuthenticationFilter.java`
- [Security Configuration](https://github.com/47siva/vaultbill/blob/master/src/main/java/com/app/Authentication/Authorization/security/SecurityConfiguration.java): `src/main/java/com/app/Authentication/Authorization/security/SecurityConfiguration.java`
- [Admin Service](https://github.com/47siva/vaultbill/blob/master/src/main/java/com/app/Authentication/Authorization/service/AdminService.java): `src/main/java/com/app/Authentication/Authorization/service/AdminService.java`

### Customer Commerce

- [Customer Service](https://github.com/47siva/vaultbill/blob/master/src/main/java/com/app/Authentication/Authorization/service/CustomerServicee.java): `src/main/java/com/app/Authentication/Authorization/service/CustomerServicee.java`
- [Product Service](https://github.com/47siva/vaultbill/blob/master/src/main/java/com/app/Authentication/Authorization/service/ProductService.java): `src/main/java/com/app/Authentication/Authorization/service/ProductService.java`
- [Invoice Service](https://github.com/47siva/vaultbill/blob/master/src/main/java/com/app/Authentication/Authorization/service/InvoiceService.java): `src/main/java/com/app/Authentication/Authorization/service/InvoiceService.java`
- [Address Service](https://github.com/47siva/vaultbill/blob/master/src/main/java/com/app/Authentication/Authorization/service/AddressService.java): `src/main/java/com/app/Authentication/Authorization/service/AddressService.java`

### API and Responses

- [Authentication API](https://github.com/47siva/vaultbill/blob/master/src/main/java/com/app/Authentication/Authorization/controller/AuthenticationController.java): `src/main/java/com/app/Authentication/Authorization/controller/AuthenticationController.java`
- [Admin API](https://github.com/47siva/vaultbill/blob/master/src/main/java/com/app/Authentication/Authorization/controller/AdminController.java): `src/main/java/com/app/Authentication/Authorization/controller/AdminController.java`
- [Customer API](https://github.com/47siva/vaultbill/blob/master/src/main/java/com/app/Authentication/Authorization/controller/CustomerControler.java): `src/main/java/com/app/Authentication/Authorization/controller/CustomerControler.java`
- [Product API](https://github.com/47siva/vaultbill/blob/master/src/main/java/com/app/Authentication/Authorization/controller/ProductController.java): `src/main/java/com/app/Authentication/Authorization/controller/ProductController.java`
- [Invoice API](https://github.com/47siva/vaultbill/blob/master/src/main/java/com/app/Authentication/Authorization/controller/InvoiceController.java): `src/main/java/com/app/Authentication/Authorization/controller/InvoiceController.java`
- [Address API](https://github.com/47siva/vaultbill/blob/master/src/main/java/com/app/Authentication/Authorization/controller/AddressControler.java): `src/main/java/com/app/Authentication/Authorization/controller/AddressControler.java`
- [Response Support](https://github.com/47siva/vaultbill/blob/master/src/main/java/com/app/Authentication/Authorization/response/ResponseGenerator.java): `src/main/java/com/app/Authentication/Authorization/response/ResponseGenerator.java`

### Persistence

- [User Repository](https://github.com/47siva/vaultbill/blob/master/src/main/java/com/app/Authentication/Authorization/repository/UserRepository.java): `src/main/java/com/app/Authentication/Authorization/repository/UserRepository.java`
- [Customer Repository](https://github.com/47siva/vaultbill/blob/master/src/main/java/com/app/Authentication/Authorization/repository/CustomerRepository.java): `src/main/java/com/app/Authentication/Authorization/repository/CustomerRepository.java`
- [Product Repository](https://github.com/47siva/vaultbill/blob/master/src/main/java/com/app/Authentication/Authorization/repository/ProductRepository.java): `src/main/java/com/app/Authentication/Authorization/repository/ProductRepository.java`
- [Purchase Repository](https://github.com/47siva/vaultbill/blob/master/src/main/java/com/app/Authentication/Authorization/repository/CustomerProductRepository.java): `src/main/java/com/app/Authentication/Authorization/repository/CustomerProductRepository.java`
- [Domain Entities](https://github.com/47siva/vaultbill/tree/master/src/main/java/com/app/Authentication/Authorization/entity): `src/main/java/com/app/Authentication/Authorization/entity`
- [Geographic Repositories](https://github.com/47siva/vaultbill/tree/master/src/main/java/com/app/Authentication/Authorization/repository): `src/main/java/com/app/Authentication/Authorization/repository`

### Other components

- **API Client**

## Connections

- API Client → Authentication API: sends requests
- Authentication API → Authentication Service: dispatches auth (evidence: `src/main/java/com/app/Authentication/Authorization/controller/AuthenticationController.java`)
- Authentication Service → User Repository: looks up users (evidence: `src/main/java/com/app/Authentication/Authorization/service/AuthenticationService.java`)
- Authentication Service → JWT Service: creates token (evidence: `src/main/java/com/app/Authentication/Authorization/service/AuthenticationService.java`)
- User Service → User Repository: reads and saves (evidence: `src/main/java/com/app/Authentication/Authorization/service/UserService.java`)
- User Service → Customer Repository: saves customer (evidence: `src/main/java/com/app/Authentication/Authorization/service/UserService.java`)
- User Service → Product Repository: uses products (evidence: `src/main/java/com/app/Authentication/Authorization/service/UserService.java`)
- User Service → JWT Service: validates token (evidence: `src/main/java/com/app/Authentication/Authorization/service/UserService.java`)
- Admin Service → User Repository: saves and reads (evidence: `src/main/java/com/app/Authentication/Authorization/service/AdminService.java`)
- Admin Service → JWT Service: checks token (evidence: `src/main/java/com/app/Authentication/Authorization/service/AdminService.java`)
- Admin Service → User Service: loads user (evidence: `src/main/java/com/app/Authentication/Authorization/service/AdminService.java`)
- Product Service → Product Repository: persists products (evidence: `src/main/java/com/app/Authentication/Authorization/service/ProductService.java`)
- Invoice Service → Customer Repository: uses customer data (evidence: `src/main/java/com/app/Authentication/Authorization/service/InvoiceService.java`)
- Invoice Service → Product Repository: uses product data (evidence: `src/main/java/com/app/Authentication/Authorization/service/InvoiceService.java`)
- Invoice Service → Purchase Repository: uses purchase data (evidence: `src/main/java/com/app/Authentication/Authorization/service/InvoiceService.java`)
- Invoice Service → Domain Entities: builds invoice data (evidence: `src/main/java/com/app/Authentication/Authorization/service/InvoiceService.java`)
- Invoice API → Invoice Service: dispatches purchases (evidence: `src/main/java/com/app/Authentication/Authorization/controller/InvoiceController.java`)
- Customer API → Customer Service: dispatches customer work
- Product API → Product Service: dispatches product work (evidence: `src/main/java/com/app/Authentication/Authorization/controller/ProductController.java`)
- Address API → Address Service: dispatches address work
- Admin API → Admin Service: dispatches admin work (evidence: `src/main/java/com/app/Authentication/Authorization/controller/AdminController.java`)
- Security Configuration → JWT Filter: configures filter
- JWT Filter → JWT Service: validates bearer token (evidence: `src/main/java/com/app/Authentication/Authorization/security/JwtAuthenticationFilter.java`)
