maintainx-migration-deep-dive

name	maintainx-migration-deep-dive
description	Execute complete platform migrations to or from MaintainX. Use when migrating from legacy CMMS systems, performing major re-platforming, or transitioning to MaintainX from spreadsheets or other tools. Trigger with phrases like "migrate to maintainx", "maintainx migration", "cmms migration", "switch to maintainx", "maintainx data migration".
allowed-tools	Read, Write, Edit, Bash(npm:*), Bash(node:*)
version	1.11.0
license	MIT
author	Jeremy Longshore <[e-mail]>
tags	["saas","maintainx","migration"]
compatibility	Designed for Claude Code, also compatible with Codex and OpenClaw

MaintainX Migration Deep Dive

Current State

!node --version 2>/dev/null || echo 'N/A'

Overview

Comprehensive guide for migrating to MaintainX from legacy CMMS systems (Maximo, UpKeep, Fiix), spreadsheets, or custom databases.

Prerequisites

• MaintainX account with API access
• Access to source system data (CSV export, API, or database)
• Node.js 18+

Migration Phases

Phase 1: Assess    →  Phase 2: Map    →  Phase 3: Migrate  →  Phase 4: Validate
(Audit source)       (Schema mapping)    (ETL + import)        (Verify + cutover)

Instructions

Step 1: Source System Assessment

// scripts/assess-source.ts
import { parse } from 'csv-parse/sync';
import { readFileSync } from 'fs';

interface AssessmentReport {
  totalRecords: number;
  recordTypes: Record<string, number>;
  dataQuality: {
    missingFields: Record<string, number>;
    duplicates: number;
    invalidDates: number;
  };
}

function assessCSV(filePath: string, columns: string[]): AssessmentReport {
  const content = readFileSync(filePath, 'utf-8');
  const rows = parse(content, { : , :  });

   : <, > = {};
   seen =  <>();
   duplicates = ;
   invalidDates = ;

   ( row  rows) {
    
     ( col  columns) {
       (!row[col] || row[col].() === ) {
        missing[col] = (missing[col] || ) + ;
      }
    }

    
     key = row[] || row[] || row[];
     (key && seen.(key)) duplicates++;
     (key) seen.(key);

    
     ( col  .(row)) {
       (col.().() && row[col]) {
         ((.(row[col]))) invalidDates++;
      }
    }
  }

   {
    : rows.,
    : { [filePath]: rows. },
    : { : missing, duplicates, invalidDates },
  };
}


 report = (, [, , ]);
.();
.();
.(, report..);
.();
.();