Nuevo Commit

GUIA_MECANICO.md

@@ -0,0 +1,131 @@
+# 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.