rckrdmrd/workspace-v1
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
main
workspace-v1/projects/erp-mecanicas-diesel/docs/08-epicas/EPIC-MMD-005-vehiculos.md
rckrdmrd 66161b1566 feat: Workspace-v1 complete migration with NEXUS v3.4 
Sistema NEXUS v3.4 migrado con:

Estructura principal:
- core/orchestration: Sistema SIMCO + CAPVED (27 directivas, 28 perfiles)
- core/catalog: Catalogo de funcionalidades reutilizables
- shared/knowledge-base: Base de conocimiento compartida
- devtools/scripts: Herramientas de desarrollo
- control-plane/registries: Control de servicios y CI/CD
- orchestration/: Configuracion de orquestacion de agentes

Proyectos incluidos (11):
- gamilit (submodule -> GitHub)
- trading-platform (OrbiquanTIA)
- erp-suite con 5 verticales:
  - erp-core, construccion, vidrio-templado
  - mecanicas-diesel, retail, clinicas
- betting-analytics
- inmobiliaria-analytics
- platform_marketing_content
- pos-micro, erp-basico

Configuracion:
- .gitignore completo para Node.js/Python/Docker
- gamilit como submodule (git@github.com:rckrdmrd/gamilit-workspace.git)
- Sistema de puertos estandarizado (3005-3199)

Generated with NEXUS v3.4 Migration System
EPIC-010: Configuracion Git y Repositorios
2026-01-04 03:37:42 -06:00

7.2 KiB
Raw Permalink Blame History

EPICA: EPIC-MMD-005 - Vehiculos y Equipos

Metadata

Campo Valor
ID EPIC-MMD-005
Nombre Vehiculos y Equipos
Modulo vehiculos
Fase Fase 1 - MVP
Prioridad P0 (Critico)
Estado Backlog
Story Points 34
Sprint(s) Sprint 2

Descripcion

Modulo de registro y gestion de vehiculos y equipos diesel que ingresan al taller. Incluye datos tecnicos del vehiculo (marca, modelo, motor, VIN), datos del propietario/cliente, y mantiene el historial completo de servicios realizados.

Objetivo de Negocio

  • Trazabilidad completa: historial por vehiculo
  • Evitar diagnosticos repetidos (consultar historial)
  • Conocer al cliente y su flota
  • Base para mantenimiento preventivo
  • Facilitar garantias (saber que se hizo antes)

Historias de Usuario

ID Historia Prioridad SP Estado
US-MMD005-001 Como recepcionista, quiero registrar vehiculo con datos basicos (placas, marca, modelo) para identificarlo P0 5 Backlog
US-MMD005-002 Como recepcionista, quiero registrar datos tecnicos del motor diesel (tipo, litros, serie) para diagnosticos P0 5 Backlog
US-MMD005-003 Como recepcionista, quiero asociar vehiculo a un cliente (propietario o empresa) P0 3 Backlog
US-MMD005-004 Como recepcionista, quiero buscar vehiculo por placas, VIN o cliente para verificar si ya existe P0 3 Backlog
US-MMD005-005 Como mecanico, quiero ver historial completo de servicios del vehiculo para consulta rapida P0 5 Backlog
US-MMD005-006 Como jefe de taller, quiero ver kilometraje historico para detectar patrones de uso P1 3 Backlog
US-MMD005-007 Como admin, quiero importar flota de vehiculos desde Excel para clientes grandes P1 5 Backlog
US-MMD005-008 Como recepcionista, quiero registrar fotos del vehiculo al ingreso para documentar estado P2 5 Backlog

Total Story Points: 34 SP

Estructura de Datos del Vehiculo

Datos Generales

Campo Tipo Requerido Descripcion
placas string Si Placas del vehiculo
vin string No Numero de identificacion (17 chars)
marca string Si Marca (Kenworth, Freightliner, etc.)
modelo string Si Modelo del vehiculo
anio number Si Ano del modelo
color string No Color del vehiculo
tipo enum Si Tracto, Camion, Autobus, Equipo
cliente_id FK Si Propietario

Datos Tecnicos Motor

Campo Tipo Descripcion
motor_marca string Cummins, Detroit, CAT, Paccar, etc.
motor_modelo string Modelo del motor (ej: ISX15)
motor_serie string Numero de serie del motor
motor_litros number Desplazamiento (ej: 15.0)
motor_hp number Potencia (ej: 500)
transmision string Tipo y marca transmision
ejes number Numero de ejes

Datos de Seguimiento

