# miguel-mariano/jogo-velha architecture

> Architecture diagram of the GitHub repository miguel-mariano/jogo-velha, 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/miguel-mariano/jogo-velha
- Repository: https://github.com/miguel-mariano/jogo-velha

## Overview

This repository is a collection of Python learning exercises, not one integrated application. Its principal runnable workflow is the console calculator: a user chooses an operation, enters two numbers, and `main.py` calls the calculator functions. Other independent examples cover Python fundamentals, functions, object-oriented programming, a Tkinter login screen, and a text-file hero catalog. The graph preserves these distinct learning branches; most are standalone scripts, so no connections between them are implied. Source excerpts are incomplete, and the README is empty.

Main entry points: [`main.py`](https://github.com/miguel-mariano/jogo-velha/blob/main/main.py) (Calculator menu), [`catalogo_herois.py`](https://github.com/miguel-mariano/jogo-velha/blob/main/catalogo_herois.py) (Hero catalog), [`calculadora.py`](https://github.com/miguel-mariano/jogo-velha/blob/main/calculadora.py) (Calculator operations), [`geometria.py`](https://github.com/miguel-mariano/jogo-velha/blob/main/geometria.py) (Geometry functions)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_fundamentals["Python fundamentals"]
  node_tuples["Tuples<br/>[Tuplas.py]"]
  node_collections["Collections examples<br/>[tuplas denovo.py]"]
  node_lists["List examples"]
  node_dictionaries_sets["Dictionaries and sets"]
  node_comparisons["Conditions and comparisons"]
  node_io["Input and output<br/>[entradaesaida.py]"]
  node_length["Length examples<br/>[função LEN.py]"]
  node_exercises["Programming exercises<br/>[exercicios.py]"]
  node_exercise14["Exercise set 14<br/>[exercicios14.py]"]
  node_lesson_structures["Structure exercises<br/>[etruturas.py]"]
  node_review["Review exercises<br/>[revisao.py]"]
  node_exam["Exam exercise<br/>[exame.py]"]
  node_string_exercise["String exercise"]
  node_sets["Set examples<br/>[conjuntos.py]"]
  node_dictionaries["Dictionary examples<br/>[dicionario.py]"]
  node_name["Name exercise<br/>[nome.py]"]
end

subgraph group_functions["Functions and math"]
  node_main["Calculator menu<br/>[main.py]"]
  node_calculator["Calculator operations<br/>[calculadora.py]"]
  node_geometry["Geometry functions<br/>[geometria.py]"]
  node_functions_lessons["Function lessons<br/>[Funcao.py]"]
  node_composed_functions["Composed and recursive functions"]
  node_function_review["Function review"]
  node_passwords["Password generator"]
end

subgraph group_oop["Object-oriented programming"]
  node_oop_intro["Classes and objects<br/>[POO.py]"]
  node_abstraction["Abstraction<br/>[abstraçao.py]"]
  node_encapsulation["Encapsulation<br/>[encapsulamento.py]"]
  node_inheritance["Inheritance<br/>[herança.py]"]
  node_polymorphism["Polymorphism<br/>[polimorfismo.py]"]
  node_animal_challenge["Animal classification challenge<br/>[desafio13.py]"]
  node_game["Object-oriented game<br/>[jogo POO.py]"]
end

subgraph group_applications["Interactive examples"]
  node_login["Login window<br/>[aula 13 .py]"]
  node_catalog["Hero catalog<br/>[catalogo_herois.py]"]
  node_hero_file["Hero text file<br/>[herois.txt]"]
end

node_user(("User"))

node_user -->|"chooses operation"| node_main
node_main -->|"calls operations"| node_calculator
node_main -->|"calls functions"| node_geometry
node_user -->|"enters credentials"| node_login
node_user -->|"uses menu"| node_catalog
node_catalog -->|"reads and writes"| node_hero_file

click node_main "https://github.com/miguel-mariano/jogo-velha/blob/main/main.py"
click node_calculator "https://github.com/miguel-mariano/jogo-velha/blob/main/calculadora.py"
click node_geometry "https://github.com/miguel-mariano/jogo-velha/blob/main/geometria.py"
click node_functions_lessons "https://github.com/miguel-mariano/jogo-velha/blob/main/Funcao.py"
click node_composed_functions "https://github.com/miguel-mariano/jogo-velha/blob/main/funcaocomposta%20e%20recursiva.py"
click node_function_review "https://github.com/miguel-mariano/jogo-velha/blob/main/revis%C3%A3o%20de%20fun%C3%A7%C3%A3o.py"
click node_passwords "https://github.com/miguel-mariano/jogo-velha/blob/main/Gerador%20de%20senhas.py"
click node_tuples "https://github.com/miguel-mariano/jogo-velha/blob/main/Tuplas.py"
click node_collections "https://github.com/miguel-mariano/jogo-velha/blob/main/tuplas%20denovo.py"
click node_lists "https://github.com/miguel-mariano/jogo-velha/blob/main/listas%20e%20mais%20listas.py"
click node_dictionaries_sets "https://github.com/miguel-mariano/jogo-velha/blob/main/atividade%20em%20anexo2.py"
click node_comparisons "https://github.com/miguel-mariano/jogo-velha/blob/main/revisao%20de%20compara%C3%A7%C3%A3o.py"
click node_io "https://github.com/miguel-mariano/jogo-velha/blob/main/entradaesaida.py"
click node_length "https://github.com/miguel-mariano/jogo-velha/blob/main/fun%C3%A7%C3%A3o%20LEN.py"
click node_exercises "https://github.com/miguel-mariano/jogo-velha/blob/main/exercicios.py"
click node_exercise14 "https://github.com/miguel-mariano/jogo-velha/blob/main/exercicios14.py"
click node_lesson_structures "https://github.com/miguel-mariano/jogo-velha/blob/main/etruturas.py"
click node_review "https://github.com/miguel-mariano/jogo-velha/blob/main/revisao.py"
click node_exam "https://github.com/miguel-mariano/jogo-velha/blob/main/exame.py"
click node_string_exercise "https://github.com/miguel-mariano/jogo-velha/blob/main/atividade%20em%20anexo.py"
click node_sets "https://github.com/miguel-mariano/jogo-velha/blob/main/conjuntos.py"
click node_dictionaries "https://github.com/miguel-mariano/jogo-velha/blob/main/dicionario.py"
click node_name "https://github.com/miguel-mariano/jogo-velha/blob/main/nome.py"
click node_oop_intro "https://github.com/miguel-mariano/jogo-velha/blob/main/POO.py"
click node_abstraction "https://github.com/miguel-mariano/jogo-velha/blob/main/abstra%C3%A7ao.py"
click node_encapsulation "https://github.com/miguel-mariano/jogo-velha/blob/main/encapsulamento.py"
click node_inheritance "https://github.com/miguel-mariano/jogo-velha/blob/main/heran%C3%A7a.py"
click node_polymorphism "https://github.com/miguel-mariano/jogo-velha/blob/main/polimorfismo.py"
click node_animal_challenge "https://github.com/miguel-mariano/jogo-velha/blob/main/desafio13.py"
click node_game "https://github.com/miguel-mariano/jogo-velha/blob/main/jogo%20POO.py"
click node_login "https://github.com/miguel-mariano/jogo-velha/blob/main/aula%2013%20.py"
click node_catalog "https://github.com/miguel-mariano/jogo-velha/blob/main/catalogo_herois.py"
click node_hero_file "https://github.com/miguel-mariano/jogo-velha/blob/main/herois.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_tuples,node_collections,node_lists,node_dictionaries_sets,node_comparisons,node_io,node_length,node_exercises,node_exercise14,node_lesson_structures,node_review,node_exam,node_string_exercise,node_sets,node_dictionaries,node_name,node_user toneBlue
class node_main,node_calculator,node_geometry,node_functions_lessons,node_composed_functions,node_function_review,node_passwords toneAmber
class node_oop_intro,node_abstraction,node_encapsulation,node_inheritance,node_polymorphism,node_animal_challenge,node_game toneMint
class node_login,node_catalog,node_hero_file toneRose
```

## Components

### Python fundamentals

- [Tuples](https://github.com/miguel-mariano/jogo-velha/blob/main/Tuplas.py): `Tuplas.py`
- [Collections examples](https://github.com/miguel-mariano/jogo-velha/blob/main/tuplas%20denovo.py): `tuplas denovo.py`
- [List examples](https://github.com/miguel-mariano/jogo-velha/blob/main/listas%20e%20mais%20listas.py): `listas e mais listas.py`
- [Dictionaries and sets](https://github.com/miguel-mariano/jogo-velha/blob/main/atividade%20em%20anexo2.py): `atividade em anexo2.py`
- [Conditions and comparisons](https://github.com/miguel-mariano/jogo-velha/blob/main/revisao%20de%20compara%C3%A7%C3%A3o.py): `revisao de comparação.py`
- [Input and output](https://github.com/miguel-mariano/jogo-velha/blob/main/entradaesaida.py): `entradaesaida.py`
- [Length examples](https://github.com/miguel-mariano/jogo-velha/blob/main/fun%C3%A7%C3%A3o%20LEN.py): `função LEN.py`
- [Programming exercises](https://github.com/miguel-mariano/jogo-velha/blob/main/exercicios.py): `exercicios.py`
- [Exercise set 14](https://github.com/miguel-mariano/jogo-velha/blob/main/exercicios14.py): `exercicios14.py`
- [Structure exercises](https://github.com/miguel-mariano/jogo-velha/blob/main/etruturas.py): `etruturas.py`
- [Review exercises](https://github.com/miguel-mariano/jogo-velha/blob/main/revisao.py): `revisao.py`
- [Exam exercise](https://github.com/miguel-mariano/jogo-velha/blob/main/exame.py): `exame.py`
- [String exercise](https://github.com/miguel-mariano/jogo-velha/blob/main/atividade%20em%20anexo.py): `atividade em anexo.py`
- [Set examples](https://github.com/miguel-mariano/jogo-velha/blob/main/conjuntos.py): `conjuntos.py`
- [Dictionary examples](https://github.com/miguel-mariano/jogo-velha/blob/main/dicionario.py): `dicionario.py`
- [Name exercise](https://github.com/miguel-mariano/jogo-velha/blob/main/nome.py): `nome.py`

### Functions and math

- [Calculator menu](https://github.com/miguel-mariano/jogo-velha/blob/main/main.py): `main.py`
- [Calculator operations](https://github.com/miguel-mariano/jogo-velha/blob/main/calculadora.py): `calculadora.py`
- [Geometry functions](https://github.com/miguel-mariano/jogo-velha/blob/main/geometria.py): `geometria.py`
- [Function lessons](https://github.com/miguel-mariano/jogo-velha/blob/main/Funcao.py): `Funcao.py`
- [Composed and recursive functions](https://github.com/miguel-mariano/jogo-velha/blob/main/funcaocomposta%20e%20recursiva.py): `funcaocomposta e recursiva.py`
- [Function review](https://github.com/miguel-mariano/jogo-velha/blob/main/revis%C3%A3o%20de%20fun%C3%A7%C3%A3o.py): `revisão de função.py`
- [Password generator](https://github.com/miguel-mariano/jogo-velha/blob/main/Gerador%20de%20senhas.py): `Gerador de senhas.py`

### Object-oriented programming

- [Classes and objects](https://github.com/miguel-mariano/jogo-velha/blob/main/POO.py): `POO.py`
- [Abstraction](https://github.com/miguel-mariano/jogo-velha/blob/main/abstra%C3%A7ao.py): `abstraçao.py`
- [Encapsulation](https://github.com/miguel-mariano/jogo-velha/blob/main/encapsulamento.py): `encapsulamento.py`
- [Inheritance](https://github.com/miguel-mariano/jogo-velha/blob/main/heran%C3%A7a.py): `herança.py`
- [Polymorphism](https://github.com/miguel-mariano/jogo-velha/blob/main/polimorfismo.py): `polimorfismo.py`
- [Animal classification challenge](https://github.com/miguel-mariano/jogo-velha/blob/main/desafio13.py): `desafio13.py`
- [Object-oriented game](https://github.com/miguel-mariano/jogo-velha/blob/main/jogo%20POO.py): `jogo POO.py`

### Interactive examples

- [Login window](https://github.com/miguel-mariano/jogo-velha/blob/main/aula%2013%20.py): `aula 13 .py`
- [Hero catalog](https://github.com/miguel-mariano/jogo-velha/blob/main/catalogo_herois.py): `catalogo_herois.py`
- [Hero text file](https://github.com/miguel-mariano/jogo-velha/blob/main/herois.txt): `herois.txt`

### Other components

- **User**

## Connections

- User → Calculator menu: chooses operation (evidence: `main.py`)
- Calculator menu → Calculator operations: calls operations (evidence: `main.py`)
- Calculator menu → Geometry functions: calls functions (evidence: `main.py`)
- User → Login window: enters credentials (evidence: `aula 13 .py`)
- User → Hero catalog: uses menu (evidence: `catalogo_herois.py`)
- Hero catalog → Hero text file: reads and writes (evidence: `catalogo_herois.py`)
