# jonas56/freelance-management-app architecture

> Architecture diagram of the GitHub repository jonas56/freelance-management-app, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/jonas56/freelance-management-app
- Repository: https://github.com/jonas56/freelance-management-app

## Overview

##### Project type and purpose
- This is a J2EE-based full-stack web application for managing freelance assignments.
- The README calls it “Freelance management,” and the presence of JSP pages under src/main/webapp indicates a server-rendered Java web UI.

##### File structure
- Presentation layer:
– JSP pages in src/main/webapp/views/pages and components
– Static assets (CSS, JS, images) under src/main/webapp/assets
– web.xml and JSP files deployed to a servlet container (e.g., Tomcat)
- Controller layer:
– com.freelance.controllers with controllers for login, registration, annonces, missions, etc.
- Service layer:
– com.freelance.services with AuthService, AnnonceService, MissionService
- Persistence/data-access layer:
– com.freelance.models: repositories (AnnonceRepository, ClientRepository, etc.)
– com.freelance.beans: entity classes (User, Admin, Client, Freelancer, Annonce, Mission)
– Configuration: HibernateUtil.java, persistence.xml, hibernate.cfg.xml
- Utilities:
– com.freelance.utils helpers for mapping or business logic
- Build & config:
– pom.xml (Maven), maven wrapper, .gitignore

##### README for additional insights
- We infer a classic 3-tier MVC web application with Hibernate ORM over a relational database

##### Elements
- Clear labels for each component (e.g., “AnnonceService”, “MissionRepository”)
- Optionally, note ports (e.g., 8080 for HTTP) and protocol (HTTP, JDBC)

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Presentation Layer: Client Side
    subgraph "Client Browser" 
        direction TB
        Browser["Web Browser"]:::ui
        StaticAssets["Static Assets\n(CSS, JS, Images)"]:::ui
        JSPViews["JSP Views"]:::ui
    end

    click StaticAssets "https://github.com/jonas56/freelance-management-app/tree/main/src/main/webapp/assets"
    click JSPViews "https://github.com/jonas56/freelance-management-app/tree/main/src/main/webapp/views"

    %% Application Server Layer
    subgraph "Application Server (Servlet Container)" 
        direction TB

        Deployment["web.xml\n(Servlet Config)"]:::config
        Controllers["Controllers\n(com.freelance.controllers)"]:::server
        Services["Services\n(com.freelance.services)"]:::server
        Repositories["Repositories\n(com.freelance.models)"]:::data
        Entities["Entity Beans\n(com.freelance.beans)"]:::data
        Utils["Utility Helpers\n(com.freelance.utils)"]:::server
        HibernateUtil["HibernateUtil.java"]:::config
        PersistenceCfg["persistence.xml"]:::config
        HibernateCfg["hibernate.cfg.xml"]:::config
        MavenBuild["pom.xml"]:::config
        MavenWrapper[".mvn/ & mvnw"]:::config
    end

    click Deployment "https://github.com/jonas56/freelance-management-app/blob/main/src/main/webapp/WEB-INF/web.xml"
    click Controllers "https://github.com/jonas56/freelance-management-app/tree/main/src/main/java/com/freelance/controllers"
    click Services "https://github.com/jonas56/freelance-management-app/tree/main/src/main/java/com/freelance/services"
    click Repositories "https://github.com/jonas56/freelance-management-app/tree/main/src/main/java/com/freelance/models"
    click Entities "https://github.com/jonas56/freelance-management-app/tree/main/src/main/java/com/freelance/beans"
    click Utils "https://github.com/jonas56/freelance-management-app/tree/main/src/main/java/com/freelance/utils"
    click HibernateUtil "https://github.com/jonas56/freelance-management-app/blob/main/src/main/java/com/freelance/config/HibernateUtil.java"
    click PersistenceCfg "https://github.com/jonas56/freelance-management-app/blob/main/src/main/resources/META-INF/persistence.xml"
    click HibernateCfg "https://github.com/jonas56/freelance-management-app/blob/main/src/main/resources/hibernate.cfg.xml"
    click MavenBuild "https://github.com/jonas56/freelance-management-app/blob/main/pom.xml"
    click MavenWrapper "https://github.com/jonas56/freelance-management-app/tree/main/.mvn/"

    %% Database Layer
    Database[(Relational Database)]:::db

    %% Interactions
    Browser -->|"HTTP GET/POST"| JSPViews
    Browser -->|"/assets/*"| StaticAssets
    JSPViews -->|forward/request| Controllers
    Deployment -->|maps URLs| Controllers
    Controllers -->|calls| Services
    Services -->|invokes| Repositories
    Repositories -->|manages| Entities
    Repositories -->|JDBC/ORM| Database
    HibernateUtil -->|bootstraps| Repositories
    PersistenceCfg -->|JPA config| HibernateUtil
    HibernateCfg -->|Hibernate config| HibernateUtil
    Utils -->|used by| Services
    MavenBuild -->|builds WAR| ApplicationServer[Application Server]
    MavenWrapper -->|wrapper scripts| MavenBuild

    %% Classes for styling
    classDef ui fill:#ccffcc,stroke:#2d572c,stroke-width:1px;
    classDef server fill:#cce5ff,stroke:#1a4d80,stroke-width:1px;
    classDef data fill:#ffe5cc,stroke:#804d1a,stroke-width:1px;
    classDef db fill:#e0e0e0,stroke:#4d4d4d,stroke-width:1px,stroke-dasharray: 5 5;
    classDef config fill:#f2ccff,stroke:#661a80,stroke-width:1px;
```
