# robsonissomoto/projeto-inventario-patrimonial-frontend architecture

> Architecture diagram of the GitHub repository robsonissomoto/projeto-inventario-patrimonial-frontend, 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/robsonissomoto/projeto-inventario-patrimonial-frontend
- Repository: https://github.com/robsonissomoto/projeto-inventario-patrimonial-frontend

## Overview

This is a Flutter mobile frontend for physical asset inventory and patrimonial management. Its documented user workflow is to enter the main app, navigate among home, inventory, and profile, inspect assets, open the scanner on a separate route, add observations, and start a transfer. The tree also shows login, receiving, movement history, and service/data layers. Source excerpts do not cover Dart runtime code, so internal call relationships and backend integration are not asserted; the API connection is documented as still in development.

Main entry points: [`lib/views/pages/home_page.dart`](https://github.com/robsonissomoto/projeto-inventario-patrimonial-frontend/blob/main/lib/views/pages/home_page.dart) (Home and menu), [`lib/main.dart`](https://github.com/robsonissomoto/projeto-inventario-patrimonial-frontend/blob/main/lib/main.dart) (App entry), [`lib/views/pages/inventario_page.dart`](https://github.com/robsonissomoto/projeto-inventario-patrimonial-frontend/blob/main/lib/views/pages/inventario_page.dart) (Inventory screen), [`lib/data/network/api_requester.dart`](https://github.com/robsonissomoto/projeto-inventario-patrimonial-frontend/blob/main/lib/data/network/api_requester.dart) (API requester)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App navigation"]
  node_entry["App entry<br/>[main.dart]"]
  node_home["Home and menu<br/>[home_page.dart]"]
  node_start["Inicio screen<br/>[inicio_page.dart]"]
  node_login["Login screen<br/>[login_page.dart]"]
  node_profile["Profile screen<br/>[profile_page.dart]"]
  node_profilevm["Profile state"]
end

subgraph group_assets["Asset workflows"]
  node_inventory["Inventory screen"]
  node_inventoryvm["Inventory state"]
  node_scanner["Asset scanner<br/>[scanner_page.dart]"]
  node_detail["Asset details"]
  node_transfer["Asset transfer"]
  node_receiving["Asset receiving"]
  node_receivingvm["Receiving state"]
  node_history["Movement history"]
  node_movementvm["Movement state"]
end

subgraph group_data["Data and services"]
  node_assetmodel["Asset model<br/>[patrimonio.dart]"]
  node_assetservice["Asset service"]
  node_assetrepo["Asset repository"]
  node_requester["API requester<br/>[api_requester.dart]"]
end

node_user(("Mobile user"))
node_api{{"Backend REST API"}}

node_user -->|"opens app"| node_entry
node_entry -.->|"navigates to"| node_home
node_home -->|"offers section"| node_start
node_home -->|"offers section"| node_inventory
node_home -->|"offers section"| node_profile
node_user -->|"opens separate route"| node_scanner
node_user -->|"starts transfer"| node_transfer
node_user -->|"adds observation"| node_detail
node_inventory -.->|"displays assets"| node_assetmodel
node_assetservice -.->|"uses requester"| node_requester
node_requester -.->|"calls REST API"| node_api

click node_entry "https://github.com/robsonissomoto/projeto-inventario-patrimonial-frontend/blob/main/lib/main.dart"
click node_home "https://github.com/robsonissomoto/projeto-inventario-patrimonial-frontend/blob/main/lib/views/pages/home_page.dart"
click node_start "https://github.com/robsonissomoto/projeto-inventario-patrimonial-frontend/blob/main/lib/views/pages/inicio_page.dart"
click node_login "https://github.com/robsonissomoto/projeto-inventario-patrimonial-frontend/blob/main/lib/views/pages/login_page.dart"
click node_profile "https://github.com/robsonissomoto/projeto-inventario-patrimonial-frontend/blob/main/lib/views/pages/profile_page.dart"
click node_profilevm "https://github.com/robsonissomoto/projeto-inventario-patrimonial-frontend/blob/main/lib/viewmodels/perfil_viewmodel.dart"
click node_inventory "https://github.com/robsonissomoto/projeto-inventario-patrimonial-frontend/blob/main/lib/views/pages/inventario_page.dart"
click node_inventoryvm "https://github.com/robsonissomoto/projeto-inventario-patrimonial-frontend/blob/main/lib/viewmodels/inventario_viewmodel.dart"
click node_scanner "https://github.com/robsonissomoto/projeto-inventario-patrimonial-frontend/blob/main/lib/views/pages/scanner_page.dart"
click node_detail "https://github.com/robsonissomoto/projeto-inventario-patrimonial-frontend/blob/main/lib/views/pages/patrimonio_detail.dart"
click node_transfer "https://github.com/robsonissomoto/projeto-inventario-patrimonial-frontend/blob/main/lib/views/pages/transferencia_page.dart"
click node_receiving "https://github.com/robsonissomoto/projeto-inventario-patrimonial-frontend/blob/main/lib/views/pages/recebimentos_page.dart"
click node_receivingvm "https://github.com/robsonissomoto/projeto-inventario-patrimonial-frontend/blob/main/lib/viewmodels/recebimento_viewmodel.dart"
click node_history "https://github.com/robsonissomoto/projeto-inventario-patrimonial-frontend/blob/main/lib/views/pages/historico_movimentacoes_page.dart"
click node_movementvm "https://github.com/robsonissomoto/projeto-inventario-patrimonial-frontend/blob/main/lib/viewmodels/movimentacao_viewmodel.dart"
click node_assetmodel "https://github.com/robsonissomoto/projeto-inventario-patrimonial-frontend/blob/main/lib/models/patrimonio.dart"
click node_assetservice "https://github.com/robsonissomoto/projeto-inventario-patrimonial-frontend/blob/main/lib/services/patrimonio_service.dart"
click node_assetrepo "https://github.com/robsonissomoto/projeto-inventario-patrimonial-frontend/blob/main/lib/repositories/patrimonio_repository.dart"
click node_requester "https://github.com/robsonissomoto/projeto-inventario-patrimonial-frontend/blob/main/lib/data/network/api_requester.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_home,node_start,node_login,node_profile,node_profilevm,node_user toneBlue
class node_inventory,node_inventoryvm,node_scanner,node_detail,node_transfer,node_receiving,node_receivingvm,node_history,node_movementvm toneAmber
class node_assetmodel,node_assetservice,node_assetrepo,node_requester,node_api toneMint
```

## Components

### App navigation

- [App entry](https://github.com/robsonissomoto/projeto-inventario-patrimonial-frontend/blob/main/lib/main.dart): `lib/main.dart`
- [Home and menu](https://github.com/robsonissomoto/projeto-inventario-patrimonial-frontend/blob/main/lib/views/pages/home_page.dart): `lib/views/pages/home_page.dart`
- [Inicio screen](https://github.com/robsonissomoto/projeto-inventario-patrimonial-frontend/blob/main/lib/views/pages/inicio_page.dart): `lib/views/pages/inicio_page.dart`
- [Login screen](https://github.com/robsonissomoto/projeto-inventario-patrimonial-frontend/blob/main/lib/views/pages/login_page.dart): `lib/views/pages/login_page.dart`
- [Profile screen](https://github.com/robsonissomoto/projeto-inventario-patrimonial-frontend/blob/main/lib/views/pages/profile_page.dart): `lib/views/pages/profile_page.dart`
- [Profile state](https://github.com/robsonissomoto/projeto-inventario-patrimonial-frontend/blob/main/lib/viewmodels/perfil_viewmodel.dart): `lib/viewmodels/perfil_viewmodel.dart`

### Asset workflows

- [Inventory screen](https://github.com/robsonissomoto/projeto-inventario-patrimonial-frontend/blob/main/lib/views/pages/inventario_page.dart): `lib/views/pages/inventario_page.dart`
- [Inventory state](https://github.com/robsonissomoto/projeto-inventario-patrimonial-frontend/blob/main/lib/viewmodels/inventario_viewmodel.dart): `lib/viewmodels/inventario_viewmodel.dart`
- [Asset scanner](https://github.com/robsonissomoto/projeto-inventario-patrimonial-frontend/blob/main/lib/views/pages/scanner_page.dart): `lib/views/pages/scanner_page.dart`
- [Asset details](https://github.com/robsonissomoto/projeto-inventario-patrimonial-frontend/blob/main/lib/views/pages/patrimonio_detail.dart): `lib/views/pages/patrimonio_detail.dart`
- [Asset transfer](https://github.com/robsonissomoto/projeto-inventario-patrimonial-frontend/blob/main/lib/views/pages/transferencia_page.dart): `lib/views/pages/transferencia_page.dart`
- [Asset receiving](https://github.com/robsonissomoto/projeto-inventario-patrimonial-frontend/blob/main/lib/views/pages/recebimentos_page.dart): `lib/views/pages/recebimentos_page.dart`
- [Receiving state](https://github.com/robsonissomoto/projeto-inventario-patrimonial-frontend/blob/main/lib/viewmodels/recebimento_viewmodel.dart): `lib/viewmodels/recebimento_viewmodel.dart`
- [Movement history](https://github.com/robsonissomoto/projeto-inventario-patrimonial-frontend/blob/main/lib/views/pages/historico_movimentacoes_page.dart): `lib/views/pages/historico_movimentacoes_page.dart`
- [Movement state](https://github.com/robsonissomoto/projeto-inventario-patrimonial-frontend/blob/main/lib/viewmodels/movimentacao_viewmodel.dart): `lib/viewmodels/movimentacao_viewmodel.dart`

### Data and services

- [Asset model](https://github.com/robsonissomoto/projeto-inventario-patrimonial-frontend/blob/main/lib/models/patrimonio.dart): `lib/models/patrimonio.dart`
- [Asset service](https://github.com/robsonissomoto/projeto-inventario-patrimonial-frontend/blob/main/lib/services/patrimonio_service.dart): `lib/services/patrimonio_service.dart`
- [Asset repository](https://github.com/robsonissomoto/projeto-inventario-patrimonial-frontend/blob/main/lib/repositories/patrimonio_repository.dart): `lib/repositories/patrimonio_repository.dart`
- [API requester](https://github.com/robsonissomoto/projeto-inventario-patrimonial-frontend/blob/main/lib/data/network/api_requester.dart): `lib/data/network/api_requester.dart`

### Other components

- **Mobile user**
- **Backend REST API**

## Connections

- Mobile user → App entry: opens app (evidence: `README.md`)
- App entry → Home and menu: navigates to
- Home and menu → Inicio screen: offers section (evidence: `README.md`)
- Home and menu → Inventory screen: offers section (evidence: `README.md`)
- Home and menu → Profile screen: offers section (evidence: `README.md`)
- Mobile user → Asset scanner: opens separate route (evidence: `README.md`)
- Mobile user → Asset transfer: starts transfer (evidence: `README.md`)
- Mobile user → Asset details: adds observation (evidence: `README.md`)
- Inventory screen → Asset model: displays assets
- Asset service → API requester: uses requester
- API requester → Backend REST API: calls REST API
