# joaoaasoares/fabao-delivery-simples architecture

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

- Interactive diagram: https://gitdiagram.com/joaoaasoares/fabao-delivery-simples
- Repository: https://github.com/joaoaasoares/fabao-delivery-simples

## Overview

Batatas do Fabão is a Django food-delivery storefront and operations system. Customers browse the menu, manage a cart and coupon, verify delivery coverage or choose pickup, submit an order, then track it and view PIX details when applicable. Kitchen staff manage order status and availability; delivery staff handle active deliveries; administrators manage the catalog, geography and reports. The graph separates request handling, order rules, geography/payment support and persisted domain data. Some capabilities are documented in the README but their implementation was not sampled, so their links are documented rather than inferred from unseen calls.

Main entry points: [`config/urls.py`](https://github.com/joaoaasoares/fabao-delivery-simples/blob/main/config/urls.py) (HTTP routes), [`delivery/services.py`](https://github.com/joaoaasoares/fabao-delivery-simples/blob/main/delivery/services.py) (Order services), [`delivery/models.py`](https://github.com/joaoaasoares/fabao-delivery-simples/blob/main/delivery/models.py) (Domain records), [`delivery/forms.py`](https://github.com/joaoaasoares/fabao-delivery-simples/blob/main/delivery/forms.py) (Order forms)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_customer["Customer ordering"]
  node_routes["HTTP routes<br/>[urls.py]"]
  node_storefront["Menu and cart<br/>[views.py]"]
  node_checkout["Checkout<br/>[views.py]"]
  node_tracking["Order tracking<br/>[views.py]"]
  node_forms["Order forms<br/>[forms.py]"]
end

subgraph group_operations["Order operations"]
  node_order_rules["Order services<br/>[services.py]"]
  node_kitchen["Kitchen actions<br/>[views.py]"]
  node_delivery_panel["Courier panel<br/>[views.py]"]
end

subgraph group_support["Delivery and payment"]
  node_postal["Postal lookup<br/>[postal.py]"]
  node_coverage["Coverage rules<br/>[coverage.py]"]
  node_geo_admin["Geography API<br/>[geography.py]"]
  node_pix["PIX generation<br/>[pix.py]"]
  node_coupons["Coupon rules<br/>[coupons.py]"]
end

subgraph group_management["Management"]
  node_admin["Catalog management<br/>[admin.py]"]
  node_reports["Sales reports<br/>[reports.py]"]
  node_contact["Customer contact<br/>[contact.py]"]
  node_images["Photo processing<br/>[images.py]"]
  node_photo_storage["Photo cleanup<br/>[photo_storage.py]"]
end

subgraph group_domain["Domain data"]
  node_records[("Domain records<br/>[models.py]")]
end

node_buyer(("Customer"))
node_staff(("Staff"))
node_cep_service["ViaCEP"]

node_buyer -->|"browses and orders"| node_routes
node_routes -->|"routes storefront"| node_storefront
node_routes -->|"routes checkout"| node_checkout
node_routes -->|"routes tracking"| node_tracking
node_routes -->|"routes kitchen"| node_kitchen
node_routes -->|"routes courier"| node_delivery_panel
node_routes -->|"routes geography"| node_geo_admin
node_routes -->|"routes reports"| node_reports
node_storefront -->|"quotes cart"| node_order_rules
node_checkout -->|"validates input"| node_forms
node_checkout -->|"places order"| node_order_rules
node_forms -->|"checks coverage"| node_coverage
node_forms -->|"verifies CEP"| node_postal
node_forms -->|"resolves municipality"| node_geo_admin
node_order_rules -->|"reads and writes"| node_records
node_order_rules -->|"validates delivery"| node_coverage
node_order_rules -->|"applies discounts"| node_coupons
node_order_rules -->|"checks PIX setup"| node_pix
node_postal -->|"queries CEP"| node_cep_service
node_coverage -->|"checks verification"| node_postal
node_coverage -->|"reads delivery zones"| node_records
node_geo_admin -->|"looks up postal data"| node_postal
node_geo_admin -->|"reads zones"| node_records
node_kitchen -->|"updates order state"| node_order_rules
node_delivery_panel -->|"shows active deliveries"| node_records
node_tracking -->|"shows payment QR"| node_pix
node_staff -->|"manages catalog"| node_admin
node_staff -->|"reviews sales"| node_reports
node_admin -->|"manages records"| node_records
node_admin -->|"uses admin forms"| node_forms
node_admin -->|"cleans photos"| node_photo_storage
node_forms -->|"optimizes uploads"| node_images
node_photo_storage -->|"checks references"| node_records
node_reports -->|"queries order data"| node_records
node_storefront -->|"offers support contact"| node_contact

click node_routes "https://github.com/joaoaasoares/fabao-delivery-simples/blob/main/config/urls.py"
click node_storefront "https://github.com/joaoaasoares/fabao-delivery-simples/blob/main/delivery/views.py"
click node_checkout "https://github.com/joaoaasoares/fabao-delivery-simples/blob/main/delivery/views.py"
click node_tracking "https://github.com/joaoaasoares/fabao-delivery-simples/blob/main/delivery/views.py"
click node_forms "https://github.com/joaoaasoares/fabao-delivery-simples/blob/main/delivery/forms.py"
click node_order_rules "https://github.com/joaoaasoares/fabao-delivery-simples/blob/main/delivery/services.py"
click node_kitchen "https://github.com/joaoaasoares/fabao-delivery-simples/blob/main/delivery/views.py"
click node_delivery_panel "https://github.com/joaoaasoares/fabao-delivery-simples/blob/main/delivery/views.py"
click node_postal "https://github.com/joaoaasoares/fabao-delivery-simples/blob/main/delivery/postal.py"
click node_coverage "https://github.com/joaoaasoares/fabao-delivery-simples/blob/main/delivery/coverage.py"
click node_geo_admin "https://github.com/joaoaasoares/fabao-delivery-simples/blob/main/delivery/geography.py"
click node_pix "https://github.com/joaoaasoares/fabao-delivery-simples/blob/main/delivery/pix.py"
click node_coupons "https://github.com/joaoaasoares/fabao-delivery-simples/blob/main/delivery/coupons.py"
click node_admin "https://github.com/joaoaasoares/fabao-delivery-simples/blob/main/delivery/admin.py"
click node_reports "https://github.com/joaoaasoares/fabao-delivery-simples/blob/main/delivery/reports.py"
click node_contact "https://github.com/joaoaasoares/fabao-delivery-simples/blob/main/delivery/contact.py"
click node_images "https://github.com/joaoaasoares/fabao-delivery-simples/blob/main/delivery/images.py"
click node_photo_storage "https://github.com/joaoaasoares/fabao-delivery-simples/blob/main/delivery/photo_storage.py"
click node_records "https://github.com/joaoaasoares/fabao-delivery-simples/blob/main/delivery/models.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_routes,node_storefront,node_checkout,node_tracking,node_forms toneBlue
class node_order_rules,node_kitchen,node_delivery_panel toneAmber
class node_postal,node_coverage,node_geo_admin,node_pix,node_coupons toneMint
class node_admin,node_reports,node_contact,node_images,node_photo_storage toneRose
class node_records,node_buyer,node_staff,node_cep_service toneIndigo
```

## Components

### Customer ordering

- [HTTP routes](https://github.com/joaoaasoares/fabao-delivery-simples/blob/main/config/urls.py): `config/urls.py`
- [Menu and cart](https://github.com/joaoaasoares/fabao-delivery-simples/blob/main/delivery/views.py): `delivery/views.py`
- [Checkout](https://github.com/joaoaasoares/fabao-delivery-simples/blob/main/delivery/views.py): `delivery/views.py`
- [Order tracking](https://github.com/joaoaasoares/fabao-delivery-simples/blob/main/delivery/views.py): `delivery/views.py`
- [Order forms](https://github.com/joaoaasoares/fabao-delivery-simples/blob/main/delivery/forms.py): `delivery/forms.py`

### Order operations

- [Order services](https://github.com/joaoaasoares/fabao-delivery-simples/blob/main/delivery/services.py): `delivery/services.py`
- [Kitchen actions](https://github.com/joaoaasoares/fabao-delivery-simples/blob/main/delivery/views.py): `delivery/views.py`
- [Courier panel](https://github.com/joaoaasoares/fabao-delivery-simples/blob/main/delivery/views.py): `delivery/views.py`

### Delivery and payment

- [Postal lookup](https://github.com/joaoaasoares/fabao-delivery-simples/blob/main/delivery/postal.py): `delivery/postal.py`
- [Coverage rules](https://github.com/joaoaasoares/fabao-delivery-simples/blob/main/delivery/coverage.py): `delivery/coverage.py`
- [Geography API](https://github.com/joaoaasoares/fabao-delivery-simples/blob/main/delivery/geography.py): `delivery/geography.py`
- [PIX generation](https://github.com/joaoaasoares/fabao-delivery-simples/blob/main/delivery/pix.py): `delivery/pix.py`
- [Coupon rules](https://github.com/joaoaasoares/fabao-delivery-simples/blob/main/delivery/coupons.py): `delivery/coupons.py`

### Management

- [Catalog management](https://github.com/joaoaasoares/fabao-delivery-simples/blob/main/delivery/admin.py): `delivery/admin.py`
- [Sales reports](https://github.com/joaoaasoares/fabao-delivery-simples/blob/main/delivery/reports.py): `delivery/reports.py`
- [Customer contact](https://github.com/joaoaasoares/fabao-delivery-simples/blob/main/delivery/contact.py): `delivery/contact.py`
- [Photo processing](https://github.com/joaoaasoares/fabao-delivery-simples/blob/main/delivery/images.py): `delivery/images.py`
- [Photo cleanup](https://github.com/joaoaasoares/fabao-delivery-simples/blob/main/delivery/photo_storage.py): `delivery/photo_storage.py`

### Domain data

- [Domain records](https://github.com/joaoaasoares/fabao-delivery-simples/blob/main/delivery/models.py): `delivery/models.py`

### Other components

- **Customer**
- **Staff**
- **ViaCEP**

## Connections

- Customer → HTTP routes: browses and orders (evidence: `README.md`)
- HTTP routes → Menu and cart: routes storefront (evidence: `config/urls.py`)
- HTTP routes → Checkout: routes checkout (evidence: `config/urls.py`)
- HTTP routes → Order tracking: routes tracking (evidence: `config/urls.py`)
- HTTP routes → Kitchen actions: routes kitchen (evidence: `config/urls.py`)
- HTTP routes → Courier panel: routes courier (evidence: `config/urls.py`)
- HTTP routes → Geography API: routes geography (evidence: `config/urls.py`)
- HTTP routes → Sales reports: routes reports (evidence: `config/urls.py`)
- Menu and cart → Order services: quotes cart (evidence: `delivery/views.py`)
- Checkout → Order forms: validates input (evidence: `delivery/views.py`)
- Checkout → Order services: places order (evidence: `delivery/views.py`)
- Order forms → Coverage rules: checks coverage (evidence: `delivery/forms.py`)
- Order forms → Postal lookup: verifies CEP (evidence: `delivery/forms.py`)
- Order forms → Geography API: resolves municipality (evidence: `delivery/forms.py`)
- Order services → Domain records: reads and writes (evidence: `delivery/services.py`)
- Order services → Coverage rules: validates delivery (evidence: `delivery/services.py`)
- Order services → Coupon rules: applies discounts (evidence: `delivery/services.py`)
- Order services → PIX generation: checks PIX setup (evidence: `delivery/services.py`)
- Postal lookup → ViaCEP: queries CEP (evidence: `delivery/postal.py`)
- Coverage rules → Postal lookup: checks verification (evidence: `delivery/coverage.py`)
- Coverage rules → Domain records: reads delivery zones (evidence: `delivery/coverage.py`)
- Geography API → Postal lookup: looks up postal data (evidence: `delivery/geography.py`)
- Geography API → Domain records: reads zones (evidence: `delivery/geography.py`)
- Kitchen actions → Order services: updates order state (evidence: `delivery/views.py`)
- Courier panel → Domain records: shows active deliveries (evidence: `README.md`)
- Order tracking → PIX generation: shows payment QR (evidence: `README.md`)
- Staff → Catalog management: manages catalog (evidence: `README.md`)
- Staff → Sales reports: reviews sales (evidence: `README.md`)
- Catalog management → Domain records: manages records (evidence: `delivery/admin.py`)
- Catalog management → Order forms: uses admin forms (evidence: `delivery/admin.py`)
- Catalog management → Photo cleanup: cleans photos (evidence: `delivery/admin.py`)
- Order forms → Photo processing: optimizes uploads (evidence: `delivery/forms.py`)
- Photo cleanup → Domain records: checks references (evidence: `delivery/photo_storage.py`)
- Sales reports → Domain records: queries order data (evidence: `delivery/reports.py`)
- Menu and cart → Customer contact: offers support contact (evidence: `README.md`)
