Skip to main content

Overview

EnvaSistema tracks user sessions and shift information to ensure proper accountability for warehouse operations. Each transaction is associated with a specific user and shift for auditing purposes.

User Session Information

When you’re logged into the app, your session information is always visible in the home header.

Status Badge

The status badge appears in the top-left of the home screen (HomeHeader.kt:46-68):
Surface(
    color = Color.White.copy(alpha = 0.15f),
    shape = RoundedCornerShape(20.dp)
) {
    Row {
        Box(
            modifier = Modifier
                .size(8.dp)
                .background(Color(0xFF43A047)) // Green indicator
        )
        Text(text = statusText, color = Color.White) // "C66 · ONLINE"
    }
}
The status badge shows:
  • Terminal ID: Your warehouse terminal identifier (e.g., “C66”)
  • Connection Status: ONLINE (green dot) or OFFLINE (red dot)

User Badge

The user badge displays your logged-in identity (HomeHeader.kt:72-94):
Surface(
    color = Color.White.copy(alpha = 0.15f),
    shape = RoundedCornerShape(20.dp)
) {
    Row {
        Icon(imageVector = Icons.Default.Person)
        Text(text = userName) // "J. PÉREZ"
    }
}
1

Check Your Name

Before starting any operation, verify the user badge shows YOUR name, not a coworker’s.
2

Verify Terminal ID

Confirm you’re using the correct terminal for your assigned area.
3

Check Online Status

Ensure the green indicator shows ONLINE before starting critical operations.

Shift Information Display

The current date and shift are displayed below the header on the home screen (ShiftInfoRow.kt:19-47):
ShiftInfoRow(
    dateText = "Lun, 9 de Marzo 2026",
    shiftText = "Turno Mañana"
)

Date Format

The date is displayed in Spanish format:
  • Day abbreviation: Lun, Mar, Mié, Jue, Vie, Sáb, Dom
  • Day number: 1-31
  • Month: enero, febrero, marzo, etc.
  • Year: Full 4-digit year
Example: "Lun, 9 de Marzo 2026"

Shift Types

Common shift labels include:

Turno Mañana

Morning shift

Turno Tarde

Afternoon shift

Turno Noche

