# elivanjr/sistemasdistribuidos architecture

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

- Interactive diagram: https://gitdiagram.com/elivanjr/sistemasdistribuidos
- Repository: https://github.com/elivanjr/sistemasdistribuidos

## Overview

This is a small collection of distributed-systems teaching examples, not one integrated application. Its clearest user workflow is Pub/Sub: a user connects and publishes or subscribes through a TCP client; the server tracks subscriptions and forwards matching events. Separate socket examples compare product serialization formats, while topic3 contains concurrency and asynchronous-programming exercises. The README gives no further capability detail; relationships for the serialization pairs and Pub/Sub are shown in source, while unsampled exercise behavior is left unspecified.

Main entry points: [`PubSub/server/main.py`](https://github.com/elivanjr/sistemasdistribuidos/blob/main/PubSub/server/main.py) (TCP server), [`PubSub/client/main.py`](https://github.com/elivanjr/sistemasdistribuidos/blob/main/PubSub/client/main.py) (Interactive client), [`Serializacao/A/ACliente.py`](https://github.com/elivanjr/sistemasdistribuidos/blob/main/Serializacao/A/ACliente.py) (Delimited client), [`Serializacao/A/AServidor.py`](https://github.com/elivanjr/sistemasdistribuidos/blob/main/Serializacao/A/AServidor.py) (Delimited server)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_pubsub["Pub/Sub messaging"]
  node_pubsub_client["Interactive client<br/>[main.py]"]
  node_pubsub_server["TCP server<br/>[main.py]"]
  node_client_registry[("Client registry<br/>[main.py]")]
  node_subscription_registry[("Subscriptions<br/>[main.py]")]
  node_event_fanout["Event forwarding<br/>[main.py]"]
end

subgraph group_serialization["Serialization examples"]
  node_plain_client["Delimited client<br/>[ACliente.py]"]
  node_plain_server["Delimited server<br/>[AServidor.py]"]
  node_pickle_client["Pickle client<br/>[BCliente.py]"]
  node_pickle_server["Pickle server<br/>[BServidor.py]"]
  node_json_client["JSON client<br/>[CCliente.py]"]
  node_json_server["JSON server<br/>[CServidor.py]"]
end

subgraph group_concurrency["Concurrency exercises"]
  node_async_tasks["Async task demo<br/>[exec1_1.py]"]
  node_async_example["Async exercise<br/>[exec1.py]"]
  node_async_example_3["Async exercise<br/>[exec1.py]"]
  node_async_http["Async HTTP exercise<br/>[main.py]"]
  node_race_demo["Threaded race<br/>[lab04-2.py]"]
  node_thread_demo["Thread exercise<br/>[lab04-1.py]"]
  node_thread_demo_3["Thread exercise<br/>[lab04-3.py]"]
  node_counter_demo["Locked counter<br/>[lab04-4a.py]"]
end

node_pubsub_user(("Pub/Sub user"))
node_product_user(("Product data user"))
node_http_service["Local API"]

node_pubsub_user -->|"uses"| node_pubsub_client
node_pubsub_client -->|"sends TCP messages"| node_pubsub_server
node_pubsub_server -->|"registers clients"| node_client_registry
node_pubsub_server -->|"updates subscriptions"| node_subscription_registry
node_pubsub_server -->|"dispatches publishes"| node_event_fanout
node_event_fanout -->|"reads subscribers"| node_subscription_registry
node_event_fanout -->|"selects sockets"| node_client_registry
node_event_fanout -->|"forwards events"| node_pubsub_client
node_product_user -->|"enters product"| node_plain_client
node_plain_client -->|"sends delimited bytes"| node_plain_server
node_plain_server -->|"prints decoded product"| node_product_user
node_product_user -->|"enters product"| node_pickle_client
node_pickle_client -->|"sends pickled bytes"| node_pickle_server
node_pickle_server -->|"prints decoded product"| node_product_user
node_product_user -->|"enters product"| node_json_client
node_json_client -->|"sends JSON bytes"| node_json_server
node_json_server -->|"prints decoded product"| node_product_user
node_async_tasks -->|"creates tasks"| node_async_tasks
node_async_http -->|"requests items"| node_http_service

click node_pubsub_client "https://github.com/elivanjr/sistemasdistribuidos/blob/main/PubSub/client/main.py"
click node_pubsub_server "https://github.com/elivanjr/sistemasdistribuidos/blob/main/PubSub/server/main.py"
click node_client_registry "https://github.com/elivanjr/sistemasdistribuidos/blob/main/PubSub/server/main.py"
click node_subscription_registry "https://github.com/elivanjr/sistemasdistribuidos/blob/main/PubSub/server/main.py"
click node_event_fanout "https://github.com/elivanjr/sistemasdistribuidos/blob/main/PubSub/server/main.py"
click node_plain_client "https://github.com/elivanjr/sistemasdistribuidos/blob/main/Serializacao/A/ACliente.py"
click node_plain_server "https://github.com/elivanjr/sistemasdistribuidos/blob/main/Serializacao/A/AServidor.py"
click node_pickle_client "https://github.com/elivanjr/sistemasdistribuidos/blob/main/Serializacao/B/BCliente.py"
click node_pickle_server "https://github.com/elivanjr/sistemasdistribuidos/blob/main/Serializacao/B/BServidor.py"
click node_json_client "https://github.com/elivanjr/sistemasdistribuidos/blob/main/Serializacao/C/CCliente.py"
click node_json_server "https://github.com/elivanjr/sistemasdistribuidos/blob/main/Serializacao/C/CServidor.py"
click node_async_tasks "https://github.com/elivanjr/sistemasdistribuidos/blob/main/topic3/1/exec1_1.py"
click node_async_example "https://github.com/elivanjr/sistemasdistribuidos/blob/main/topic3/1/exec1.py"
click node_async_example_3 "https://github.com/elivanjr/sistemasdistribuidos/blob/main/topic3/3/exec1.py"
click node_async_http "https://github.com/elivanjr/sistemasdistribuidos/blob/main/topic3/asyncioSlide2/main.py"
click node_race_demo "https://github.com/elivanjr/sistemasdistribuidos/blob/main/topic3/threading/lab04-2.py"
click node_thread_demo "https://github.com/elivanjr/sistemasdistribuidos/blob/main/topic3/threading/lab04-1.py"
click node_thread_demo_3 "https://github.com/elivanjr/sistemasdistribuidos/blob/main/topic3/threading/lab04-3.py"
click node_counter_demo "https://github.com/elivanjr/sistemasdistribuidos/blob/main/topic3/threading/lab04-4a.py"

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_pubsub_client,node_pubsub_server,node_client_registry,node_subscription_registry,node_event_fanout,node_pubsub_user,node_product_user toneBlue
class node_plain_client,node_plain_server,node_pickle_client,node_pickle_server,node_json_client,node_json_server toneAmber
class node_async_tasks,node_async_example,node_async_example_3,node_async_http,node_race_demo,node_thread_demo,node_thread_demo_3,node_counter_demo,node_http_service toneMint
```

## Components

### Pub/Sub messaging

- [Interactive client](https://github.com/elivanjr/sistemasdistribuidos/blob/main/PubSub/client/main.py): `PubSub/client/main.py`
- [TCP server](https://github.com/elivanjr/sistemasdistribuidos/blob/main/PubSub/server/main.py): `PubSub/server/main.py`
- [Client registry](https://github.com/elivanjr/sistemasdistribuidos/blob/main/PubSub/server/main.py): `PubSub/server/main.py`
- [Subscriptions](https://github.com/elivanjr/sistemasdistribuidos/blob/main/PubSub/server/main.py): `PubSub/server/main.py`
- [Event forwarding](https://github.com/elivanjr/sistemasdistribuidos/blob/main/PubSub/server/main.py): `PubSub/server/main.py`

### Serialization examples

- [Delimited client](https://github.com/elivanjr/sistemasdistribuidos/blob/main/Serializacao/A/ACliente.py): `Serializacao/A/ACliente.py`
- [Delimited server](https://github.com/elivanjr/sistemasdistribuidos/blob/main/Serializacao/A/AServidor.py): `Serializacao/A/AServidor.py`
- [Pickle client](https://github.com/elivanjr/sistemasdistribuidos/blob/main/Serializacao/B/BCliente.py): `Serializacao/B/BCliente.py`
- [Pickle server](https://github.com/elivanjr/sistemasdistribuidos/blob/main/Serializacao/B/BServidor.py): `Serializacao/B/BServidor.py`
- [JSON client](https://github.com/elivanjr/sistemasdistribuidos/blob/main/Serializacao/C/CCliente.py): `Serializacao/C/CCliente.py`
- [JSON server](https://github.com/elivanjr/sistemasdistribuidos/blob/main/Serializacao/C/CServidor.py): `Serializacao/C/CServidor.py`

### Concurrency exercises

- [Async task demo](https://github.com/elivanjr/sistemasdistribuidos/blob/main/topic3/1/exec1_1.py): `topic3/1/exec1_1.py`
- [Async exercise](https://github.com/elivanjr/sistemasdistribuidos/blob/main/topic3/1/exec1.py): `topic3/1/exec1.py`
- [Async exercise](https://github.com/elivanjr/sistemasdistribuidos/blob/main/topic3/3/exec1.py): `topic3/3/exec1.py`
- [Async HTTP exercise](https://github.com/elivanjr/sistemasdistribuidos/blob/main/topic3/asyncioSlide2/main.py): `topic3/asyncioSlide2/main.py`
- [Threaded race](https://github.com/elivanjr/sistemasdistribuidos/blob/main/topic3/threading/lab04-2.py): `topic3/threading/lab04-2.py`
- [Thread exercise](https://github.com/elivanjr/sistemasdistribuidos/blob/main/topic3/threading/lab04-1.py): `topic3/threading/lab04-1.py`
- [Thread exercise](https://github.com/elivanjr/sistemasdistribuidos/blob/main/topic3/threading/lab04-3.py): `topic3/threading/lab04-3.py`
- [Locked counter](https://github.com/elivanjr/sistemasdistribuidos/blob/main/topic3/threading/lab04-4a.py): `topic3/threading/lab04-4a.py`

### Other components

- **Pub/Sub user**
- **Product data user**
- **Local API**

## Connections

- Pub/Sub user → Interactive client: uses (evidence: `PubSub/client/main.py`)
- Interactive client → TCP server: sends TCP messages (evidence: `PubSub/client/main.py`)
- TCP server → Client registry: registers clients (evidence: `PubSub/server/main.py`)
- TCP server → Subscriptions: updates subscriptions (evidence: `PubSub/server/main.py`)
- TCP server → Event forwarding: dispatches publishes (evidence: `PubSub/server/main.py`)
- Event forwarding → Subscriptions: reads subscribers (evidence: `PubSub/server/main.py`)
- Event forwarding → Client registry: selects sockets (evidence: `PubSub/server/main.py`)
- Event forwarding → Interactive client: forwards events (evidence: `PubSub/server/main.py`)
- Product data user → Delimited client: enters product (evidence: `Serializacao/A/ACliente.py`)
- Delimited client → Delimited server: sends delimited bytes (evidence: `Serializacao/A/ACliente.py`)
- Delimited server → Product data user: prints decoded product (evidence: `Serializacao/A/AServidor.py`)
- Product data user → Pickle client: enters product (evidence: `Serializacao/B/BCliente.py`)
- Pickle client → Pickle server: sends pickled bytes (evidence: `Serializacao/B/BCliente.py`)
- Pickle server → Product data user: prints decoded product (evidence: `Serializacao/B/BServidor.py`)
- Product data user → JSON client: enters product (evidence: `Serializacao/C/CCliente.py`)
- JSON client → JSON server: sends JSON bytes (evidence: `Serializacao/C/CCliente.py`)
- JSON server → Product data user: prints decoded product (evidence: `Serializacao/C/CServidor.py`)
- Async task demo → Async task demo: creates tasks (evidence: `topic3/1/exec1_1.py`)
- Async HTTP exercise → Local API: requests items (evidence: `topic3/asyncioSlide2/main.py`)
