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

4.0 KiB

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

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

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

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

schemas_core:
  - auth
  - core_users
  - core_rbac
  - core_tenants (extendido)
  - core_catalogs (extendido)
  - core_audit

Propios de Mecanicas

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