You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Commit d0b3541
Browse filesBrowse the repository at this point in the historyBrowse files
Copy file name to clipboardExpand all lines: ComoFunciona.md
+10Lines changed: 10 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -56,3 +56,13 @@ En tu lista de días con extra, si el día de hoy todavía no tiene corte Z, en
56
56
57
57
***Sin login no hay avance.** Si no has entrado hoy, la barra va en 0%. El reloj solo no es trabajo.
58
58
***La hora la pone tu computadora.** El POS cree lo que diga el reloj de Windows. Si la computadora está mal de hora, todo sale mal. Por eso la computadora de la tienda debe tener la hora automática activada.
59
+
60
+
---
61
+
62
+
## 10. Cómo piensa Y.A.R.V.I.S. (tu ayudante de la tienda)
63
+
64
+
Imagina que Y.A.R.V.I.S. es un ayudante con muy buena memoria y varios cuadernos: uno de ventas, uno de inventario, uno de proveedores y otro de caducidades. Cuando le preguntas algo, primero piensa si necesita abrir un cuaderno. Si sí, lo abre, copia el dato exacto y con eso te responde. Nunca inventa números: si el cuaderno está vacío, te lo dice.
65
+
66
+
Tiene dos formas de pensar. Una es llamar por teléfono a un amigo muy listo que vive lejos: para eso la tienda necesita una llave y tener internet. La otra es pensar solito dentro de la computadora de la tienda, sin internet, aunque es más lento y más sencillo.
67
+
68
+
Si el amigo de lejos no contesta, no se queda callado: piensa solito y te avisa con un letrerito amarillo de que la respuesta vino de la tienda. Y siempre te dice quién respondió, para que sepas a quién creerle.
Copy file name to clipboardExpand all lines: docs/arquitectura/interconexion.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -48,7 +48,7 @@ No hay HTTP local. No hay puertos libres. No hay ai_service. No hay externalBin
48
48
1. El usuario escribe en adminyarvis o empleayarvis.
49
49
2. ChatWidget llama send_chat_stream o send_chat_message (Tauri command).
50
50
3. admintarvis/chat.rs delega en src-ia/motor-chat:
51
-
- Cloud: cloud/apis_cloud/generacion.rs abre un stream HTTP/SSE a OpenCode Zen o Gemini. Los bloques think/response se separan (think.rs). Si el proveedor devuelve 429, la cola de fallback releva al siguiente proveedor (espera 2-4 s, max 3 modelos). Las 10 tools se resuelven via ciclo_tools.rs con re-inyeccion del resultado como mensaje role tool (MAX_RONDAS_TOOLS=3).
51
+
- Cloud: cloud/apis_cloud/generacion.rs abre un stream HTTP/SSE a OpenCode Zen o Gemini. Los bloques think/response se separan (think.rs). Si el proveedor devuelve 429, la cola de fallback releva al siguiente proveedor (espera 2-4 s, max 3 modelos). Las 19 tools se resuelven via ciclo_tools.rs con re-inyeccion del resultado como mensaje role tool (MAX_RONDAS_TOOLS=3).
52
52
- Local: llm/mod.rs genera con Qwen GGUF (llama.cpp) en CPU, con recortar_historial para no exceder 4096 tokens. Usa el mismo ejecutor de tools que cloud.
53
53
4. Roles: herramientas_rol.rs filtra TOOLS_SOLO_ADMIN (query_sales, compare_periods, get_restock_analysis) para empleados. El prompt es sugerencia; el guard es control de acceso real.
54
54
5. La respuesta llega al frontend por el mismo mecanismo (invoke no bloquea la caja).
Copy file name to clipboardExpand all lines: docs/arquitectura/que-es-yarvis.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -29,7 +29,7 @@ Capacidades:
29
29
- Cortes de caja X/Z, gastos recurrentes, alertas financieras, metricas y exportacion.
30
30
- Empleados: metas/bonos, turnos, salario, resumen de ventas, asistencia y horas extra.
31
31
- Parseo de tickets y catalogos (TXT/CSV/Excel) con reglas + LLM local para mapeo automatico y lotes con streaming.
32
-
- Chat con IA: cloud (OpenCode Zen/Gemini) con fallback a local (Qwen2.5-Coder 1.5B Instruct fine-tuneado (unico modelo local)) y 10 tools de consulta.
32
+
- Chat con IA: cloud (OpenCode Zen/Gemini) con fallback a local (Qwen2.5-Coder 1.5B Instruct fine-tuneado (unico modelo local)) y 19 tools de consulta.
33
33
- Predicciones de ventas con Holt-Winters e intervalos de confianza al 95% (src-ia/predicciones).
> Chat cloud: OpenCode Zen + Gemini con cola de fallback 429, streaming SSE, instrucciones de tools congeladas segun dataset tools_arreglado.jsonl (TOOLS_LINEA en src-ia/motor-chat/cloud/prompts.rs:28 y src-ia/motor-chat/llm/tools/).
62
-
> Tools: 10 tools de solo lectura, SQL parametrizado con escape_like, LIMIT parametrizado, ejecutor compartido cloud/local (src-ia/motor-chat/llm/tools/mod.rs). Roles enforced en herramientas_rol.rs (empleado no ve finanzas/nomina).
62
+
> Tools: 19 tools de solo lectura, SQL parametrizado con escape_like, LIMIT parametrizado, ejecutor compartido cloud/local (src-ia/motor-chat/llm/tools/mod.rs). Roles enforced en herramientas_rol.rs (empleado no ve finanzas/nomina).
63
63
> Parseador: 100% Rust sin LLM (detección estadística + folio/clave/orden cronológico). Comandos parser_* (adminparser/, parser_txt/ por tema) + get_tickets_total para el historial real.
64
64
> Predicciones: implementadas con Holt-Winters aditivo (src-ia/predicciones/holt_winters.rs:70 predecir, ventana 7 dias, grid 343 combos alpha/beta/gamma, banda 95% z 1.96). Capa de datos lee ventas completadas, agrupa por dia, densifica huecos con 0 y devuelve fecha/prediccion/minimo/maximo (src-ia/predicciones/ventas.rs:37).
65
65
> Embeddings / RAG: no hay RAG. Pendiente busqueda semantica con modelo de embeddings propio. El plan anterior de all-MiniLM-L6-v2 + ort/fastembed fue descartado.
Copy file name to clipboardExpand all lines: docs/historial/bugs-resueltos.md
+37Lines changed: 37 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -627,3 +627,40 @@ APPIMAGE_EXTRACT_AND_RUN=1 npm run tauri build
627
627
4. Test de regresión vitest `turno-extra.test.tsx` (7 casos).
628
628
629
629
**Leccion aprendida:** "reloj pasado de la salida" no es "trabajo extra": todo cálculo de extra debe anclarse a la llegada real, no a la hora actual. Y ojo con efectos cruzados: el stamp de salida del corte Z (#26) es correcto, pero cualquier consumidor de `ultimo_login` debe aplicar la misma regla o hereda el fantasma.
630
+
631
+
---
632
+
633
+
### Bug Z2: la ronda 2 de tools cloud moría con `400 Upstream request failed` — ALTO (RESUELTO 2026-09-15)
634
+
635
+
**Sintoma:** con `YARVIS_SIN_FALLBACK=1` el chat cloud fallaba siempre que el modelo pedía una tool: `Error 400 del proveedor (OpenCode). Detalle del servidor: Error from provider (Console): Upstream request failed: [400] Provider returned error`. Sin la variable, el fallo se enmascaraba cayendo a Qwen (y la UI mostraba `UNKNOWN` en el badge del modelo cuando el stream solo traía reasoning).
636
+
637
+
**Causa raiz (cuádruple, verificada con sondas directas contra `https://opencode.ai/zen/v1/chat/completions`):**
638
+
1.`role:"tool"` suelto: `ciclo_tools.rs` reinyectaba el resultado como mensaje `role:"tool"` y `normalizar_mensajes` lo mandaba literal a Zen. El gateway OpenAI-compatible lo rechaza sin `tool_calls` previos. Repro: mismo historial con `tool` → 400; como `user` → 200 con respuesta correcta.
639
+
2.`MAX_TOKENS = 39800` (variables.rs): techo de salida absurdo para los free; se bajó a 4096.
640
+
3. Session id estable por proceso (`OnceLock`): el sticky-routing de Zen puede clavar un id en una réplica rota y fallar el 100% hasta reiniciar (ver sst/opencode#46011). Ahora es fresco por request y se mandan ambos headers (`x-opencode-session` oficial + `X-Session-Id` alias + `x-opencode-client`), como el CLI oficial.
641
+
4. Cola de fallback con modelos muertos (`hy3-free`, `laguna-s-2.1-free` ya no existen en `GET /models`) y `muse-spark-*-contributor-free` listado aunque usa `/responses` (daba 500): se excluye del catálogo chat con error accionable.
642
+
643
+
**Solucion:**
644
+
1.`helpers.rs::normalizar_mensajes` convierte `tool` → `user` con prefijo `Resultado de <tool>:` (el modelo local sigue recibiendo `role:"tool"` por llama.cpp, sin pasar por ahí); `ciclo_tools.rs` guarda el nombre en el contenido; `prompts.rs` documenta el formato.
645
+
2.`variables.rs`: `MAX_TOKENS 4096`, `ORDEN_FALLBACK_FREE` con los 6 free vivos verificados el 2026-09-15.
646
+
3.`proveedores.rs`: `nueva_sesion_zen()` por request + headers duales + guard temprano para modelos `/responses`.
647
+
4.`rutas.rs`: `model_used` defaultea al modelo pedido (adiós badge `UNKNOWN`) y solo lo reemplaza el primer modelo real del stream; `errores.rs` recorta a 600 chars para no perder el detalle upstream.
648
+
5. De paso: 8 tools nuevas de abasto/trazabilidad (`compras.rs`, `operativa.rs`, migración `0018_abasto_trazabilidad.sql` con trigger de historial de costos) + allowlist de `sql_readonly` extendida. Total: 19 tools.
649
+
650
+
**Verificación real:** ciclo completo contra Zen en vivo (ronda 1 → `<tool_call>query_sales today/revenue</tool_call>`, ronda 2 → `$300 MXN en ventas`); `cargo test -p src-ia --lib motor_chat` 57/57; `cargo check` Tauri limpio.
651
+
652
+
**Leccion aprendida:** "OpenAI-compatible" no significa "acepta cualquier rol": `tool` sin `tool_calls` es 400 garantizado aguas arriba. Y un session id estable es una trampa de sticky-routing: barato de generar, carísimo cuando se clava.
653
+
654
+
---
655
+
656
+
### Bug Z3: "Falta la API key" con la clave ya guardada — ALTO (RESUELTO 2026-09-15)
657
+
658
+
**Sintoma:** con la API key configurada y guardada en `Configurar modelos`, al enviar un mensaje el chat respondía `Falta la API key del proveedor.`
659
+
660
+
**Causa raiz:**`useChatStream.ts` resolvía `currentSelection = activeSession?.modelSelection || fallbackSelection`. Cada chat persiste un snapshot `{provider, apiKey, model}` en localStorage, y `ChatProvider` solo lo re-sincroniza cuando cambia `provider:modelo:label` (la key no forma parte de esa clave a propósito). Si la sesión nació antes de que `leerApiKeys()` resolviera (o antes de guardar la clave), el snapshot quedaba con `apiKey: ""` para siempre y cada envío mandaba la key vacía al backend.
661
+
662
+
**Solucion:** la sesión conserva provider/modelo/label, pero la key se resuelve SIEMPRE del caché vivo (`apiKeysCache`, alimentado del `api_keys.json` 0600) vía nuevo `getApiKeyFor(provider)` en `ChatWidget.tsx`. Los chats existentes se curan solos sin recrearlos. Además el error de backend ahora dice dónde ponerla (`...Agrégala en 'Configurar modelos'...`).
**Leccion aprendida:** un snapshot persistido nunca debe ser la fuente de un secreto rotativo: provider/modelo/label se congelan, la key se resuelve en vivo en el momento del envío.
Copy file name to clipboardExpand all lines: docs/negocio/idea-comercial.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -34,7 +34,7 @@ Busqueda experta: "que productos para el cabello no tienen sal?" -> "tienes el s
34
34
35
35
Contador conversacional: "cuanto gane libre hoy quitando el costo?" -> "tu utilidad neta hoy fue de 2,543 MXN, 15% mas que el promedio de los miercoles". Predicciones de inventario: "que deberia comprar para el fin de semana?" -> "viene frente frio, tus ventas de cafe y pan suben 30% historicamente, aumenta 15-20% el pedido de pan".
36
36
37
-
El chat usa 10 tools de solo lectura, SQL parametrizado y roles (admin ve finanzas/nomina, empleado solo mostrador). Estrategia: fine-tuning de Qwen + ejecutor de tools, sin RAG.
37
+
El chat usa 19 tools de solo lectura, SQL parametrizado y roles (admin ve finanzas/nomina, empleado solo mostrador). Estrategia: fine-tuning de Qwen + ejecutor de tools, sin RAG.
0 commit comments