# shiva7071007/taskdistributionsystem architecture

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

- Interactive diagram: https://gitdiagram.com/shiva7071007/taskdistributionsystem
- Repository: https://github.com/shiva7071007/taskdistributionsystem

## Overview

##### Main System Components

a) Client Component
- Entry point for task submission and management
- Handles task queuing, querying, and result retrieval
- Located in /TDS/client directory

b) Coordinator Component
- Central management system
- Handles task distribution and scheduling
- Manages node health monitoring
- Database management
- Located in /TDS/co-ordinator directory

c) Node Component
- Task execution units
- Handles actual task processing
- Reports status back to coordinator
- Located in /TDS/node directory

d) Core Component
- Shared functionality and communication protocols
- Exception handling
- Located in /TDS/core directory

**[Client] ←→ [Coordinator] ←→ [Nodes (1..n)]**

##### Connection and Data Flow

- Task submission flow: Client → Coordinator → Node
- Result retrieval flow: Node → Coordinator → Client
- Health check flow: Coordinator ↔ Node
- Database interactions: Coordinator ↔ Database

##### Additional Elements

Include:
- Database symbol showing the following repositories:
- Client Repository
- Node Repository
- Task Repository
- Task Result Repository
- Communication protocols (TDS Protocol)
- Configuration management components

##### Technical Details

Following technical aspects:
- JSON/XML serialization options
- Task states (from TaskState.java)
- Node states (from NodeState.java)
- Error handling flow
- Retry mechanisms

