# miicchhel/fruittrace architecture

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

- Interactive diagram: https://gitdiagram.com/miicchhel/fruittrace
- Repository: https://github.com/miicchhel/fruittrace

## Overview

FruitTrace is a Flutter fruit-store app. The documented customer journey is account sign-in or registration, browsing and filtering fruit, choosing quantities, managing a cart, tracking orders and paying open orders; users can also view their profile, update a password, and log out. The README describes these capabilities, but Dart implementation excerpts were not provided, so edges between app screens and services are limited to documented relationships. Native desktop launch code is represented as host infrastructure, not as part of the shopping workflow.

Main entry points: [`lib/src/pages/home/home_tab.dart`](https://github.com/miicchhel/fruittrace/blob/main/lib/src/pages/home/home_tab.dart) (Home catalog), [`lib/src/pages/orders/orders_tab.dart`](https://github.com/miicchhel/fruittrace/blob/main/lib/src/pages/orders/orders_tab.dart) (Order history), [`lib/main.dart`](https://github.com/miicchhel/fruittrace/blob/main/lib/main.dart) (Flutter app), [`windows/runner`](https://github.com/miicchhel/fruittrace/tree/main/windows/runner) (Desktop host runners)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["App entry"]
  node_app["Flutter app<br/>[main.dart]"]
  node_base["Base screen<br/>[base_screen.dart]"]
  node_sign_in["Sign in"]
  node_sign_up["Sign up"]
end

subgraph group_shopping["Shopping"]
  node_home["Home catalog<br/>[home_tab.dart]"]
  node_category["Category filters<br/>[category_tile.dart]"]
  node_item_tile["Product cards<br/>[item_tile.dart]"]
  node_product["Product details"]
  node_cart["Cart<br/>[cart_tab.dart]"]
  node_cart_item["Cart items<br/>[cart_tile.dart]"]
  node_cart_service["Cart service<br/>[cart_service.dart]"]
  node_item_model["Item model<br/>[item_model.dart]"]
  node_cart_model["Cart item model"]
end

subgraph group_orders["Orders and account"]
  node_orders_tab["Order history<br/>[orders_tab.dart]"]
  node_order_tile["Order cards<br/>[order_tile.dart]"]
  node_order_status["Status timeline"]
  node_payment["Order payment"]
  node_order_model["Order model<br/>[order_model.dart]"]
  node_profile["User profile<br/>[profile_tab.dart]"]
  node_user_model["User model<br/>[user_model.dart]"]
end

subgraph group_platform["Platform hosts"]
  node_desktop_hosts["Desktop host runners"]
  node_linux_host["Linux host"]
end

node_customer(("Customer"))

node_customer -->|"signs in"| node_sign_in
node_customer -->|"registers"| node_sign_up
node_customer -->|"browses"| node_home
node_home -->|"filters by"| node_category
node_home -->|"displays products"| node_item_tile
node_customer -->|"views details"| node_product
node_customer -->|"manages items"| node_cart
node_customer -->|"tracks orders"| node_orders_tab
node_orders_tab -->|"shows timeline"| node_order_status
node_customer -->|"pays open orders"| node_payment
node_customer -->|"manages account"| node_profile
node_desktop_hosts -.->|"hosts Flutter"| node_app
node_linux_host -.->|"hosts Flutter"| node_app

click node_app "https://github.com/miicchhel/fruittrace/blob/main/lib/main.dart"
click node_base "https://github.com/miicchhel/fruittrace/blob/main/lib/src/pages/base/base_screen.dart"
click node_sign_in "https://github.com/miicchhel/fruittrace/blob/main/lib/src/pages/auth/sign_in_screen.dart"
click node_sign_up "https://github.com/miicchhel/fruittrace/blob/main/lib/src/pages/auth/sign_up_screen.dart"
click node_home "https://github.com/miicchhel/fruittrace/blob/main/lib/src/pages/home/home_tab.dart"
click node_category "https://github.com/miicchhel/fruittrace/blob/main/lib/src/pages/home/components/category_tile.dart"
click node_item_tile "https://github.com/miicchhel/fruittrace/blob/main/lib/src/pages/home/components/item_tile.dart"
click node_product "https://github.com/miicchhel/fruittrace/blob/main/lib/src/pages/product/product_screen.dart"
click node_cart "https://github.com/miicchhel/fruittrace/blob/main/lib/src/pages/cart/cart_tab.dart"
click node_cart_item "https://github.com/miicchhel/fruittrace/blob/main/lib/src/pages/cart/components/cart_tile.dart"
click node_cart_service "https://github.com/miicchhel/fruittrace/blob/main/lib/src/services/cart_service.dart"
click node_item_model "https://github.com/miicchhel/fruittrace/blob/main/lib/src/models/item_model.dart"
click node_cart_model "https://github.com/miicchhel/fruittrace/blob/main/lib/src/models/cart_item_model.dart"
click node_orders_tab "https://github.com/miicchhel/fruittrace/blob/main/lib/src/pages/orders/orders_tab.dart"
click node_order_tile "https://github.com/miicchhel/fruittrace/blob/main/lib/src/pages/orders/components/order_tile.dart"
click node_order_status "https://github.com/miicchhel/fruittrace/blob/main/lib/src/pages/orders/components/order_status_widget.dart"
click node_payment "https://github.com/miicchhel/fruittrace/blob/main/lib/src/pages/common_widgets/payment_dialog.dart"
click node_order_model "https://github.com/miicchhel/fruittrace/blob/main/lib/src/models/order_model.dart"
click node_profile "https://github.com/miicchhel/fruittrace/blob/main/lib/src/pages/profile/profile_tab.dart"
click node_user_model "https://github.com/miicchhel/fruittrace/blob/main/lib/src/models/user_model.dart"
click node_desktop_hosts "https://github.com/miicchhel/fruittrace/tree/main/windows/runner"
click node_linux_host "https://github.com/miicchhel/fruittrace/tree/main/linux"

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_app,node_base,node_sign_in,node_sign_up toneBlue
class node_home,node_category,node_item_tile,node_product,node_cart,node_cart_item,node_cart_service,node_item_model,node_cart_model toneAmber
class node_orders_tab,node_order_tile,node_order_status,node_payment,node_order_model,node_profile,node_user_model toneMint
class node_desktop_hosts,node_linux_host toneRose
class node_customer toneIndigo
```

## Components

### App entry

- [Flutter app](https://github.com/miicchhel/fruittrace/blob/main/lib/main.dart): `lib/main.dart`
- [Base screen](https://github.com/miicchhel/fruittrace/blob/main/lib/src/pages/base/base_screen.dart): `lib/src/pages/base/base_screen.dart`
- [Sign in](https://github.com/miicchhel/fruittrace/blob/main/lib/src/pages/auth/sign_in_screen.dart): `lib/src/pages/auth/sign_in_screen.dart`
- [Sign up](https://github.com/miicchhel/fruittrace/blob/main/lib/src/pages/auth/sign_up_screen.dart): `lib/src/pages/auth/sign_up_screen.dart`

### Shopping

- [Home catalog](https://github.com/miicchhel/fruittrace/blob/main/lib/src/pages/home/home_tab.dart): `lib/src/pages/home/home_tab.dart`
- [Category filters](https://github.com/miicchhel/fruittrace/blob/main/lib/src/pages/home/components/category_tile.dart): `lib/src/pages/home/components/category_tile.dart`
- [Product cards](https://github.com/miicchhel/fruittrace/blob/main/lib/src/pages/home/components/item_tile.dart): `lib/src/pages/home/components/item_tile.dart`
- [Product details](https://github.com/miicchhel/fruittrace/blob/main/lib/src/pages/product/product_screen.dart): `lib/src/pages/product/product_screen.dart`
- [Cart](https://github.com/miicchhel/fruittrace/blob/main/lib/src/pages/cart/cart_tab.dart): `lib/src/pages/cart/cart_tab.dart`
- [Cart items](https://github.com/miicchhel/fruittrace/blob/main/lib/src/pages/cart/components/cart_tile.dart): `lib/src/pages/cart/components/cart_tile.dart`
- [Cart service](https://github.com/miicchhel/fruittrace/blob/main/lib/src/services/cart_service.dart): `lib/src/services/cart_service.dart`
- [Item model](https://github.com/miicchhel/fruittrace/blob/main/lib/src/models/item_model.dart): `lib/src/models/item_model.dart`
- [Cart item model](https://github.com/miicchhel/fruittrace/blob/main/lib/src/models/cart_item_model.dart): `lib/src/models/cart_item_model.dart`

### Orders and account

- [Order history](https://github.com/miicchhel/fruittrace/blob/main/lib/src/pages/orders/orders_tab.dart): `lib/src/pages/orders/orders_tab.dart`
- [Order cards](https://github.com/miicchhel/fruittrace/blob/main/lib/src/pages/orders/components/order_tile.dart): `lib/src/pages/orders/components/order_tile.dart`
- [Status timeline](https://github.com/miicchhel/fruittrace/blob/main/lib/src/pages/orders/components/order_status_widget.dart): `lib/src/pages/orders/components/order_status_widget.dart`
- [Order payment](https://github.com/miicchhel/fruittrace/blob/main/lib/src/pages/common_widgets/payment_dialog.dart): `lib/src/pages/common_widgets/payment_dialog.dart`
- [Order model](https://github.com/miicchhel/fruittrace/blob/main/lib/src/models/order_model.dart): `lib/src/models/order_model.dart`
- [User profile](https://github.com/miicchhel/fruittrace/blob/main/lib/src/pages/profile/profile_tab.dart): `lib/src/pages/profile/profile_tab.dart`
- [User model](https://github.com/miicchhel/fruittrace/blob/main/lib/src/models/user_model.dart): `lib/src/models/user_model.dart`

### Platform hosts

- [Desktop host runners](https://github.com/miicchhel/fruittrace/tree/main/windows/runner): `windows/runner`
- [Linux host](https://github.com/miicchhel/fruittrace/tree/main/linux): `linux`

### Other components

- **Customer**

## Connections

- Customer → Sign in: signs in (evidence: `README.md`)
- Customer → Sign up: registers (evidence: `README.md`)
- Customer → Home catalog: browses (evidence: `README.md`)
- Home catalog → Category filters: filters by (evidence: `README.md`)
- Home catalog → Product cards: displays products (evidence: `README.md`)
- Customer → Product details: views details (evidence: `README.md`)
- Customer → Cart: manages items (evidence: `README.md`)
- Customer → Order history: tracks orders (evidence: `README.md`)
- Order history → Status timeline: shows timeline (evidence: `README.md`)
- Customer → Order payment: pays open orders (evidence: `README.md`)
- Customer → User profile: manages account (evidence: `README.md`)
- Desktop host runners → Flutter app: hosts Flutter
- Linux host → Flutter app: hosts Flutter
