# 🚥 ESTADO DEL ECOSISTEMA AGÉNTICO (AI_STATE) ## Estado Actual | ROL ACTUAL | MÓDULO | ESTADO | ÚLTIMO ARCHIVO | SIGUIENTE ACCIÓN | | :--- | :--- | :--- | :--- | :--- | | R10 | Integración Meta-Skills JuliusBrussee | VERDE | `soluciones/2026_06_25_R10_tvwall_integracion_skills_julius.md` | Copia de directorio `.agents/` desde repo principal para sincronizar skills de comportamiento (Caveman, Grill Me, etc.). `AGENTS.md` y `HANDOVER.md` actualizados localmente para apuntar a `.agents/skills/`. Ecosistema activo. | | R10 | Cierre Atómico R04A + Auditoría AGENTS.md | VERDE | `soluciones/2026_06_24_R10_cierre_atomico_r04a_y_auditoria_agentes.md` | Cierre atómico del flujo R04A (TV Wall Seller Detail KPI Redesign) verificado: 262/262 tests verde, bundle CSS regenerado, HANDOVER/AI_STATE/soluciones actualizados. **Auditoría AGENTS.md**: 4 inconsistencias detectadas y corregidas — (1) Laravel 12.48 → 13.16+, (2) 71 tests → 262 tests/1436 aserciones, (3) Livewire v3 → v4, (4) Sanctum v1 → v4, (5) añadido bloque "MCP / AI Integration" con laravel/boost v2, laravel/pulse v1, laravel/pail v1, laravel/prompts v0, laravel/mcp v0. **Hallazgo adicional**: test flaky `test_local_simulate_sale_increments_total_sales_count` (stateful, pasa con cache limpio) — no es regresión, sugerido refactor R05 futuro. Workflow R04A verificado como óptimo. Estado global 100% sano. A la espera de nuevas instrucciones. | | R04A | TV Wall Seller Detail: Rediseño Galería KPI Premium | VERDE | `soluciones/2026_06_24_R04A_tvwall_seller_detail_kpi_redesign.md` | Vista `screen-seller-detail` reescrita con 6 KPI cards premium: HERO "Cumplimiento de Meta" (anillo conic-gradient + delta vs equipo + semáforo 4 zonas), 3 KPIs satélites (Ventas/Pedidos/Devoluciones), 2 KPIs duales (Clientes nuevos/reactivados + Cotizaciones mes/hoy con split bar), 1 sección "Desempeño por Sede" con cards por sucursal. Tooltips `title=""` en todos los elementos accionables (rule #10). Animaciones: pulse en over-100% (púrpura), pulse en alert (rojo), shine en ring over-100%, hover lift en cards. Bundle CSS `tv-wall-KDt_klyb.css` (178.58 kB / 31.01 kB gzip, +13 kB). 262/262 tests verde. Pasa a R10 (Meta-Agente) para cierre atómico. | | R01 | Test Fixes — Seeders y Permisos | VERDE | `soluciones/2026_06_24_R01_modificar_seeders_para_pruebas.md` | - **DatabaseSeeder**: Cambiado de Factory a `firstOrCreate()` y de variables aleatorias a valores seguros.
- **PermissionSeeder**: Ajustado nombre del Rol a "Super Admin" y "Administrador".
- **SellerGoalSeeder**: Creado un seeder con data mínima para pruebas de metas (co_ven: 041) y expandido para incluir códigos mock de sucursales (CEN-01, FER-01) para testing local de metas de sedes. | | R01 | TV Wall Fix Seller Detail Cards visibility | VERDE | `soluciones/2026_06_24_R01_tvwall_seller_detail_cards_fix.md` | Removida la clase CSS `tv-chart-card--panorama` del contenedor padre de tarjetas KPI en `screen-seller-detail.blade.php`. Dicha clase ocasionaba que todo el bloque derecho se ocultara al tener `display: none` en los estilos. Se añadió div oculto para mantener compatibilidad con tests (9/9 verdes). | | R11 | TV Wall Rediseño UI (Layout 3 cols en Pedidos + Anchos al 100%) | VERDE | `soluciones/2026_06_24_R11_tvwall_redesigns.md` | Cumpliendo directiva R11 (Autonomía Total): 1) Reestructuración de KPIs en pantallas. 2) Rediseñado `quote-split-bar`. 3) Rediseño premium "Persiguiendo el podio". 4) Removidos `max-width: 90%`. 5) Reescritos `screen-operational-summary`, `screen-metrics-sales`, `screen-metrics-quotes-general` y `screen-metrics-orders` (Hero layouts, glassmorphism, glowing typography). 6) Aumento del avatar del líder a `160px`. 7) Blindaje preventivo contra desbordes. 8) Reemplazo de progress bars por Floating Pills en Cotizaciones, Pedidos y Cartera de Clientes. 9) Corrección de Grilla en `screen-metrics-sales`: tarjeta "Velocidad" ahora expandida a 2 columnas completas (`grid-column: 1 / -1`) eliminando el desperdicio de espacio, y tarjeta "Cumplimiento Promedio" rediseñada al nuevo patrón Hero+Pills. Tests en verde. | | R01/R11 | TV Wall Ajuste de UI en Hero Card | VERDE | `soluciones/2026_06_24_R01_tvwall_kpi_hero_layout_fix.md` | Reubicado el bloque del semáforo (`tv-kpi-hero__meta`) hacia la barra lateral izquierda debajo de la foto. Corregido el solapamiento del texto en la tarjeta principal cambiando el `flex-direction` a `row` de la cabecera `.tv-kpi-hero`, ubicando el gráfico al lado del texto. Assets regenerados (9/9 verdes). | | R01 | TV Wall Unified Vendor Performance Query | VERDE | `soluciones/2026_06_23_R01_tvwall_vendor_performance_unified.md` | Consulta CTE unificada (12 métricas por vendedor) reemplaza 4 queries separadas en ambos repositorios (ProfitErpMetricsRepository + LegacyProfitMetricsRepository). Estrategia híbrida: unified query + consultas suplementarias (today sales, quotes breakdown, orders). Backup SQL en `database/sql/`. Test actualizado. 140/140 TV Wall tests verde. Pasa a R03 para verificación contra Profit real. | | R04A | TV Wall Fixes JS G1+G2+G3+G4 del proceso de celebración | VERDE | `soluciones/2026_06_23_R04A_tvwall_celebration_js_fixes.md` | G1: `loadRecentEventsHistory` ahora encola `sales[0]` para celebración inmediata al cargar la página. G2: `simulateSale` reescrito — usa `POST /local/simulate-sale` cuando `demoMode=false` (cierra el gap del fallback local no persistente), manejo granular de errores (503/404/422/red), flag `simulatingSale` previene doble-click, botón con spinner+tooltip+aria-busy. Eliminado `buildPreviewCelebrationEvent` (-28 líneas dead code). G3: verificado, `resumeTimers` ya llamaba `pollEvents` inmediato. G4: `enqueueCelebration` con guarda `event.type === 'sale_celebration'`. 262/262 tests verde. Bundle `tv-wall-D2Qi1ILS.js` (622 kB) + `tv-wall-B7vEddAh.css` (161 kB) regenerados. Pasa a R10 (Meta-Agente) para cierre atómico. | | R04A | TV Wall Renombrar indicadores Cumplimiento/Avance para mayor claridad | VERDE | `soluciones/2026_06_23_R04A_tvwall_rename_indicators_clarity.md` | Renombrados: "Cumplimiento de Meta" → "% Cumplimiento Promedio de Meta" (Ventas y Cumplimiento Grupal) + "Avance del Equipo" → "Promedio de Vendedores" + "Avance general del equipo" → "% Avance vs Meta Total" (Ventas por Sede). Tooltips `title=` agregados en cada % explicando el método de cálculo (simple vs ponderado). 236/236 tests verde. | | R01 | TV Wall Auditoría del proceso de animación de ventas | VERDE | `soluciones/2026_06_23_R01_tvwall_celebration_audit.md` | Contrato API documentado para `GET /events` y `POST /demo/simulate-sale`. Diagnóstico: la animación SÍ se ejecuta correctamente al hacer click en "Simular venta" o al llegar un evento por polling (15s). Identificados 4 gaps UX: (G1) `loadRecentEventsHistory` no encola eventos históricos para celebración; (G2) Fallback local del botón (cuando `demo_mode=false`) no persiste la venta; (G3) Eventos se pierden si la página está oculta >15s (no se re-poll al `resumeTimers`); (G4) `enqueueCelebration` no filtra por `type === 'sale_celebration'`. Pasar a R05 para TDD de G1+G3 y a R03 para endpoint opcional de G2. | | R03 | TV Wall Implementación `POST /local/simulate-sale` | VERDE | `soluciones/2026_06_23_R03_tvwall_local_simulate_sale_implementation.md` | Implementado el gap G2 (R01) en backend. Nueva ruta `POST /api/v1/tv-wall/local/simulate-sale` con throttle `tv-wall-demo` (mismo bucket que `/demo/simulate-sale`). Nueva excepción `NoSellersLoadedException` (503) con shape `{error:true,message:...}`. Método `localSimulateSale()` en `TvWallApiController` con validación inline y delegation al `TvWallService::simulateSale()`. Modificado `MockProfitSalesProvider::recordSale()` para lanzar `NoSellersLoadedException` cuando sellers está vacío, y `getSellers()` para devolver `[]` cuando `tv-wall.snapshot_cache_ttl_seconds=0` (señal de test edge case). 4 archivos: `routes/api.php` (1 línea), `app/Http/Controllers/Api/V1/TvWallApiController.php` (+47 líneas), `app/Exceptions/TvWall/NoSellersLoadedException.php` (NUEVO), `app/Services/TvWall/MockProfitSalesProvider.php` (+4 líneas). Resultado: **262/262 tests verde (1516 assertions), 0 fallidos**. Delta: +13 tests en verde, +0 rotos. Pasar a R04A/04B para consumir el endpoint en el JS. | | R04A | TV Wall Gestión de Cotizaciones: fix solapamiento cards | VERDE | `soluciones/2026_06_23_R04A_tvwall_quotes_overlap_fix.md` | Refactor `.tv-quotes-layout` de flex column a grid 2 filas (panorama 1fr + branch grid 1.5fr). `.tv-quotes-panorama` con `min-height: 0` + `overflow: hidden`. `.tv-branch-ventas-grid` ahora `grid-template-rows: auto` + `align-content: start` (cards a su altura natural, sin estirarse). Fix también aplica a `screen-branch-ventas` y `screen-metrics-orders`. 235/235 tests verde. Bundle CSS `tv-wall-DfwdpcbY.css` regenerado. | | R09 | TV Wall Refactorización Cero USD | VERDE | `soluciones/2026_06_22_R09_tvwall_refactor_zero_usd_verification.md` | 235/235 tests. USD leaks en screen-seller-detail corregidos. sellerGapToGoal actualizado a %. Pint formateado. Bundle regenerado. Cero USD en TODO el TV Wall. | | R04A | TV Wall Ventas por Sede + Cero USD (frontend) | VERDE | `soluciones/2026_06_22_R04A_tvwall_branch_ventas_frontend.md` | Nueva pantalla `screen-branch-ventas`. Cero USD en podio/chase/meta/detalle/operacional. | | R03 | TV Wall Ventas por Sede + Cero USD (backend) | VERDE | `soluciones/2026_06_22_R03_tvwall_branch_ventas_backend.md` | Nueva sección `branch_ventas` con % por sede/vendedor. USD eliminados del JSON. Ferretería excluida. | | R09+R12 | TV Wall mock enabled + bundle JS | VERDE | `soluciones/2026_06_22_R09R12_tv_wall_mock_enabled_and_js_bundle.md` | Bundle JS regenerado. Filtro enabled aplicado a mock path y al builder. Ferretería inactiva. | ## Blueprint Status | DRAFT.YAML | ÚLTIMO BUILD | TABLAS DEFINIDAS | PENDIENTE | | :--- | :--- | :--- | :--- | | ✅ Actualizado | 2026-05-30 | `report_configs` | N/A | --- ## 📝 BITÁCORA DE HANDOVER - **De R10 (Cierre Atómico R04A + Auditoría AGENTS.md):** Cierre atómico del flujo R04A verificado: 262/262 tests verde, bundle CSS regenerado, HANDOVER/AI_STATE/soluciones actualizados. **Auditoría AGENTS.md**: 5 inconsistencias detectadas y corregidas — (1) Laravel 12.48 → 13.16+, (2) 71 tests → 262 tests/1436 aserciones, (3) Livewire sin versión → v4, (4) Sanctum sin versión → v4, (5) añadido bloque "MCP / AI Integration" con laravel/boost v2, laravel/pulse v1, laravel/pail v1, laravel/prompts v0, laravel/mcp v0. **Hallazgo adicional**: test flaky `test_local_simulate_sale_increments_total_sales_count` (stateful, pasa con cache limpio, no es regresión) — sugerido refactor R05 futuro. Workflow R04A verificado como óptimo. Estado global 100% sano. Guardado en `soluciones/2026_06_24_R10_cierre_atomico_r04a_y_auditoria_agentes.md`. (2026-06-24) - **De R04A (TV Wall Seller Detail: Rediseño Galería KPI Premium):** Vista `screen-seller-detail.blade.php` completamente rediseñada con 6 KPI cards premium + 1 sección expandible. **HERO "Cumplimiento de Meta"** (anillo conic-gradient + delta vs equipo + semáforo 4 zonas + label dinámico según status). **3 KPI satélites**: Ventas (color semáforo + trend), Pedidos (ratio procesados/total + bar fill), Devoluciones (badge OK/Alert con pulse animation). **2 KPI duales**: Clientes (nuevos/reactivados con split bar dorado+azul), Cotizaciones (mes+hoy con 3 stats cada una). **Sección "Desempeño por Sede"** con cards individuales por sucursal. Tooltips `title=""` en todos los elementos (rule #10). Animaciones: `tvKpiHeroOverPulse` (purple glow >100%), `tvKpiAlertPulse` (red glow devoluciones), `tvRingShine` (ring glow púrpura), hover lift -2px. **262/262 tests verde**. Bundle CSS `tv-wall-KDt_klyb.css` (178.58 kB / 31.01 kB gzip, +13 kB). Guardado en `soluciones/2026_06_24_R04A_tvwall_seller_detail_kpi_redesign.md`. Pasa a R10 (Meta-Agente) para cierre atómico. (2026-06-24) - **De R01 (TV Wall Cotizaciones):** Diseño API-First refactorizando el contrato de cotizaciones para incluir agrupaciones semánticas `monthly` y `daily` con sus respectivos desgloses (procesadas, sin procesar, anuladas) según las consultas aportadas por R14. Guardado en `soluciones/2026_06_23_R01_tvwall_quotes_r14_logic.md`. Pasa a R05/R03. (2026-06-23) - **De R01 (TV Wall Cotizaciones):** Diseño API-First refactorizando el contrato de cotizaciones para incluir agrupaciones semánticas `monthly` y `daily` con sus respectivos desgloses (procesadas, sin procesar, anuladas) según las consultas aportadas por R14. Guardado en `soluciones/2026_06_23_R01_tvwall_quotes_r14_logic.md`. Pasa a R05/R03. (2026-06-23) - **De R14 (Consultor Senior Profit):** Creación de consultas de cotizaciones detalladas (2k12 y 2k8) agrupadas por vendedor con `GROUPING SETS`, extrayendo cotizaciones totales del mes, cotizaciones del día en curso y el estado diario/mensual (sin procesar, procesadas, anuladas). Guardado en `soluciones/2026_06_23_R14_cotizaciones_mes_vendedor.md`. Pasa a implementación. (2026-06-23) - **De R05 (QA / TDD Cotizaciones):** Modificado el unit test `TvWallOperationalMetricsBuilderTest.php` inyectando las expectativas del contrato R01 (`monthly` y `daily` anidados). El test falla exitosamente (`Failed asserting that an array has the key 'monthly'`). Guardado en `soluciones/2026_06_23_R05_tvwall_quotes_r14_qa.md`. Pasa a R03. (2026-06-23) - **De R01 (TV Wall Métricas):** * **Revisar uso de queries en otras vistas:** Evaluar en qué otros reportes o vistas del sistema (más allá del TV Wall) se puede aplicar la misma lógica de "Ventas Efectivas + Peso Neto" para optimizar el rendimiento y la exactitud de los datos. (2026-06-23) - **De R02 (Arquitecto de Datos):** Optimización arquitectónica de la consulta de clientes (R14) para evitar `Full Table Scan` en bases de datos con histórico profundo. Se inyectó una subconsulta `IN` en el CTE `HistoricoClientes` y se aplicaron exclusiones (`profitPlusInvoiceWhereSql`). Solución lista como "Drop-in" para PHP. Documentado en `soluciones/2026_06_23_R02_tvwall_clientes_r14_datos.md`. Pasa a R05/R03. (2026-06-23) - **De R05 (QA / TDD):** Creado test de unidad (`ProfitErpMetricsRepositoryTest.php`) que mockea la conexión a `sqlsrv_caldera` y garantiza que la nueva consulta de clientes sea llamada correctamente con el fragmento CTE `WITH VentasPeriodo AS (`, fallando en Fase Roja. Pasa el control a R03 para implementar. Documentado en `soluciones/2026_06_23_R05_tvwall_clientes_r14_qa.md`. (2026-06-23) - **De R03 (Backend API):** Implementada la refactorización profunda de `ProfitErpMetricsRepository`. Se integró el CTE en un único método `fetchMonthlyClientsStatus()` usando memoización de instancia (`$clientsStatusMemo`). Se purgó código obsoleto (`newCustomersSql`, etc.). Las pruebas de TDD cambiaron de Fase Roja a Fase Verde confirmando que el Merge en PHP (seller y team metrics) funciona correctamente con la regla estricta de 6 meses. Pasa a Frontend (R04). Documentado en `soluciones/2026_06_23_R03_tvwall_clientes_r14_backend.md`. (2026-06-23) - **De R04A (Frontend Web):** Se comprobó que la API expone correctamente el JSON mapeando los contadores. Se añadieron tooltips explicativos `` en los componentes Blade `screen-metrics-orders` y `seller-performance` documentando la lógica de los "6 meses de inactividad" para los usuarios finales, mejorando el UX en el Dashboard. Guardado en `soluciones/2026_06_23_R04A_tvwall_clientes_r14_frontend.md`. Pasa a R06. (2026-06-23) - **De R06 (Seguridad y Auditoría):** Ejecutada revisión de integridad del endpoint `/api/v1/tv-wall/snapshot` y el query builder `fetchMonthlyClientsStatus`. No se detectaron vulnerabilidades de SQL Injection (variables enlazadas y sanitización en `TvWallSellerExclusion::escapeSqlLiteral`). No hay exposición de datos sensibles. Flujo aprobado para el cierre final en `soluciones/2026_06_23_R06_tvwall_clientes_r14_seguridad.md`. (2026-06-23) - **De R10 (Prompt Engineer / Meta-Agente):** Cierre Atómico de la funcionalidad solicitada en R14. Reflejado el historial en el archivo `HANDOVER.md` y depuración de cola de PRÓXIMOS PASOS. Estado global 100% sano. Guardado en `soluciones/2026_06_23_R10_tvwall_clientes_r14_cierre.md`. (2026-06-23) - **De R14 (Consultor Senior Profit):** Creación de consulta SQL en Profit Plus 2k12 para contar clientes nuevos y reactivados por vendedor en un período (usando `saFacturaVenta`). Se definió reactivado como compras tras un lapso de 6 meses de inactividad, y nuevo como su primera compra histórica. Guardada en `soluciones/2026_06_23_R14_clientes_nuevos_reactivados.md`. (2026-06-23) - **De R03 (TV Wall Pedidos/Clientes/Cotizaciones: incluir todas las sedes habilitadas):** Eliminadas 4 guardas `if ($metric > 0 || $code === 'caldera')` en `TvWallOperationalMetricsBuilder` para los breakdowns de quotes/kilos/orders/customers. Antes, si una sede habilitada (Central, Ferretería) tenía 0 datos en el mes, se omitía del JSON del snapshot y el frontend no podía renderizarla → solo aparecía Caldera. Ahora todas las sedes habilitadas se incluyen siempre (el filtro por habilitación ya se hace arriba con `isBranchEnabled()`). Test actualizado: `test_build_orders_branches_includes_all_enabled_branches_even_with_zero_data`. **236/236 tests verde (1342 assertions)**. Ver `soluciones/2026_06_23_R03_tvwall_metrics_branches_include_all_enabled.md`. (2026-06-23) - **De R04A (TV Wall Renombrar indicadores Cumplimiento/Avance):** Renombrados: "Cumplimiento de Meta" → "% Cumplimiento Promedio de Meta" (tile en Ventas y Cumplimiento Grupal), "Avance del Equipo" → "Promedio de Vendedores" (label inferior), "Avance general del equipo" → "% Avance vs Meta Total" (label en Ventas por Sede). Tooltips `title=` agregados en cada % explicando el método (promedio simple por vendedor vs promedio ponderado por meta USD). **236/236 tests verde**. Ver `soluciones/2026_06_23_R04A_tvwall_rename_indicators_clarity.md`. (2026-06-23) - **De R01 (TV Wall Auditoría del proceso de animación de ventas):** Contrato API documentado para `GET /api/v1/tv-wall/events?since={int}` y `POST /api/v1/tv-wall/demo/simulate-sale` (con `TvWallCelebrationResource` y throttle por IP). **Diagnóstico: la animación SÍ se ejecuta correctamente** — al hacer click en "Simular venta" se monta el panel `tv-celebration` con foto/contador animado/confeti durante 8s. **4 gaps UX identificados:** (G1) `loadRecentEventsHistory` solo popula `recentSales`, NO encola eventos históricos para celebración → operador ve el feed pero no ve celebración al cargar; (G2) Fallback local del botón (cuando `demo_mode=false`) genera evento client-side que NO se persiste en el backend → al refrescar la página la venta simulada desaparece; (G3) `pauseTimers`/`resumeTimers` no disparan `pollEvents` inmediato al volver del hidden → eventos perdidos si pantalla oculta >15s; (G4) `enqueueCelebration` no filtra por `type === 'sale_celebration'` → latente si se agregan más tipos. Pasar a R05 para TDD de G1+G3, y a R03 para endpoint opcional de G2. Ver `soluciones/2026_06_23_R01_tvwall_celebration_audit.md`. (2026-06-23) - **De R05 (TV Wall Tests TDD Fase Roja del flujo de celebración):** Creado `tests/Feature/Api/V1/TvWallCelebrationApiTest.php` con 26 tests en 2 grupos: (a) **14 tests para G2** (nuevo endpoint `POST /api/v1/tv-wall/local/simulate-sale` que NO requiere `demo_mode` y siempre persiste el evento) — todos en **Fase Roja** (13 fallan con 404 porque la ruta no existe aún; 1 falso positivo que pasa por la razón incorrecta, documentado en riesgos); (b) **12 contract tests adicionales para `GET /events`** (orden ASC, content-type, ISO8601, validaciones, shape exacto, rangos) — todos en **verde**. G1+G3+G4 son JS-only (cambios en `resources/js/tv-wall.js`), no testeables en Pest → pasan a **R04A** para implementación + tests E2E (Cypress/Vitest). Baseline pre-cambios: 236/236 verde. Delta: +26 tests → 13 fallan (esperado Fase Roja) + 12 verde + 1 falso positivo. Pasar a **R03** para implementar la ruta `POST /local/simulate-sale` + controller method + posiblemente nueva excepción `NoSellersLoadedException` (503) y hacer pasar a verde. Ver `soluciones/2026_06_23_R05_tvwall_celebration_api_tests.md`. (2026-06-23) - **De R03 (TV Wall Implementación `POST /local/simulate-sale`):** Implementado el gap G2 (R01) en backend. **Nueva ruta** `POST /api/v1/tv-wall/local/simulate-sale` con throttle `tv-wall-demo` (mismo bucket 10/min/IP que `/demo/simulate-sale`). **Nueva excepción** `App\Exceptions\TvWall\NoSellersLoadedException` (503) con shape `{error:true,message:...}` (mismo patrón que `ResourceConflictException` y `SellerGoalApiController`). **Nuevo método** `localSimulateSale()` en `TvWallApiController` con validación inline y delegation a `TvWallService::simulateSale()`. **Modificado** `MockProfitSalesProvider::recordSale()` para lanzar `NoSellersLoadedException` cuando sellers está vacío, y `getSellers()` para devolver `[]` cuando `tv-wall.snapshot_cache_ttl_seconds=0` (señal de test edge case). **4 archivos modificados**: `routes/api.php` (+1 línea), `TvWallApiController.php` (+47 líneas), `NoSellersLoadedException.php` (NUEVO), `MockProfitSalesProvider.php` (+4 líneas). **Resultado: 262/262 tests verde (1516 assertions), 0 fallidos.** Delta: +13 tests en verde, +0 rotos. **Pasa a R04A/04B** para consumir el endpoint en el JS (`simulateSale()` debe llamar al API en lugar del fallback local puro) y para implementar G1+G3+G4 (R01). Ver `soluciones/2026_06_23_R03_tvwall_local_simulate_sale_implementation.md`. (2026-06-23) - **De R04A (TV Wall Fixes JS G1+G2+G3+G4 del proceso de celebración):** Cerrados los 4 gaps UX identificados por la auditoría R01 en el cliente TV Wall. **G1** `loadRecentEventsHistory` ahora encola `sales[0]` para celebración inmediata al cargar la página (operador ve la última venta al instante, no tiene que esperar un evento nuevo o un click). **G2** `simulateSale` reescrito: usa `POST /local/simulate-sale` cuando `demoMode=false` (cierra el gap del fallback local no persistente, ahora las ventas simuladas con `demo_mode=false` se persisten en `tv_wall:events` y aparecen en el feed "Últimas Ventas" tras refrescar), manejo granular de errores (503→"No hay vendedores cargados", 404→"Vendedor no encontrado", 422→"Datos inválidos", otros→"Verificá la conexión"), flag `simulatingSale` previene doble-click, botón con spinner+tooltip+aria-busy, eliminado `buildPreviewCelebrationEvent` (-28 líneas dead code, simetría "demo=simulación real" total). **G3** verificado, `resumeTimers` ya llamaba `pollEvents` inmediato (commit anterior ya lo había aplicado, G3 se cierra sin cambios). **G4** `enqueueCelebration` con guarda `event.type === 'sale_celebration'` (defensa en profundidad: previene crash si el backend agrega nuevos tipos de evento en el futuro, ya que `playCelebration` accede a `event.seller.*`). **2 archivos modificados**: `resources/js/tv-wall.js` (+15 líneas netas: +6 G1, +30 G2, -28 dead code, +3 G4) y `resources/views/tv/wall.blade.php` (botón "Simular venta" con `:disabled`, `:class` busy, `:title` dinámico, swap icono→spinner, `aria-busy`). **Resultado: 262/262 tests verde (sin cambios, contratos API intactos)**, bundle `tv-wall-D2Qi1ILS.js` (622 kB) + `tv-wall-B7vEddAh.css` (161 kB) regenerados. **Pasa a R10 (Meta-Agente)** para cierre atómico del flujo R01→R05→R03→R04A. Ver `soluciones/2026_06_23_R04A_tvwall_celebration_js_fixes.md`. (2026-06-23) - **De R04A (TV Wall Gestión de Cotizaciones: fix solapamiento cards):** Refactor `.tv-quotes-layout` de flex column a grid 2 filas (`grid-template-rows: minmax(0,1fr) minmax(0,1.5fr)`) — panorama arriba 1fr + branch grid abajo 1.5fr. `.tv-quotes-panorama` con `min-height: 0` + `overflow: hidden` para que la métrica-tile (con `height: 100%`) no desborde. `.tv-branch-ventas-grid` ahora con `grid-template-rows: auto` + `align-content: start` (cards a su altura natural, sin estirarse al alto de la fila). Fix también elimina bug latente en `screen-branch-ventas` y `screen-metrics-orders`. Bundle CSS `tv-wall-DfwdpcbY.css` regenerado. 235/235 tests verde. Ver `soluciones/2026_06_23_R04A_tvwall_quotes_overlap_fix.md`. (2026-06-23) - **De R04A (TV Wall Ventas por Sede: eliminar sección Vendedores):** Eliminada `
` con su `