Skip to main content

​
Overview

The Maintenance Management module in GIMA enables organizations to track asset maintenance needs, schedule preventive maintenance, and monitor assets currently undergoing repairs. While the dedicated maintenance page at /dashboard/mantenimiento is under development, maintenance tracking is integrated throughout the platform.

Preventive Maintenance

Schedule regular maintenance to prevent asset failures and extend lifespan

Corrective Maintenance

Track and manage repairs for assets that have failed or are malfunctioning

Maintenance Queue

View all assets currently in maintenance from the dashboard

Status Tracking

Monitor maintenance progress and completion status

​
Maintenance Metrics

​
Dashboard Integration

The main dashboard at src/app/dashboard/page.tsx prominently displays maintenance statistics: 
<StatCard 
  title="En mantenimiento" 
  value="8" 
/>
This metric shows the current number of assets undergoing maintenance procedures, helping managers:
  • Identify bottlenecks in maintenance operations
  • Allocate resources effectively
  • Track maintenance workload trends
The maintenance count is displayed without a trend indicator, focusing on the current state rather than historical changes.

​
Maintenance Workflow

1

Identify Maintenance Need

Assets requiring maintenance can be identified through:
  • Regular inspection schedules
  • Asset performance monitoring
  • User-reported issues via AI Diagnostics
  • Preventive maintenance schedules
2

Create Maintenance Record

When an asset needs maintenance:
  • Mark the asset status as “En mantenimiento”
  • Assign to maintenance personnel
  • Document the issue or preventive task
  • Set expected completion date
3

Perform Maintenance

Technicians complete the work and document:
  • Actions taken
  • Parts replaced
  • Time spent
  • Costs incurred
4

Complete & Review

Upon completion:
  • Update asset status to “Disponible”
  • Review maintenance quality
  • Update asset maintenance history
  • The dashboard count automatically decrements

​
Maintenance Categories

Maintenance in GIMA is organized by asset categories:
Computer Equipment Maintenance
  • Hardware diagnostics and repair
  • Software updates and patches
  • Peripheral device servicing
  • Network connectivity issues
Common tasks:
  • Hard drive replacements
  • RAM upgrades
  • Operating system reinstallation
  • Keyboard and screen repairs

​
Integration with AI Diagnostics

The AI Diagnostics feature at /asistencia complements maintenance management: 
<textarea 
  className="w-full h-40 bg-[#E8EEEF] rounded-2xl p-6 text-slate-700 placeholder-slate-400 focus:outline-none focus:ring-2 focus:ring-gima-blue/30 resize-none transition-all text-sm mb-6" 
  placeholder="Ej: el aire acondicionado hace ruido metalico..."
/>
<button className="w-full bg-gima-blue text-white py-4 rounded-xl font-bold text-base hover:bg-blue-600 transition shadow-xl shadow-gima-blue/20 flex items-center justify-center gap-2 active:scale-95 duration-200">
  <Sparkles size={20} /> Analizar Falla
</button>
Users can describe equipment issues in natural language, and the AI helps diagnose problems before creating maintenance tickets.

​
Maintenance Scheduling

While the dedicated maintenance page is under development, best practices for maintenance scheduling include:

Preventive Schedule

Create recurring maintenance tasks based on:
  • Manufacturer recommendations
  • Usage patterns
  • Historical failure data
  • Regulatory requirements

Priority Levels

Classify maintenance by urgency:
  • Critical (immediate)
  • High (within 24 hours)
  • Medium (within week)
  • Low (scheduled)

Resource Planning

Assign maintenance based on:
  • Technician expertise
  • Workload balance
  • Required certifications
  • Part availability

Downtime Windows

Schedule maintenance during:
  • Off-peak hours
  • Planned downtime
  • Backup system availability
  • Minimal operational impact

​
Maintenance Documentation

Proper documentation is essential for effective maintenance management:

​
Work Order Components

interface MaintenanceRecord {
  id: string;
  assetId: string;
  category: string;
  type: 'preventive' | 'corrective';
  status: 'pending' | 'in-progress' | 'completed';
  assignedTo: string;
  scheduledDate: Date;
  completedDate?: Date;
  description: string;
  actions: string[];
  partsUsed: Part[];
  laborHours: number;
  cost: number;
}

​
Maintenance History

Each asset should maintain a complete maintenance history:
  • Date of service
  • Type of maintenance performed
  • Technician responsible
  • Parts replaced
  • Costs incurred
  • Next scheduled maintenance
Incomplete maintenance records can lead to premature asset failures and compliance issues. Ensure all technicians complete documentation promptly.

​
Performance Metrics

Track maintenance effectiveness with key metrics:
Measure the average time between asset failures to evaluate reliability and preventive maintenance effectiveness.
MTBF = Total Operating Time / Number of Failures
Track how quickly maintenance teams resolve issues.
MTTR = Total Repair Time / Number of Repairs
Calculate the average maintenance cost for each asset type to identify cost-intensive categories.
Cost per Asset = Total Maintenance Cost / Number of Assets
A higher ratio of preventive maintenance indicates better asset management practices.
PM Ratio = Preventive Maintenance Tasks / Total Maintenance Tasks

​
Best Practices

Regular Inspections

Conduct routine inspections to identify issues before they cause failures

Spare Parts Inventory

Maintain stock of commonly replaced parts to minimize downtime

Technician Training

Ensure maintenance staff are trained on all equipment types in your inventory

Digital Records

Use GIMA to maintain digital maintenance records for easy access and analysis

Vendor Relationships

Maintain relationships with equipment vendors for specialized repairs and parts

Performance Tracking

Monitor maintenance metrics to continuously improve processes

​
Budget Integration

Maintenance costs directly impact the budget execution metric shown on the dashboard: 
<StatCard 
  title="Presupuesto ejecutado" 
  value="100$" 
  highlighted={true} 
/>
Each maintenance activity should:
  • Be tracked against budget allocations
  • Include both labor and parts costs
  • Be categorized for budget reporting
  • Contribute to budget execution percentage
The highlighted budget card on the dashboard helps managers quickly assess if maintenance costs are within budget.

​
Compliance & Safety

Maintenance management supports regulatory compliance:
  • Safety Standards: Ensure equipment meets safety requirements
  • Regulatory Compliance: Maintain records for audits
  • Warranty Tracking: Perform maintenance within warranty terms
  • Certification Requirements: Track required certifications for equipment operation

Build docs developers (and LLMs) love

Get started for freeTalk to us