# fernandoaab/organiza-o architecture

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

- Interactive diagram: https://gitdiagram.com/fernandoaab/organiza-o
- Repository: https://github.com/fernandoaab/organiza-o

## Overview

This is a Portuguese terminal application for reviewing records in A1, selecting or searching entries into A2, and comparing debit records for a printable report. The sampled source shows Rich-based tables and prompts, text-file reads and writes, and HTML opened in a browser. The README is empty and main.py excerpts are partial, so links for unsampled menu dispatch and other workflows are omitted.

Main entry points: [`py/main.py`](https://github.com/fernandoaab/organiza-o/blob/main/py/main.py) (Terminal interface), [`py/a1.txt`](https://github.com/fernandoaab/organiza-o/blob/main/py/a1.txt) (A1 source file), [`py/a2.txt`](https://github.com/fernandoaab/organiza-o/blob/main/py/a2.txt) (A2 destination file)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interaction["Terminal interaction"]
  node_cli["Terminal interface<br/>[main.py]"]
end

subgraph group_records["Record workflows"]
  node_search["Search records<br/>[main.py]"]
  node_select["Select A1 entries<br/>[main.py]"]
  node_a1[("A1 source file<br/>[a1.txt]")]
  node_a2[("A2 destination file<br/>[a2.txt]")]
end

subgraph group_reporting["Comparison and reporting"]
  node_compare["Compare debits<br/>[main.py]"]
  node_html["HTML report<br/>[main.py]"]
end

node_user(("User"))
node_browser["Web browser"]

node_user -->|"interacts"| node_cli
node_cli -->|"routes search"| node_search
node_cli -->|"routes selection"| node_select
node_cli -->|"routes comparison"| node_compare
node_search -->|"reads"| node_a1
node_search -->|"reads"| node_a2
node_select -->|"reads"| node_a1
node_select -->|"writes"| node_a2
node_compare -->|"reads"| node_a1
node_compare -->|"reads"| node_a2
node_compare -->|"generates"| node_html
node_html -->|"opens report"| node_browser

click node_cli "https://github.com/fernandoaab/organiza-o/blob/main/py/main.py"
click node_search "https://github.com/fernandoaab/organiza-o/blob/main/py/main.py"
click node_select "https://github.com/fernandoaab/organiza-o/blob/main/py/main.py"
click node_compare "https://github.com/fernandoaab/organiza-o/blob/main/py/main.py"
click node_html "https://github.com/fernandoaab/organiza-o/blob/main/py/main.py"
click node_a1 "https://github.com/fernandoaab/organiza-o/blob/main/py/a1.txt"
click node_a2 "https://github.com/fernandoaab/organiza-o/blob/main/py/a2.txt"

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_cli,node_user,node_browser toneBlue
class node_search,node_select,node_a1,node_a2 toneAmber
class node_compare,node_html toneMint
```

## Components

### Terminal interaction

- [Terminal interface](https://github.com/fernandoaab/organiza-o/blob/main/py/main.py): `py/main.py`

### Record workflows

- [Search records](https://github.com/fernandoaab/organiza-o/blob/main/py/main.py): `py/main.py`
- [Select A1 entries](https://github.com/fernandoaab/organiza-o/blob/main/py/main.py): `py/main.py`
- [A1 source file](https://github.com/fernandoaab/organiza-o/blob/main/py/a1.txt): `py/a1.txt`
- [A2 destination file](https://github.com/fernandoaab/organiza-o/blob/main/py/a2.txt): `py/a2.txt`

### Comparison and reporting

- [Compare debits](https://github.com/fernandoaab/organiza-o/blob/main/py/main.py): `py/main.py`
- [HTML report](https://github.com/fernandoaab/organiza-o/blob/main/py/main.py): `py/main.py`

### Other components

- **User**
- **Web browser**

## Connections

- User → Terminal interface: interacts
- Terminal interface → Search records: routes search
- Terminal interface → Select A1 entries: routes selection
- Terminal interface → Compare debits: routes comparison
- Search records → A1 source file: reads
- Search records → A2 destination file: reads
- Select A1 entries → A1 source file: reads
- Select A1 entries → A2 destination file: writes
- Compare debits → A1 source file: reads
- Compare debits → A2 destination file: reads
- Compare debits → HTML report: generates
- HTML report → Web browser: opens report