Recorrido por la aplicación de ejemplo
Un recorrido pantalla a pantalla por la aplicación de administración de ejemplo incluida con SQLly Embedded: estado y licencias, perfiles y conexiones, etiquetas, usuarios e inicio de SQLly.
El paquete incluye una pequeña aplicación de administración (sample-app/, Node.js 20+, sin dependencias) que ejercita todo lo que SQLly Embedded puede hacer. Hace las veces de tu aplicación: un lado de administración para perfiles, etiquetas y usuarios, y un lado de usuario donde la gente inicia sesión y abre SQLly. Cada pantalla de abajo es una capa fina sobre una o dos API de gestión , que se nombran debajo de cada captura de pantalla para que puedas ver qué llamaría tu propia aplicación.
Estas capturas de pantalla provienen de un puente real vinculado a una licencia de prueba, con una base de datos SQL Server Northwind detrás.
Inicio de sesión de administrador
Estado y licencias
Estado es GET /manage/status se representa como una página. Un puente iniciado sin clave ni archivo de licencia está sin licencia: ya puedes crear y probar perfiles, pero SQLly no se iniciará hasta que la instalación esté vinculada.
Conéctate a sqlly.app pide a sqlly.app un código de enlace (POST /api/embedded/links) y lo muestra. Abre sqlly.app para aprobar lleva al propietario de la licencia a sqlly.app, donde confirma el mismo código y elige una licencia:
Segundos después, la aplicación de administrador recoge la clave de la instalación, se la entrega al puente con PUT /manage/license, y en Estado se muestra la licencia:
Perfiles
Un perfil es el conjunto de conexiones que ve un grupo de usuarios. La lista muestra las conexiones de cada perfil y quién está asignado a él, con Lanzar para abrir SQLly como tú mismo con ese perfil.
Editar una conexión
El editor de conexiones ofrece todos los campos que el formato de credenciales soporta para el motor elegido. La lista de motores y los tipos de inicio de sesión de cada motor provienen de GET /manage/engines. Prueba verifica lo que esté en el formulario, guardado o no, y muestra la respuesta del propio motor en línea:
Etiquetas
Clientes, proyectos y entornos colorean y agrupan las conexiones en SQLly, y llevan asociadas reglas de seguridad. La aplicación de ejemplo mantiene un conjunto compartido y lo envía con cada perfil, así que renombrar una etiqueta actualiza todas las conexiones que la usan.
Usuarios y asientos
Los usuarios de la aplicación de ejemplo son cuentas propias, cada una con un perfil asignado. En tu aplicación, los usuarios y su acceso son los que ya tienes. La página también muestra quién está ocupando una plaza ahora mismo (GET /manage/seats), con Liberar asiento (DELETE /manage/seats/{user}).
Lo que ven tus usuarios
Los usuarios inician sesión en la raíz de la aplicación, no bajo /admin:
Mientras SQLly está abierto, Status muestra el asiento en uso:
Leyendo el código
| Archivo | Qué sacar de ello |
|---|---|
lib/bridge.js | Un cliente completo de la API de gestión: cada llamada, el manejo de errores y los tiempos de espera. Cópialo o adáptalo. |
lib/credentials.js | Convierte los campos de formulario y las etiquetas compartidas en un sqlly-credentials documento. |
lib/sqllyapp.js | La parte de sqlly.app del proceso de vinculación: crea un enlace y hace polling para obtener la clave. |
server.js | Enrutamiento. GET /app/ es la ruta de lanzamiento; /admin/* es el lado de administración; /admin/link* es enlace. |
views/pages.js | El HTML, incluyendo injectLaunch, que establece las dos variables globales antes boot.js. |
test/ | node --test suites que ejecutan la aplicación contra un puente falso. Un buen modelo para probar tu propia integración. |
¿Listo para reemplazarlo? Crea tu propia aplicación repasa cada uno de estos trabajos en tu propia pila.