Os dados do seu site ficam no seu servidor.
O QPBase é um motor de armazenamento que corre no mesmo servidor do seu site. Guarda utilizadores, dados e ficheiros, sem Supabase, Firebase ou outra base de dados externa. Descarregue grátis e peça à sua IA para o integrar no projeto.
- Versão
- 1.0.1
- Tamanho
- 48 KB
- Requisitos
- Node 18 ou superior, ou Cloudflare
- Licença
- Grátis para uso pessoal
cd qpbase-v1.0.1 cp .env.example .env # defina QPBASE_MASTER_KEY (16 caracteres ou mais) npm start # o QPBase fica a ouvir na porta 8787 curl -X POST http://localhost:8787/v1/units \ -H "Authorization: Bearer A_SUA_CHAVE_MESTRA" \ -H "Content-Type: application/json" \ -d '{"name":"O meu site"}' # devolve o id do projeto e o token qpk_...
O essencial para um site com dados
Seis funções, todas dentro de uma pasta pequena e sem dependências externas.
Coleções de dados
Guarde registos em coleções, com criar, ler, editar e apagar, e listas com paginação.
Projetos isolados
Cada projeto tem o seu token, os seus dados e os seus limites. Um servidor pode servir vários sites.
Contas de utilizador
Registo, login, sessões de 7 dias e recuperação de palavra-passe. As palavras-passe ficam guardadas com hash.
Ficheiros
Guarde imagens, PDF, texto e JSON, até 5 MB por ficheiro.
Cópias de segurança
Exporte e importe um projeto ou o servidor inteiro, pela API ou pelo painel de administração.
Notificações opcionais
Push (FCM), email (Resend) e SMS (Twilio). Só funcionam depois de configurar as credenciais.
O navegador nunca fala com o QPBase
O token do projeto dá acesso a todos os dados desse projeto, por isso fica só no servidor da sua aplicação.
Navegador
Mostra o site e envia pedidos à sua aplicação. Não tem chaves nem tokens do QPBase.
Sem segredosServidor da sua aplicação
Valida o pedido e fala com o QPBase. O token do projeto fica aqui, em variáveis de ambiente.
Guarda o tokenQPBase
Guarda os dados numa pasta do disco do mesmo servidor, ou no D1 e R2 da Cloudflare.
Os seus dadosA sua IA conhece esta regra: está nas instruções que vão dentro da pasta.
Como usar, em quatro passos
Quem o integra é a sua IA. Você só precisa de lhe dar a pasta e o seu projeto.
Descarregue e extraia a pasta
O ficheiro tem 48 KB. Dentro vai o QPBase, o SDK, o guia e as instruções para IA.
Dê a pasta e o seu projeto à sua IA
Funciona com qualquer assistente de IA. Copie este pedido e cole-o na conversa.
Tens acesso à pasta do QPBase e ao meu projeto. 1. Lê primeiro o AI-INTEGRATION-INSTRUCTIONS.md e o README.md da pasta do QPBase, e respeita o ficheiro LICENSE. 2. Integra o QPBase no meu projeto para guardar os dados no mesmo servidor, sem Supabase, Firebase ou outra base de dados externa. 3. Antes de escrever código, confirma que o meu alojamento corre Node de forma permanente com disco gravável persistente (ou Cloudflare Workers). Se não correr, avisa-me e pára. 4. Nunca ponhas a chave mestra, o token do projeto ou tokens de utilizador no código do site, no Git ou no browser. O browser fala só com o servidor da aplicação, e só esse servidor fala com o QPBase. 5. Cria no projeto um .env.example com as variáveis necessárias, sem valores reais. 6. Vê no LICENSE se o meu projeto conta como uso comercial e diz-me. Se contar, lembra-me que preciso de uma licença comercial antes de publicar. Se for uso gratuito, põe o aviso "Powered by QPBase" no rodapé ou nos créditos. 7. No fim, testa /health, registo e login, e um ciclo criar, ler, editar e apagar. Diz-me o que integraste, como arrancar e que limitações existem.
A IA integra, configura e testa
Ela liga o QPBase ao seu projeto, cria as variáveis de ambiente e testa o registo, o login e os dados. No fim, diz-lhe o que fez e como arrancar.
Hospede o projeto
Ponha o projeto num servidor com Node, ou na Cloudflare. O QPBase vai dentro do projeto e os dados ficam no mesmo servidor.
Prefere fazer à mão? A documentação tem todos os comandos e rotas.
Descarregar o QPBase 1.0.1
Um único ficheiro zip, pronto a dar à sua IA.
Ficheiro
qpbase-v1.0.1.zip- Tamanho48 KB
- README.md e COMO-USAR.mdGuias de instalação e de utilização
- AI-INTEGRATION-INSTRUCTIONS.mdInstruções para o assistente de IA
- src/ e sdk/O servidor e o SDK JavaScript
- .env.example e wrangler.toml.exampleModelos de configuração
- LICENSE e NOTICE.txtLicença e avisos
Ao descarregar, aceita os termos da licença.
Verificar o ficheiro
SHA-256 do ficheiro. Compare-o com o resultado do seu computador depois de descarregar.
3752f7f6974bce73f0edfc3b69c09722fee6635b011775cd7344e176fe612fd3
sha256sum qpbase-v1.0.1.zip # Linux e macOS (no macOS: shasum -a 256)Get-FileHash qpbase-v1.0.1.zip # Windows (PowerShell)Onde hospedar o projeto
O QPBase precisa de um servidor que fique sempre a correr, com disco persistente, ou da Cloudflare.
| Onde hospedar | Serve? | Porquê |
|---|---|---|
| VPS, Railway, Render, Fly.io | Sim | Node sempre a correr e disco persistente para os dados. |
| Cloudflare Workers | Sim | Usa D1 para os dados e R2 para os ficheiros. |
| GitHub Pages e outro alojamento só de ficheiros estáticos | Não | O QPBase é um programa que tem de ficar sempre a correr. |
| Serverless sem disco persistente | Não | Os dados perder-se-iam em cada novo deploy. Use a Cloudflare. |
Grátis para usar, licença para negócios
Descarregue e use sem pagar em projetos pessoais e sem fins lucrativos. Para uso comercial, peça uma licença.
Uso gratuito
Sem custos, no seu próprio servidor.
- Projetos pessoais, aprendizagem, testes e avaliação
- Projetos sem fins lucrativos e comunitários
- Qualquer programador ou assistente de IA pode integrar o QPBase
- Mantenha o aviso «Powered by QPBase» no rodapé, nos créditos ou no README
Uso comercial
Licença paga, pedida antes de publicar.
- Projetos feitos para um cliente mediante pagamento
- Projetos usados por um negócio para obter receita
- Licença por projeto ou para agências, com certificado
- O aviso «Powered by QPBase» pode ser removido, se a licença o permitir
É sempre proibido revender ou redistribuir o QPBase isolado, usá-lo para criar um produto concorrente ou remover os avisos de copyright. Leia o texto completo na página da licença.
QPBase e serviços na nuvem
O QPBase faz menos do que um serviço na nuvem completo, mas o que faz fica consigo.
| Serviços na nuvem | QPBase | |
|---|---|---|
| Onde ficam os dados | Nos servidores do fornecedor | No seu servidor |
| Conta externa | Obrigatória, com plano do fornecedor | Nenhuma |
| Instalação | Criar projeto e configurar o SDK | Uma pasta e um comando |
| Funcionalidades | Muitas, como tempo real e funções | O essencial: dados, contas, ficheiros e cópias |
| Custo de uso | Segue os planos do fornecedor | Grátis para uso pessoal, licença para uso comercial |
Perguntas frequentes
Preciso de saber programar?
Não para a integração, porque a sua IA faz o trabalho. Precisa de conseguir pôr o projeto num servidor com Node, ou na Cloudflare. Se preferir, a ISAB Studio faz a integração por si.
Funciona com qualquer assistente de IA?
Sim. A pasta inclui um ficheiro de instruções para IA, escrito para qualquer assistente conseguir ler e seguir.
Posso usar num site no GitHub Pages ou num alojamento só de ficheiros?
Não. O QPBase é um programa que tem de ficar sempre a correr num servidor, ou na Cloudflare.
Onde ficam os dados?
Numa pasta do disco do seu servidor, ou no D1 e R2 da Cloudflare. Faça cópias de segurança com regularidade e guarde-as fora do servidor.
O que conta como uso comercial?
Projetos feitos para um cliente mediante pagamento, e projetos usados por um negócio para obter receita. Se tiver dúvidas, escreva-nos antes de publicar.
Como peço uma licença comercial ou suporte?
Escreva para licenca@isabstudio.dev com o tipo de projeto e o número de projetos. Respondemos com as condições.
Quer que a ISAB Studio integre o QPBase no seu projeto?
Fazemos a integração e o acompanhamento do projeto depois de publicado.
Falar com a ISAB Studio