Conceitos da plataforma

Esta página reúne o vocabulário usado no console, na CLI, na API e no restante da documentação. Leia antes de criar o primeiro projeto: a maior parte das decisões de configuração e cobrança depende destes conceitos.

Conta, organização e permissões

Conta

A conta identifica uma pessoa. Ela tem e-mail verificado, senha e autenticação em dois fatores opcional. As conexões com GitHub e Forgejo, usadas para publicar a partir de repositórios, pertencem à organização e são gerenciadas pelo owner em Conta (seções do GitHub e Conexões de provedores Git). Veja Configurações de conta.

Organização

A organização é o espaço onde projetos, cobrança, crédito, membros e API keys vivem. Uma mesma conta pode participar de várias organizações e alternar entre elas no console. Todo projeto pertence a exatamente uma organização. Veja Organizações.

Papéis e permissões

Cada membro recebe um papel (owner, assistant ou member) e, quando necessário, permissões granulares por recurso, como um projeto específico, bancos de dados ou cobrança. O mesmo modelo de permissões vale para pessoas e para API keys. Veja Permissões granulares.

API key da organização

Chave usada pela API, pela CLI, pela GitHub Action e por automações. O MCP não usa API key: ele se conecta por OAuth no navegador, com acesso somente leitura. Ela pertence à organização, recebe apenas os scopes que você conceder e pode ser revogada a qualquer momento. Veja API keys.

Projetos

Projeto

Projeto é a unidade que você cria, configura, monitora e paga. Cada projeto tem um tipo, um plano, um modelo de pagamento e um ID único usado pela CLI e pela API.

Tipos de projeto

Tipo	Para que serve	Onde aprender
HTTP	Sites, APIs, workers e aplicações em geral	Deploy
PostgreSQL / MariaDB	Banco relacional gerenciado	Banco de Dados
Chave-Valor, Cache e Filas	Valkey gerenciado para estado, cache e mensageria	Serviços gerenciados
Analytics	ClickHouse gerenciado para consultas analíticas	Analytics
Job agendado	Tarefas que rodam por agendamento e são cobradas por minuto de execução	Jobs agendados

Origem do projeto HTTP

Um projeto HTTP é publicado a partir de um destes tipos de origem, escolhido na criação:

Repositório Git (GitHub ou Forgejo): a Zenifra faz o build do código (Node.js, Python ou Bun) a partir de uma branch. Veja Implantação via GitHub e Implantação via Forgejo.
Imagem OCI: você entrega uma imagem pronta de um registry público ou privado. Veja Deploy via imagem OCI.

Em projetos com repositório Git, é possível trocar o repositório, a branch e as configurações de build depois da criação; veja Conexões e origens Git.

Template

Um template descreve uma aplicação pronta (imagem, porta, variáveis e, opcionalmente, um banco) para ser implantada com poucos cliques. Veja Templates.

Ambiente de preview

Cópia temporária de um projeto HTTP criada para um pull request ou para uma chave de preview. Ele herda a configuração e o plano do projeto principal, roda sempre com uma instância, sem auto-scaling, e expira automaticamente. Veja Ambientes de Preview.

Capacidade e execução

Plano

O plano define CPU, memória, armazenamento incluído e recursos extras, como subdomínio personalizado, métricas, health checks, auto-scaling e controle de acesso por IP. Os logs da aplicação estão disponíveis em todos os planos. O console sempre mostra os recursos do plano antes da confirmação.

Instância

Instância é uma cópia em execução da sua aplicação ou banco. Projetos HTTP podem rodar com um número fixo de instâncias, limitado à capacidade disponível do plano, ou variar automaticamente com auto-scaling. Mais instâncias aumentam capacidade e disponibilidade, e também o custo.

Exposição

Projetos HTTP são públicos (recebem endereço *.clients.zenifra.com e aceitam domínios próprios) ou privados (sem rota pública, ideais para workers e automações). Veja Rede e acesso.

Variáveis de ambiente e armazenamento

Variáveis de ambiente guardam configuração e segredos fora do código. O armazenamento persistente mantém arquivos entre reinícios e novas versões.

Cobrança

Modelo de pagamento

Cada projeto é cobrado por hora, por mês ou por ano; Jobs agendados são cobrados por minuto de execução. O modelo por hora oferece mais flexibilidade para mudar plano e armazenamento; os modelos mensal e anual reservam a capacidade pelo período contratado. Veja Modelos de pagamento.

Crédito

O crédito é o saldo pré-pago da organização, usado inclusive para o consumo de IA. Veja Gestão de pagamentos.