Introduction

Welcome to MLM (Manteniendo la Misión) - A modern CMMS platform for comprehensive maintenance management

Welcome to MLM

MLM (Manteniendo la Misión) is a modern Computerized Maintenance Management System (CMMS) designed to streamline maintenance operations across multiple locations. Built with React, TypeScript, and Supabase, MLM provides a complete solution for managing work requests, work orders, inventory, assets, and more.

What is MLM?

MLM is a full-featured maintenance management platform that helps organizations:

• Track Maintenance Requests: Capture, prioritize, and manage work requests from submission to completion
• Manage Work Orders: Convert approved requests into work orders, assign technicians, and track progress through a visual Kanban board
• Control Inventory: Manage parts, warehouses, stock levels, and automate reordering with comprehensive inventory management
• Track Assets: Monitor equipment, schedule preventive maintenance, and maintain complete maintenance history
• Generate Reports: Access real-time dashboards and custom reports for data-driven decision making
• Collaborate Effectively: Real-time notifications, comments, and updates keep your team synchronized

Key Features

Visual Kanban Board

Drag-and-drop interface for managing work orders across customizable workflow stages

Real-Time Notifications

Push notifications and in-app alerts keep your team informed of critical updates

Inventory Management

Complete inventory control with warehouses, bins, reorder policies, and reservations

Asset Tracking

Track equipment, maintenance history, and schedule preventive maintenance

Role-Based Access Control

Granular permissions system with customizable roles for secure access control

Multi-Location Support

Manage maintenance operations across multiple facilities from a single platform

Architecture Overview

MLM is built on a modern, scalable architecture:

• Frontend: React 19 with TypeScript, Vite, and Tailwind CSS v4
• Backend: Supabase (PostgreSQL, Authentication, Row Level Security, Realtime, Storage, Edge Functions)
• Database: PostgreSQL with comprehensive RBAC policies and triggers
• Real-time Updates: WebSocket connections for live notifications and data synchronization
• PWA Support: Progressive Web App with offline capabilities and push notifications

Quick Links

Get Started

Set up your MLM instance and create your first work order

Installation Guide

Complete installation instructions for development and production

Technical Architecture

Deep dive into the system architecture and design decisions

Deployment Guide

Deploy MLM to production with Supabase

Who Should Use MLM?

MLM is ideal for:

• Facilities Managers: Coordinate maintenance across multiple buildings or locations
• Maintenance Teams: Track work orders, manage inventory, and collaborate efficiently
• Operations Managers: Access real-time insights and reports on maintenance operations
• IT Administrators: Deploy and manage a self-hosted maintenance management solution

Technology Stack

{
  "frontend": {
    "framework": "React 19.1.0",
    "language": "TypeScript 5.8.3",
    "buildTool": "Vite 6.3.5",
    "styling": "Tailwind CSS 4.1.10",
    "routing": "React Router DOM 7.6.1"
  },
  "backend": {
    "platform": "Supabase",
    "database": "PostgreSQL",
    "authentication": "Supabase Auth",
    "storage": "Supabase Storage",
    "realtime": "Supabase Realtime"
  },
  "components": {
    "ui": ["Radix UI", "Headless UI", "Heroicons", "Lucide React"],
    "charts": "Chart.js with react-chartjs-2",
    "notifications": ["React Toastify", "SweetAlert2", "Web Push API"]
  }
}

Getting Help

• Documentation: Browse the comprehensive documentation in the sidebar
• GitHub: Report issues or contribute at EdgarJr30/proyecto-de-grado-cms
• Technical Reference: Explore the technical documentation for developers

MLM is under active development. Features and APIs may change. Check the GitHub repository for the latest updates.

Next Steps

1. Read the Quickstart

   Follow the quickstart guide to set up MLM and create your first work order.

2. Configure Your Environment

   Set up environment variables and configure Supabase in the installation guide.

3. Explore Features

   Learn about core features like work requests, inventory management, and notifications.

4. Deploy to Production

   Follow the deployment guide to deploy MLM to your production environment.