Tour do aplicativo de exemplo
Um tour tela a tela do app de administração de exemplo que vem com o SQLly Embedded: status e licenciamento, perfis e conexões, rótulos, usuários e como iniciar o SQLly.
O pacote inclui um pequeno aplicativo de administração (sample-app/, Node.js 20+, sem dependências) que exercita tudo o que o SQLly Embedded consegue fazer. Ele faz o papel de seu aplicativo: um lado de administração para perfis, etiquetas e usuários, e um lado de usuário que autentica pessoas e abre o SQLly. Cada tela abaixo é uma camada fina sobre uma ou duas API de gerenciamento , que são nomeadas abaixo de cada captura de tela para que você veja o que o seu próprio aplicativo chamaria.
Estas capturas de tela vêm de uma ponte real vinculada a uma licença de teste, com um banco de dados SQL Server Northwind por trás dela.
Login de administrador
Status e licenciamento
Status é GET /manage/status renderizado como uma página. Uma ponte iniciada sem uma chave ou arquivo de licença é sem licença: você já pode construir e testar perfis, mas o SQLly não será iniciado até que a instalação esteja vinculada.
Conecte-se ao sqlly.app solicita ao sqlly.app um código de link (POST /api/embedded/links) e o mostra. Abra o sqlly.app para aprovar leva o proprietário da licença ao sqlly.app, onde ele confirma o mesmo código e escolhe uma licença:
Segundos depois, o aplicativo de administração coleta a chave da instalação e a entrega à ponte com PUT /manage/license, e o Status mostra a licença:
Perfis
Um perfil é o conjunto de conexões que um grupo de usuários vê. A lista mostra as conexões de cada perfil e quem está atribuído a ele, com Inicialização para abrir o SQLly como você mesmo com esse perfil.
Editando uma conexão
O editor de conexão oferece todos os campos que o formato de credencial suporta para o mecanismo escolhido. A lista de mecanismos e os tipos de login de cada mecanismo vêm de GET /manage/engines. Teste verifica tudo o que está no formulário, salvo ou não, e mostra a resposta do próprio mecanismo inline:
Rótulos
Clientes, projetos e ambientes dão cor às conexões e as agrupam no SQLly, além de carregarem regras de segurança. O aplicativo de exemplo mantém um conjunto compartilhado e o envia com cada perfil, então renomear um rótulo atualiza todas as conexões que o usam.
Usuários e assentos
Os usuários do aplicativo de exemplo são suas próprias contas, cada uma atribuída a um perfil. No seu aplicativo, usuários e seus acessos são aqueles que você já possui. A página também mostra quem atualmente ocupa um assento (GET /manage/seats), com Liberar assento (DELETE /manage/seats/{user}).
O que seus usuários veem
Os usuários fazem login na raiz do app, não em /admin:
Enquanto o SQLly está aberto, o Status mostra o assento em uso:
Lendo o código
| Arquivo | O que tirar disso |
|---|---|
lib/bridge.js | Um cliente completo da API de gerenciamento: todas as chamadas, tratamento de erros, tempos limite. Copie-o ou porte-o. |
lib/credentials.js | Transforma campos de formulário e rótulos compartilhados em um sqlly-credentials documento. |
lib/sqllyapp.js | O lado do sqlly.app no vínculo: cria o link e consulta a chave. |
server.js | Roteamento. GET /app/ é a rota de lançamento; /admin/* é o lado de administração; /admin/link* é vinculação. |
views/pages.js | O HTML, incluindo injectLaunch, que define as duas variáveis globais antes boot.js. |
test/ | node --test suítes que executam o aplicativo contra uma ponte falsa. Um bom modelo para testar a sua própria integração. |
Pronto para substituí-lo? Crie seu próprio app percorre cada um desses trabalhos na sua própria stack.