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-003-diagnosticos.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

6.4 KiB
Raw Permalink Blame History

EPICA: EPIC-MMD-003 - Diagnosticos y Pruebas

Metadata

Campo Valor
ID EPIC-MMD-003
Nombre Diagnosticos y Pruebas
Modulo diagnosticos
Fase Fase 1 - MVP
Prioridad P0 (Critico)
Estado Backlog
Story Points 42
Sprint(s) Sprint 3-4

Descripcion

Modulo especializado para el registro y seguimiento de diagnosticos y pruebas realizadas a equipos diesel. Incluye diagnosticos computarizados, pruebas de banco (inyectores, bombas), mediciones y resultados con parametros de referencia. Permite documentar problemas encontrados y recomendaciones.

Objetivo de Negocio

  • Estandarizar proceso de diagnostico
  • Documentar problemas y soluciones para consulta futura
  • Justificar trabajos ante el cliente con evidencia
  • Reducir diagnosticos repetidos (consulta de historial)
  • Base para cotizaciones precisas

Historias de Usuario

ID Historia Prioridad SP Estado
US-MMD003-001 Como mecanico, quiero registrar diagnostico computarizado con codigos de error para documentar fallas P0 8 Backlog
US-MMD003-002 Como mecanico, quiero registrar pruebas de banco de inyectores con resultados para evaluar estado P0 8 Backlog
US-MMD003-003 Como mecanico, quiero registrar pruebas de bomba de inyeccion con parametros para diagnosticar P0 5 Backlog
US-MMD003-004 Como mecanico, quiero comparar resultados vs valores de referencia para determinar estado P0 5 Backlog
US-MMD003-005 Como mecanico, quiero adjuntar fotos de partes danadas para evidencia P1 5 Backlog
US-MMD003-006 Como mecanico, quiero registrar recomendaciones de reparacion para la cotizacion P0 3 Backlog
US-MMD003-007 Como jefe de taller, quiero ver historial de diagnosticos por vehiculo para consulta P1 5 Backlog
US-MMD003-008 Como admin, quiero configurar tipos de prueba con parametros de referencia P2 3 Backlog

Total Story Points: 42 SP

Tipos de Diagnostico Soportados

Diagnostico Computarizado (OBD/Scanner)

Campo Descripcion
Codigo DTC Codigo de falla (ej: P0201)
Descripcion Descripcion del codigo
Sistema Motor, Transmision, Frenos, etc.
Gravedad Critico, Importante, Menor
Congelado Si/No (freeze frame)

Prueba de Banco - Inyectores

Parametro Unidad Rango Normal
Presion Apertura PSI 2800-3200
Patron de Spray Visual Uniforme
Retorno ml/min 0-20
Goteo Visual Ninguno
Caudal ml/100 inyecciones 45-55

Prueba de Banco - Bomba Inyeccion

Parametro Unidad Descripcion
Presion Maxima PSI A RPM especificadas
Caudal por Cilindro ml/min Balance entre cilindros
Timing Grados Punto de inyeccion
Curva de Avance Grafica Comportamiento vs RPM

Mediciones Generales

Medicion Unidad Equipo
Compresion PSI Compresimetro
Voltaje Bateria V Multimetro
Resistencia Sensor Ohms Multimetro
Temperatura C Termometro
Presion Aceite PSI Manometro

Criterios de Aceptacion de la Epica

Funcionales:

  • Registro de diagnostico computarizado con codigos
  • Registro de pruebas de banco con plantillas
  • Comparacion automatica vs valores de referencia
  • Semaforo de estado (verde/amarillo/rojo)
  • Adjuntar fotos como evidencia
  • Generar recomendaciones de reparacion
  • Vincular diagnostico a orden de servicio

No Funcionales:

  • Carga de formulario diagnostico < 1 segundo
  • Soporte de imagenes hasta 5MB
  • Historial consultable en < 500ms

Tecnicos:

  • Almacenamiento de imagenes (S3 o local)
  • Integracion con modulo Vehiculos
  • Integracion con modulo Ordenes
  • Export a PDF de diagnostico

Dependencias

Esta epica depende de:

Epica/Modulo Estado Bloqueante
EPIC-MMD-001 Fundamentos Backlog Si
EPIC-MMD-005 Vehiculos Backlog Si

Esta epica bloquea:

Epica/Modulo Razon
EPIC-MMD-002 Ordenes Requiere diagnosticos
EPIC-MMD-006 Cotizaciones Usa recomendaciones

Desglose Tecnico

Database:

  • Schema: service_management (compartido con ordenes)
  • Tablas: 6 (diagnosticos, diagnostico_items, pruebas_banco, fotos, referencias, etc.)
  • Funciones: 2 (evaluar_resultado, generar_reporte)

Backend:

  • Modulo: diagnostics
  • Entities: 5 (Diagnostic, DiagnosticItem, BenchTest, Photo, Reference)
  • Endpoints: 15+
  • Tests: 25+

Frontend:

  • Paginas: 3 (DiagnosticForm, DiagnosticDetail, DiagnosticHistory)
  • Componentes: 12+ (DTCInput, BenchTestForm, PhotoUpload, ResultCard, etc.)
  • Stores: 1 (diagnosticsStore)

Endpoints API

Metodo Endpoint Descripcion
POST /api/diagnostics Crear diagnostico
GET /api/diagnostics/:id Detalle diagnostico
POST /api/diagnostics/:id/dtc Agregar codigo DTC
POST /api/diagnostics/:id/bench-test Agregar prueba banco
POST /api/diagnostics/:id/photos Subir foto
GET /api/vehicles/:id/diagnostics Historial por vehiculo
GET /api/references/injectors/:type Valores referencia
GET /api/diagnostics/:id/pdf Exportar PDF

Riesgos

Riesgo Probabilidad Impacto Mitigacion
Valores referencia incompletos Alta Medio Permitir captura manual
Fotos muy pesadas Media Bajo Compresion automatica
Mecanicos no documentan Alta Alto UI simple, campos minimos

Definition of Ready (DoR)

  • Historias de usuario definidas
  • Criterios de aceptacion claros
  • Tipos de diagnostico identificados
  • Parametros de referencia documentados
  • Diseno de formularios aprobado

Definition of Done (DoD)

  • Formularios de diagnostico funcionando
  • Pruebas de banco con plantillas
  • Comparacion vs referencia operativa
  • Upload de fotos funcionando
  • Export PDF
  • Tests pasando
  • Demo realizada

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