# 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` + `pass` en el registro del empleado
- **Clientes:** Campo `user` + `pass` en cada `appUser` del 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

```bash
# 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