# roccodelgado10/tp-concurrencia architecture

> Architecture diagram of the GitHub repository roccodelgado10/tp-concurrencia, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-20). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/roccodelgado10/tp-concurrencia
- Repository: https://github.com/roccodelgado10/tp-concurrencia

## Overview

Tp-Concurrencia is a Java simulation of concurrent cluster job processing. Main starts scheduler, validator, worker, auditor, and logging threads around a shared ClusterManager. Schedulers create jobs and reserve nodes; validators route jobs to execution or failure; workers route completed jobs onward; auditors make the final validation decision. The manager holds the synchronized queues, node pool, and counters, while the logger periodically writes statistics. The README gives no further product description; links below reflect the shown source and its reference index.

Main entry points: [`src/com/cluster/manager/ClusterManager.java`](https://github.com/roccodelgado10/tp-concurrencia/blob/main/src/com/cluster/manager/ClusterManager.java) (Cluster manager), [`src/com/cluster/Main.java`](https://github.com/roccodelgado10/tp-concurrencia/blob/main/src/com/cluster/Main.java) (Application entry), [`src/com/cluster/threads/SchedulerThread.java`](https://github.com/roccodelgado10/tp-concurrencia/blob/main/src/com/cluster/threads/SchedulerThread.java) (Scheduler threads), [`src/com/cluster/threads/ValidatorThread.java`](https://github.com/roccodelgado10/tp-concurrencia/blob/main/src/com/cluster/threads/ValidatorThread.java) (Validator threads)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_orchestration["Runtime orchestration"]
  node_main["Application entry<br/>[Main.java]"]
end

subgraph group_coordination["Cluster coordination"]
  node_manager["Cluster manager"]
end

subgraph group_domain["Domain state"]
  node_node["Compute node<br/>[ComputeNode.java]"]
  node_job["Job state<br/>[Job.java]"]
  node_jobstatus["Job statuses<br/>[JobStatus.java]"]
  node_nodestate["Node states<br/>[NodeState.java]"]
end

subgraph group_processing["Job processing"]
  node_scheduler["Scheduler threads"]
  node_validator["Validator threads"]
  node_worker["Worker threads<br/>[WorkerThread.java]"]
  node_auditor["Auditor threads<br/>[AuditorThread.java]"]
end

subgraph group_observability["Observability"]
  node_logger["Statistics logger<br/>[Logger.java]"]
end

node_logfile["Statistics log"]

node_main -->|"creates shared manager"| node_manager
node_main -->|"starts threads"| node_scheduler
node_main -->|"starts threads"| node_validator
node_main -->|"starts threads"| node_worker
node_main -->|"starts threads"| node_auditor
node_main -->|"starts thread"| node_logger
node_scheduler -->|"reserves node, enqueues job"| node_manager
node_scheduler -->|"creates job"| node_job
node_manager -->|"creates, assigns nodes"| node_node
node_manager -->|"tracks and updates jobs"| node_job
node_validator -->|"polls, routes jobs"| node_manager
node_validator -->|"updates node state"| node_node
node_worker -->|"polls, routes jobs"| node_manager
node_auditor -->|"polls, finalizes jobs"| node_manager
node_job -->|"uses status enum"| node_jobstatus
node_node -->|"uses state enum"| node_nodestate
node_logger -->|"reads statistics"| node_manager
node_logger -->|"writes statistics"| node_logfile

click node_scheduler "https://github.com/roccodelgado10/tp-concurrencia/blob/main/src/com/cluster/threads/SchedulerThread.java"
click node_validator "https://github.com/roccodelgado10/tp-concurrencia/blob/main/src/com/cluster/threads/ValidatorThread.java"
click node_worker "https://github.com/roccodelgado10/tp-concurrencia/blob/main/src/com/cluster/threads/WorkerThread.java"
click node_auditor "https://github.com/roccodelgado10/tp-concurrencia/blob/main/src/com/cluster/threads/AuditorThread.java"
click node_main "https://github.com/roccodelgado10/tp-concurrencia/blob/main/src/com/cluster/Main.java"
click node_manager "https://github.com/roccodelgado10/tp-concurrencia/blob/main/src/com/cluster/manager/ClusterManager.java"
click node_node "https://github.com/roccodelgado10/tp-concurrencia/blob/main/src/com/cluster/model/ComputeNode.java"
click node_job "https://github.com/roccodelgado10/tp-concurrencia/blob/main/src/com/cluster/model/Job.java"
click node_jobstatus "https://github.com/roccodelgado10/tp-concurrencia/blob/main/src/com/cluster/model/JobStatus.java"
click node_nodestate "https://github.com/roccodelgado10/tp-concurrencia/blob/main/src/com/cluster/model/NodeState.java"
click node_logger "https://github.com/roccodelgado10/tp-concurrencia/blob/main/src/com/cluster/threads/Logger.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_main toneBlue
class node_manager toneAmber
class node_node,node_job,node_jobstatus,node_nodestate toneMint
class node_scheduler,node_validator,node_worker,node_auditor toneRose
class node_logger,node_logfile toneIndigo
```

## Components

### Runtime orchestration

- [Application entry](https://github.com/roccodelgado10/tp-concurrencia/blob/main/src/com/cluster/Main.java): `src/com/cluster/Main.java`

### Cluster coordination

- [Cluster manager](https://github.com/roccodelgado10/tp-concurrencia/blob/main/src/com/cluster/manager/ClusterManager.java): `src/com/cluster/manager/ClusterManager.java`

### Domain state

- [Compute node](https://github.com/roccodelgado10/tp-concurrencia/blob/main/src/com/cluster/model/ComputeNode.java): `src/com/cluster/model/ComputeNode.java`
- [Job state](https://github.com/roccodelgado10/tp-concurrencia/blob/main/src/com/cluster/model/Job.java): `src/com/cluster/model/Job.java`
- [Job statuses](https://github.com/roccodelgado10/tp-concurrencia/blob/main/src/com/cluster/model/JobStatus.java): `src/com/cluster/model/JobStatus.java`
- [Node states](https://github.com/roccodelgado10/tp-concurrencia/blob/main/src/com/cluster/model/NodeState.java): `src/com/cluster/model/NodeState.java`

### Job processing

- [Scheduler threads](https://github.com/roccodelgado10/tp-concurrencia/blob/main/src/com/cluster/threads/SchedulerThread.java): `src/com/cluster/threads/SchedulerThread.java`
- [Validator threads](https://github.com/roccodelgado10/tp-concurrencia/blob/main/src/com/cluster/threads/ValidatorThread.java): `src/com/cluster/threads/ValidatorThread.java`
- [Worker threads](https://github.com/roccodelgado10/tp-concurrencia/blob/main/src/com/cluster/threads/WorkerThread.java): `src/com/cluster/threads/WorkerThread.java`
- [Auditor threads](https://github.com/roccodelgado10/tp-concurrencia/blob/main/src/com/cluster/threads/AuditorThread.java): `src/com/cluster/threads/AuditorThread.java`

### Observability

- [Statistics logger](https://github.com/roccodelgado10/tp-concurrencia/blob/main/src/com/cluster/threads/Logger.java): `src/com/cluster/threads/Logger.java`

### Other components

- **Statistics log**

## Connections

- Application entry → Cluster manager: creates shared manager (evidence: `src/com/cluster/Main.java`)
- Application entry → Scheduler threads: starts threads (evidence: `src/com/cluster/Main.java`)
- Application entry → Validator threads: starts threads (evidence: `src/com/cluster/Main.java`)
- Application entry → Worker threads: starts threads (evidence: `src/com/cluster/Main.java`)
- Application entry → Auditor threads: starts threads (evidence: `src/com/cluster/Main.java`)
- Application entry → Statistics logger: starts thread (evidence: `src/com/cluster/Main.java`)
- Scheduler threads → Cluster manager: reserves node, enqueues job (evidence: `src/com/cluster/threads/SchedulerThread.java`)
- Scheduler threads → Job state: creates job (evidence: `src/com/cluster/threads/SchedulerThread.java`)
- Cluster manager → Compute node: creates, assigns nodes (evidence: `src/com/cluster/manager/ClusterManager.java`)
- Cluster manager → Job state: tracks and updates jobs (evidence: `src/com/cluster/manager/ClusterManager.java`)
- Validator threads → Cluster manager: polls, routes jobs (evidence: `src/com/cluster/threads/ValidatorThread.java`)
- Validator threads → Compute node: updates node state (evidence: `src/com/cluster/threads/ValidatorThread.java`)
- Worker threads → Cluster manager: polls, routes jobs (evidence: `src/com/cluster/threads/WorkerThread.java`)
- Auditor threads → Cluster manager: polls, finalizes jobs (evidence: `src/com/cluster/threads/AuditorThread.java`)
- Job state → Job statuses: uses status enum (evidence: `src/com/cluster/model/Job.java`)
- Compute node → Node states: uses state enum (evidence: `src/com/cluster/model/ComputeNode.java`)
- Statistics logger → Cluster manager: reads statistics (evidence: `src/com/cluster/threads/Logger.java`)
- Statistics logger → Statistics log: writes statistics (evidence: `src/com/cluster/threads/Logger.java`)
