# abhijeetkadtan/railsebackendassignment architecture

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

- Interactive diagram: https://gitdiagram.com/abhijeetkadtan/railsebackendassignment
- Repository: https://github.com/abhijeetkadtan/railsebackendassignment

## Overview

##### Project type and purpose
- This is a single-service Spring Boot backend application (a monolith) that provides a REST API for workforce management (task creation, update, assignment, fetch).
- The README confirms it’s purely a backend take-home assignment using Java 17, Gradle, and exposes endpoints under `/task-mgmt`.

##### File structure
- Top level:
- build & CI: `build.gradle`, `gradlew(.bat)`, Gradle wrapper under `gradle/wrapper`
- source code: `src/main/java/com/railse/hiring/workforcemgmt/...`
- resource config: `src/main/resources/application.properties`
- tests: `src/test/java/com/railse/hiring/workforcemgmt/...`
- Within `workforcemgmt`:
- controller layer (`controller/…Controller.java`)
- service layer (`service` interfaces + `service/impl`)
- repository layer (`repository` with `InMemoryTaskRepository`)
- domain model (`model` + enums)
- DTOs (`dto`) and mappers (`mapper`)
- common concerns (exceptions, response wrappers)

##### README for additional insights
- Endpoints: GET `/task-mgmt/{id}`, POST `/create`, `/update`, `/assign-by-ref`, `/fetch-by-date/v2`
- No external systems (e.g., message brokers or other microservices) are listed

## Diagram (Mermaid)

