a1dde36ddc
13 módulos, 6 roles, 5 idiomas, 4 temas visuales Creador: José Jiménez Salinas — Consultoría Alcaraz Salazar
6.8 KiB
6.8 KiB
CRANEGOO — Plataforma de Gestión para Grúas y Elevadores
Versión: 3.0
Creador: José Jiménez Salinas — Consultoría Alcaraz Salazar
Contacto: lalcarazsalazar@consultoria-as.com | 664 217 0990
¿Qué es CRANEGOO?
Sistema integral para la administración de empresas de renta de grúas torre y elevadores de construcción. Diseñado como plataforma SaaS multi-tenant donde cada empresa de grúas es un cliente independiente.
Tecnología actual: React (Single-File JSX, ~7,450 líneas)
Estado: Prototipo funcional completo — listo para migración a backend
Módulos (13)
| # | Módulo | Descripción |
|---|---|---|
| 1 | 📊 Dashboard | KPIs operativos + panel financiero (saldos, deudas, SAT/IMSS, nómina) |
| 2 | 📦 Inventario | CRUD equipos (grúas torre, elevadores) + refacciones |
| 3 | 🔧 Servicios | Calendario con festivos, asignación de personal, checklist en campo, firmas digitales |
| 4 | 🛠️ Mantenimiento | Preventivo y correctivo, vistas por rol |
| 5 | 📝 Cotizaciones | Catálogo de 32 conceptos, generación PDF, anticipo, 7 cláusulas editables |
| 6 | 🛒 Compras | Órdenes de compra, proveedores, fotos, comprobantes de pago |
| 7 | 📑 Contable | 6 pestañas: Control por cliente, Facturas, Estado de cuenta, Tesorería, SAT/IMSS, Nómina |
| 8 | 📍 GPS | Tracking de empleados en tiempo real, vista por proyecto para clientes |
| 9 | 👥 Personal | Alta de empleados con credenciales, roles del sistema, acceso a compras |
| 10 | 🏢 Clientes | Alta de empresas, proyectos, equipos, usuarios de app (máx 2 por obra) |
| 11 | 📋 Reportes | 4 tipos de inspección (grúa/elevador × mant/correctivo), checklists completos, firmas, PDF |
| 12 | 📚 Manuales | 6 categorías, upload/download por equipo |
| 13 | ⚙️ Configuración | Idiomas (5), temas (4), datos empresa, IVA, idioma por cliente/obra, Acerca de |
Roles y Permisos (6)
| Rol | Acceso |
|---|---|
| ⚙️ Administrador | Todo — 13 módulos, edición total, configuración |
| 🏗️ Jefe de Operaciones | Dashboard, Inventario, Servicios, Mantenimiento, Compras, GPS, Personal, Reportes, Manuales |
| 📊 Jefe de Ventas | Dashboard (cobranza), Servicios, Mantenimiento, Cotizaciones, Clientes |
| 📑 Contador | Dashboard (financiero), Contable (6 pestañas), Compras (pagos) |
| 👷 Empleado | Dashboard, Inventario, Servicios, Mantenimiento, GPS, Reportes, Manuales |
| 🏢 Cliente | Dashboard (mi proyecto), Servicios, Mantenimiento, Cotizaciones, GPS |
Autenticación
Login unificado por usuario + contraseña. El admin asigna credenciales al dar de alta:
- Admin: Credenciales hardcoded en
ADMIN_CREDS - Empleados: Campo
user+passen el registro del empleado - Clientes: Campo
user+passen cadaappUserdel proyecto
Funcionalidades Especiales
Inspecciones / Checklists
- Grúa Torre: 22 secciones, ~65 puntos (desde PDF real de Mexus)
- Elevador: 4 secciones, 24 puntos (BASE, TORRE, VAGÓN, ARRESTRAMIENTOS)
- Generación automática al iniciar servicio según tipo de equipo
Firmas Digitales
- Canvas táctil (mouse + touch) para firma
- Técnico firma al completar checklist
- Supervisor firma al aprobar reporte
- Ambas aparecen en el PDF generado
Tesorería
- Cuentas bancarias (pesos + dólares) con saldos
- Créditos y tarjetas con % de utilización
- Transacciones que actualizan saldos automáticamente
- Alertas de créditos al +80% de utilización
SAT / IMSS / Estatal
- Obligaciones fiscales con fechas límite
- Alertas de vencimiento en Dashboard
- Subir comprobantes de pago
Nómina Semanal
- Registro con bruto/neto/ISR/IMSS/Infonavit
- Upload de XML Timbre y XML Complemento
- Comprobante de pago
Internacionalización
- 5 idiomas: ES-LATAM, ES-España, English, Русский, Français
- ~90 claves de traducción
- Idioma configurable por cliente y por obra
- Cambio en tiempo real
Temas Visuales
- 4 temas: Oscuro, Claro, Mexus Rojo, Azul Corporativo
- CSS dinámico que cambia body, cards, inputs, botones
Estructura del Código
src/App.jsx — Archivo principal (~7,450 líneas)
├── Constantes — C (colores), ROLES, SYS_ROLES, EMP_ROLES, SVC_TYPES, etc.
├── Init Data — INIT_EQUIPMENT, INIT_EMPLOYEES, etc. (20 arrays, vacíos en versión limpia)
├── Traducciones — TRANSLATIONS (~90 claves × 5 idiomas)
├── Temas — THEMES (4 temas con paletas completas)
├── Checklists — GRUA_TORRE_CHECKLIST (22 secciones), ELEVADOR_CHECKLIST (4 secciones)
├── Catálogo — COT_CATALOG (32 conceptos con precios)
├── Hooks — useIsMobile()
├── Componentes UI — SignaturePad, Field, Modal, Calendar, StatusBadge, etc.
├── Módulos — 13 componentes principales (Dashboard, ServicesModule, etc.)
├── Login — Autenticación por usuario/contraseña
└── App — Estado global, routing, layout
Roadmap Técnico para Migración
Fase 1 — Backend (Supabase o Firebase)
- Migrar estado en memoria a base de datos
- Autenticación real (JWT + bcrypt)
- Storage para archivos/fotos/XMLs/firmas
- Real-time subscriptions para GPS y notificaciones
Fase 2 — PWA
- Service Worker para modo offline
- Push notifications
- Instalable en homescreen
Fase 3 — Mobile (React Native)
- Android + iOS + Huawei
- Cámara nativa para fotos y firmas
- GPS nativo para tracking
Fase 4 — Multi-Tenant SaaS
- Cada empresa de grúas es un tenant
- Onboarding self-service
- Billing por suscripción
Cómo Correr en Desarrollo
# Opción 1: Con Vite
npm create vite@latest cranegoo -- --template react
cd cranegoo
# Copiar src/App.jsx al proyecto
npm install
npm run dev
# Opción 2: Con Create React App
npx create-react-app cranegoo
cd cranegoo
# Reemplazar src/App.js con src/App.jsx
npm start
Dependencias
Solo React — no requiere librerías adicionales. Todo está construido con:
- React (useState, useMemo, useRef, useEffect)
- CSS-in-JS (inline styles)
- Canvas API (para firmas)
- Window.open (para generación de PDF)
Credenciales por Defecto
| Tipo | Usuario | Contraseña |
|---|---|---|
| Administrador | jose.jimenez |
mexus2024 |
| Administrador (alt) | admin |
mexus2024 |
Los demás usuarios se crean desde el módulo de Personal (empleados) y Clientes (usuarios de obra).
Licencia
Propiedad intelectual de José Jiménez Salinas — Consultoría Alcaraz Salazar.
Todos los derechos reservados © 2026.
Contacto
📧 lalcarazsalazar@consultoria-as.com
📞 664 217 0990
📍 Tijuana: Misión de San Javier 10661, Zona Urbana Río Tijuana, B.C.
📍 Guadalajara: Florencia 2280, Col. Italia Providencia, Jalisco