# arzak21st/role-manager architecture

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

- Interactive diagram: https://gitdiagram.com/arzak21st/role-manager
- Repository: https://github.com/arzak21st/role-manager

## Overview

##### Project Type and Purpose
- This is a monolithic, server-rendered full-stack web application built with Spring Boot.
- It provides role-based access control (RBAC) to manage user permissions (create, read, update, delete).

##### Key Components
a. Client Layer
- Web Browser: interacts over HTTP/HTTPS.
- Static Assets: CSS/JS/Images under `src/main/resources/static/stisla*`.
b. Web/Application Layer
- Spring MVC DispatcherServlet: entry point for all HTTP requests.
- Controllers (`HomeController`, `LoginController`, `ManagerController`): map URLs to actions.
c. Security Layer
- Spring Security Filter Chain (`SecurityConfiguration`): intercepts requests for authentication/authorization.
- `MyUserDetailsService` / `MyUserDetails`: loads user roles from database into Spring Security.
d. Service Layer
- `HomeService`, `ManagerService`: business logic, orchestrate between controllers and repositories.
e. Data Access Layer
- Spring Data JPA Repositories (`UserRepository`, `RoleRepository`): CRUD operations on `User` and `Role` entities.
f. Persistence Layer
- Relational Database (configured in `application.properties`): stores users & roles.
g. View Layer
- Thymeleaf Templates (`home.html`, `login.html`, `manager.html`): generate HTML.

##### Interactions and Data Flow
1. Browser → HTTP Request → DispatcherServlet
2. Security Filter Chain checks authentication/authorization
3. DispatcherServlet routes to appropriate Controller
4. Controller calls Service
5. Service calls Repository → Database
6. Service returns data to Controller
7. Controller selects Thymeleaf view + model data
8. DispatcherServlet returns rendered HTML + static assets → Browser

##### Architectural Patterns & Principles
- Layered (Web → Security → Controller → Service → Repository → DB)
- Separation of Concerns: distinct packages for models, controllers, services, repositories, security.
- Convention over Configuration: Spring Boot auto-configures MVC, JPA, Security.
- Template-based UI: No single-page-app framework; uses server-side rendering with Stisla theme.

##### Detailed Element Checklist
- Clear labels: e.g., “HomeController”, “ManagerService”, “RoleRepository”.
- Annotations: note “session-based auth” or “JWT (if used)”—here it’s form login with roles.
- External dependencies: Maven wrapper (`.mvn/wrapper`), but this can be omitted or shown as “Build Tool: Maven”.

## Diagram (Mermaid)

