rckrdmrd/erp-mecanicas-diesel
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
main
erp-mecanicas-diesel/docs/00-vision-general/VISION.md

6.3 KiB
Raw Permalink Blame History

Vision del Proyecto - ERP Mecanicas Diesel

Version: 1.0.0 Fecha: 2025-12-06 Proyecto: ERP Suite - Vertical Mecanicas Diesel Estado: Planificacion

Resumen Ejecutivo

El modulo ERP Mecanicas Diesel es una vertical especializada del ERP Suite orientada a laboratorios y talleres de mecanica diesel. Extiende el erp-core (60-70% de reutilizacion) con funcionalidades especificas para:

  • Diagnosticos y pruebas de equipos diesel
  • Gestion de ordenes de reparacion y servicio
  • Control de inventario de refacciones
  • Trazabilidad completa por vehiculo/equipo
  • Cotizaciones y presupuestos de reparacion

Problema que Resuelve

Los talleres de mecanica diesel enfrentan desafios criticos:

Problema Impacto Solucion Propuesta
Sin historial de servicios Diagnosticos repetidos, perdida de tiempo Historial completo por vehiculo
Inventario descontrolado Perdidas 10-20% en refacciones Control de stock con alertas
Cotizaciones manuales Errores de precio, tiempo perdido Generacion automatica
Sin trazabilidad No se sabe que se hizo a cada unidad Registro completo de servicios
Retrasos en entregas Clientes insatisfechos Tracking de ordenes en tiempo real

Objetivo de Negocio

Vision a 12 meses

Convertirse en el sistema ERP de referencia para talleres diesel en Mexico, ofreciendo:

  1. Eficiencia Operativa: Reducir tiempo de gestion en 40%
  2. Control de Inventario: Perdida de refacciones < 2%
  3. Trazabilidad: 100% de servicios documentados
  4. Satisfaccion Cliente: Tiempo de respuesta < 24hrs

Metricas de Exito (KPIs)

KPI Meta MVP Meta 6 meses
Ordenes procesadas/dia 10+ 50+
Tiempo cierre orden < 48hrs < 24hrs
Precision inventario 95% 99%
Historiales completos 80% 100%

Usuarios Objetivo

Perfiles de Usuario

Rol Responsabilidad Uso Principal
Gerente de Taller Direccion general Dashboard, reportes, precios
Jefe de Taller Supervision operativa Asignacion trabajos, seguimiento
Mecanico Diesel Ejecucion diagnosticos Registro avances, refacciones
Almacenista Control refacciones Inventarios, pedidos
Recepcionista Atencion cliente Ordenes, cotizaciones
Contador Facturacion Reportes, CFDI

Flujo Principal de Usuario

Cliente llega → Recepcion crea orden → Jefe asigna mecanico
                                              ↓
                         Mecanico diagnostica → Cotizacion
                                              ↓
                         Cliente aprueba → Ejecucion reparacion
                                              ↓
                         Cierre orden → Facturacion → Entrega

Alcance del MVP

Incluido en MVP (Fase 1)

Modulo Descripcion Prioridad
MMD-001 Fundamentos Auth, roles taller, catalogos P0
MMD-002 Ordenes de Servicio Creacion, seguimiento, cierre P0
MMD-003 Diagnosticos Registro pruebas, resultados P0
MMD-004 Inventario Refacciones Stock, movimientos, alertas P0
MMD-005 Vehiculos/Equipos Registro, historial P0
MMD-006 Cotizaciones Generacion, aprobacion P1

Fuera del MVP (Fase 2+)

Modulo Descripcion Fase
MMD-007 Facturacion CFDI Timbrado SAT Fase 2
MMD-008 Reportes Avanzados BI, Analytics Fase 2
MMD-009 App Movil App para mecanicos Fase 2
MMD-010 Integracion Proveedores Pedidos automaticos Fase 3
MMD-011 Mantenimiento Preventivo Alertas programadas Fase 3

Arquitectura de Alto Nivel

Herencia del ERP Core

erp-core (base 60-70%)
├── MGN-001 Auth          → 100% reutilizado
├── MGN-002 Users         → 100% + roles taller
├── MGN-003 Roles         → 100% + permisos diesel
├── MGN-004 Tenants       → 100% (taller = tenant)
├── MGN-005 Catalogs      → 80% + catalogos refacciones
├── MGN-011 Inventory     → 70% + logica refacciones
└── MGN-015 Projects      → 30% (base ordenes)

mecanicas-diesel (extension 30-40%)
├── MMD-001 Fundamentos   → Extiende MGN-001,002,003,004
├── MMD-002 Ordenes       → Nuevo (80%)
├── MMD-003 Diagnosticos  → Nuevo (100%)
├── MMD-004 Inventario    → Extiende MGN-011
├── MMD-005 Vehiculos     → Nuevo (100%)
└── MMD-006 Cotizaciones  → Nuevo (90%)

Stack Tecnologico

Capa Tecnologia Notas
Backend Node.js + Express + TypeScript Extiende erp-core
Frontend React + Vite + Tailwind UI especializada
Database PostgreSQL + RLS Schemas especificos
Mobile React Native Fase 2

Schemas de Base de Datos

Schema Descripcion Tablas Estimadas
workshop_core Fundamentos taller 6-8
service_management Ordenes, diagnosticos 10-12
parts_management Refacciones, inventario 8-10
vehicle_management Vehiculos, historial 6-8

Riesgos y Mitigacion

Riesgo Probabilidad Impacto Mitigacion
Dependencia de erp-core Alta Alto Desarrollo paralelo con mocks
Complejidad diagnosticos Media Medio MVP con diagnosticos basicos
Adopcion usuarios Media Alto Capacitacion y UI simple
Integracion SAT Baja Medio Usar patrones de construccion

Timeline de Alto Nivel

Fase 1: MVP (8-10 semanas)

  • MMD-001: Fundamentos (2 semanas)
  • MMD-002: Ordenes de Servicio (2 semanas)
  • MMD-003: Diagnosticos (2 semanas)
  • MMD-004: Inventario (2 semanas)
  • MMD-005: Vehiculos (1 semana)
  • MMD-006: Cotizaciones (1 semana)

Fase 2: Enterprise (6-8 semanas)

  • MMD-007: Facturacion CFDI
  • MMD-008: Reportes Avanzados
  • MMD-009: App Movil

Referencias

  • ERP Core: ../../erp-core/
  • Vertical Construccion (referencia): ../construccion/
  • Templates: /workspace/core/orchestration/templates/
  • Directivas: /workspace/core/orchestration/directivas/

Creado por: Requirements-Analyst Fecha: 2025-12-06 Ultima actualizacion: 2025-12-06