Remember to include the following technical stack elements visible in the codebase:
- Java-based implementation
- Socket-based communication
- Database persistence
- Health monitoring system
- Task scheduling mechanism

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Style Definitions
    classDef client fill:#3498db,stroke:#2980b9,color:white
    classDef coordinator fill:#2ecc71,stroke:#27ae60,color:white
    classDef node fill:#e67e22,stroke:#d35400,color:white
    classDef core fill:#95a5a6,stroke:#7f8c8d,color:white
    classDef database fill:#9b59b6,stroke:#8e44ad,color:white

    %% Core Layer
    subgraph Core
        CP["Communication Protocol"]
        SS["Serialization Services"]
        EH["Exception Handling"]
        LS["Logging Services"]
    end
    click CP "https://github.com/Shiva7071007/taskDistributionSystem/blob/master/TDS/core/src/main/java/com/itt/tds/comm/TDSProtocol.java"
    click SS "https://github.com/Shiva7071007/taskDistributionSystem/blob/master/TDS/core/src/main/java/com/itt/tds/comm/JSONSerializer.java"
    click EH "https://github.com/Shiva7071007/taskDistributionSystem/tree/master/TDS/core/src/main/java/com/itt/tds/TDSExceptions/"
    click LS "https://github.com/Shiva7071007/taskDistributionSystem/blob/master/TDS/core/src/main/java/com/itt/tds/logging/TDSLogger.java"

    %% Client Layer
    subgraph Client
        C["Client"]
        TM["Task Manager"]
        QH["Query Handler"]
        QUH["Queue Handler"]
        RH["Result Handler"]
        C --> TM
        C --> QH
        C --> QUH
        C --> RH
    end
    click C "https://github.com/Shiva7071007/taskDistributionSystem/blob/master/TDS/client/src/main/java/com/itt/tds/client/Client.java"
    click TM "https://github.com/Shiva7071007/taskDistributionSystem/blob/master/TDS/client/src/main/java/client/Taskmgr.java"
    click QH "https://github.com/Shiva7071007/taskDistributionSystem/blob/master/TDS/client/src/main/java/com/itt/tds/client/Query.java"
    click QUH "https://github.com/Shiva7071007/taskDistributionSystem/blob/master/TDS/client/src/main/java/com/itt/tds/client/Queue.java"
    click RH "https://github.com/Shiva7071007/taskDistributionSystem/blob/master/TDS/client/src/main/java/com/itt/tds/client/Result.java"

    %% Coordinator Layer
    subgraph Coordinator
        CO["Coordinator"]
        TS["Task Scheduler"]
        NC["Node Controller"]
        NHM["Node Health Monitor"]
        RD["Request Dispatcher"]
        CC["Client Controller"]
        DBM["Database Manager"]
        CO --> TS
        CO --> NC
        CO --> NHM
        CO --> RD
        CO --> CC
        CO --> DBM
    end
    click CO "https://github.com/Shiva7071007/taskDistributionSystem/blob/master/TDS/co-ordinator/src/main/java/com/itt/tds/coordinator/CoOrdinator.java"
    click TS "https://github.com/Shiva7071007/taskDistributionSystem/blob/master/TDS/co-ordinator/src/main/java/com/itt/tds/coordinator/TaskScheduler.java"
    click NC "https://github.com/Shiva7071007/taskDistributionSystem/blob/master/TDS/co-ordinator/src/main/java/com/itt/tds/coordinator/NodeController.java"
    click NHM "https://github.com/Shiva7071007/taskDistributionSystem/blob/master/TDS/co-ordinator/src/main/java/com/itt/tds/coordinator/NodeHealthMonitor.java"
    click RD "https://github.com/Shiva7071007/taskDistributionSystem/blob/master/TDS/co-ordinator/src/main/java/com/itt/tds/coordinator/RequestDispatcher.java"
    click CC "https://github.com/Shiva7071007/taskDistributionSystem/blob/master/TDS/co-ordinator/src/main/java/com/itt/tds/coordinator/ClientController.java"
    click DBM "https://github.com/Shiva7071007/taskDistributionSystem/blob/master/TDS/co-ordinator/src/main/java/com/itt/tds/coordinator/db/DBManager.java"

    %% Node Layer
    subgraph Node
        N["Node"]
        NS["Node Server"]
        TE["Task Executor"]
        NRH["Request Handler"]
        SR["Status Reporter"]
        N --> NS
        N --> TE
        N --> NRH
        N --> SR
    end
    click N "https://github.com/Shiva7071007/taskDistributionSystem/blob/master/TDS/node/src/main/java/com/itt/tds/node/Node.java"
    click NS "https://github.com/Shiva7071007/taskDistributionSystem/blob/master/TDS/node/src/main/java/com/itt/tds/node/NodeServer.java"
    click TE "https://github.com/Shiva7071007/taskDistributionSystem/blob/master/TDS/node/src/main/java/com/itt/tds/node/RequestHandler/TaskExecuter.java"
    click NRH "https://github.com/Shiva7071007/taskDistributionSystem/blob/master/TDS/node/src/main/java/com/itt/tds/node/NodeRequestHandler.java"
    click SR "https://github.com/Shiva7071007/taskDistributionSystem/blob/master/TDS/node/src/main/java/com/itt/tds/node/RequestHandler/NodeStatus.java"

    %% Database Layer
    subgraph Database
        CR[(Client Repository)]
        NR[(Node Repository)]
        TR[(Task Repository)]
        TRR[(Task Result Repository)]
    end
    click CR "https://github.com/Shiva7071007/taskDistributionSystem/blob/master/TDS/co-ordinator/src/main/java/com/itt/tds/coordinator/db/repository/TDSClientRepository.java"
    click NR "https://github.com/Shiva7071007/taskDistributionSystem/blob/master/TDS/co-ordinator/src/main/java/com/itt/tds/coordinator/db/repository/TDSNodeRepository.java"
    click TR "https://github.com/Shiva7071007/taskDistributionSystem/blob/master/TDS/co-ordinator/src/main/java/com/itt/tds/coordinator/db/repository/TDSTaskRepository.java"
    click TRR "https://github.com/Shiva7071007/taskDistributionSystem/blob/master/TDS/co-ordinator/src/main/java/com/itt/tds/coordinator/db/repository/TDSTaskResultRepository.java"

    %% Connections
    Client --> Coordinator
    Coordinator --> Node
    Coordinator --> Database
    Core --> Client
    Core --> Coordinator
    Core --> Node

    %% Apply styles
    class C,TM,QH,QUH,RH client
    class CO,TS,NC,NHM,RD,CC,DBM coordinator
    class N,NS,TE,NRH,SR node
    class CP,SS,EH,LS core
    class CR,NR,TR,TRR database
```
