Especificación de Comunicaciones de AXIOM
Alcance: Despliegue mediante docker-compose.prod.yml distribuido en este sitio
1. Arquitectura de Contenedores
AXIOM está compuesto por los siguientes contenedores que se ejecutan íntegramente en tu propio servidor:
- Interfaz Web (Next.js): Expuesta en el puerto 3001 del host.
- Servidor API (Go): Expuesto en el puerto 8081 del host. Gestiona autenticación, trabajos y verificación local de la clave de licencia.
- Runner de Ejecución (Python / Playwright / Maestro): Se comunica únicamente dentro de la red interna de Docker.
- PostgreSQL / Redis / MinIO: Expuestos exclusivamente en 127.0.0.1 del host e inaccesibles desde redes externas.
Las URLs bajo prueba, credenciales de acceso, código de pruebas, contenido de pantallas, vídeos grabados y capturas se guardan localmente en los volúmenes de PostgreSQL y MinIO.
Por defecto, los puertos Web y API escuchan en las interfaces del host. Si no deseas exponerlos fuera de tu red interna, restringe el acceso mediante firewall.
2. Comunicaciones con el Exterior
Proveedor de IA Configurado (OpenAI / Google / Anthropic)
Momento: Al utilizar funciones de IA
Envía la información de escenarios, código y estructura de pantalla necesaria para generar, reparar o analizar pruebas. Si configuras Ollama local, esta comunicación solo se realiza con tu servidor Ollama.
api.axiom-qa.dev
Momento: Una vez al día
Envía contadores anónimos (ID de instancia, ID de licencia, versión, SO, arquitectura CPU, tiempo activo, número de ejecuciones y tipo de proveedor IA, sin incluir URLs ni contenido de pruebas). Se puede desactivar con AXIOM_TELEMETRY_DISABLED=true.
Sistema Bajo Prueba
Momento: Durante la ejecución de pruebas
El contenedor Runner accede al sistema objetivo configurado.
ghcr.io, Docker Hub
Momento: Al descargar imágenes de contenedores
Descarga imágenes durante la instalación o actualización. En entornos sin Internet, carga previamente las imágenes en el servidor.
3. Verificación de la Clave de Licencia
Cada clave de licencia (AXIOM-LIC-...) incluye una firma digital Ed25519 del operador y se verifica localmente mediante la clave pública integrada en la API, sin necesidad de comunicación externa.
Si el envío de estadísticas está activo, la respuesta también permite comprobar si la licencia ha sido revocada.