Primer commit

HANDOFF.md

@@ -0,0 +1,73 @@
+================================
+HANDOFF PROYECTO PANEL VUE
+Fecha: 2026-07-10
+Ruta local actual: C:/python/test/panel
+
+1. Resumen ejecutivo
+Proyecto migrado a arquitectura de panel admin con Vue 3 + Vite + Tailwind.
+Login obligatorio antes de entrar al panel, con guard de rutas.
+Integración de WebSocket activa.
+Búsqueda principal en Dashboard (3 pestañas: Teléfono, Placa, Nombre).
+Monitor WS con logs.
+Arquitectura nueva de resultados normalizados en árbol (sesión -> base -> card -> búsquedas hijas).
+Exportación de reporte final en JSON y PDF desde selección de cards.
+2. Estado funcional implementado
+Autenticación:
+Login y sesión en localStorage.
+Ruta protegida para admin.
+Layout:
+Navbar, Sidebar, Footer.
+Sidebar colapsable y persistente.
+Dashboard:
+Formulario de búsqueda principal.
+Envío por WS con contrato alineado a HomeView.
+Resultados:
+Store central de resultados.
+Adaptadores por fuente/base.
+Tablero agrupado por base.
+Cards con acciones para búsquedas derivadas.
+Reportes:
+Selección manual de cards.
+Exportación JSON.
+Exportación PDF (imprimible).
+3.Archivos clave
+src/views/DashboardView.vue
+src/composables/useSearchResultsStore.js
+src/composables/useWsMonitor.js
+src/components/WsMonitorPanel.vue
+src/components/results/SearchResultBoard.vue
+src/components/results/SourceGroup.vue
+src/components/results/ResultCard.vue
+src/components/results/ChildSearchPanel.vue
+src/components/report/ReportBuilderSheet.vue
+src/services/wsService.js
+src/services/auth.js
+src/services/resultAdapters/index.js
+src/services/resultAdapters/adapterGeneric.js
+src/services/resultAdapters/adapterIne.js
+src/services/resultAdapters/adapterActas.js
+src/services/resultAdapters/adapterPlacas.js
+.env.example
+
+4. Variables de entorno requeridas
+VITE_AUTH_LOGIN_URL
+VITE_AUTH_CLIENT_ID
+VITE_AUTH_CLIENT_SECRET
+VITE_WS_HOST
+VITE_WS_PORT
+VITE_WS_PATH
+VITE_WS_SECURE
+5. Punto crítico validado
+Se eliminó la inyección de requestId dentro de busqueda.context para respetar contrato de backend WS.
+El envío actual de búsqueda usa estructura:
+cmd: busqueda
+busqueda.query
+busqueda.context
+Pendientes recomendados
+Pendientes recomendados
+Cambiar searchLoading para que termine con respuesta real WS y no por timeout.
+Agregar validaciones visuales por pestaña de búsqueda.
+Paginación o virtualización por grupo cuando haya muchos resultados.
+Persistencia opcional de sesiones de resultados.
+================================
+FIN HANDOFF