a1dde36ddc
13 módulos, 6 roles, 5 idiomas, 4 temas visuales Creador: José Jiménez Salinas — Consultoría Alcaraz Salazar
196 lines
6.8 KiB
Markdown
196 lines
6.8 KiB
Markdown
# 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
|