# martimteixeiraa89796/gestao-recessao-hotel architecture

> Architecture diagram of the GitHub repository martimteixeiraa89796/gestao-recessao-hotel, 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/martimteixeiraa89796/gestao-recessao-hotel
- Repository: https://github.com/martimteixeiraa89796/gestao-recessao-hotel

## Overview

Esta aplicação CLI gere dados de receção de hotel em SQLite. O fluxo principal começa no menu de `main.py`, que encaminha o utilizador para consultas, inserções, atualizações ou remoções; na inicialização, verifica e cria as tabelas. Os módulos de operação recolhem escolhas ou valores e executam consultas através da camada SQLite. A documentação e os excertos mostram também consultas específicas de horários, quartos, hóspedes, chegadas, camas e estadias. Os módulos não amostrados são incluídos quando identificados pelo índice, mas não lhes atribuo relações internas não demonstradas.

Main entry points: [`main.py`](https://github.com/martimteixeiraa89796/gestao-recessao-hotel/blob/main/main.py) (Menu principal), [`ferramentas_BD.py`](https://github.com/martimteixeiraa89796/gestao-recessao-hotel/blob/main/ferramentas_BD.py) (Acesso SQLite), [`ferramentas_escolha.py`](https://github.com/martimteixeiraa89796/gestao-recessao-hotel/blob/main/ferramentas_escolha.py) (Entrada e escolhas), [`funcoes_sqlite_select.py`](https://github.com/martimteixeiraa89796/gestao-recessao-hotel/blob/main/funcoes_sqlite_select.py) (Consultas e relatórios)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_cli["CLI e navegação"]
  node_main["Menu principal<br/>[main.py]"]
  node_choices["Entrada e escolhas"]
end

subgraph group_operations["Operações hoteleiras"]
  node_views["Consultas e relatórios"]
  node_inserts["Inserções"]
  node_updates["Atualizações"]
  node_deletes["Remoções"]
end

subgraph group_persistence["Persistência SQLite"]
  node_db_api["Acesso SQLite<br/>[ferramentas_BD.py]"]
  node_sqlite_store[("Base de dados")]
end

subgraph group_schema["Esquema e arranque"]
  node_bootstrap["Verificação de tabelas"]
  node_schema_create["Criação de tabelas"]
end

node_operator(("Operador"))

node_operator -->|"usa CLI"| node_main
node_main -->|"solicita escolhas"| node_choices
node_main -->|"verifica tabelas"| node_bootstrap
node_main -->|"encaminha consultas"| node_views
node_main -->|"encaminha inserções"| node_inserts
node_main -->|"encaminha atualizações"| node_updates
node_main -->|"encaminha remoções"| node_deletes
node_views -->|"recolhe escolhas"| node_choices
node_views -->|"consulta dados"| node_db_api
node_inserts -->|"recolhe valores"| node_choices
node_inserts -->|"executa inserções"| node_db_api
node_updates -->|"recolhe critérios"| node_choices
node_updates -->|"executa atualizações"| node_db_api
node_deletes -->|"recolhe critérios"| node_choices
node_deletes -->|"executa remoções"| node_db_api
node_bootstrap -->|"verifica existência"| node_db_api
node_bootstrap -->|"cria tabelas"| node_schema_create
node_schema_create -->|"executa DDL"| node_db_api
node_db_api -->|"lê e grava"| node_sqlite_store

click node_main "https://github.com/martimteixeiraa89796/gestao-recessao-hotel/blob/main/main.py"
click node_choices "https://github.com/martimteixeiraa89796/gestao-recessao-hotel/blob/main/ferramentas_escolha.py"
click node_views "https://github.com/martimteixeiraa89796/gestao-recessao-hotel/blob/main/funcoes_sqlite_select.py"
click node_inserts "https://github.com/martimteixeiraa89796/gestao-recessao-hotel/blob/main/funcoes_sqlite_insert.py"
click node_updates "https://github.com/martimteixeiraa89796/gestao-recessao-hotel/blob/main/funcoes_sqlite_update.py"
click node_deletes "https://github.com/martimteixeiraa89796/gestao-recessao-hotel/blob/main/funcoes_sqlite_delete.py"
click node_db_api "https://github.com/martimteixeiraa89796/gestao-recessao-hotel/blob/main/ferramentas_BD.py"
click node_bootstrap "https://github.com/martimteixeiraa89796/gestao-recessao-hotel/blob/main/verificar_e_atualizar_bd.py"
click node_schema_create "https://github.com/martimteixeiraa89796/gestao-recessao-hotel/blob/main/funcoes_sqlite_create.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_choices toneBlue
class node_views,node_inserts,node_updates,node_deletes toneAmber
class node_db_api,node_sqlite_store toneMint
class node_bootstrap,node_schema_create toneRose
class node_operator toneIndigo
```

## Components

### CLI e navegação

- [Menu principal](https://github.com/martimteixeiraa89796/gestao-recessao-hotel/blob/main/main.py): `main.py`
- [Entrada e escolhas](https://github.com/martimteixeiraa89796/gestao-recessao-hotel/blob/main/ferramentas_escolha.py): `ferramentas_escolha.py`

### Operações hoteleiras

- [Consultas e relatórios](https://github.com/martimteixeiraa89796/gestao-recessao-hotel/blob/main/funcoes_sqlite_select.py): `funcoes_sqlite_select.py`
- [Inserções](https://github.com/martimteixeiraa89796/gestao-recessao-hotel/blob/main/funcoes_sqlite_insert.py): `funcoes_sqlite_insert.py`
- [Atualizações](https://github.com/martimteixeiraa89796/gestao-recessao-hotel/blob/main/funcoes_sqlite_update.py): `funcoes_sqlite_update.py`
- [Remoções](https://github.com/martimteixeiraa89796/gestao-recessao-hotel/blob/main/funcoes_sqlite_delete.py): `funcoes_sqlite_delete.py`

### Persistência SQLite

- [Acesso SQLite](https://github.com/martimteixeiraa89796/gestao-recessao-hotel/blob/main/ferramentas_BD.py): `ferramentas_BD.py`
- **Base de dados**

### Esquema e arranque

- [Verificação de tabelas](https://github.com/martimteixeiraa89796/gestao-recessao-hotel/blob/main/verificar_e_atualizar_bd.py): `verificar_e_atualizar_bd.py`
- [Criação de tabelas](https://github.com/martimteixeiraa89796/gestao-recessao-hotel/blob/main/funcoes_sqlite_create.py): `funcoes_sqlite_create.py`

### Other components

- **Operador**

## Connections

- Operador → Menu principal: usa CLI (evidence: `README.md`)
- Menu principal → Entrada e escolhas: solicita escolhas (evidence: `main.py`)
- Menu principal → Verificação de tabelas: verifica tabelas (evidence: `main.py`)
- Menu principal → Consultas e relatórios: encaminha consultas (evidence: `main.py`)
- Menu principal → Inserções: encaminha inserções (evidence: `main.py`)
- Menu principal → Atualizações: encaminha atualizações (evidence: `main.py`)
- Menu principal → Remoções: encaminha remoções (evidence: `main.py`)
- Consultas e relatórios → Entrada e escolhas: recolhe escolhas (evidence: `funcoes_sqlite_select.py`)
- Consultas e relatórios → Acesso SQLite: consulta dados (evidence: `funcoes_sqlite_select.py`)
- Inserções → Entrada e escolhas: recolhe valores (evidence: `funcoes_sqlite_insert.py`)
- Inserções → Acesso SQLite: executa inserções (evidence: `funcoes_sqlite_insert.py`)
- Atualizações → Entrada e escolhas: recolhe critérios (evidence: `funcoes_sqlite_update.py`)
- Atualizações → Acesso SQLite: executa atualizações (evidence: `funcoes_sqlite_update.py`)
- Remoções → Entrada e escolhas: recolhe critérios (evidence: `funcoes_sqlite_delete.py`)
- Remoções → Acesso SQLite: executa remoções (evidence: `funcoes_sqlite_delete.py`)
- Verificação de tabelas → Acesso SQLite: verifica existência (evidence: `verificar_e_atualizar_bd.py`)
- Verificação de tabelas → Criação de tabelas: cria tabelas (evidence: `verificar_e_atualizar_bd.py`)
- Criação de tabelas → Acesso SQLite: executa DDL (evidence: `funcoes_sqlite_create.py`)
- Acesso SQLite → Base de dados: lê e grava (evidence: `ferramentas_BD.py`)
