Skip to main content

​
Overview

GIMA uses a secure authentication system to control access to asset management and maintenance features. This guide walks you through the login process, password management, and user role permissions.

​
Logging In

1

Navigate to the login page

Open your browser and go to /auth/login. You’ll see the GIMA login screen with:
  • Left panel: GIMA branding with security, efficiency, and control features
  • Right panel: Login form
2

Enter your credentials

Fill in the login form:Usuario field:
  • Located at the top with a User icon
  • Enter your email address (e.g., Pedro_perez)
  • Input type: email with gray background (bg-gray-100)
Contraseña field:
  • Located below with a Lock icon
  • Enter your password (e.g., Pedro123)
  • Click the Eye icon to toggle password visibility
  • Uses showPassword state to switch between text and password input types
3

Optional: Remember me

Check the “Recuérdame” checkbox to stay logged in on this device.
The remember me feature keeps you logged in for future sessions, but always log out on shared computers.
4

Submit and access dashboard

Click the “Accede al sistema” button with the ArrowRight icon.After successful authentication:
  • The system simulates a 500ms authentication delay
  • You’re automatically redirected to /dashboard
  • The dashboard displays your assets, maintenance tasks, and system stats

​
Password Management

​
Forgot Password

If you’ve forgotten your password:
  1. Click the “¿Olvidaste tu contraseña?” link on the login page (line 192)
  2. The link is styled in blue (text-blue-600) and appears to the right of the remember me checkbox
  3. Follow the password reset instructions sent to your registered email
Password reset functionality is currently in development. Contact your system administrator if you need to reset your password.

​
Password Visibility Toggle

While entering your password:
  • Click the Eye icon to reveal your password as plain text
  • Click the EyeOff icon to hide it again
  • This uses the showPassword state managed by the login component

​
User Roles and Permissions

GIMA supports multiple user roles with different permission levels:
Full system access including:
  • User management (/configuracion/User)
  • Asset creation, editing, and deletion
  • Maintenance scheduling and approval
  • System configuration
  • Report generation and exports
  • AI assistant access
Administrators see all menu items in the sidebar and can modify any data.

​
Session Management

​
Active Session

Once logged in:
  • Your session remains active as long as you’re using the system
  • The User icon in the top right (DashboardHeader) shows your logged-in status
  • You can navigate freely between dashboard sections

​
Logging Out

To end your session:
1

Open the sidebar

The sidebar is located on the left side of the screen with the GIMA logo.
2

Click logout button

Scroll to the bottom of the sidebar and click the “Cerrar sesión” button:
  • Located in the footer section (line 130 of Sidebar.tsx)
  • Features a LogOut icon
  • Styled with red hover effect (hover:bg-red-500/20)
3

Confirm logout

You’ll be redirected to /auth/login and your session will be cleared.
Always log out when:
  • Using a shared or public computer
  • Finishing your work session
  • Switching to a different user account

​
User Account Information

Your user profile includes: 
interface User {
  id: string;              // Unique identifier
  iniciales: string;       // User initials (auto-generated)
  name: string;            // Full name
  email: string;           // Login email
  rol: string;             // Role (Administrador, Técnico, etc.)
  department: string;      // Department assignment
  status: UserEstado;      // 'available' | 'unavailable'
}

​
Available Departments

  • Infraestructura - Infrastructure and facilities
  • Laboratorios - Laboratory equipment
  • Desarrollo - Software development
  • Soporte - Technical support
  • Marketing - Marketing and communications
  • Finanzas - Finance and accounting

​
Troubleshooting

​
Cannot Log In

  • Verify your email is spelled correctly
  • Check if Caps Lock is enabled
  • Use the eye icon to verify your password
  • Try the “¿Olvidaste tu contraseña?” link
Your account may be set to status: 'unavailable' in the user management system. Contact your administrator to:
  • Verify your account status
  • Request account reactivation
  • Check for any access restrictions
  • Clear your browser cache
  • Try a different browser
  • Check your internet connection
  • Verify you’re using the correct URL

​
Security Best Practices

Strong Passwords

Use passwords with:
  • At least 8 characters
  • Mix of letters, numbers, and symbols
  • No common words or personal info

Session Security

  • Don’t share your credentials
  • Log out after each session
  • Report suspicious activity

Device Safety

  • Keep your devices updated
  • Use antivirus software
  • Avoid public Wi-Fi for sensitive operations

Account Monitoring

  • Review your activity regularly
  • Report unauthorized access
  • Update your password periodically

​
Next Steps

After logging in, you can:

Manage Assets

Create, categorize, and track your organization’s assets

Schedule Maintenance

Set up maintenance tasks and track their completion

Use AI Assistant

Get intelligent help with diagnostics and queries

Generate Reports

Create detailed reports for analysis and compliance

Build docs developers (and LLMs) love

Get started for freeTalk to us