Files
checklist/GUIA_MECANICO.md
2025-11-18 16:46:20 -03:00

4.4 KiB

Guía de Uso - Interfaz del Mecánico

🔧 Nueva Funcionalidad: Realizar Inspecciones

Inicio de Sesión

  1. Accede a http://localhost:5173
  2. Ingresa como mecánico:
    • Usuario: mecanico1
    • Contraseña: mecanico123

Realizar una Nueva Inspección

Paso 1: Seleccionar Checklist

  1. En la pestaña "Checklists", verás todos los checklists disponibles
  2. Cada checklist muestra:
    • Nombre y descripción
    • Puntuación máxima
    • Modo de IA (off/assisted/full)
  3. Haz clic en el botón "Nueva Inspección" del checklist que deseas usar

Paso 2: Datos del Vehículo

El modal se abrirá mostrando un formulario con:

  • Placa del Vehículo* (requerido)
  • Marca* (requerido)
  • Modelo* (requerido)
  • Año
  • Kilometraje
  • Número de OR (Orden de Reparación)
  • Nombre del Cliente
  • Teléfono del Cliente

Los campos marcados con asterisco son obligatorios

Haz clic en "Continuar" para avanzar.

Paso 3: Responder Preguntas

El sistema te mostrará cada pregunta del checklist una por una:

Tipos de Respuesta:

  • Pasa/Falla: Opciones de radio para indicar si pasa o no la verificación
  • Bueno/Regular/Malo: Menú desplegable para calificar el estado
  • Numérico: Campo para ingresar valores numéricos (ej: presión de neumáticos)
  • Estado: Opciones OK/Advertencia/Crítico
  • Texto: Campo de texto libre para respuestas descriptivas

Para cada pregunta puedes:

  • Ingresar la respuesta requerida
  • 📝 Agregar observaciones (opcional)
  • 📷 Subir fotografías si la pregunta lo permite (opcional)

Navegación:

  • Botón "← Anterior" para volver a la pregunta anterior
  • Botón "Siguiente →" para avanzar a la siguiente pregunta
  • Botón "Continuar a Firmas" al finalizar todas las preguntas

Paso 4: Firmas

Al completar todas las preguntas:

  1. Se mostrará un mensaje de confirmación verde
  2. Verás dos áreas de firma:
    • Firma del Mecánico (tú)
    • Firma del Cliente
  3. Usa el cursor/stylus/dedo para dibujar las firmas
  4. Botón "Limpiar" para borrar y volver a firmar
  5. Haz clic en "✓ Finalizar Inspección"

Paso 5: PDF Automático

Al finalizar:

  • El sistema generará automáticamente un PDF con todos los datos
  • El PDF se descargará a tu dispositivo
  • La inspección quedará registrada en la pestaña "Inspecciones"

Ver Inspecciones Realizadas

  • Cambia a la pestaña "Inspecciones"
  • Verás todas tus inspecciones con:
    • Datos del vehículo
    • Fecha de realización
    • Puntuación obtenida (score/max_score y porcentaje)
    • Número de elementos señalados (si los hay)
  • Botón "Ver Detalle" para consultar la inspección completa

📊 Ejemplo de Checklist Disponible

"Inspección Vehicular Completa" (103 preguntas)

Secciones:

  1. Documentación del Vehículo (8 preguntas)
  2. Inspección Exterior (9 preguntas)
  3. Neumáticos y Ruedas (9 preguntas)
  4. Sistema Eléctrico (10 preguntas)
  5. Motor y Compartimento (9 preguntas)
  6. Sistema de Frenos (9 preguntas)
  7. Suspensión y Dirección (8 preguntas)
  8. Interior del Vehículo (10 pregunas)
  9. Sistema de Seguridad (9 preguntas)
  10. Transmisión (6 preguntas)
  11. Sistema de Escape (7 preguntas)
  12. Prueba de Ruta (6 preguntas)
  13. Verificación Final (3 preguntas)

Total: 147 puntos máximos

🎯 Consejos

  • Completa todas las preguntas con atención
  • 📸 Toma fotos de elementos importantes o con fallas
  • 📝 Agrega observaciones detalladas cuando sea necesario
  • ✍️ Asegúrate de que ambas firmas estén claras
  • 💾 El PDF se genera automáticamente al finalizar

🔄 Flujo Técnico (Backend)

  1. POST /api/checklists/{id}/inspections - Crea la inspección con datos del vehículo
  2. POST /api/inspections/{id}/answers - Guarda cada respuesta
  3. POST /api/inspections/{id}/answers/{answer_id}/upload-photo - Sube fotos (si hay)
  4. PATCH /api/inspections/{id} - Actualiza con firmas en base64
  5. GET /api/inspections/{id}/pdf - Genera y descarga el PDF

🛠️ Próximos Pasos

Esta es la primera versión del MVP. Funcionalidades futuras:

  • Vista detallada de inspecciones completadas
  • Edición de inspecciones en progreso
  • Filtros y búsqueda de inspecciones
  • Dashboard con estadísticas
  • Notificaciones y alertas
  • Integración con IA para recomendaciones

¿Preguntas o problemas? Revisa la consola del navegador (F12) o los logs de Docker para más información.