# 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