# a94091/gestorfrutas architecture

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

- Interactive diagram: https://gitdiagram.com/a94091/gestorfrutas
- Repository: https://github.com/a94091/gestorfrutas

## Overview

Este repositório é uma aplicação de linha de comandos para gerir stock de frutas e processar vendas. O utilizador escolhe operações num menu; o programa consulta ou altera um stock mantido apenas em memória, ou executa um pedido que valida o peso disponível, recolhe dados do cliente e atualiza o stock. O mapa separa a interface, as operações de inventário e o fluxo de vendas. A implementação está concentrada num único ficheiro; não há evidência de persistência externa nem de outros serviços.

Main entry points: [`gestor_frutas.py`](https://github.com/a94091/gestorfrutas/blob/main/gestor_frutas.py) (Menu e ciclo)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["Interface CLI"]
  node_menu["Menu e ciclo<br/>[gestor_frutas.py]"]
  node_console["Entrada e saída<br/>[gestor_frutas.py]"]
end

subgraph group_inventory["Gestão de inventário"]
  node_inventory_ops["Operações de stock<br/>[gestor_frutas.py]"]
  node_stock["Stock em memória<br/>[gestor_frutas.py]"]
  node_fruit["Registo de fruta<br/>[gestor_frutas.py]"]
end

subgraph group_sales["Vendas"]
  node_order["Processar pedido<br/>[gestor_frutas.py]"]
  node_customer["Dados do cliente<br/>[gestor_frutas.py]"]
end

node_user(("Utilizador"))

node_user -->|"escolhe operação"| node_menu
node_menu -->|"pede opções"| node_console
node_menu -->|"invoca operações"| node_inventory_ops
node_menu -->|"invoca pedido"| node_order
node_inventory_ops -->|"consulta e altera"| node_stock
node_inventory_ops -->|"cria registos"| node_fruit
node_order -->|"valida e reduz"| node_stock
node_order -->|"cria dados"| node_customer
node_order -->|"mostra resumo"| node_console

click node_menu "https://github.com/a94091/gestorfrutas/blob/main/gestor_frutas.py"
click node_console "https://github.com/a94091/gestorfrutas/blob/main/gestor_frutas.py"
click node_inventory_ops "https://github.com/a94091/gestorfrutas/blob/main/gestor_frutas.py"
click node_stock "https://github.com/a94091/gestorfrutas/blob/main/gestor_frutas.py"
click node_fruit "https://github.com/a94091/gestorfrutas/blob/main/gestor_frutas.py"
click node_order "https://github.com/a94091/gestorfrutas/blob/main/gestor_frutas.py"
click node_customer "https://github.com/a94091/gestorfrutas/blob/main/gestor_frutas.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_menu,node_console toneBlue
class node_inventory_ops,node_stock,node_fruit toneAmber
class node_order,node_customer toneMint
class node_user toneIndigo
```

## Components

### Interface CLI

- [Menu e ciclo](https://github.com/a94091/gestorfrutas/blob/main/gestor_frutas.py): `gestor_frutas.py`
- [Entrada e saída](https://github.com/a94091/gestorfrutas/blob/main/gestor_frutas.py): `gestor_frutas.py`

### Gestão de inventário

- [Operações de stock](https://github.com/a94091/gestorfrutas/blob/main/gestor_frutas.py): `gestor_frutas.py`
- [Stock em memória](https://github.com/a94091/gestorfrutas/blob/main/gestor_frutas.py): `gestor_frutas.py`
- [Registo de fruta](https://github.com/a94091/gestorfrutas/blob/main/gestor_frutas.py): `gestor_frutas.py`

### Vendas

- [Processar pedido](https://github.com/a94091/gestorfrutas/blob/main/gestor_frutas.py): `gestor_frutas.py`
- [Dados do cliente](https://github.com/a94091/gestorfrutas/blob/main/gestor_frutas.py): `gestor_frutas.py`

### Other components

- **Utilizador**

## Connections

- Utilizador → Menu e ciclo: escolhe operação (evidence: `gestor_frutas.py`)
- Menu e ciclo → Entrada e saída: pede opções (evidence: `gestor_frutas.py`)
- Menu e ciclo → Operações de stock: invoca operações (evidence: `gestor_frutas.py`)
- Menu e ciclo → Processar pedido: invoca pedido (evidence: `gestor_frutas.py`)
- Operações de stock → Stock em memória: consulta e altera (evidence: `gestor_frutas.py`)
- Operações de stock → Registo de fruta: cria registos (evidence: `gestor_frutas.py`)
- Processar pedido → Stock em memória: valida e reduz (evidence: `gestor_frutas.py`)
- Processar pedido → Dados do cliente: cria dados (evidence: `gestor_frutas.py`)
- Processar pedido → Entrada e saída: mostra resumo (evidence: `gestor_frutas.py`)
