# belhajmokhlis/intrabank architecture

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

- Interactive diagram: https://gitdiagram.com/belhajmokhlis/intrabank
- Repository: https://github.com/belhajmokhlis/intrabank

## Overview

##### Project type and purpose
- This is a full-stack web application called “Intrabank.”
- Backend: Java Spring Boot monolith implementing REST endpoints for authentication (JWT), user/admin management, document/category/version management, file upload, and profile.
- Frontend: Angular SPA using NgRx for state management, with routes & guards for auth, admin, documents, workflows, profile, and shared UI components.

##### File structure
- Top level splits into two roots: intrabank-backend/ and intrabank-frontend/.
- Backend layers follow MVC + service + repository + security + config + mapper + dto patterns.
- Frontend features a core folder (guards, interceptors, generic services), a features folder (UI components per domain), shared folder, and a store folder (actions/effects/reducers/selectors/state).
- Presence of application-*.properties, Maven wrapper, Spring Security config, JWT filter, CORS config.
- Angular side includes environment configs, tailwind, proxy script, route definitions, and NgRx setup.

##### Detail but keep clarity
- Layers (UI, state management, HTTP pipeline, security, controllers, services, repositories).
- Data flow for a key use case (e.g. “Upload new document”: UI → DocumentUploadComponent → DocumentService → HTTP Interceptor → DocumentController → DocumentServiceImpl → FichierDocumentRepository + save file → response → update NgRx store).
- Avoid over-clustering: group related controllers/services but show each layer’s boundary.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Client Tier
    subgraph "Client Tier"
        Browser["User Browser"]:::external
        AngularApp["Angular SPA"]:::client
        subgraph "UI & Routing"
            UIComponents["Feature Components"]:::client
            RouteGuards["AuthGuard & AdminGuard"]:::client
        end
        subgraph "State Management"
            Store["NgRx Store"]:::client
        end
        subgraph "Services & Interceptor"
            CoreServices["Core Services"]:::client
            Interceptor["HTTP Interceptor"]:::client
        end
    end

    %% Server Tier
    subgraph "Server Tier"
        subgraph "Security Layer"
            Cors["CorsConfig"]:::server
            JwtFilter["JwtAuthenticationFilter"]:::server
        end
        subgraph "Controllers"
            AuthCtrl["AuthController"]:::server
            DocCtrl["DocumentController"]:::server
            FileUploadCtrl["FileUploadController"]:::server
            UserCatCtrl["UserCategoryController"]:::server
            AdminCatCtrl["AdminCategoryController"]:::server
            UserCtrl["UserController"]:::server
            ProfileCtrl["ProfileController"]:::server
        end
        subgraph "Business Logic"
            Services["Service Layer"]:::server
        end
        subgraph "Repository Layer"
            Repos["JPA Repositories"]:::persistence
        end
    end

    %% Persistence Tier
    subgraph "Persistence Tier"
        DB["Database"]:::persistence
        FileStorage["File Storage"]:::external
    end

    %% Data Flow
    Browser -->|navigates| AngularApp
    AngularApp -->|renders| UIComponents
    UIComponents -->|dispatch actions| Store
    Store -->|effects call| CoreServices
    UIComponents -->|calls| CoreServices
    CoreServices -->|attach JWT| Interceptor
    Interceptor -->|HTTP requests| Cors
    Cors -->|CORS check| JwtFilter
    JwtFilter -->|validate token| AuthCtrl
    AuthCtrl -->|calls| Services
    DocCtrl -->|calls| Services
    FileUploadCtrl -->|calls| Services
    UserCatCtrl -->|calls| Services
    AdminCatCtrl -->|calls| Services
    UserCtrl -->|calls| Services
    ProfileCtrl -->|calls| Services
    Services -->|uses| Repos
    Repos -->|SQL queries| DB
    Services -->|save files| FileStorage
    DB -->|data| Services
    Services -->|response| Controllers
    Controllers -->|JSON| Interceptor
    Interceptor -->|response| CoreServices
    CoreServices -->|update| Store
    Store -->|state| UIComponents

    %% Click Events - Client
    click AngularApp "https://github.com/belhajmokhlis/intrabank/tree/main/intrabank-frontend/src/app"
    click AuthService "https://github.com/belhajmokhlis/intrabank/blob/main/intrabank-frontend/src/app/core/service/auth/auth.service.ts"
    click DocumentService "https://github.com/belhajmokhlis/intrabank/blob/main/intrabank-frontend/src/app/core/service/document/document.service.ts"
    click CategoryService "https://github.com/belhajmokhlis/intrabank/blob/main/intrabank-frontend/src/app/core/service/document/category.service.ts"
    click ProfileService "https://github.com/belhajmokhlis/intrabank/blob/main/intrabank-frontend/src/app/core/service/profile/profile.service.ts"
    click UserService "https://github.com/belhajmokhlis/intrabank/blob/main/intrabank-frontend/src/app/core/service/user/user.service.ts"
    click WorkflowService "https://github.com/belhajmokhlis/intrabank/blob/main/intrabank-frontend/src/app/core/service/workflow/workflow.service.ts"
    click AuditLogService "https://github.com/belhajmokhlis/intrabank/blob/main/intrabank-frontend/src/app/core/service/audit-log/audit-log.service.ts"
    click Interceptor "https://github.com/belhajmokhlis/intrabank/blob/main/intrabank-frontend/src/app/core/interceptors/auth.interceptor.ts"
    click RouteGuards "https://github.com/belhajmokhlis/intrabank/blob/main/intrabank-frontend/src/app/core/guards/auth.guard.ts"
    click RouteGuards "https://github.com/belhajmokhlis/intrabank/blob/main/intrabank-frontend/src/app/core/guards/admin.guard.ts"
    click Store "https://github.com/belhajmokhlis/intrabank/blob/main/intrabank-frontend/src/app/store/state/app.state.ts"
    click Store "https://github.com/belhajmokhlis/intrabank/tree/main/intrabank-frontend/src/app/store/actions"
    click Store "https://github.com/belhajmokhlis/intrabank/tree/main/intrabank-frontend/src/app/store/effects"
    click Store "https://github.com/belhajmokhlis/intrabank/tree/main/intrabank-frontend/src/app/store/reducers"
    click Store "https://github.com/belhajmokhlis/intrabank/tree/main/intrabank-frontend/src/app/store/selectors"

    %% Click Events - Server
    click IntrabankBackendApplication "https://github.com/belhajmokhlis/intrabank/blob/main/intrabank-backend/src/main/java/com/intrabank/intrabank_backend/IntrabankBackendApplication.java"
    click Cors "https://github.com/belhajmokhlis/intrabank/blob/main/intrabank-backend/src/main/java/com/intrabank/intrabank_backend/config/CorsConfig.java"
    click JwtFilter "https://github.com/belhajmokhlis/intrabank/blob/main/intrabank-backend/src/main/java/com/intrabank/intrabank_backend/security/JwtAuthenticationFilter.java"
    click AuthCtrl "https://github.com/belhajmokhlis/intrabank/blob/main/intrabank-backend/src/main/java/com/intrabank/intrabank_backend/controller/auth/AuthController.java"
    click DocCtrl "https://github.com/belhajmokhlis/intrabank/blob/main/intrabank-backend/src/main/java/com/intrabank/intrabank_backend/controller/document/DocumentController.java"
    click FileUploadCtrl "https://github.com/belhajmokhlis/intrabank/blob/main/intrabank-backend/src/main/java/com/intrabank/intrabank_backend/controller/document/FileUploadController.java"
    click UserCatCtrl "https://github.com/belhajmokhlis/intrabank/blob/main/intrabank-backend/src/main/java/com/intrabank/intrabank_backend/controller/category/UserCategoryController.java"
    click AdminCatCtrl "https://github.com/belhajmokhlis/intrabank/blob/main/intrabank-backend/src/main/java/com/intrabank/intrabank_backend/controller/admin/AdminCategoryController.java"
    click UserCtrl "https://github.com/belhajmokhlis/intrabank/blob/main/intrabank-backend/src/main/java/com/intrabank/intrabank_backend/controller/admin/UserController.java"
    click ProfileCtrl "https://github.com/belhajmokhlis/intrabank/blob/main/intrabank-backend/src/main/java/com/intrabank/intrabank_backend/controller/profile/ProfileController.java"
    click Services "https://github.com/belhajmokhlis/intrabank/tree/main/intrabank-backend/src/main/java/com/intrabank/intrabank_backend/service"
    click Repos "https://github.com/belhajmokhlis/intrabank/tree/main/intrabank-backend/src/main/java/com/intrabank/intrabank_backend/repository"
    click GlobalExceptionHandler "https://github.com/belhajmokhlis/intrabank/blob/main/intrabank-backend/src/main/java/com/intrabank/intrabank_backend/exception/GlobalExceptionHandler.java"
    click DataInitializer "https://github.com/belhajmokhlis/intrabank/blob/main/intrabank-backend/src/main/java/com/intrabank/intrabank_backend/config/DataInitializer.java"
    click WebConfig "https://github.com/belhajmokhlis/intrabank/blob/main/intrabank-backend/src/main/java/com/intrabank/intrabank_backend/config/WebConfig.java"
    click IntrabankBackendApplication "https://github.com/belhajmokhlis/intrabank/blob/main/intrabank-backend/src/main/java/com/intrabank/intrabank_backend/config/PasswordConfig.java"
    click FileStorage "https://github.com/belhajmokhlis/intrabank/blob/main/intrabank-backend/src/main/java/com/intrabank/intrabank_backend/service/FichierDocumentService.java"
    classDef client fill:#D0E8FF,stroke:#0366d6,color:#0366d6;
    classDef server fill:#DFFFE0,stroke:#28a745,color:#28a745;
    classDef persistence fill:#FFF4D6,stroke:#e36209,color:#e36209;
    classDef external fill:#F0F0F0,stroke:#6a737d,color:#6a737d;
```