```mermaid
graph TD
    %% Presentation Layer
    subgraph "Presentation Layer"
        direction TB
        Browser["Web Browser"]:::presentation
        StaticAssets["Stisla CSS/JS\n(src/main/resources/static/stisla*, ...)"]:::presentation
        subgraph "Thymeleaf Templates"
            direction TB
            HomeTpl["home.html"]:::presentation
            LoginTpl["login.html"]:::presentation
            ManagerTpl["manager.html"]:::presentation
        end
    end

    %% Application Layer
    subgraph "Application Layer"
        direction TB
        DS["DispatcherServlet\n(Spring MVC)"]:::application
        Security["SecurityFilterChain\n(Session-based auth)"]:::security
        subgraph "Controllers"
            direction TB
            HomeCtrl["HomeController"]:::application
            LoginCtrl["LoginController"]:::application
            ManagerCtrl["ManagerController"]:::application
        end
        subgraph "Services"
            direction TB
            HomeSvc["HomeService"]:::application
            ManagerSvc["ManagerService"]:::application
        end
    end

    %% Data Layer
    subgraph "Data Layer"
        direction TB
        subgraph "Repositories"
            direction TB
            UserRepo["UserRepository"]:::data
            RoleRepo["RoleRepository"]:::data
        end
        DB["Relational Database"]:::data
    end

    %% Config & Models
    ApplicationProps["application.properties\n(DB config)"]:::data
    subgraph "Domain Models"
        direction TB
        UserModel["User"]:::data
        RoleModel["Role"]:::data
    end

    %% Flows
    Browser -->|"1. HTTP/HTTPS"| DS
    Browser -->|"Assets"| StaticAssets
    DS -->|"2. Authentication/Authorization"| Security
    Security -->|"3. Route request"| HomeCtrl
    Security -->|"3. Route request"| LoginCtrl
    Security -->|"3. Route request"| ManagerCtrl

    HomeCtrl -->|"4. call"| HomeSvc
    LoginCtrl -->|"4. call"| HomeSvc
    ManagerCtrl -->|"4. call"| ManagerSvc

    HomeSvc -->|"5. use"| UserRepo
    HomeSvc -->|"5. use"| RoleRepo
    ManagerSvc -->|"5. use"| UserRepo
    ManagerSvc -->|"5. use"| RoleRepo

    UserRepo -->|"SQL"| DB
    RoleRepo -->|"SQL"| DB

    HomeSvc -->|"6. return data"| HomeCtrl
    ManagerSvc -->|"6. return data"| ManagerCtrl
    LoginCtrl -->|"6. return data"| LoginCtrl

    HomeCtrl -->|"7. select view"| HomeTpl
    LoginCtrl -->|"7. select view"| LoginTpl
    ManagerCtrl -->|"7. select view"| ManagerTpl

    DS -->|"8. render HTML"| Browser

    %% Click Events
    click StaticAssets "https://github.com/arzak21st/role-manager/tree/main/src/main/resources/static/stisla-master/"
    click StaticAssets "https://github.com/arzak21st/role-manager/tree/main/src/main/resources/static/stisla/"
    click DS "https://github.com/arzak21st/role-manager/blob/main/src/main/java/dev/arzak21st/rolemanager/RoleManagerApplication.java"
    click HomeCtrl "https://github.com/arzak21st/role-manager/blob/main/src/main/java/dev/arzak21st/rolemanager/controllers/HomeController.java"
    click LoginCtrl "https://github.com/arzak21st/role-manager/blob/main/src/main/java/dev/arzak21st/rolemanager/controllers/LoginController.java"
    click ManagerCtrl "https://github.com/arzak21st/role-manager/blob/main/src/main/java/dev/arzak21st/rolemanager/controllers/ManagerController.java"
    click Security "https://github.com/arzak21st/role-manager/blob/main/src/main/java/dev/arzak21st/rolemanager/security/SecurityConfiguration.java"
    click HomeSvc "https://github.com/arzak21st/role-manager/blob/main/src/main/java/dev/arzak21st/rolemanager/services/HomeService.java"
    click ManagerSvc "https://github.com/arzak21st/role-manager/blob/main/src/main/java/dev/arzak21st/rolemanager/services/ManagerService.java"
    click UserRepo "https://github.com/arzak21st/role-manager/blob/main/src/main/java/dev/arzak21st/rolemanager/repositories/UserRepository.java"
    click RoleRepo "https://github.com/arzak21st/role-manager/blob/main/src/main/java/dev/arzak21st/rolemanager/repositories/RoleRepository.java"
    click ApplicationProps "https://github.com/arzak21st/role-manager/blob/main/src/main/resources/application.properties"
    click HomeTpl "https://github.com/arzak21st/role-manager/blob/main/src/main/resources/templates/home.html"
    click LoginTpl "https://github.com/arzak21st/role-manager/blob/main/src/main/resources/templates/login.html"
    click ManagerTpl "https://github.com/arzak21st/role-manager/blob/main/src/main/resources/templates/manager.html"
    click UserModel "https://github.com/arzak21st/role-manager/blob/main/src/main/java/dev/arzak21st/rolemanager/models/User.java"
    click RoleModel "https://github.com/arzak21st/role-manager/blob/main/src/main/java/dev/arzak21st/rolemanager/models/Role.java"
    click MyUser["MyUserDetails"] "src/main/java/dev/arzak21st/rolemanager/security/MyUserDetails.java"
    click MyUserSvc["MyUserDetailsService"] "src/main/java/dev/arzak21st/rolemanager/security/MyUserDetailsService.java"

    %% Styles
    classDef presentation fill:#E8F4FD,stroke:#1E88E5,color:#1E88E5;
    classDef application fill:#F0F4C3,stroke:#827717,color:#827717;
    classDef security fill:#FFEBEE,stroke:#C62828,color:#C62828;
    classDef data fill:#E8EAF6,stroke:#3949AB,color:#3949AB;
```
