# spixxxx/saritracker architecture

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

- Interactive diagram: https://gitdiagram.com/spixxxx/saritracker
- Repository: https://github.com/spixxxx/saritracker

## Overview

This is a Flutter application named Sari Track. Its source tree suggests an inventory-tracking product with authentication, stock adjustment, scanning, dashboard metrics, and finance/export capabilities. The intended user journey appears to run from sign-in through inventory work to reporting, but the README is only Flutter boilerplate and no Dart source excerpts were provided. Components below are therefore identified from exact tree paths; their calls, data flow, and external integrations cannot be verified.

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App navigation"]
  node_entry["App entry<br/>[main.dart]"]
  node_navigation["Main navigation"]
  node_login["Sign in<br/>[login_screen.dart]"]
end

subgraph group_inventory["Inventory operations"]
  node_inventory_screen["Inventory view"]
  node_adjustment["Stock adjustment"]
  node_scanner["Scanner screen"]
  node_product_card["Product card<br/>[product_card.dart]"]
end

subgraph group_insights["Finance and reporting"]
  node_dashboard["Dashboard"]
  node_finance["Finance service"]
  node_profit["Profit calculation"]
  node_export["Data export"]
  node_metric_card["Metric card<br/>[metric_card.dart]"]
  node_profit_chart["Profit chart"]
end

subgraph group_foundation["Data and presentation"]
  node_auth["Authentication<br/>[auth_service.dart]"]
  node_product["Product model<br/>[product.dart]"]
  node_movement["Stock movement"]
  node_adjustment_type["Adjustment types"]
  node_profile["User profile<br/>[user_profile.dart]"]
  node_database["Database service"]
end

node_user(("User"))

click node_entry "https://github.com/spixxxx/saritracker/blob/main/lib/main.dart"
click node_navigation "https://github.com/spixxxx/saritracker/blob/main/lib/screens/main_navigation_controller.dart"
click node_login "https://github.com/spixxxx/saritracker/blob/main/lib/screens/login_screen.dart"
click node_auth "https://github.com/spixxxx/saritracker/blob/main/lib/services/auth_service.dart"
click node_dashboard "https://github.com/spixxxx/saritracker/blob/main/lib/screens/dashboard_screen.dart"
click node_inventory_screen "https://github.com/spixxxx/saritracker/blob/main/lib/screens/inventory_screen.dart"
click node_adjustment "https://github.com/spixxxx/saritracker/blob/main/lib/screens/stock_adjustment_screen.dart"
click node_scanner "https://github.com/spixxxx/saritracker/blob/main/lib/screens/scanner_test_screen.dart"
click node_product "https://github.com/spixxxx/saritracker/blob/main/lib/models/product.dart"
click node_movement "https://github.com/spixxxx/saritracker/blob/main/lib/models/stock_movement.dart"
click node_adjustment_type "https://github.com/spixxxx/saritracker/blob/main/lib/models/adjustment_type.dart"
click node_profile "https://github.com/spixxxx/saritracker/blob/main/lib/models/user_profile.dart"
click node_database "https://github.com/spixxxx/saritracker/blob/main/lib/services/database_service.dart"
click node_finance "https://github.com/spixxxx/saritracker/blob/main/lib/services/finance_service.dart"
click node_profit "https://github.com/spixxxx/saritracker/blob/main/lib/services/profit_calculator.dart"
click node_export "https://github.com/spixxxx/saritracker/blob/main/lib/services/export_service.dart"
click node_metric_card "https://github.com/spixxxx/saritracker/blob/main/lib/widgets/metric_card.dart"
click node_profit_chart "https://github.com/spixxxx/saritracker/blob/main/lib/widgets/profit_line_chart.dart"
click node_product_card "https://github.com/spixxxx/saritracker/blob/main/lib/widgets/product_card.dart"

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_entry,node_navigation,node_login,node_user toneBlue
class node_inventory_screen,node_adjustment,node_scanner,node_product_card toneAmber
class node_dashboard,node_finance,node_profit,node_export,node_metric_card,node_profit_chart toneMint
class node_auth,node_product,node_movement,node_adjustment_type,node_profile,node_database toneRose
```

## Components

### App navigation

- [App entry](https://github.com/spixxxx/saritracker/blob/main/lib/main.dart): `lib/main.dart`
- [Main navigation](https://github.com/spixxxx/saritracker/blob/main/lib/screens/main_navigation_controller.dart): `lib/screens/main_navigation_controller.dart`
- [Sign in](https://github.com/spixxxx/saritracker/blob/main/lib/screens/login_screen.dart): `lib/screens/login_screen.dart`

### Inventory operations

- [Inventory view](https://github.com/spixxxx/saritracker/blob/main/lib/screens/inventory_screen.dart): `lib/screens/inventory_screen.dart`
- [Stock adjustment](https://github.com/spixxxx/saritracker/blob/main/lib/screens/stock_adjustment_screen.dart): `lib/screens/stock_adjustment_screen.dart`
- [Scanner screen](https://github.com/spixxxx/saritracker/blob/main/lib/screens/scanner_test_screen.dart): `lib/screens/scanner_test_screen.dart`
- [Product card](https://github.com/spixxxx/saritracker/blob/main/lib/widgets/product_card.dart): `lib/widgets/product_card.dart`

### Finance and reporting

- [Dashboard](https://github.com/spixxxx/saritracker/blob/main/lib/screens/dashboard_screen.dart): `lib/screens/dashboard_screen.dart`
- [Finance service](https://github.com/spixxxx/saritracker/blob/main/lib/services/finance_service.dart): `lib/services/finance_service.dart`
- [Profit calculation](https://github.com/spixxxx/saritracker/blob/main/lib/services/profit_calculator.dart): `lib/services/profit_calculator.dart`
- [Data export](https://github.com/spixxxx/saritracker/blob/main/lib/services/export_service.dart): `lib/services/export_service.dart`
- [Metric card](https://github.com/spixxxx/saritracker/blob/main/lib/widgets/metric_card.dart): `lib/widgets/metric_card.dart`
- [Profit chart](https://github.com/spixxxx/saritracker/blob/main/lib/widgets/profit_line_chart.dart): `lib/widgets/profit_line_chart.dart`

### Data and presentation

- [Authentication](https://github.com/spixxxx/saritracker/blob/main/lib/services/auth_service.dart): `lib/services/auth_service.dart`
- [Product model](https://github.com/spixxxx/saritracker/blob/main/lib/models/product.dart): `lib/models/product.dart`
- [Stock movement](https://github.com/spixxxx/saritracker/blob/main/lib/models/stock_movement.dart): `lib/models/stock_movement.dart`
- [Adjustment types](https://github.com/spixxxx/saritracker/blob/main/lib/models/adjustment_type.dart): `lib/models/adjustment_type.dart`
- [User profile](https://github.com/spixxxx/saritracker/blob/main/lib/models/user_profile.dart): `lib/models/user_profile.dart`
- [Database service](https://github.com/spixxxx/saritracker/blob/main/lib/services/database_service.dart): `lib/services/database_service.dart`

### Other components

- **User**