Night shift
The shift badge has a green background (#E8F5E9) with green text (#4CAF50) to match the online status indicator theme.

Shift Badge Implementation

The shift badge is styled for visibility (ShiftInfoRow.kt:34-45):
Surface(
    color = Color(0xFFE8F5E9), // Light green background
    shape = RoundedCornerShape(8.dp)
) {
    Text(
        text = shiftText,
        color = Color(0xFF4CAF50), // Green text
        fontSize = 12.sp,
        fontWeight = FontWeight.Bold
    )
}

Header Design

The home header uses a distinctive blue curved design (HomeHeader.kt:28-34):
Box(
    modifier = Modifier
        .fillMaxWidth()
        .clip(RoundedCornerShape(bottomStart = 40.dp, bottomEnd = 40.dp))
        .background(Color(0xFF0061A6))
        .padding(bottom = 32.dp)
)
The curved bottom corners (40dp radius) create a modern, app-like appearance that distinguishes the header from the content area.

Logout Functionality

The logout button is positioned in the top-right corner (HomeHeader.kt:97-110):
Surface(
    color = Color.White.copy(alpha = 0.15f),
    shape = RoundedCornerShape(12.dp),
    onClick = onLogoutClick
) {
    Icon(
        imageVector = Icons.AutoMirrored.Filled.Logout,
        contentDescription = "Logout",
        tint = Color.White
    )
}

How to Logout

1

Navigate to Home

Return to the home screen if you’re in another operation
2

Tap Logout Icon

Tap the logout icon (arrow exiting a door) in the top-right corner
3

Confirm

Confirm you want to log out (if prompted)
4

Login Screen

You’ll be returned to the login screen
Always log out when:
  • Ending your shift
  • Taking an extended break
  • Handing the terminal to another user
Failing to log out means operations will be recorded under your user account!

System Header Text

The header displays the system branding (HomeHeader.kt:116-129):
Text(
    text = "SISTEMA DE GESTIÓN",
    color = Color.White.copy(alpha = 0.7f),
    fontSize = 14.sp,
    fontWeight = FontWeight.SemiBold,
    letterSpacing = 0.5.sp
)
Text(
    text = "Gestión de\nAlmacén Móvil",
    color = Color.White,
    fontSize = 30.sp,
    fontWeight = FontWeight.Bold
)
The system title uses increased letter spacing (0.5sp) for a professional, uppercase appearance.

Connection Status Monitoring

Online Status (Green)

When the terminal is connected:
  • Badge shows: “[Terminal ID] · ONLINE”
  • Green indicator dot (Color #43A047)
  • All operations available

Offline Status (Red)

When network connectivity is lost:
  • Badge shows: “[Terminal ID] · OFFLINE”
  • Red indicator dot
  • Some operations may be restricted or unavailable
  • Data will sync when connection is restored
If you see the OFFLINE status:
  1. Check the terminal’s WiFi connection
  2. Verify you’re in a coverage area
  3. Restart the terminal if needed
  4. Contact IT support if the issue persists
Do not perform critical operations while offline unless specifically authorized.

User Accountability

Every operation in EnvaSistema is logged with:
1

User Identification

Your user name (as shown in the user badge)
2

Timestamp

Date and time the operation was completed
3

Shift Association

The active shift when the operation occurred
4

Terminal ID

Which warehouse terminal was used
5

Operation Details

Type of operation and items processed
This audit trail ensures accountability and helps track inventory discrepancies or operational issues.

Best Practices

Start of Shift Checklist:
  1. Log in with your credentials
  2. Verify your user name in the badge
  3. Confirm the shift matches your schedule
  4. Check for ONLINE status
  5. Note your terminal ID
During Your Shift:
  • Periodically verify you’re still logged in
  • Monitor the online status indicator
  • Report any connectivity issues immediately
  • Never use another user’s login
End of Shift Checklist:
  1. Complete all pending operations
  2. Verify no unsaved work
  3. Tap the logout button
  4. Confirm logout was successful
  5. Return terminal to charging station

Multi-User Environment

In warehouses with shared terminals:
1

Always Check Active User

Before any operation, verify the user badge shows YOUR name
2

Log Out Previous User

If someone else’s name appears, log them out before logging in
3

Don't Share Credentials

Each user must have their own login. Never share passwords.
4

Report Unauthorized Access

If you notice operations under your name that you didn’t perform, report immediately
Security Violation: Using another person’s credentials or allowing someone to use yours is a serious policy violation and compromises audit integrity.

Terminal Assignment

Some warehouses assign specific terminals to areas or users:
Terminal IDTypical Assignment
C01-C20Receiving area
C21-C40Picking area
C41-C60Shipping area
C61-C80Production area
Your supervisor will tell you which terminal(s) you’re authorized to use. The terminal ID is always visible in the status badge.

Shift Change Procedures

Outgoing Shift

1

15 Minutes Before End

Begin wrapping up current operations
2

Complete Pending Work

Finish or properly document any incomplete tasks
3

Handoff Notes

If needed, communicate issues to incoming shift
4

Logout

Log out of all terminals you used

Incoming Shift

1

Login

Log in with your credentials
2

Verify Information

Check user name, shift label, and terminal ID
3

Review Handoffs

Check for any notes from previous shift
4

Begin Operations

Start your shift workflow

Troubleshooting

Cause: Previous user forgot to log outSolution:
  1. Tap the logout button
  2. Wait for login screen
  3. Log in with your credentials
  4. Verify your name appears correctly
Cause: System shift configuration may be incorrectSolution:
  1. Note the discrepancy
  2. Proceed with operations (they’ll still be logged correctly)
  3. Report to supervisor or IT
Note: The shift display is informational; actual shift is determined by server timestamp.
Cause: App frozen or logout button unresponsiveSolution:
  1. Try navigating to home screen first
  2. Wait a few seconds, try again
  3. If still frozen, force close the app
  4. Reopen and verify you’re logged out
  5. Log in again if needed
Causes:
  • WiFi disconnected
  • Network outage
  • Server maintenance
Solutions:
  1. Check terminal WiFi settings
  2. Move to area with better coverage
  3. Restart terminal
  4. Contact IT if persistent
  5. Switch to backup terminal if available

Date and Time Synchronization

The date and shift information are updated from the server to ensure accuracy across all terminals. If you notice incorrect dates:
  1. Check the terminal’s system clock
  2. Ensure WiFi is connected (ONLINE status)
  3. Restart the app to force a sync
  4. Report persistent issues to IT

Privacy and Security

1

Password Protection

Keep your login credentials secure and private
2

Auto-Logout

Some configurations may automatically log you out after inactivity
3

Session Monitoring

IT can monitor active sessions and force logout if needed
4

Audit Compliance

All operations are permanently logged for compliance and quality control

Next Steps

Navigation

Learn about app navigation and menu structure

Barcode Scanning

Master barcode scanning techniques

Build docs developers (and LLMs) love