Acerca de y Arquitectura

PgArachne™ sirve como un servidor web ligero y de alto rendimiento que se sitúa entre tus clientes HTTP y la base de datos PostgreSQL. Elimina la necesidad de lenguajes backend tradicionales (como Python, Node.js o PHP) al mapear las peticiones HTTP directamente a funciones de la base de datos.

Capacidades Técnicas Principales

  • Pasarela JSON-RPC 2.0: Todas las interacciones de la API siguen la estricta especificación JSON-RPC 2.0. No hay endpoints REST que diseñar; simplemente llamas a funciones SQL por su nombre mediante peticiones POST.
  • Autenticación Nativa de BD: Sin tablas de usuarios separadas. Los usuarios inician sesión con sus credenciales reales de PostgreSQL para recibir un JWT. Alternativamente, las cuentas de servicio pueden usar Tokens de API persistentes.
  • Enmascaramiento de Roles: PgArachne™ se conecta como un usuario proxy pero ejecuta cada petición usando SET LOCAL ROLE para cambiar a la identidad del usuario autenticado. La seguridad a nivel de fila (Row-Level Security – RLS) funciona automáticamente.
  • Servidor de Archivos Estáticos: PgArachne™ puede servir activos estáticos (HTML, JS, CSS), permitiéndote alojar Single Page Applications (SPAs) o la herramienta Explorer directamente.
  • Notificaciones en tiempo real (SSE): Suscríbete a canales NOTIFY de PostgreSQL mediante SSE para actualizaciones en vivo sin polling.

Esta arquitectura simplifica drásticamente el stack: Base de Datos ↔ PgArachne ↔ Frontend.

Formato del Endpoint de API: Todas las funciones de la base de datos están expuestas en:
POST http://{servidor}:{puerto}
/api
/{nombre_base_datos}
El método se especifica en el cuerpo JSON-RPC.