erp-mecanicas-diesel/orchestration/00-guidelines/HERENCIA-ERP-CORE.md

172 lines
4.0 KiB
Markdown

# Herencia de ERP Core - Vertical Mecanicas Diesel
**Version:** 1.0.0
**Vertical:** Mecanicas Diesel
**Nivel:** STANDALONE (proyecto independiente)
**Version ERP-Core:** 1.2.0
**Ruta ERP-Core:** projects/erp-core
**Herencia:** 60-70% de funcionalidad base de erp-core
**Fecha Migracion:** 2025-12-27
---
## RESUMEN DE HERENCIA
Este documento especifica exactamente que hereda la vertical Mecanicas Diesel del ERP Core y como lo extiende.
---
## 1. MODULOS HEREDADOS (100%)
| Modulo Core | Codigo | Uso en Mecanicas |
|-------------|--------|------------------|
| Auth | MGN-001 | Autenticacion |
| Users | MGN-002 | Gestion de mecanicos y recepcionistas |
| Roles | MGN-003 | Roles por puesto (mecanico, jefe taller) |
| Audit | MGN-007 | Bitacora de operaciones |
| Notifications | MGN-008 | Alertas de vehiculos listos |
| Reports | MGN-009 | Reportes de taller |
**Accion:** NO crear codigo para estos modulos. Usar directamente del core.
---
## 2. MODULOS HEREDADOS Y EXTENDIDOS
### MGN-004: Tenants → Talleres
```yaml
herencia_base:
- Multi-tenancy basico
extension_mecanicas:
- Taller como tenant
- Campos adicionales:
- especialidades (diesel, gasolina, hibrido)
- certificaciones_fabricantes
- capacidad_bahias
- Relaciones:
- taller → bahias (1:N)
- taller → mecanicos (1:N)
```
### MGN-005: Catalogs → Catalogos Automotrices
```yaml
herencia_base:
- CRUD de catalogos genericos
extension_mecanicas:
- Catalogo de marcas/modelos vehiculos
- Catalogo de tipos de servicio
- Catalogo de refacciones comunes
- Catalogo de mano de obra estandar
- Catalogo de codigos de falla OBD
```
### MGN-011: Inventory → Refacciones
```yaml
herencia_base:
- Productos y variantes
- Movimientos de stock
extension_mecanicas:
- Refacciones por marca/modelo
- Compatibilidad cruzada
- Minimos por frecuencia de uso
- Proveedores automotrices
```
---
## 3. ESPECIFICACIONES TRANSVERSALES HEREDADAS
### Obligatorias
| Especificacion | Gap | Uso |
|----------------|-----|-----|
| `SPEC-VALORACION-INVENTARIO.md` | GAP-MGN-005 | Costeo de refacciones |
| `SPEC-TRAZABILIDAD-LOTES-SERIES.md` | GAP-MGN-005 | Tracking de refacciones criticas |
| `SPEC-INVENTARIOS-CICLICOS.md` | GAP-MGN-005 | Conteo de refacciones |
### Recomendadas
| Especificacion | Gap | Uso |
|----------------|-----|-----|
| `SPEC-SISTEMA-SECUENCIAS.md` | GAP-MGN-004 | Foliado de ordenes de trabajo |
| `SPEC-MAIL-THREAD-TRACKING.md` | Patron | Comunicacion con clientes |
| `SPEC-GASTOS-EMPLEADOS.md` | GAP-MGN-010 | Viaticos de mecanicos externos |
---
## 4. MODULOS PROPIOS (No heredados)
| Codigo | Modulo | Descripcion |
|--------|--------|-------------|
| MD-001 | work_orders | Ordenes de trabajo |
| MD-002 | vehicles | Registro de vehiculos clientes |
| MD-003 | diagnostics | Diagnostico y fallas |
| MD-004 | quotations | Cotizaciones de servicio |
| MD-005 | billing | Facturacion de servicios |
| MD-006 | warranty | Control de garantias |
---
## 5. SCHEMAS DE BASE DE DATOS
### Heredados de Core
```yaml
schemas_core:
- auth
- core_users
- core_rbac
- core_tenants (extendido)
- core_catalogs (extendido)
- core_audit
```
### Propios de Mecanicas
```yaml
schemas_vertical:
- vertical_mecanicas
- work_orders
- vehicles
- diagnostics
- service_history
- warranties
```
---
## 6. CONSIDERACIONES ESPECIALES
### Clientes y Vehiculos
- Un cliente puede tener multiples vehiculos
- Historial de servicio por vehiculo
- Kilometraje y proximos servicios
### Integracion Futura
- Lectura de OBD-II para diagnostico
- Catalogos de refacciones externos
---
## 7. REFERENCIAS
| Recurso | Ubicacion |
|---------|-----------|
| MASTER_INVENTORY Core | `erp-core/orchestration/inventarios/MASTER_INVENTORY.yml` |
| Specs Transversales | `erp-core/docs/04-modelado/especificaciones-tecnicas/transversal/` |
| HERENCIA-DIRECTIVAS | `./HERENCIA-DIRECTIVAS.md` |
---
*Sistema NEXUS + SIMCO v2.2.0*
*Vertical: Mecanicas Diesel (Nivel 2B.2)*
*Ultima actualizacion: 2025-12-08*