La IA en Forálic y tus datos

Forálic usa un modelo de lenguaje (una inteligencia artificial que lee y escribe texto) en dos sitios: la Ayuda de Forálic y el asistente de IA de la farmacia, si la farmacia conecta uno. Ninguno de los dos manda a Forálic datos del negocio. El resto de funciones —la lectura de la pantalla de venta en Mostrador, la lectura de facturas, los cálculos de precios o pedidos— corren en el equipo de la farmacia y no usan ningún modelo de lenguaje.

Resumen

	Ayuda de Forálic	Asistente de IA de la farmacia
Para qué	Dudas sobre cómo se usa Forálic	Consultar y operar el equipo desde un asistente
Módulo de la licencia	`ayuda_ia`	`agente` (el manual del asistente)
Quién lo usa	Todo el equipo	El gestor, con una llave de máquina
Dónde se pregunta	En Forálic, en el botón de la estrella	En el asistente, en un ordenador de la red de la farmacia
Qué sale del equipo	La pregunta y el contexto de la pantalla	Lo que el asistente consulte
Hacia quién	Pasarela de Forálic (Cloudflare) y Anthropic	El proveedor del asistente, con el contrato de la farmacia
Pasa por Forálic	Sí, por la pasarela	No
Datos del negocio	No salen	Los que consulte el asistente
Datos de pacientes	No salen, salvo que alguien los escriba en la pregunta	Clientes y precintos, cerrados
Cambia algo en Forálic	No	Sí, con los frenos de la herramienta
Escribe en el programa de gestión	No	No

Ayuda de Forálic

Es el botón redondo con una estrella, abajo a la derecha. Cómo se usa, en Entrar y moverse.

La respuesta vuelve por el mismo camino, a trozos, según se escribe.

Recorrido de una pregunta

El navegador manda la pregunta al equipo de la farmacia (POST /api/ayuda-ia/preguntar), por la red local.
El equipo añade lo que solo sabe él —la licencia, el modo de quien pregunta, el programa de gestión y los módulos— y la reenvía por https a la pasarela de Forálic, https://foralic.com/api/ayuda-ia, un Worker de Cloudflare.
La pasarela comprueba la licencia y la cuota, añade sus instrucciones y el manual entero (este centro de ayuda) y pregunta a Claude Haiku 5.5 en la API de Anthropic.
La respuesta vuelve por el mismo camino, a trozos según se escribe.

Qué sale del equipo

Campo	Contenido	Límite
Pregunta	El texto tal cual se escribe	1.000 caracteres
Conversación	Los últimos 6 mensajes de esa conversación, preguntas y respuestas	2.000 caracteres cada uno
Pantalla	Solo el primer tramo de la dirección: `/producto/670123` sale como `/producto`	—
Pestaña	El nombre de la pestaña abierta, si lo tiene	40 caracteres
Programa de gestión	Farmatic o Nixfarma	—
Modo	Equipo o gestor. Lo pone el equipo, no el navegador	—
Módulos	Los módulos de la licencia	—
Licencia	El fichero de licencia firmado del equipo, que identifica a la farmacia	—

Con la pregunta no sale ningún dato del programa de gestión ni de Forálic: ni ventas, ni stock, ni márgenes, ni facturas, ni turnos, ni clientes. El equipo no consulta nada para contestar, y el modelo no tiene herramientas: solo devuelve texto, así que no puede pedir datos al equipo ni pulsar nada. Los botones que nombra en la respuesta los resalta la propia aplicación cuando se pulsa el enlace.

En la pasarela

Verifica la firma Ed25519 de la licencia con la clave pública de Forálic (la misma que comprueba el equipo), la caducidad, con su periodo de gracia, y que incluya ayuda_ia.
Aplica la cuota: 300 preguntas al mes por farmacia, contadas en Workers KV. Al agotarse lo avisa, y se renueva el día 1.
Recorta lo que llega (longitudes y conversación) y rechaza lo que no cuadra. Las instrucciones y el manual los pone siempre la pasarela: lo que mande un equipo no los cambia.
Llama a Anthropic con la llave de API de Forálic, que vive como secreto del Worker. Ningún equipo la tiene.

Qué se registra

Dónde	Qué queda	Qué no
Navegador	La conversación, en la memoria de la pestaña. Se borra al recargar	—
Equipo	Los fallos de conexión con la pasarela y su código	El texto de las preguntas y de las respuestas
Pasarela	Farmacia, número de mensajes, tokens, uso de la caché, tiempo y errores	El texto de las preguntas y de las respuestas
Workers KV	Un contador por farmacia y mes, que caduca solo a los 40 días	—

Anthropic recibe la petición completa —instrucciones, manual, contexto y conversación— para generar la respuesta.

Proveedores y cómo se apaga

La pasarela y el contador son de Cloudflare; el modelo, de Anthropic, en EE. UU. Si una farmacia no quiere la Ayuda, Forálic la desactiva para ella en la pasarela, sin tocar su equipo ni su licencia.

Si no contesta