```mermaid
flowchart TD
    Client["Client (curl/Postman)"]:::external
    DS["DispatcherServlet"]:::common

    subgraph "Controller Layer"
        TC["TaskController"]:::controller
        TMC["TaskManagementController"]:::controller
    end

    subgraph "Service Layer"
        TS["TaskService"]:::service
        TMS["TaskManagementService"]:::service
        TMSI["TaskManagementServiceImpl"]:::service
    end

    IM["ITaskManagementMapper"]:::mapper

    subgraph "Repository Layer"
        TR["TaskRepository"]:::repository
        IMR["InMemoryTaskRepository"]:::repository
    end

    DB["In-Memory Store"]:::database

    subgraph "Domain Model"
        TMm["TaskManagement"]:::model
        TA["TaskActivity"]:::model
        TCm["TaskComment"]:::model
        S["Staff"]:::model
        Enums["Enums"]:::model
    end

    subgraph "DTOs"
        DTOs["DTOs"]:::dto
    end

    subgraph "Response Models"
        R["Response"]:::dto
        RS["ResponseStatus"]:::dto
        P["Pagination"]:::dto
    end

    EH["CustomExceptionHandler"]:::common
    RNF["ResourceNotFoundException"]:::common
    SC["StatusCode"]:::common
    CFG["application.properties"]:::config

    Client -->|HTTP Request| DS
    DS -->|Routes to| TC
    DS -->|Routes to| TMC

    TC -->|calls| TS
    TMC -->|calls| TMS

    TS -->|uses| IM
    TMS -->|implemented by| TMSI
    TMSI -->|uses| IM
    TMSI -->|uses| TR

    IM -->|maps to/from| TMm
    TMm --> DTOs
    DTOs --> TC

    TR -->|implemented by| IMR
    IMR -->|stores in| DB

    CFG --> DS

    TC -->|returns errors to| EH
    TMC -->|returns errors to| EH
    EH -->|throws| RNF
    EH -->|uses| SC

    TS -->|produces| R
    TS -->|produces| RS
    TS -->|produces| P

    classDef external fill:#ddd,stroke:#333
    classDef controller fill:#f9f,stroke:#333
    classDef service fill:#ff9,stroke:#333
    classDef mapper fill:#9f9,stroke:#333
    classDef repository fill:#9ff,stroke:#333
    classDef database fill:#ccc,stroke:#333,stroke-dasharray: 5 5
    classDef model fill:#ccf,stroke:#333
    classDef dto fill:#fcf,stroke:#333
    classDef common fill:#fdd,stroke:#333
    classDef config fill:#dfd,stroke:#333

    click DS "https://github.com/abhijeetkadtan/railsebackendassignment/blob/master/railseBackendAssignment/src/main/java/com/railse/hiring/workforcemgmt/Application.java"
    click TC "https://github.com/abhijeetkadtan/railsebackendassignment/blob/master/railseBackendAssignment/src/main/java/com/railse/hiring/workforcemgmt/controller/TaskController.java"
    click TMC "https://github.com/abhijeetkadtan/railsebackendassignment/blob/master/railseBackendAssignment/src/main/java/com/railse/hiring/workforcemgmt/controller/TaskManagementController.java"
    click TS "https://github.com/abhijeetkadtan/railsebackendassignment/blob/master/railseBackendAssignment/src/main/java/com/railse/hiring/workforcemgmt/service/TaskService.java"
    click TMS "https://github.com/abhijeetkadtan/railsebackendassignment/blob/master/railseBackendAssignment/src/main/java/com/railse/hiring/workforcemgmt/service/TaskManagementService.java"
    click TMSI "https://github.com/abhijeetkadtan/railsebackendassignment/blob/master/railseBackendAssignment/src/main/java/com/railse/hiring/workforcemgmt/service/impl/TaskManagementServiceImpl.java"
    click IM "https://github.com/abhijeetkadtan/railsebackendassignment/blob/master/railseBackendAssignment/src/main/java/com/railse/hiring/workforcemgmt/mapper/ITaskManagementMapper.java"
    click TR "https://github.com/abhijeetkadtan/railsebackendassignment/blob/master/railseBackendAssignment/src/main/java/com/railse/hiring/workforcemgmt/repository/TaskRepository.java"
    click IMR "https://github.com/abhijeetkadtan/railsebackendassignment/blob/master/railseBackendAssignment/src/main/java/com/railse/hiring/workforcemgmt/repository/InMemoryTaskRepository.java"
    click TMm "https://github.com/abhijeetkadtan/railsebackendassignment/blob/master/railseBackendAssignment/src/main/java/com/railse/hiring/workforcemgmt/model/TaskManagement.java"
    click TA "https://github.com/abhijeetkadtan/railsebackendassignment/blob/master/railseBackendAssignment/src/main/java/com/railse/hiring/workforcemgmt/model/TaskActivity.java"
    click TCm "https://github.com/abhijeetkadtan/railsebackendassignment/blob/master/railseBackendAssignment/src/main/java/com/railse/hiring/workforcemgmt/model/TaskComment.java"
    click S "https://github.com/abhijeetkadtan/railsebackendassignment/blob/master/railseBackendAssignment/src/main/java/com/railse/hiring/workforcemgmt/model/Staff.java"
    click Enums "https://github.com/abhijeetkadtan/railsebackendassignment/tree/master/railseBackendAssignment/src/main/java/com/railse/hiring/workforcemgmt/model/enums/"
    click RNF "https://github.com/abhijeetkadtan/railsebackendassignment/blob/master/railseBackendAssignment/src/main/java/com/railse/hiring/workforcemgmt/common/exception/ResourceNotFoundException.java"
    click EH "https://github.com/abhijeetkadtan/railsebackendassignment/blob/master/railseBackendAssignment/src/main/java/com/railse/hiring/workforcemgmt/common/exception/CustomExceptionHandler.java"
    click SC "https://github.com/abhijeetkadtan/railsebackendassignment/blob/master/railseBackendAssignment/src/main/java/com/railse/hiring/workforcemgmt/common/exception/StatusCode.java"
    click R "https://github.com/abhijeetkadtan/railsebackendassignment/blob/master/railseBackendAssignment/src/main/java/com/railse/hiring/workforcemgmt/common/model/response/Response.java"
    click RS "https://github.com/abhijeetkadtan/railsebackendassignment/blob/master/railseBackendAssignment/src/main/java/com/railse/hiring/workforcemgmt/common/model/response/ResponseStatus.java"
    click P "https://github.com/abhijeetkadtan/railsebackendassignment/blob/master/railseBackendAssignment/src/main/java/com/railse/hiring/workforcemgmt/common/model/response/Pagination.java"
    click CFG "https://github.com/abhijeetkadtan/railsebackendassignment/blob/master/railseBackendAssignment/src/main/resources/application.properties"
```
