# suyog-ghadage/insuranceproject architecture

> Architecture diagram of the GitHub repository suyog-ghadage/insuranceproject, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/suyog-ghadage/insuranceproject
- Repository: https://github.com/suyog-ghadage/insuranceproject

## Overview

##### Project type and purpose
- This is a monolithic Spring Boot backend service (“HealthInsurance”) implementing a RESTful API for managing health‐insurance domain objects (users, policies, claims, appointments, documents, FAQs, hospitals, doctors, etc.).
- It performs CRUD operations, user authentication/authorization (with JWT), email notifications, and “super-admin” alerts.

##### File structure
- Top level:
- pom.xml, mvnw scripts, application properties
- src/main/java/com/crud:
– confg: security (SecurityConfig, JwtAuthFilter, JwtUtil, entry points, CustomUserDetailsService)
– controller: one REST controller per domain concept (UserController, ClaimController, AppointmentController, AdminController, etc.)
– dto: input/output data transfer objects
– entity: JPA entities mapping to database tables
– enums: domain enumerations (Role, PolicyStatus, etc.)
– repository: Spring Data JPA repositories
– service: service interfaces
– serviceimpl: service implementations
– util: supporting utilities (SuperAdminNotifier, EmailServiceImpl)
- src/main/resources/application.properties for DB and mail configuration
- src/test: basic Spring Boot integration test
- BUILD: packaged as an executable JAR

##### Key architectural observations
- Layered architecture (Controller → Service → Repository → Database)
- Spring Security + JWT filter chain for authN/authZ
- Domain-driven modules organized by package
- External SMTP/email service integration
- No separate frontend—this is purely a backend microservice

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Clients
    subgraph "Clients"
        Client["API Client\n(Web/Mobile)"]:::external
    end

    %% Security Layer
    subgraph "Security Layer"
        JWTFilter["JwtAuthFilter"]:::security
        AuthEntry["JwtAuthenticationEntryPoint"]:::security
        SecurityConfig["SecurityConfig"]:::security
        JwtUtil["JwtUtil"]:::security
        UserDetailsSvc["CustomUserDetailsService"]:::security
    end

    %% API Layer
    subgraph "API Layer"
        Controllers["Controllers\n(com/crud/controller)"]:::api
    end

    %% Business Layer
    subgraph "Business Layer"
        Services["Service Interfaces\n(com/crud/service)"]:::business
        ServiceImpl["Service Implementations\n(com/crud/serviceimpl)"]:::business
    end

    %% DTOs
    DTOs["DTOs\n(com/crud/dto)"]:::data

    %% Data Layer
    subgraph "Data Layer"
        Repos["Repositories\n(com/crud/repository)"]:::data
        Entities["Entities\n(com/crud/entity)"]:::data
        DB["Relational Database\n(RDBMS)"]:::data
    end

    %% Utilities
    subgraph "Utilities"
        EmailSvc["EmailServiceImpl"]:::util
        Notifier["SuperAdminNotifier"]:::util
        SMTP["SMTP Email Server"]:::external
    end

    %% Application & Config
    App["CrudOperationApplication"]:::api
    Config["application.properties"]:::api
    Test["Integration Tests\n(com/crud/CrudOperationApplicationTests.java)"]:::external

    %% Data Flow
    Client -->|"HTTP/JSON"| JWTFilter
    JWTFilter -->|valid JWT| Controllers
    JWTFilter -->|invalid JWT| AuthEntry
    SecurityConfig --> JWTFilter
    SecurityConfig --> AuthEntry
    SecurityConfig --> UserDetailsSvc
    Controllers -->|uses| DTOs
    Controllers -->|calls| Services
    Services -->|interface impl| ServiceImpl
    ServiceImpl -->|CRUD ops| Repos
    Repos -->|maps to| Entities
    ServiceImpl -->|send email| EmailSvc
    ServiceImpl -->|notify super-admin| Notifier
    EmailSvc --> SMTP
    App --> Controllers
    App --> SecurityConfig
    App --> Services
    App --> Repos
    App --> Entities
    App --> DTOs
    App --> EmailSvc
    App --> Notifier
    Config --> App
    Test --> App

    %% Click Events
    click Controllers "https://github.com/suyog-ghadage/insuranceproject/tree/BackEnd/HealthInsurance/src/main/java/com/crud/controller"
    click SecurityConfig "https://github.com/suyog-ghadage/insuranceproject/blob/BackEnd/HealthInsurance/src/main/java/com/crud/confg/SecurityConfig.java"
    click JWTFilter "https://github.com/suyog-ghadage/insuranceproject/blob/BackEnd/HealthInsurance/src/main/java/com/crud/confg/JwtAuthFilter.java"
    click AuthEntry "https://github.com/suyog-ghadage/insuranceproject/blob/BackEnd/HealthInsurance/src/main/java/com/crud/confg/JwtAuthenticationEntryPoint.java"
    click JwtUtil "https://github.com/suyog-ghadage/insuranceproject/blob/BackEnd/HealthInsurance/src/main/java/com/crud/confg/JwtUtil.java"
    click UserDetailsSvc "https://github.com/suyog-ghadage/insuranceproject/blob/BackEnd/HealthInsurance/src/main/java/com/crud/confg/CustomUserDetailsService.java"
    click Services "https://github.com/suyog-ghadage/insuranceproject/tree/BackEnd/HealthInsurance/src/main/java/com/crud/service"
    click ServiceImpl "https://github.com/suyog-ghadage/insuranceproject/tree/BackEnd/HealthInsurance/src/main/java/com/crud/serviceimpl"
    click Entities "https://github.com/suyog-ghadage/insuranceproject/tree/BackEnd/HealthInsurance/src/main/java/com/crud/entity"
    click Repos "https://github.com/suyog-ghadage/insuranceproject/tree/BackEnd/HealthInsurance/src/main/java/com/crud/repository"
    click DTOs "https://github.com/suyog-ghadage/insuranceproject/tree/BackEnd/HealthInsurance/src/main/java/com/crud/dto"
    click EmailSvc "https://github.com/suyog-ghadage/insuranceproject/blob/BackEnd/HealthInsurance/src/main/java/com/crud/serviceimpl/EmailServiceImpl.java"
    click Notifier "https://github.com/suyog-ghadage/insuranceproject/blob/BackEnd/HealthInsurance/src/main/java/com/crud/util/SuperAdminNotifier.java"
    click App "https://github.com/suyog-ghadage/insuranceproject/blob/BackEnd/HealthInsurance/src/main/java/com/crud/CrudOperationApplication.java"
    click Config "https://github.com/suyog-ghadage/insuranceproject/blob/BackEnd/HealthInsurance/src/main/resources/application.properties"
    click Test "https://github.com/suyog-ghadage/insuranceproject/blob/BackEnd/HealthInsurance/src/test/java/com/crud/CrudOperationApplicationTests.java"

    %% Styles
    classDef api fill:#D6EAF8,stroke:#21618C,color:#000
    classDef security fill:#FCF3CF,stroke:#B7950B,color:#000
    classDef business fill:#D5F5E3,stroke:#239B56,color:#000
    classDef data fill:#FAD7A0,stroke:#BA4A00,color:#000
    classDef util fill:#F5B7B1,stroke:#922B21,color:#000
    classDef external fill:#F1948A,stroke:#C0392B,color:#000
```