Lo que ves	Qué suele ser
«La ayuda no está disponible ahora mismo…»	El equipo no llega a internet o la pasarela no responde. El resto de Forálic funciona igual.
«Esta farmacia ha usado las 300 preguntas del mes…»	Cuota agotada. Se renueva el día 1.
«La licencia de esta farmacia no incluye la Ayuda de Forálic.»	La licencia no trae `ayuda_ia`.
No aparece el botón de la estrella	La licencia no trae el módulo.

Asistente de IA de la farmacia

La farmacia usa su propio asistente (Claude, Mistral u otro que cargue skills) en un ordenador de su red, y Forálic le da el manual y la herramienta para trabajar con el equipo.

Ni pasarela ni llave de Forálic en este camino.

Qué se descarga

En Ajustes → «🤖 Asistente de IA»:

«⬇ Descargar paquete (.zip)»: el manual (AGENTS.md), sus capítulos por tema (.agents/skills/…/SKILL.md) y la herramienta foralic. Se descomprime encima de la carpeta desde la que trabaja el asistente.
«Solo el manual (AGENTS.md)»: el manual suelto.

Los genera el propio equipo, así que describen la versión instalada. La herramienta es un único fichero de Python 3, sin dependencias, que habla con la API del equipo por la red local; desde fuera de la red no se llega al equipo. La demostración pública no reparte el paquete.

La llave

Entra como gestor y abre Ajustes → «🔐 Accesos» → «🔑 Llaves de máquina».
Pulsa «Crear llave» y luego «Copiar»: la llave se enseña una sola vez.
Guárdala en un fichero .foralic-llave en la carpeta del asistente, o en la variable FORALIC_LLAVE. No hace falta pegarla en la conversación.

Solo el gestor crea llaves para la herramienta, y siempre llevan su rol. «Revocar» desactiva una llave al momento.

Qué hace la herramienta con cada petición

Cajón	Qué entra	Qué pasa
Cerrado	Clientes (`/api/clientes/…`) y precintos (`/api/precintos/…`), también para leer	No lo hace (código de salida 3)
Denegado	Lo que no tiene vuelta atrás o decide una persona: compras al mayorista, contraseñas y llaves, soporte remoto, actualizaciones, claves de la copia de seguridad y su descarga, claves y consultas del banco, releer el histórico de facturas	No lo hace (3)
Con confirmación	Lo que se ve fuera del equipo o lo ocupa un rato: Telegram, correos a comerciales, boletín, cartelería, impresoras, borrar o autorrellenar un mes de turnos, recálculos largos	Solo con `--si` (si falta, 4)
Libre	Las consultas y el trabajo de cada día: stock, ventas, pedidos, turnos, promociones, facturas	Lo hace

./foralic politica imprime la lista completa, con el motivo de cada regla.

Qué comprueba el equipo

El equipo comprueba cada petición por su cuenta, se use la herramienta o no:

Una llave de la herramienta es siempre de gestor.
Con el modo de acceso «Activo» (ver Entrar y moverse), las rutas con datos de pacientes —clientes y precintos— y las de fichajes y horas del equipo solo se abren con la sesión de una persona en el navegador: ninguna llave llega a ellas.
Con el modo «Apagado» u «Observando», esa comprobación no se aplica y queda la de la herramienta.

Qué sale

Lo que la herramienta devuelve entra en la conversación del asistente y viaja a su proveedor, según el contrato de la farmacia con él: cifras de ventas y de stock, márgenes, facturas de proveedor, pedidos, turnos con los nombres del equipo. Forálic no recibe nada por este camino: no hay pasarela ni llave de Forálic, y el equipo solo habla con el ordenador de la red local.

Conviene un plan del proveedor para empresas, con contrato de encargo del tratamiento y sin uso de las conversaciones para entrenar el modelo.
Lo que lee el asistente puede traer texto de terceros, como el de la factura de un proveedor. Por eso lo irreversible está denegado en la herramienta: no depende de lo que decida el modelo.
Por esta vía no se escribe en el programa de gestión.

Lo que no usa un modelo de lenguaje

Función	Cómo funciona	Sale algo
Mostrador	El sensor del puesto lee la columna de códigos de la pantalla de venta con OCR (Tesseract) en ese mismo ordenador; el resto lo busca el equipo por código	No: del puesto al equipo, por la red local
Facturas	El texto del PDF, u OCR si está escaneado, y patrones por proveedor, en el equipo. Un patrón nuevo lo puede crear el asistente de IA de la farmacia (sección anterior)	No
Extractos del banco	Lectura del fichero con reglas fijas	No
Precios, rotación, pedidos y avisos	Cálculos sobre los datos del equipo	No, salvo la consulta de precios a la competencia, si se activa

Lo que sale de la farmacia por otros motivos —la copia de seguridad cifrada, el parte de salud del servidor, las actualizaciones, el correo, Telegram— está en Qué es Forálic.

Ver también

Dirección segura (https): cómo viaja cifrada la conexión entre el navegador y el equipo.
IA y privacidad: la versión resumida, en foralic.com.