# aladino24/salesgo architecture

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

- Interactive diagram: https://gitdiagram.com/aladino24/salesgo
- Repository: https://github.com/aladino24/salesgo

## Overview

SalesGo is a Flutter mobile sales-force-automation app. Its repository organizes field-sales work around authentication, outlet and visit activity, sales transactions, and operational follow-up; supporting capabilities include offline synchronization, GPS, approvals, notifications, and reporting. The README is a generic Flutter starter description, and the sampled source contains platform launchers rather than Dart runtime code, so component connections below are limited to the product entry point and documented external integrations; internal feature wiring is not asserted.

Main entry points: [`lib/main.dart`](https://github.com/aladino24/salesgo/blob/main/lib/main.dart) (Flutter app), [`lib/modules/visit`](https://github.com/aladino24/salesgo/tree/main/lib/modules/visit) (Visits and GPS)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_field["Field Work"]
  node_outlet["Outlet management"]
  node_journey["Journey planning"]
  node_visit["Visits and GPS"]
  node_meeting["Meetings"]
end

subgraph group_sales["Sales Operations"]
  node_orders["Sales orders"]
  node_payments["Payments"]
  node_delivery["Delivery notes"]
  node_promotions["Promotion control"]
  node_approval["Approvals"]
  node_reports["Reports"]
end

subgraph group_platform["App Platform"]
  node_app["Flutter app<br/>[main.dart]"]
  node_auth["Sign-in"]
  node_home["Home dashboard"]
  node_sync["Offline sync"]
end

subgraph group_services["Data Services"]
  node_local[("Local data")]
  node_api["Backend API"]
end

node_rep(("Sales representative"))
node_gps(("Device location"))
node_push["Push messaging"]

node_rep -->|"uses"| node_app
node_gps -.->|"provides location"| node_visit
node_push -.->|"delivers alerts"| node_app

click node_app "https://github.com/aladino24/salesgo/blob/main/lib/main.dart"
click node_auth "https://github.com/aladino24/salesgo/tree/main/lib/modules/auth"
click node_home "https://github.com/aladino24/salesgo/tree/main/lib/modules/home"
click node_outlet "https://github.com/aladino24/salesgo/tree/main/lib/modules/outlet"
click node_journey "https://github.com/aladino24/salesgo/tree/main/lib/modules/journey"
click node_visit "https://github.com/aladino24/salesgo/tree/main/lib/modules/visit"
click node_meeting "https://github.com/aladino24/salesgo/tree/main/lib/modules/meeting"
click node_orders "https://github.com/aladino24/salesgo/tree/main/lib/modules/sales"
click node_payments "https://github.com/aladino24/salesgo/tree/main/lib/modules/payment"
click node_delivery "https://github.com/aladino24/salesgo/tree/main/lib/modules/delivery_note"
click node_promotions "https://github.com/aladino24/salesgo/tree/main/lib/modules/promotion"
click node_approval "https://github.com/aladino24/salesgo/tree/main/lib/modules/approval"
click node_reports "https://github.com/aladino24/salesgo/tree/main/lib/modules/reports"
click node_sync "https://github.com/aladino24/salesgo/tree/main/lib/core/sync"
click node_local "https://github.com/aladino24/salesgo/tree/main/lib/core/storage"
click node_api "https://github.com/aladino24/salesgo/tree/main/lib/core/network"

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_outlet,node_journey,node_visit,node_meeting toneBlue
class node_orders,node_payments,node_delivery,node_promotions,node_approval,node_reports toneAmber
class node_app,node_auth,node_home,node_sync toneMint
class node_local,node_api toneRose
class node_rep,node_gps,node_push toneIndigo
```

## Components

### Field Work

- [Outlet management](https://github.com/aladino24/salesgo/tree/main/lib/modules/outlet): `lib/modules/outlet`
- [Journey planning](https://github.com/aladino24/salesgo/tree/main/lib/modules/journey): `lib/modules/journey`
- [Visits and GPS](https://github.com/aladino24/salesgo/tree/main/lib/modules/visit): `lib/modules/visit`
- [Meetings](https://github.com/aladino24/salesgo/tree/main/lib/modules/meeting): `lib/modules/meeting`

### Sales Operations

- [Sales orders](https://github.com/aladino24/salesgo/tree/main/lib/modules/sales): `lib/modules/sales`
- [Payments](https://github.com/aladino24/salesgo/tree/main/lib/modules/payment): `lib/modules/payment`
- [Delivery notes](https://github.com/aladino24/salesgo/tree/main/lib/modules/delivery_note): `lib/modules/delivery_note`
- [Promotion control](https://github.com/aladino24/salesgo/tree/main/lib/modules/promotion): `lib/modules/promotion`
- [Approvals](https://github.com/aladino24/salesgo/tree/main/lib/modules/approval): `lib/modules/approval`
- [Reports](https://github.com/aladino24/salesgo/tree/main/lib/modules/reports): `lib/modules/reports`

### App Platform

- [Flutter app](https://github.com/aladino24/salesgo/blob/main/lib/main.dart): `lib/main.dart`
- [Sign-in](https://github.com/aladino24/salesgo/tree/main/lib/modules/auth): `lib/modules/auth`
- [Home dashboard](https://github.com/aladino24/salesgo/tree/main/lib/modules/home): `lib/modules/home`
- [Offline sync](https://github.com/aladino24/salesgo/tree/main/lib/core/sync): `lib/core/sync`

### Data Services

- [Local data](https://github.com/aladino24/salesgo/tree/main/lib/core/storage): `lib/core/storage`
- [Backend API](https://github.com/aladino24/salesgo/tree/main/lib/core/network): `lib/core/network`

### Other components

- **Sales representative**
- **Device location**
- **Push messaging**

## Connections

- Sales representative → Flutter app: uses
- Device location → Visits and GPS: provides location
- Push messaging → Flutter app: delivers alerts