# fadelrio/tallerdecom architecture

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

- Interactive diagram: https://gitdiagram.com/fadelrio/tallerdecom
- Repository: https://github.com/fadelrio/tallerdecom

## Overview

This is an academic digital-communications source simulator: it reads UTF-8 text, analyzes Unicode characters, builds and applies a Huffman code, directly decodes the resulting bit string, writes the received text, and compares it with the original. The main workflow is explicit in `main.py`; reporting adds source and coding tables, metrics, a fixed-width reference, and a sample. The graph includes shared data contracts as an internal layer. Relationships for documented capabilities not shown in sampled source are based on the README; no channel, modulation, or noise stages are implemented.

Main entry points: [`main.py`](https://github.com/fadelrio/tallerdecom/blob/master/main.py) (Simulation orchestrator), [`common/data_types.py`](https://github.com/fadelrio/tallerdecom/blob/master/common/data_types.py) (Shared data contracts), [`common/report_utils.py`](https://github.com/fadelrio/tallerdecom/blob/master/common/report_utils.py) (Report preparation), [`transmitter/huffman.py`](https://github.com/fadelrio/tallerdecom/blob/master/transmitter/huffman.py) (Huffman coding)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_orchestration["Simulation flow"]
  node_main["Simulation orchestrator<br/>[main.py]"]
  node_config["Simulation configuration<br/>[config.py]"]
end

subgraph group_transmission["Source coding"]
  node_analysis["Character analysis<br/>[source_analysis.py]"]
  node_huffman["Huffman coding<br/>[huffman.py]"]
  node_encoder["Block source encoder<br/>[source_encoder.py]"]
end

subgraph group_reception["Reception and files"]
  node_input["UTF-8 input text"]
  node_decoder["Huffman decoder<br/>[source_decoder.py]"]
  node_fileutils["Text file utilities<br/>[file_utils.py]"]
  node_output["Received text"]
end

subgraph group_reporting["Reporting and contracts"]
  node_report["Report preparation<br/>[report_utils.py]"]
  node_datatypes["Shared data contracts<br/>[data_types.py]"]
end

node_user(("User"))

node_user -->|"runs"| node_main
node_main -->|"loads defaults"| node_config
node_input -->|"provides text"| node_main
node_main -->|"reads and writes"| node_fileutils
node_main -->|"analyzes"| node_analysis
node_main -->|"builds code"| node_huffman
node_main -->|"encodes source"| node_encoder
node_main -->|"decodes bits"| node_decoder
node_main -->|"writes received text"| node_output
node_main -->|"formats report"| node_report
node_main -->|"compares texts"| node_fileutils
node_analysis -->|"returns statistics"| node_datatypes
node_huffman -->|"returns code results"| node_datatypes
node_encoder -->|"returns encoded source"| node_datatypes
node_decoder -->|"uses encoded source"| node_datatypes
node_fileutils -->|"returns comparison"| node_datatypes
node_report -->|"prepares report data"| node_datatypes
node_report -->|"calculates efficiency"| node_huffman
node_report -->|"encodes sample"| node_encoder
node_report -->|"decodes sample"| node_decoder

click node_main "https://github.com/fadelrio/tallerdecom/blob/master/main.py"
click node_config "https://github.com/fadelrio/tallerdecom/blob/master/config.py"
click node_analysis "https://github.com/fadelrio/tallerdecom/blob/master/transmitter/source_analysis.py"
click node_huffman "https://github.com/fadelrio/tallerdecom/blob/master/transmitter/huffman.py"
click node_encoder "https://github.com/fadelrio/tallerdecom/blob/master/transmitter/source_encoder.py"
click node_decoder "https://github.com/fadelrio/tallerdecom/blob/master/receiver/source_decoder.py"
click node_fileutils "https://github.com/fadelrio/tallerdecom/blob/master/common/file_utils.py"
click node_report "https://github.com/fadelrio/tallerdecom/blob/master/common/report_utils.py"
click node_datatypes "https://github.com/fadelrio/tallerdecom/blob/master/common/data_types.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_main,node_config,node_user toneBlue
class node_analysis,node_huffman,node_encoder toneAmber
class node_input,node_decoder,node_fileutils,node_output toneMint
class node_report,node_datatypes toneRose
```

## Components

### Simulation flow

- [Simulation orchestrator](https://github.com/fadelrio/tallerdecom/blob/master/main.py): `main.py`
- [Simulation configuration](https://github.com/fadelrio/tallerdecom/blob/master/config.py): `config.py`

### Source coding

- [Character analysis](https://github.com/fadelrio/tallerdecom/blob/master/transmitter/source_analysis.py): `transmitter/source_analysis.py`
- [Huffman coding](https://github.com/fadelrio/tallerdecom/blob/master/transmitter/huffman.py): `transmitter/huffman.py`
- [Block source encoder](https://github.com/fadelrio/tallerdecom/blob/master/transmitter/source_encoder.py): `transmitter/source_encoder.py`

### Reception and files

- **UTF-8 input text**
- [Huffman decoder](https://github.com/fadelrio/tallerdecom/blob/master/receiver/source_decoder.py): `receiver/source_decoder.py`
- [Text file utilities](https://github.com/fadelrio/tallerdecom/blob/master/common/file_utils.py): `common/file_utils.py`
- **Received text**

### Reporting and contracts

- [Report preparation](https://github.com/fadelrio/tallerdecom/blob/master/common/report_utils.py): `common/report_utils.py`
- [Shared data contracts](https://github.com/fadelrio/tallerdecom/blob/master/common/data_types.py): `common/data_types.py`

### Other components

- **User**

## Connections

- User → Simulation orchestrator: runs (evidence: `README.md`)
- Simulation orchestrator → Simulation configuration: loads defaults (evidence: `main.py`)
- UTF-8 input text → Simulation orchestrator: provides text (evidence: `main.py`)
- Simulation orchestrator → Text file utilities: reads and writes (evidence: `main.py`)
- Simulation orchestrator → Character analysis: analyzes (evidence: `main.py`)
- Simulation orchestrator → Huffman coding: builds code (evidence: `main.py`)
- Simulation orchestrator → Block source encoder: encodes source (evidence: `main.py`)
- Simulation orchestrator → Huffman decoder: decodes bits (evidence: `main.py`)
- Simulation orchestrator → Received text: writes received text (evidence: `README.md`)
- Simulation orchestrator → Report preparation: formats report (evidence: `main.py`)
- Simulation orchestrator → Text file utilities: compares texts (evidence: `main.py`)
- Character analysis → Shared data contracts: returns statistics (evidence: `transmitter/source_analysis.py`)
- Huffman coding → Shared data contracts: returns code results (evidence: `transmitter/huffman.py`)
- Block source encoder → Shared data contracts: returns encoded source (evidence: `transmitter/source_encoder.py`)
- Huffman decoder → Shared data contracts: uses encoded source (evidence: `receiver/source_decoder.py`)
- Text file utilities → Shared data contracts: returns comparison (evidence: `common/file_utils.py`)
- Report preparation → Shared data contracts: prepares report data (evidence: `common/report_utils.py`)
- Report preparation → Huffman coding: calculates efficiency (evidence: `common/report_utils.py`)
- Report preparation → Block source encoder: encodes sample (evidence: `common/report_utils.py`)
- Report preparation → Huffman decoder: decodes sample (evidence: `common/report_utils.py`)
