Overview
GIMA supports three distinct types of maintenance workflows, each designed for different scenarios and asset management strategies. The system tracks maintenance activities through their complete lifecycle, from planning to completion, with role-based assignments and detailed activity logging.Maintenance Types
Defined inapp/Enums/TipoMantenimiento.php:source/app/Enums/TipoMantenimiento.php:
Preventivo
PreventiveScheduled maintenance performed regularly to prevent failures and extend asset lifespan.
Correctivo
CorrectiveReactive maintenance performed in response to asset failures or fault reports.
Predictivo
PredictiveData-driven maintenance based on asset condition monitoring and performance trends.
Tipo Mantenimiento Enum
Preventive Maintenance
Overview
Preventive maintenance is scheduled ahead of time to keep assets in optimal condition and avoid unexpected failures.Characteristics
Characteristics
- Proactive: Performed before issues occur
- Scheduled: Based on time intervals or usage metrics
- Planned: Resources and spare parts allocated in advance
- Cost-effective: Reduces expensive emergency repairs
- Extends lifespan: Regular care prolongs asset life
Use Cases
Time-Based
- Weekly equipment inspections
- Monthly filter replacements
- Quarterly system cleanings
- Annual comprehensive overhauls
Usage-Based
- After X hours of operation
- After X production cycles
- Based on meter readings
- Triggered by performance thresholds
Scheduling Preventive Maintenance
Preventive maintenance is scheduled using theCalendarioMantenimiento model:
Workflow
Planning
Role: Supervisor or Admin
- Create maintenance schedule in calendar
- Assign técnico
- Specify maintenance activities
- Reserve required spare parts
Notification
System Action
- Notify assigned técnico of upcoming maintenance
- Alert if spare parts need ordering
- Reminder X days before scheduled date
Execution
Role: Técnico
- Review maintenance plan
- Change asset state to “En Mantenimiento”
- Perform scheduled activities
- Log work in maintenance sessions
- Record spare parts used
Completion
Role: Técnico
- Mark activities complete
- Return asset to “Operativo” state
- Update calendar status to “Completado”
Corrective Maintenance
Overview
Corrective maintenance is reactive, performed in response to asset failures or issues reported by users.Characteristics
Characteristics
- Reactive: Triggered by failures or fault reports
- Urgent: Often requires immediate attention
- Unplanned: Disrupts normal workflow
- Variable cost: Can be expensive depending on severity
- Documented: Links to originating fault report
Trigger Sources
Fault Reports
Users submit reports when assets malfunction:
- Any user can create fault reports
- Reports include priority level
- Assigned to técnicos by supervisors
- Tracked from open to resolution
Failed Inspections
Issues discovered during routine checks:
- Found during preventive maintenance
- Identified in walkthroughs
- Escalated from minor to major issues
Creating Corrective Maintenance
Corrective maintenance typically originates from a fault report:The
reporte_id field links corrective maintenance to the originating fault report, maintaining complete traceability.Workflow
Report
Role: Any user (Reporter, Técnico, Supervisor, Admin)
- Submit fault report via API
- Include description and priority
- Report status: “Abierto”
Triage
Role: Supervisor
- Review fault report
- Assess priority and urgency
- Assign to available técnico
- Create corrective maintenance record
- Report status: “Asignado”
Diagnosis
Role: Técnico
- Inspect asset
- Identify root cause
- Determine required repairs
- Request additional parts if needed
- Report status: “En Proceso”
Repair
Role: Técnico
- Perform repairs
- Replace faulty components
- Log all activities in sessions
- Test asset functionality
Resolution
Role: Técnico
- Verify asset works correctly
- Return asset to service
- Complete maintenance record
- Report status: “Resuelto”
Priority Levels
Fromapp/Enums/NivelPrioridad.php:source/app/Enums/NivelPrioridad.php:
Alta
Critical Priority
- Asset completely non-functional
- Blocks critical operations
- Safety hazard
- Immediate response required
Media
Medium Priority
- Reduced functionality
- Workaround available
- Schedule within 24-48 hours
Baja
Low Priority
- Minor inconvenience
- Cosmetic issues
- Can be batched with other work
Predictive Maintenance
Overview
Predictive maintenance uses data analysis and condition monitoring to predict when maintenance should be performed.Characteristics
Characteristics
- Data-driven: Based on actual asset condition
- Optimized timing: Perform maintenance just before failure
- Cost-efficient: Avoid unnecessary preventive work
- Requires monitoring: Needs sensors or regular measurements
- Advanced: May use machine learning or trend analysis
Use Cases
Condition Monitoring
- Vibration analysis on rotating equipment
- Temperature monitoring
- Oil analysis for contamination
- Electrical current analysis
Performance Trending
- Declining efficiency metrics
- Increasing error rates
- Longer processing times
- Rising energy consumption
Implementation Strategy
Data Collection
- Install sensors or monitoring tools
- Establish baseline metrics
- Record performance indicators
- Log historical patterns
Analysis
- Compare current vs. baseline metrics
- Identify deterioration trends
- Calculate remaining useful life
- Predict optimal maintenance timing
Trigger
- System detects threshold breach
- Automatic maintenance recommendation
- Supervisor reviews and approves
- Schedule predictive maintenance
Maintenance States
All maintenance records progress through states defined inEstadoMantenimiento:
Pendiente
PendingMaintenance created but not yet started. Waiting for técnico availability or scheduled date.
En Proceso
In ProgressTécnico actively working on maintenance. Activities being logged in sessions.
Completado
CompletedMaintenance finished successfully. Asset returned to service. Awaiting validation.
Cancelado
CancelledMaintenance cancelled before completion. Reason documented in record.
Maintenance Model Structure
Fromapp/Models/Mantenimiento.php:source/app/Models/Mantenimiento.php:
Maintenance Relationships
Asset
Supervisor
Lead Technician
Maintenance Sessions
Maintenance sessions track individual work periods by técnicos, including start/end times, activities performed, and spare parts used.
Originating Report
Tracking Maintenance Activities
Starting Maintenance
Recording Spare Parts Usage
Completing Maintenance
Permissions Required
Plan Maintenance
Permission:
gestionar mantenimientosRoles: Admin, SupervisorCreate and schedule maintenanceExecute Tasks
Permission:
ver mis tareas, registrar actividad tecnicaRoles: Admin, Supervisor, TécnicoPerform and log maintenance workReport Faults
Permission:
crear reporte fallasRoles: All rolesSubmit fault reportsBest Practices
Preventive Maintenance
Preventive Maintenance
- Schedule based on manufacturer recommendations
- Use calendar system for consistent scheduling
- Track completion rates and adjust frequency
- Pre-allocate spare parts for scheduled work
- Review and optimize maintenance plans quarterly
Corrective Maintenance
Corrective Maintenance
- Respond to high-priority reports immediately
- Document root cause analysis in sessions
- Link all corrective work to originating reports
- Track MTBF (Mean Time Between Failures)
- Identify recurring issues for preventive action
Predictive Maintenance
Predictive Maintenance
- Start with simple metrics before complex sensors
- Establish reliable baseline measurements
- Validate predictions with actual outcomes
- Adjust thresholds based on experience
- Document condition data in maintenance records
General
General
- Always update asset state during maintenance
- Log all activities in maintenance sessions
- Track actual vs. estimated costs
- Require supervisor validation for completed work
- Maintain complete audit trail
Reporting and Metrics
Key Performance Indicators
Next Steps
Asset Management
Learn about asset lifecycle and states
Roles & Permissions
Understand who can perform maintenance
API Reference
View maintenance API endpoints