267 lines
9.5 KiB
Markdown
267 lines
9.5 KiB
Markdown
# ESTADO DEL PROYECTO - ERP Mecánicas Diesel
|
|
|
|
**Proyecto:** ERP Mecánicas Diesel (Proyecto Independiente)
|
|
**Estado:** Documentacion COMPLETA + GAPs RESUELTOS - Listo para desarrollo
|
|
**Progreso:** 100%
|
|
**Ultima actualizacion:** 2025-12-12
|
|
|
|
---
|
|
|
|
## RESUMEN
|
|
|
|
- **Tipo:** Proyecto independiente - Sistema ERP para talleres diesel
|
|
- **Fase actual:** Documentacion completa + DDL - Listo para desarrollo
|
|
- **Epicas documentadas:** 6/6 (MVP completo)
|
|
- **Modulos documentados:** 6/6 (MVP completo)
|
|
- **Story Points totales:** 241 SP
|
|
- **Historias de usuario:** 55 historias detalladas (100% cobertura)
|
|
- **Schemas de BD:** 7 schemas DDL implementados (65+ tablas)
|
|
- **Validacion arquitectonica:** Completada
|
|
|
|
---
|
|
|
|
## EPICAS MVP (Fase 1)
|
|
|
|
| Codigo | Nombre | SP | Epica | Modulo | US |
|
|
|--------|--------|-----|-------|--------|-----|
|
|
| EPIC-MMD-001 | Fundamentos | 42 | ✅ | ✅ | 9/9 ✅ |
|
|
| EPIC-MMD-002 | Ordenes de Servicio | 55 | ✅ | ✅ | 11/11 ✅ |
|
|
| EPIC-MMD-003 | Diagnosticos | 42 | ✅ | ✅ | 8/8 ✅ |
|
|
| EPIC-MMD-004 | Inventario | 42 | ✅ | ✅ | 10/10 ✅ |
|
|
| EPIC-MMD-005 | Vehiculos | 34 | ✅ | ✅ | 8/8 ✅ |
|
|
| EPIC-MMD-006 | Cotizaciones | 26 | ✅ | ✅ | 7/7 ✅ |
|
|
|
|
**Total MVP:** 241 SP | 6 Epicas | 6 Modulos | 55 US completas
|
|
|
|
---
|
|
|
|
## DOCUMENTACION DISPONIBLE
|
|
|
|
### Vision y Epicas
|
|
```
|
|
docs/
|
|
├── 00-vision-general/
|
|
│ └── VISION.md ✅
|
|
└── 08-epicas/
|
|
├── README.md ✅
|
|
├── EPIC-MMD-001-fundamentos.md ✅
|
|
├── EPIC-MMD-002-ordenes-servicio.md ✅
|
|
├── EPIC-MMD-003-diagnosticos.md ✅
|
|
├── EPIC-MMD-004-inventario.md ✅
|
|
├── EPIC-MMD-005-vehiculos.md ✅
|
|
└── EPIC-MMD-006-cotizaciones.md ✅
|
|
```
|
|
|
|
### Modulos y User Stories
|
|
```
|
|
docs/02-definicion-modulos/
|
|
├── MMD-001-fundamentos/
|
|
│ ├── README.md ✅
|
|
│ └── historias-usuario/
|
|
│ └── US-MMD001-001 a 009 ✅ (9 US)
|
|
│
|
|
├── MMD-002-ordenes-servicio/
|
|
│ ├── README.md ✅
|
|
│ └── historias-usuario/
|
|
│ └── US-MMD002-001 a 011 ✅ (11 US)
|
|
│
|
|
├── MMD-003-diagnosticos/
|
|
│ ├── README.md ✅
|
|
│ └── historias-usuario/
|
|
│ └── US-MMD003-001 a 008 ✅ (8 US)
|
|
│
|
|
├── MMD-004-inventario/
|
|
│ ├── README.md ✅
|
|
│ └── historias-usuario/
|
|
│ └── US-MMD004-001 a 010 ✅ (10 US)
|
|
│
|
|
├── MMD-005-vehiculos/
|
|
│ ├── README.md ✅
|
|
│ └── historias-usuario/
|
|
│ └── US-MMD005-001 a 008 ✅ (8 US)
|
|
│
|
|
└── MMD-006-cotizaciones/
|
|
├── README.md ✅
|
|
└── historias-usuario/
|
|
└── US-MMD006-001 a 007 ✅ (7 US)
|
|
```
|
|
|
|
### Modelo de Datos
|
|
```
|
|
docs/03-modelo-datos/
|
|
├── README.md ✅
|
|
├── SCHEMA-WORKSHOP-CORE.md ✅
|
|
├── SCHEMA-SERVICE-MANAGEMENT.md ✅
|
|
├── SCHEMA-PARTS-MANAGEMENT.md ✅
|
|
└── SCHEMA-VEHICLE-MANAGEMENT.md ✅
|
|
```
|
|
|
|
---
|
|
|
|
## HISTORIAS DE USUARIO DETALLADAS (55)
|
|
|
|
### MMD-001 Fundamentos (9 US - Completo)
|
|
- US-MMD001-001: Configurar taller como tenant
|
|
- US-MMD001-002: Configurar roles de taller
|
|
- US-MMD001-003: Configurar catalogo de servicios
|
|
- US-MMD001-004: Configurar datos fiscales
|
|
- US-MMD001-005: Configurar bahias de trabajo
|
|
- US-MMD001-006: Aplicar RLS por taller_id
|
|
- US-MMD001-007: Importar catalogos desde Excel
|
|
- US-MMD001-008: Cambiar de bahia sin cerrar sesion
|
|
- US-MMD001-009: Ver dashboard de uso del sistema
|
|
|
|
### MMD-002 Ordenes (11 US - Completo)
|
|
- US-MMD002-001: Crear orden de servicio
|
|
- US-MMD002-002: Registrar sintomas del cliente
|
|
- US-MMD002-003: Asignar orden a mecanico y bahia
|
|
- US-MMD002-004: Ver ordenes asignadas
|
|
- US-MMD002-005: Registrar trabajos realizados
|
|
- US-MMD002-006: Solicitar refacciones
|
|
- US-MMD002-007: Ver tablero Kanban
|
|
- US-MMD002-008: Cerrar orden y generar pre-factura
|
|
- US-MMD002-009: Notificar cliente por WhatsApp
|
|
- US-MMD002-010: Ver historial de vehiculo
|
|
- US-MMD002-011: Configurar estados personalizados
|
|
|
|
### MMD-003 Diagnosticos (8 US - Completo)
|
|
- US-MMD003-001: Registrar diagnostico computarizado
|
|
- US-MMD003-002: Registrar pruebas de banco de inyectores
|
|
- US-MMD003-003: Registrar pruebas de bomba de combustible
|
|
- US-MMD003-004: Comparar resultados vs referencias
|
|
- US-MMD003-005: Adjuntar fotos de evidencia
|
|
- US-MMD003-006: Registrar recomendaciones de reparacion
|
|
- US-MMD003-007: Ver historial de diagnosticos
|
|
- US-MMD003-008: Configurar tipos de prueba
|
|
|
|
### MMD-004 Inventario (10 US - Completo)
|
|
- US-MMD004-001: Registrar refacciones
|
|
- US-MMD004-002: Consultar stock disponible
|
|
- US-MMD004-003: Solicitar refaccion desde orden
|
|
- US-MMD004-004: Recibir mercancia
|
|
- US-MMD004-005: Ajustar inventario
|
|
- US-MMD004-006: Alertas de stock minimo
|
|
- US-MMD004-007: Ver kardex de refaccion
|
|
- US-MMD004-008: Gestionar codigos alternos
|
|
- US-MMD004-009: Gestionar ubicaciones de almacen
|
|
- US-MMD004-010: Realizar inventario fisico
|
|
|
|
### MMD-005 Vehiculos (8 US - Completo)
|
|
- US-MMD005-001: Registrar vehiculo
|
|
- US-MMD005-002: Editar informacion de vehiculo
|
|
- US-MMD005-003: Registrar especificaciones del motor
|
|
- US-MMD005-004: Ver ficha tecnica completa
|
|
- US-MMD005-005: Ver historial de servicios
|
|
- US-MMD005-006: Gestionar flotas de vehiculos
|
|
- US-MMD005-007: Configurar recordatorios de mantenimiento
|
|
- US-MMD005-008: Importar vehiculos desde Excel
|
|
|
|
### MMD-006 Cotizaciones (7 US - Completo)
|
|
- US-MMD006-001: Crear cotizacion desde diagnostico
|
|
- US-MMD006-002: Agregar lineas a cotizacion
|
|
- US-MMD006-003: Aplicar descuentos
|
|
- US-MMD006-004: Enviar cotizacion al cliente
|
|
- US-MMD006-005: Generar PDF de cotizacion
|
|
- US-MMD006-006: Convertir cotizacion a orden
|
|
- US-MMD006-007: Ver historial de cotizaciones
|
|
|
|
---
|
|
|
|
## SCHEMAS DE BASE DE DATOS (7)
|
|
|
|
| Schema | Tablas | Descripcion | DDL |
|
|
|--------|--------|-------------|-----|
|
|
| workshop_core | 9 | Configuracion, usuarios, clientes, servicios | 01-create-schemas.sql |
|
|
| service_management | 14+ | Ordenes, diagnosticos, cotizaciones, firma | 03-service-management.sql, 11-quote-signature.sql |
|
|
| parts_management | 12+ | Inventario, refacciones, garantias | 04-parts-management.sql, 10-warranty-claims.sql |
|
|
| vehicle_management | 8 | Vehiculos, flotas, motores | 05-vehicle-management.sql |
|
|
| notifications | 6 | Tracking, followers, actividades | 07-notifications-schema.sql |
|
|
| analytics | 4 | Contabilidad analitica, P&L por orden | 08-analytics-schema.sql |
|
|
| purchasing | 5 | Ordenes de compra, proveedores, recepciones | 09-purchasing-schema.sql |
|
|
|
|
**Total:** 65+ tablas con RLS multi-tenant
|
|
|
|
### Archivos DDL
|
|
|
|
```
|
|
database/init/
|
|
├── 00-extensions.sql # Extensiones PostgreSQL
|
|
├── 01-create-schemas.sql # Creacion de schemas
|
|
├── 02-rls-functions.sql # Funciones RLS multi-tenant
|
|
├── 03-service-management-tables.sql # Ordenes, diagnosticos
|
|
├── 04-parts-management-tables.sql # Inventario, refacciones
|
|
├── 05-vehicle-management-tables.sql # Vehiculos, flotas
|
|
├── 06-seed-data.sql # Datos iniciales
|
|
├── 07-notifications-schema.sql # Tracking, followers, actividades
|
|
├── 08-analytics-schema.sql # Contabilidad analitica
|
|
├── 09-purchasing-schema.sql # Compras y proveedores
|
|
├── 10-warranty-claims.sql # Garantias de refacciones
|
|
└── 11-quote-signature.sql # Firma electronica basica
|
|
```
|
|
|
|
---
|
|
|
|
## FUNCIONALIDADES ADICIONALES IMPLEMENTADAS
|
|
|
|
| Funcionalidad | Descripcion | DDL |
|
|
|---------------|-------------|-----|
|
|
| Sistema de tracking | Historial de cambios en documentos | 07-notifications-schema.sql |
|
|
| Followers/suscriptores | Notificaciones automaticas | 07-notifications-schema.sql |
|
|
| Actividades programadas | Recordatorios y tareas | 07-notifications-schema.sql |
|
|
| Contabilidad analitica | P&L por orden de servicio | 08-analytics-schema.sql |
|
|
| Gestion de compras | Ordenes de compra y RFQ | 09-purchasing-schema.sql |
|
|
| Tracking de garantias | Control de garantias de refacciones | 10-warranty-claims.sql |
|
|
| Firma electronica | Aprobacion de cotizaciones | 11-quote-signature.sql |
|
|
|
|
**Funcionalidades para Fase 2:**
|
|
- MMD-007 Facturacion integrada (CFDI)
|
|
- Portal de clientes
|
|
|
|
---
|
|
|
|
## PROXIMOS PASOS
|
|
|
|
1. **Iniciar desarrollo backend** - APIs REST con NestJS
|
|
2. **Crear especificaciones tecnicas (ET)** - ET por modulo con endpoints y UI
|
|
3. **Implementar modulo MMD-007 Facturacion** - Fase 2 con CFDI
|
|
|
|
---
|
|
|
|
## ARQUITECTURA
|
|
|
|
**Tipo:** Proyecto Independiente - ERP Vertical para Talleres Diesel
|
|
|
|
**Stack Tecnologico:**
|
|
- **Base de datos:** PostgreSQL 15+ con RLS multi-tenant
|
|
- **Backend:** Node.js + NestJS + TypeScript
|
|
- **Frontend:** React + TypeScript
|
|
- **Autenticacion:** JWT + RBAC
|
|
|
|
**Patrones Implementados:**
|
|
- Multi-tenancy con Row Level Security (RLS)
|
|
- Arquitectura modular por dominio
|
|
- Sistema de tracking y notificaciones
|
|
- Contabilidad analitica por orden
|
|
|
|
**Opera de forma autonoma:** Sistema standalone sin dependencias externas
|
|
|
|
---
|
|
|
|
## METRICAS
|
|
|
|
| Metrica | Valor |
|
|
|---------|-------|
|
|
| Epicas MVP | 6 completas |
|
|
| Story Points | 241 SP |
|
|
| Historias detalladas | 55 |
|
|
| Cobertura US | 100% |
|
|
| Schemas BD | 7 completos |
|
|
| Tablas BD | 65+ |
|
|
| Funcionalidades adicionales | 7 implementadas |
|
|
| Sprints estimados | 10 |
|
|
|
|
---
|
|
|
|
*Proyecto parte de ERP Suite - Fabrica de Software con Agentes IA*
|
|
*Ultima actualizacion: 2025-12-12*
|