# satyamkumarmishra2005/eazyschoolwebapp architecture

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

- Interactive diagram: https://gitdiagram.com/satyamkumarmishra2005/eazyschoolwebapp
- Repository: https://github.com/satyamkumarmishra2005/eazyschoolwebapp

## Overview

##### Project type and purpose
- This is a full-stack Java web application built on Spring Boot.
- It uses Spring MVC and Thymeleaf for server-rendered views, Spring Security for authentication/authorization, Spring Data JPA (with Hibernate) for ORM persistence, and exposes REST endpoints.

##### File structure
- Top level:
- Dockerfile, pom.xml, Maven wrapper – build and containerization
- src/main/java/com/eazybytes/eazyschool – all Java code, organized by package
– annotation, aspects, audit, config, controller, rest, model, repository, security, service, validations
- src/main/resources – application properties, SQL scripts, static assets (CSS/JS/images), Thymeleaf templates
- src/test – unit/integration test suite
- Patterns: classic layered architecture (Controller → Service → Repository), MVC pattern for web, AOP for logging/audit, security filters.

##### README for additional insights
- Confirms use of Spring Core (IoC, DI), Spring MVC + Thymeleaf, Spring Security (CSRF/CORS), Spring Data JPA & JDBC, REST APIs, Actuator for health, H2 in-memory DB for dev.

a. Main components
- Client (Browser or any REST client)
- Presentation Layer
– Spring MVC Controllers + Thymeleaf templates + static resources
– REST Controllers (ContactRestController, GlobalExceptionRestController)
- Security Layer
– Spring Security filter chain, custom AuthenticationProviders
- Service Layer
– Business logic beans (ContactService, PersonService)
- Data Access Layer
– Spring Data JPA Repositories, Entities (Person, Courses, Holiday, etc.)
– Spring JDBC (for explicit SQL if any)
- Persistence Store
– H2 Database (or PostgreSQL in production) + schema/data scripts
- Cross-cutting concerns
– AOP Aspects (LoggerAspect)
– Audit (AuditAwareImpl, EazySchoolInfoContributor)
– Actuator endpoints for monitoring
b. Relationships and interactions
- User requests → Security filters → MVC or REST Controller
- Controllers invoke Services → Repositories → Database
- Thymeleaf templates rendered by Controllers
- AOP intercepts service or controller methods for logging/audit
- Actuator endpoints expose health/metrics
- Static assets served directly from /static
c. Architectural patterns and design principles
- Layered architecture (presentation → service → repository)
- MVC for UI
- RESTful design for APIs
- AOP for logging and auditing (separation of concerns)
- Dependency injection throughout
- Configuration externalization (profiles: uat, prod)
d. Relevant technologies/frameworks
- Spring Boot, Spring MVC, Thymeleaf, Spring Security, Spring Data JPA, Spring JDBC
- H2 Database, Maven, Lombok, Actuator, AOP

- Rectangles: “Service Layer” and “Repository Layer”
- From Client → Security → Controller → Service → Repository → Database
- From AOP/Audit component → (intercepts) Controllers/Services
- UI layer in blue, Business in green, Data in orange, Cross-cutting (security, audit) in red

## Diagram (Mermaid)

