Qué recibe de LobLogix una persona desarrolladora
Para quien construye el frontend. Los puntos de conexión que ofrece un backend construido, cómo se describen y cómo inician sesión sus usuarios.
Esta página es para quien construye el frontend: una persona desarrolladora, una agencia, o tú con una herramienta de programación con IA. LobLogix construye el backend, y el frontend se conecta a él.
Dos formas de conectarse
Una aplicación construida ofrece dos interfaces estándar, ambas generadas a partir de la misma especificación:
- JSON:API, para leer y escribir registros de forma directa.
- GraphQL, cuando una pantalla necesita varios registros relacionados en una sola solicitud.
Una descripción a partir de la cual puedes generar
Cada registro y cada acción disponibles por JSON:API se describen en un documento OpenAPI. Se mantiene al día con la aplicación, porque ambos salen de la especificación. Úsalo para generar un cliente con tipos. Las herramientas de programación con IA también lo leen.
GraphQL no está en ese documento. Se describe a sí mismo con su propio esquema, que las herramientas de GraphQL leen desde el punto de conexión, así que un cliente GraphQL con tipos sale de ese esquema.
Páginas para probar solicitudes
Open app (abrir aplicación), en el espacio de trabajo, abre las páginas propias de la aplicación para explorar ambas interfaces y enviar solicitudes a mano.
Inicio de sesión y permisos
Los usuarios de la aplicación inician sesión en la aplicación misma. Lo que cada rol puede ver y hacer lo decide la especificación y lo hace cumplir la aplicación, así que una pantalla no tiene que hacerlo cumplir otra vez. Una solicitud que las reglas rechazan vuelve como un rechazo.
Lo que se mantiene estable
La versión que funciona en Stage es exactamente la que pasó las verificaciones acordadas. Cuando el negocio cambia la especificación, se construye y se verifica una versión nueva, y la descripción cambia con ella.
Por dónde empezar
Lee primero la Living Spec. Te dice lo que el negocio acordó, en las palabras del negocio. Consulta Qué construye LobLogix y qué no.
Sobre qué está construida
Elixir sobre la máquina virtual de Erlang, con los registros en PostgreSQL. Consulta La tecnología por dentro.