195 lines
6.3 KiB
Markdown
195 lines
6.3 KiB
Markdown
# 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
|