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
Terminal
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 segredos

Servidor 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 token

QPBase

Guarda os dados numa pasta do disco do mesmo servidor, ou no D1 e R2 da Cloudflare.

Os seus dados

A 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.

  1. Descarregue e extraia a pasta

    O ficheiro tem 48 KB. Dentro vai o QPBase, o SDK, o guia e as instruções para IA.

  2. 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.
  3. 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.

  4. 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

Verificar o ficheiro

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 hospedarServe?Porquê
VPS, Railway, Render, Fly.ioSimNode sempre a correr e disco persistente para os dados.
Cloudflare WorkersSimUsa D1 para os dados e R2 para os ficheiros.
GitHub Pages e outro alojamento só de ficheiros estáticosNãoO QPBase é um programa que tem de ficar sempre a correr.
Serverless sem disco persistenteNãoOs 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
Descarregar grátis

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
Pedir licença comercial

É 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 nuvemQPBase
Onde ficam os dadosNos servidores do fornecedorNo seu servidor
Conta externaObrigatória, com plano do fornecedorNenhuma
InstalaçãoCriar projeto e configurar o SDKUma pasta e um comando
FuncionalidadesMuitas, como tempo real e funçõesO essencial: dados, contas, ficheiros e cópias
Custo de usoSegue os planos do fornecedorGrá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