Skip to main content

Welcome to GIMA

GIMA (Gestión Inteligente para el Mantenimiento de Activos) is a comprehensive asset maintenance management system built with Laravel 12 and PostgreSQL. It provides organizations with powerful tools to track, schedule, and manage maintenance operations across all their physical assets.

What is GIMA?

GIMA is an intelligent maintenance management platform designed to streamline the entire asset lifecycle - from registration and preventive maintenance scheduling to reactive repairs and comprehensive reporting. It enables organizations to:
  • Track Assets: Maintain a complete inventory of organizational assets with detailed information about location, status, and value
  • Schedule Maintenance: Plan and schedule preventive maintenance activities to minimize downtime
  • Manage Work Orders: Create, assign, and track maintenance work orders from initiation to completion
  • Control Inventory: Track spare parts and materials used during maintenance operations
  • Generate Reports: Access comprehensive analytics and reports on maintenance activities and costs
  • Enforce Permissions: Role-based access control ensures users only access relevant features

Key Features

Asset Management

Complete lifecycle management of physical assets including registration, tracking, status monitoring, and location management.

Maintenance Scheduling

Schedule preventive and corrective maintenance with automated notifications and technician assignment.

Work Order Management

Create and track maintenance work orders with cost tracking, progress monitoring, and validation workflows.

Role-Based Access

Four distinct user roles (Admin, Supervisor, Technician, Reporter) with granular permissions using Spatie Laravel Permission.

Inventory Control

Track spare parts, materials, and suppliers with automatic inventory updates during maintenance.

Audit & Reporting

Comprehensive audit trails and reports for maintenance activities, costs, and asset performance.

Core Modules

Asset Management

  • Register and classify assets by type and category
  • Track asset location, status (operational, under maintenance, decommissioned)
  • Record asset value and depreciation
  • Link assets to maintenance schedules and history

Maintenance Operations

  • Preventive Maintenance: Schedule recurring maintenance based on time or usage
  • Corrective Maintenance: Respond to failure reports with work order creation
  • Maintenance Calendar: Visual calendar showing scheduled and in-progress work
  • Session Tracking: Log individual maintenance sessions with time and resources used

User Roles & Permissions

Full System Access
  • Manage users and roles
  • Configure master data (locations, suppliers, spare parts)
  • Access all system features
  • View comprehensive reports

Use Cases

Manufacturing Facilities

Manage production equipment maintenance schedules, minimize machine downtime, and track maintenance costs per asset.

Healthcare Organizations

Ensure medical equipment is properly maintained with compliance tracking and preventive maintenance schedules.

Educational Institutions

Manage maintenance of buildings, HVAC systems, laboratory equipment, and IT infrastructure across multiple campuses.

Property Management

Schedule and track maintenance for facilities, common areas, and tenant equipment across multiple properties.

Technology Stack

{
  "framework": "Laravel 12",
  "php": "^8.2",
  "database": "PostgreSQL",
  "authentication": "Laravel Sanctum",
  "permissions": "Spatie Laravel Permission"
}

Architecture Overview

GIMA follows Laravel’s MVC architecture with additional service layers for complex business logic:
  • Models: Eloquent ORM models for database entities (Activo, Mantenimiento, User, etc.)
  • Controllers: RESTful API controllers with role-based middleware
  • Migrations: Version-controlled database schema
  • Seeders: Initial data setup including roles, permissions, and test users
  • Enums: Type-safe enumerations for asset states, maintenance types, and user statuses

API-First Design

GIMA provides a comprehensive RESTful API with:
  • Token-based authentication using Laravel Sanctum
  • Role-based route protection
  • JSON request/response format
  • Comprehensive error handling
GIMA is designed for internal organizational use with role-based access control. All API endpoints require authentication except for the login endpoint.

Getting Started

Ready to get started with GIMA? Check out our guides:

Quick Start

Get up and running in minutes with our quick start guide

Installation

Detailed installation instructions for production environments

Support & Contribution

GIMA is built with Laravel 12 and follows Laravel best practices. For Laravel-specific questions, refer to the Laravel Documentation.
GIMA requires PHP 8.2 or higher and PostgreSQL database. Ensure your environment meets these requirements before installation.

Build docs developers (and LLMs) love