# dadi04/java-linda-distributed-system architecture

> Architecture diagram of the GitHub repository dadi04/java-linda-distributed-system, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/dadi04/java-linda-distributed-system
- Repository: https://github.com/dadi04/java-linda-distributed-system

## Overview

This is a distributed Java job-execution system: clients submit Java jobs and files, a central server tracks and schedules them to registered workstations, and clients can query status or retrieve completed outputs. Workstations execute jobs and report outcomes; the server also exposes a Linda tuple-space service for coordination. The graph includes protocol/data structures and the execution layer. Relationships are based on shown source and the source index; unsampled implementation details are not inferred beyond those references.

Main entry points: [`src/server/CentralServer.java`](https://github.com/dadi04/java-linda-distributed-system/blob/main/src/server/CentralServer.java) (Central server), [`src/workstation/WorkstationNode.java`](https://github.com/dadi04/java-linda-distributed-system/blob/main/src/workstation/WorkstationNode.java) (Workstation node), [`src/client/ClientService.java`](https://github.com/dadi04/java-linda-distributed-system/blob/main/src/client/ClientService.java) (Client service), [`src/client/ClientMain.java`](https://github.com/dadi04/java-linda-distributed-system/blob/main/src/client/ClientMain.java) (Client CLI)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Client"]
  node_client_main["Client CLI<br/>[ClientMain.java]"]
  node_config["Job config parser"]
  node_client_service["Client service<br/>[ClientService.java]"]
end

subgraph group_server["Central server"]
  node_server_main["Server launcher<br/>[ServerMain.java]"]
  node_central["Central server<br/>[CentralServer.java]"]
  node_jobs["Job manager<br/>[JobManager.java]"]
  node_scheduler["Job scheduler<br/>[JobScheduler.java]"]
  node_workstations["Workstation manager"]
  node_job["Job state<br/>[Job.java]"]
  node_job_status["Job statuses<br/>[JobStatus.java]"]
  node_workstation_info["Workstation capacity"]
  node_protocol["Message protocol<br/>[Message.java]"]
  node_message_types["Message types<br/>[MessageType.java]"]
  node_file_transfer["File transfer"]
end

subgraph group_workers["Workstation execution"]
  node_workstation["Workstation node"]
  node_runner["Process runner<br/>[ProcessRunner.java]"]
end

subgraph group_linda["Linda coordination"]
  node_linda_api["Linda API<br/>[Linda.java]"]
  node_linda_client["Linda client<br/>[LindaClient.java]"]
  node_linda_service["Linda service<br/>[LindaService.java]"]
  node_tuple_space["Tuple space<br/>[TupleSpace.java]"]
  node_tuple["Tuple<br/>[Tuple.java]"]
  node_linda_message["Linda messages<br/>[LindaMessage.java]"]
end

node_user(("Job submitter"))
node_client_files["Client files"]
node_java_process["Java job process"]

node_user -->|"submits job"| node_client_main
node_client_main -->|"parses config"| node_config
node_client_main -->|"invokes"| node_client_service
node_client_service -->|"sends requests"| node_central
node_client_files -->|"uploads inputs"| node_client_service
node_client_service -->|"transfers files"| node_file_transfer
node_central -->|"handles job state"| node_jobs
node_central -->|"registers workers"| node_workstations
node_central -->|"starts scheduler"| node_scheduler
node_scheduler -->|"polls and updates"| node_jobs
node_scheduler -->|"selects worker"| node_workstations
node_central -->|"receives and serves files"| node_file_transfer
node_central -->|"dispatches jobs"| node_workstation
node_workstation -->|"reports outcomes"| node_central
node_workstation -->|"transfers files"| node_file_transfer
node_workstation -->|"executes job"| node_runner
node_runner -->|"launches"| node_java_process
node_central -->|"starts service"| node_linda_service
node_linda_service -->|"serves tuple operations"| node_tuple_space
node_linda_service -->|"handles messages"| node_linda_message
node_linda_client -->|"implements API"| node_linda_api
node_linda_client -->|"exchanges messages"| node_linda_message
node_tuple_space -->|"stores tuples"| node_tuple
node_server_main -->|"starts server"| node_central

click node_client_main "https://github.com/dadi04/java-linda-distributed-system/blob/main/src/client/ClientMain.java"
click node_config "https://github.com/dadi04/java-linda-distributed-system/blob/main/src/client/ConfigFileParser.java"
click node_client_service "https://github.com/dadi04/java-linda-distributed-system/blob/main/src/client/ClientService.java"
click node_server_main "https://github.com/dadi04/java-linda-distributed-system/blob/main/src/server/ServerMain.java"
click node_central "https://github.com/dadi04/java-linda-distributed-system/blob/main/src/server/CentralServer.java"
click node_jobs "https://github.com/dadi04/java-linda-distributed-system/blob/main/src/server/JobManager.java"
click node_scheduler "https://github.com/dadi04/java-linda-distributed-system/blob/main/src/server/JobScheduler.java"
click node_workstations "https://github.com/dadi04/java-linda-distributed-system/blob/main/src/server/WorkstationManager.java"
click node_job "https://github.com/dadi04/java-linda-distributed-system/blob/main/src/common/Job.java"
click node_job_status "https://github.com/dadi04/java-linda-distributed-system/blob/main/src/common/JobStatus.java"
click node_workstation_info "https://github.com/dadi04/java-linda-distributed-system/blob/main/src/common/WorkstationInfo.java"
click node_protocol "https://github.com/dadi04/java-linda-distributed-system/blob/main/src/common/Message.java"
click node_message_types "https://github.com/dadi04/java-linda-distributed-system/blob/main/src/common/MessageType.java"
click node_file_transfer "https://github.com/dadi04/java-linda-distributed-system/blob/main/src/common/FileTransferUtil.java"
click node_workstation "https://github.com/dadi04/java-linda-distributed-system/blob/main/src/workstation/WorkstationNode.java"
click node_runner "https://github.com/dadi04/java-linda-distributed-system/blob/main/src/workstation/ProcessRunner.java"
click node_linda_api "https://github.com/dadi04/java-linda-distributed-system/blob/main/src/rs/ac/bg/etf/kdp/Linda.java"
click node_linda_client "https://github.com/dadi04/java-linda-distributed-system/blob/main/src/linda/LindaClient.java"
click node_linda_service "https://github.com/dadi04/java-linda-distributed-system/blob/main/src/linda/LindaService.java"
click node_tuple_space "https://github.com/dadi04/java-linda-distributed-system/blob/main/src/linda/TupleSpace.java"
click node_tuple "https://github.com/dadi04/java-linda-distributed-system/blob/main/src/linda/Tuple.java"
click node_linda_message "https://github.com/dadi04/java-linda-distributed-system/blob/main/src/linda/LindaMessage.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_client_main,node_config,node_client_service,node_client_files toneBlue
class node_server_main,node_central,node_jobs,node_scheduler,node_workstations,node_job,node_job_status,node_workstation_info,node_protocol,node_message_types,node_file_transfer toneAmber
class node_workstation,node_runner toneMint
class node_linda_api,node_linda_client,node_linda_service,node_tuple_space,node_tuple,node_linda_message toneRose
class node_user,node_java_process toneIndigo
```

## Components

### Client

- [Client CLI](https://github.com/dadi04/java-linda-distributed-system/blob/main/src/client/ClientMain.java): `src/client/ClientMain.java`
- [Job config parser](https://github.com/dadi04/java-linda-distributed-system/blob/main/src/client/ConfigFileParser.java): `src/client/ConfigFileParser.java`
- [Client service](https://github.com/dadi04/java-linda-distributed-system/blob/main/src/client/ClientService.java): `src/client/ClientService.java`

### Central server

- [Server launcher](https://github.com/dadi04/java-linda-distributed-system/blob/main/src/server/ServerMain.java): `src/server/ServerMain.java`
- [Central server](https://github.com/dadi04/java-linda-distributed-system/blob/main/src/server/CentralServer.java): `src/server/CentralServer.java`
- [Job manager](https://github.com/dadi04/java-linda-distributed-system/blob/main/src/server/JobManager.java): `src/server/JobManager.java`
- [Job scheduler](https://github.com/dadi04/java-linda-distributed-system/blob/main/src/server/JobScheduler.java): `src/server/JobScheduler.java`
- [Workstation manager](https://github.com/dadi04/java-linda-distributed-system/blob/main/src/server/WorkstationManager.java): `src/server/WorkstationManager.java`
- [Job state](https://github.com/dadi04/java-linda-distributed-system/blob/main/src/common/Job.java): `src/common/Job.java`
- [Job statuses](https://github.com/dadi04/java-linda-distributed-system/blob/main/src/common/JobStatus.java): `src/common/JobStatus.java`
- [Workstation capacity](https://github.com/dadi04/java-linda-distributed-system/blob/main/src/common/WorkstationInfo.java): `src/common/WorkstationInfo.java`
- [Message protocol](https://github.com/dadi04/java-linda-distributed-system/blob/main/src/common/Message.java): `src/common/Message.java`
- [Message types](https://github.com/dadi04/java-linda-distributed-system/blob/main/src/common/MessageType.java): `src/common/MessageType.java`
- [File transfer](https://github.com/dadi04/java-linda-distributed-system/blob/main/src/common/FileTransferUtil.java): `src/common/FileTransferUtil.java`

### Workstation execution

- [Workstation node](https://github.com/dadi04/java-linda-distributed-system/blob/main/src/workstation/WorkstationNode.java): `src/workstation/WorkstationNode.java`
- [Process runner](https://github.com/dadi04/java-linda-distributed-system/blob/main/src/workstation/ProcessRunner.java): `src/workstation/ProcessRunner.java`

### Linda coordination

- [Linda API](https://github.com/dadi04/java-linda-distributed-system/blob/main/src/rs/ac/bg/etf/kdp/Linda.java): `src/rs/ac/bg/etf/kdp/Linda.java`
- [Linda client](https://github.com/dadi04/java-linda-distributed-system/blob/main/src/linda/LindaClient.java): `src/linda/LindaClient.java`
- [Linda service](https://github.com/dadi04/java-linda-distributed-system/blob/main/src/linda/LindaService.java): `src/linda/LindaService.java`
- [Tuple space](https://github.com/dadi04/java-linda-distributed-system/blob/main/src/linda/TupleSpace.java): `src/linda/TupleSpace.java`
- [Tuple](https://github.com/dadi04/java-linda-distributed-system/blob/main/src/linda/Tuple.java): `src/linda/Tuple.java`
- [Linda messages](https://github.com/dadi04/java-linda-distributed-system/blob/main/src/linda/LindaMessage.java): `src/linda/LindaMessage.java`

### Other components

- **Job submitter**
- **Client files**
- **Java job process**

## Connections

- Job submitter → Client CLI: submits job (evidence: `src/client/ClientMain.java`)
- Client CLI → Job config parser: parses config (evidence: `src/client/ClientMain.java`)
- Client CLI → Client service: invokes (evidence: `src/client/ClientMain.java`)
- Client service → Central server: sends requests (evidence: `src/client/ClientService.java`)
- Client files → Client service: uploads inputs (evidence: `src/client/ClientService.java`)
- Client service → File transfer: transfers files (evidence: `src/client/ClientService.java`)
- Central server → Job manager: handles job state (evidence: `src/server/CentralServer.java`)
- Central server → Workstation manager: registers workers (evidence: `src/server/CentralServer.java`)
- Central server → Job scheduler: starts scheduler (evidence: `src/server/CentralServer.java`)
- Job scheduler → Job manager: polls and updates (evidence: `src/server/JobScheduler.java`)
- Job scheduler → Workstation manager: selects worker (evidence: `src/server/JobScheduler.java`)
- Central server → File transfer: receives and serves files (evidence: `src/server/CentralServer.java`)
- Central server → Workstation node: dispatches jobs
- Workstation node → Central server: reports outcomes (evidence: `src/workstation/WorkstationNode.java`)
- Workstation node → File transfer: transfers files (evidence: `src/workstation/WorkstationNode.java`)
- Workstation node → Process runner: executes job (evidence: `src/workstation/WorkstationNode.java`)
- Process runner → Java job process: launches (evidence: `src/workstation/ProcessRunner.java`)
- Central server → Linda service: starts service (evidence: `src/server/CentralServer.java`)
- Linda service → Tuple space: serves tuple operations (evidence: `src/linda/LindaService.java`)
- Linda service → Linda messages: handles messages (evidence: `src/linda/LindaService.java`)
- Linda client → Linda API: implements API (evidence: `src/linda/LindaClient.java`)
- Linda client → Linda messages: exchanges messages (evidence: `src/linda/LindaClient.java`)
- Tuple space → Tuple: stores tuples (evidence: `src/linda/TupleSpace.java`)
- Server launcher → Central server: starts server (evidence: `src/server/ServerMain.java`)