Campo Tipo Descripcion
km_actual number Ultimo kilometraje registrado
horas_motor number Horometro (equipos)
fecha_ultimo_servicio date Ultima visita al taller
proximo_servicio_km number Km para proximo mantenimiento

Tipos de Vehiculo/Equipo

Tipo Descripcion Ejemplos
TRACTO Tractocamion Kenworth T680, Freightliner Cascadia
CAMION Camion de carga International, Hino, Isuzu
AUTOBUS Autobus de pasajeros Volvo, Mercedes, Scania
VOLTEO Camion de volteo Famsa, Dina
PIPA Pipa de combustible/agua Diversos
EQUIPO Maquinaria pesada Generadores, compresores
AGRICOLA Equipo agricola Tractores, cosechadoras

Criterios de Aceptacion de la Epica

Funcionales:

  • Registro de vehiculo con placas obligatorias
  • Datos tecnicos del motor diesel
  • Asociacion a cliente (1 vehiculo = 1 cliente principal)
  • Busqueda por placas, VIN, marca, cliente
  • Historial de servicios y diagnosticos
  • Historial de kilometraje
  • Registro de fotos de estado
  • Import desde Excel

No Funcionales:

  • Busqueda por placas < 200ms
  • Historial carga < 1 segundo
  • Soporte 10,000+ vehiculos

Tecnicos:

  • Integracion con modulo Clientes
  • Integracion con modulo Ordenes
  • Integracion con modulo Diagnosticos
  • Validacion de VIN (formato)

Dependencias

Esta epica depende de:

Epica/Modulo Estado Bloqueante
EPIC-MMD-001 Fundamentos Backlog Si
MGN-014 CRM/Clientes (Core) Pendiente Si

Esta epica bloquea:

Epica/Modulo Razon
EPIC-MMD-002 Ordenes Requiere vehiculo
EPIC-MMD-003 Diagnosticos Requiere vehiculo
EPIC-MMA-011 Mant. Preventivo Historial

Desglose Tecnico

Database:

  • Schema: vehicle_management
  • Tablas: 5 (vehicles, vehicle_photos, km_log, brands_models, etc.)
  • Indices: Por placas, VIN, cliente, marca

Backend:

  • Modulo: vehicles
  • Entities: 4 (Vehicle, VehiclePhoto, KmLog, Brand)
  • Endpoints: 12+
  • Tests: 20+

Frontend:

  • Paginas: 3 (VehiclesList, VehicleDetail, VehicleForm)
  • Componentes: 8+ (VehicleCard, HistoryTimeline, PhotoGallery, etc.)
  • Stores: 1 (vehiclesStore)

Endpoints API

Metodo Endpoint Descripcion
GET /api/vehicles Listar vehiculos (paginado, filtros)
POST /api/vehicles Registrar vehiculo
GET /api/vehicles/:id Detalle vehiculo
PATCH /api/vehicles/:id Actualizar vehiculo
GET /api/vehicles/:id/history Historial de servicios
GET /api/vehicles/:id/km-log Historial de kilometraje
POST /api/vehicles/:id/photos Subir fotos
GET /api/vehicles/search Busqueda rapida
POST /api/vehicles/import Import desde Excel
GET /api/clients/:id/vehicles Vehiculos por cliente

Marcas de Motores Diesel Soportados

Marca Modelos Comunes
Cummins ISX15, ISX12, ISB6.7, ISL9
Detroit DD15, DD13, Series 60
Caterpillar C15, C13, 3406E
Paccar MX-13, MX-11
Navistar N13, A26
Volvo D13, D11
Mercedes OM471, OM470, OM936
Scania DC13, DC16
Hino J08E, J05E
Isuzu 4HK1, 6HK1

Riesgos

Riesgo Probabilidad Impacto Mitigacion
Placas duplicadas Media Bajo Validacion unica
Datos motor incompletos Alta Medio Campos opcionales
Fotos pesadas Media Bajo Compresion automatica

Definition of Ready (DoR)

  • Historias de usuario definidas
  • Estructura de datos clara
  • Tipos de vehiculo definidos
  • Catalogo de marcas/modelos

Definition of Done (DoD)

  • CRUD de vehiculos funcionando
  • Busqueda por placas/VIN
  • Historial de servicios visible
  • Asociacion a clientes
  • Import Excel
  • Tests pasando

Historial

Fecha Cambio Autor
2025-12-06 Creacion de epica Requirements-Analyst

Creada por: Requirements-Analyst Fecha: 2025-12-06 Ultima actualizacion: 2025-12-06