🐕 Panchita — Scan + Especificación VOY v3

Gaps críticos

Parcialmente cubiertos

US-01: Sistema de reclamos

Como cliente, quiero reportar un problema con un servicio, para resolver disputas y obtener reembolso.

Criterios de aceptación

• Botón "Reportar problema" visible en booking completado o en curso
• 4 tipos de reclamo: mala calidad, no se presentó, trabajo incompleto, daños
• Campo de descripción obligatorio (min 20 caracteres)
• Upload de fotos como evidencia (Airtable attachments, max 5 fotos)
• Estado del reclamo visible para el cliente: abierto → en revisión → resuelto
• Admin puede: tomar caso, agregar nota interna, resolver con reembolso total/parcial/sin reembolso
• Email de notificación al cliente cuando se resuelve

Tabla Airtable: Claims

• ClaimId (autonumber), BookingRecordId (link), ClientRecordId, WorkerRecordId
• Type (singleSelect: mala_calidad, no_show, incompleto, daños)
• Description (long text), Photos (attachment)
• Status (singleSelect: open, reviewing, resolved)
• AdminNotes (long text), RefundAmount (number), RefundType (singleSelect: full, partial, none)
• CreatedAt, ResolvedAt (datetime)

US-02: Solicitud urgente

Como cliente, quiero marcar una solicitud como urgente, para conseguir ayuda rápidamente.

Criterios de aceptación

• Toggle "Solicitud urgente" en el formulario de nueva solicitud (dentro de bookingModal)
• Card urgente tiene borde rojo + badge "⚡ URGENTE" en la lista de solicitudes del worker
• Solicitudes urgentes aparecen primero en la lista del worker
• Campo IsUrgent (checkbox) en tabla Requests

US-03: Materiales guardados

Como profesional, quiero guardar materiales que uso frecuentemente, para cotizar más rápido.

Criterios de aceptación

• Botón "📦 Mis materiales" en el modal de cotización
• Lista desplegable de materiales guardados con nombre + precio unitario
• Click en material lo agrega a la tabla de materiales de la cotización
• CRUD de materiales guardados en perfil del worker (agregar, editar, eliminar)
• Tabla SavedMaterials: MatId, WorkerRecordId, Name, UnitPrice, Unit

US-04: Sistema de niveles

Como profesional, quiero ver mi nivel y progreso, para motivarme a completar más trabajos.

Criterios de aceptación

• 3 niveles: 🥉 Bronce (0-19 trabajos), 🥈 Plata (20-49), 🥇 Oro (50+)
• Badge de nivel visible en: dashboard worker, perfil público, worker cards
• Progress bar hacia el siguiente nivel
• Campo Level (formula basada en CompletedJobs) en tabla Workers
• Vista "Ganancias" muestra nivel + rendimiento (tasa aceptación, precio promedio, mejor día, racha)

US-05: Horario semanal + disponibilidad mejorada

Como profesional, quiero configurar mi horario por día + radio de cobertura + modo vacaciones.

Criterios de aceptación

• 7 filas (Lun-Dom) con toggle activo/inactivo + hora inicio + hora fin
• Slider de radio de cobertura (1-50 km)
• Toggle "Modo vacaciones" que pausa todas las solicitudes
• Tabla WorkerSchedule: ScheduleId, WorkerRecordId, DayOfWeek (0-6), StartTime, EndTime, IsActive
• Campos adicionales en Workers: CoverageRadius (number), VacationMode (checkbox)

US-06: Centro de notificaciones mejorado

Como usuario, quiero ver todas mis notificaciones organizadas, para no perderme nada.

Criterios de aceptación

• Tabla Notifications en Airtable (reemplaza notificaciones hardcoded)
• Tipos: quotation_received, quotation_accepted, booking_confirmed, worker_on_way, job_completed, claim_resolved
• Dot de "no leída" en cada notificación + counter en bell de topbar
• Marcar como leída al abrir
• Filtros: todas, sin leer, cotizaciones, sistema

US-07: Comparador de cotizaciones

Como cliente, quiero comparar cotizaciones lado a lado, para elegir la mejor opción.

Criterios de aceptación

• Cuando un booking tiene 2+ cotizaciones, mostrar vista comparador
• Highlight "🏆 Mejor precio" en la cotización más barata
• Mostrar: worker name, rating, verificación, precio, desglose, tiempo respuesta
• Botón "Aceptar" en cada cotización
• Se implementa dentro de view-activos o como modal

US-08: Timeline de booking

Como cliente, quiero ver el progreso de mi reserva visualmente.

Criterios de aceptación

• 5 pasos: Confirmada → Pagada → En camino → En curso → Completada
• Cada paso con icono (done ✓ / active ● / pending ○)
• Campo TimelineStatus en tabla Bookings (singleSelect)
• Worker puede avanzar el estado ("En camino", "Completar")

Cambios en Airtable

Tablas NUEVAS a crear

Campos NUEVOS en tablas existentes

Archivos JS a modificar

Archivos HTML a modificar

CSS — NO cambiar

• Mantener variables.css, main.css, app.css tal como están
• Nuevos estilos van inline en cada página (patrón existente)
• Color primario: #059669 (verde) — no cambiar
• Los 16 efectos CSS deben mantenerse sin modificación
• Nuevos componentes (claim card, timeline, comparator) siguen el design system existente

🔴 Fase 1 — Fundación (prerequisitos para todo lo demás)

🔴 Fase 2 — Features de cliente

🟡 Fase 3 — Features de worker

🟢 Fase 4 — Admin + pulido

📋 Resumen para Hoku

Stack: Vanilla JS + Airtable — NO migrar.
Color: Verde #059669.
Iconos: FontAwesome 6.5.
Comisión: 15%.
Layout: Desktop-first con sidebar, responsive mobile.
Patrón de código: funciones globales en archivos separados, showView() para toggle vistas, VOY.openModal() para modales, VoyDB.* para CRUD.
Despliegue: git push → Vercel auto-deploy voy-app-2, luego manual voy-app-3.
Testing: Probar en voy-app-2 primero (voy-app-2.vercel.app), luego fusionar a voy-app-3.
Orden: Fase 1 → 2 → 3 → 4. NO saltar fases. Cada fase debe funcionar antes de empezar la siguiente.
jsPDF: versión 2.5.1 (NO 2.5.2 que da 404).
Dev panel: no tocar, se inyecta automáticamente en voy-app-3.