Skip to main content

​
Overview

EnvaSistema uses a hierarchical navigation structure that guides you from the main menu to specific warehouse operations. The app is designed for efficient, touch-friendly navigation on warehouse handheld terminals. When you first launch the app, you’ll see the home screen with four main operation categories:

INGRESOS

Production, assembly, and returns

SALIDAS

Sales, packages, waste, and donations

MOVIMIENTOS

Transfers between locations

TRANSFORMACIONES

Disassemble finished product packages
The navigation system is implemented in AppNavigation.kt:36-105 using Jetpack Compose’s NavHost: 
NavHost(navController = navController, startDestination = Screen.Home.route) {
    composable(Screen.Home.route) {
        HomeScreen(
            onIngresosClick = { navController.navigate(Screen.Ingresos.route) },
            onSalidasClick = { navController.navigate(Screen.Salidas.route) },
            // ...
        )
    }
}

​
Home Screen Elements

1

Status Bar

Located at the top-right, shows:
  • Connection status: Green indicator with terminal ID (e.g., “C66 · ONLINE”)
  • User badge: Shows current logged-in user (e.g., “J. PÉREZ”)
  • Logout button: Tap to sign out of your session
2

Header Section

Displays:
  • System title: “SISTEMA DE GESTIÓN”
  • App name: “Gestión de Almacén Móvil”
3

Date and Shift Info

Shows the current date and active shift (e.g., “Turno Mañana”, “Turno Tarde”)
4

Operation Menu

Four large, easy-to-tap cards for main operations

​
Header Component

The home header (HomeHeader.kt:23-132) provides essential session information: 
HomeHeader(
    statusText = "C66 · ONLINE",
    userName = "J. PÉREZ",
    onLogoutClick = { /* Logout logic */ }
)

​
Ingresos (Receipts) Navigation

Tapping INGRESOS takes you to a submenu with four receipt operation types:

Producción Nueva

New products from production

Ingreso de Armado

Pre-assembled pieces and sleeves

Devolución no Armado

Unassembled piece returns to stock

Devolución de Mercadería

Customer returns (requires invoice number)
Each operation has a descriptive subtitle to help you choose the correct type quickly.

​
Salidas (Issues) Navigation

Tapping SALIDAS takes you to a submenu with four issue operation types:

Venta de PT

Finished product sales

Armar Paquetes

Group pieces into packages for dispatch

Merma (Molino)

Inventory destruction (irreversible)

Donaciones

External cost centers or donations
The Merma (Molino) operation is highlighted in red with warning indicators. This operation permanently destroys inventory and cannot be reversed. It requires supervisor confirmation.

​
Movimientos (Transfers) Navigation

Tapping MOVIMIENTOS takes you directly to:
  • Transferencia de Inventario: Transfer items between warehouse locations

​
Transformaciones (Transformations) Navigation

Tapping TRANSFORMACIONES takes you directly to:
  • Desarmar Paquetes: Disassemble finished product packages back into individual pieces

​
Back Navigation

All secondary screens include a back button in the header:
The back button is always located in the top-left corner of colored header bars. Tap it to return to the previous screen.
SecondaryHeader(
    title = "Ingresos",
    subtitle = "Seleccione el tipo de ingreso",
    onBackClick = { navController.popBackStack() }
)
All menu items are presented as large, touch-friendly cards (MenuCard.kt:19-99) with:
  • Left accent strip: Color-coded by operation type
  • Icon section: Visual identifier with colored background
  • Title and subtitle: Clear operation name and description
  • Right arrow: Indicates the card is tappable
Cards are sized at 100dp height for easy tapping with gloved hands on warehouse terminals.

​
Screen Routes

The app uses the following route structure (defined in AppNavigation.kt:13-33):
RouteScreenAccess From
homeHome ScreenApp start
ingresosReceipts MenuHome
produccion_nuevaNew ProductionIngresos
ingreso_armadoAssembly ReceiptIngresos
devolucion_no_armadoUnassembled ReturnIngresos
devolucion_mercaderiaMerchandise ReturnIngresos
salidasIssues MenuHome
venta_ptFinished Product SaleSalidas
armar_paquetesPackage AssemblySalidas
merma_molinoWaste (Destruction)Salidas
donacionesDonationsSalidas
movimientosInventory TransferHome
transformacionesDisassemble PackagesHome

​
Best Practices

Quick Navigation: Familiarize yourself with the menu structure to navigate quickly during busy shifts. All operations are just 2 taps away from the home screen.
Check Your Session: Always verify your user name and shift information in the header before starting operations.
Read Subtitles: Menu card subtitles provide important context about each operation. Take a moment to read them before selecting.

​
Troubleshooting

If the back button becomes unresponsive, try navigating to the home screen using the app’s main menu. If the issue persists, restart the app.
Simply use the back button in the header to return to the previous menu and select the correct operation.
If the status changes from “ONLINE” to “OFFLINE”, the terminal has lost network connectivity. Some operations may be restricted. Contact IT support if the issue persists.

​
Next Steps

Barcode Scanning

Learn how to scan items efficiently

Shift Management

Understand shift information and user sessions

Build docs developers (and LLMs) love

Get started for freeTalk to us