```mermaid
graph TD
    %% Client
    Client["Client Browser / REST Client"]:::client

    %% Security Layer
    Security["Security Filter Chain"]:::security

    %% Main Application
    App["EazyschoolApplication\n(Spring Boot App)"]:::backend

    %% Web Layer
    subgraph "Web Layer" 
        MVC["Spring MVC Controllers"]:::frontend
        GExceptionMVC["GlobalExceptionController"]:::frontend
        Templates["Thymeleaf Templates"]:::frontend
        Static["Static Resources"]:::frontend
    end

    %% REST API Layer
    subgraph "REST API Layer"
        ContactRest["ContactRestController"]:::frontend
        GExceptionREST["GlobalExceptionRestController"]:::frontend
    end

    %% Service Layer
    subgraph "Service Layer"
        ContactService["ContactService"]:::backend
        PersonService["PersonService"]:::backend
    end

    %% Data Access Layer
    subgraph "Repository Layer"
        Repositories["Spring Data JPA Repositories"]:::data
        Entities["JPA Entities"]:::data
    end

    %% Persistence Store
    DB["H2/PostgreSQL Database"]:::data

    %% Cross-cutting Concerns
    subgraph "Cross-cutting"
        AOP["LoggerAspect (AOP)"]:::cross
        Audit["AuditAwareImpl\nEazySchoolInfoContributor"]:::cross
        Actuator["Actuator Endpoints"]:::cross
    end

    %% Flows
    Client -->|"HTTP Request"| Security
    Security -->|"/mvc/**"| MVC
    Security -->|"/api/**"| ContactRest
    MVC -->|renders view| Templates
    Client -->|GET static| Static
    MVC -->|calls| ContactService
    ContactRest -->|calls| ContactService
    ContactService -->|calls| Repositories
    PersonService -->|calls| Repositories
    Repositories -->|SQL Queries| DB
    App --> MVC
    App --> ContactRest
    App --> ContactService
    App --> PersonService
    App --> Repositories
    App --> AOP
    App --> Audit
    App --> Actuator

    %% AOP Interception
    AOP -. intercepts .-> MVC
    AOP -. intercepts .-> ContactService

    %% Audit integration
    Audit --> Actuator

    %% Click Events
    click App "https://github.com/satyamkumarmishra2005/eazyschoolwebapp/blob/main/src/main/java/com/eazybytes/eazyschool/EazyschoolApplication.java"
    click MVC "https://github.com/satyamkumarmishra2005/eazyschoolwebapp/tree/main/src/main/java/com/eazybytes/eazyschool/controller/"
    click GExceptionMVC "https://github.com/satyamkumarmishra2005/eazyschoolwebapp/blob/main/src/main/java/com/eazybytes/eazyschool/controller/GlobalExceptionController.java"
    click Templates "https://github.com/satyamkumarmishra2005/eazyschoolwebapp/tree/main/src/main/resources/templates/"
    click Static "https://github.com/satyamkumarmishra2005/eazyschoolwebapp/tree/main/src/main/resources/static/"
    click ContactRest "https://github.com/satyamkumarmishra2005/eazyschoolwebapp/blob/main/src/main/java/com/eazybytes/eazyschool/rest/ContactRestController.java"
    click GExceptionREST "https://github.com/satyamkumarmishra2005/eazyschoolwebapp/blob/main/src/main/java/com/eazybytes/eazyschool/rest/GlobalExceptionRestController.java"
    click Security "https://github.com/satyamkumarmishra2005/eazyschoolwebapp/blob/main/src/main/java/com/eazybytes/eazyschool/config/ProjectSecurityConfig.java"
    click WebConfig "https://github.com/satyamkumarmishra2005/eazyschoolwebapp/blob/main/src/main/java/com/eazybytes/eazyschool/config/WebConfig.java"
    click AOP "https://github.com/satyamkumarmishra2005/eazyschoolwebapp/blob/main/src/main/java/com/eazybytes/eazyschool/aspects/LoggerAspect.java"
    click Audit "https://github.com/satyamkumarmishra2005/eazyschoolwebapp/blob/main/src/main/java/com/eazybytes/eazyschool/audit/AuditAwareImpl.java"
    click Audit "https://github.com/satyamkumarmishra2005/eazyschoolwebapp/blob/main/src/main/java/com/eazybytes/eazyschool/audit/EazySchoolInfoContributor.java"
    click ContactService "https://github.com/satyamkumarmishra2005/eazyschoolwebapp/blob/main/src/main/java/com/eazybytes/eazyschool/service/ContactService.java"
    click PersonService "https://github.com/satyamkumarmishra2005/eazyschoolwebapp/blob/main/src/main/java/com/eazybytes/eazyschool/service/PersonService.java"
    click Entities "https://github.com/satyamkumarmishra2005/eazyschoolwebapp/tree/main/src/main/java/com/eazybytes/eazyschool/model/"
    click Repositories "https://github.com/satyamkumarmishra2005/eazyschoolwebapp/tree/main/src/main/java/com/eazybytes/eazyschool/repository/"
    click DB "https://github.com/satyamkumarmishra2005/eazyschoolwebapp/blob/main/src/main/resources/eazyschool_schema.sql"
    click DB "https://github.com/satyamkumarmishra2005/eazyschoolwebapp/blob/main/src/main/resources/eazyschool_data.sql"
    click Actuator "https://github.com/satyamkumarmishra2005/eazyschoolwebapp/blob/main/src/main/java/com/eazybytes/eazyschool/audit/EazySchoolInfoContributor.java"
    click Tests "https://github.com/satyamkumarmishra2005/eazyschoolwebapp/blob/main/src/test/java/com/eazybytes/eazyschool/EazyschoolApplicationTests.java"

    %% Styles
    classDef client fill:#D6EAF8,stroke:#1F618D,color:#1F618D;
    classDef frontend fill:#AED6F1,stroke:#21618C,color:#1B2631;
    classDef backend fill:#ABEBC6,stroke:#196F3D,color:#1B2631;
    classDef data fill:#F9E79F,stroke:#B9770E,color:#1B2631;
    classDef security fill:#F5B7B1,stroke:#922B21,color:#1B2631;
    classDef cross fill:#FADBD8,stroke:#873600,color:#1B2631;
```
