# Planos e quotas

URL: https://0.0.0.0:3002/docs/planos-e-quotas

Como funcionam o período de teste, o pool de recursos do workspace e os limites.

Cada workspace tem um **plano**. O plano define a **memória** que você distribui entre aplicações e bancos, a **vCPU** do workspace e o limite de membros. **Armazenamento e domínios são ilimitados em todo plano**, inclusive no teste. Não há limite de quantidade de recursos, só um tamanho mínimo por tipo.

## CPU: garantida pela memória, dividida nos picos [#cpu-garantida-pela-memória-dividida-nos-picos]

Você não escolhe a vCPU de cada aplicação ou banco:

* **Garantida:** cada recurso tem **1 vCPU por GB de memória**. Assim, 256 MB valem 0,25 vCPU e 2 GB valem 2 vCPU. Aumentar a memória aumenta a CPU garantida.
* **Picos:** quando sobra CPU no workspace, qualquer recurso usa mais que a garantia, até a **vCPU do plano**. Uma app sozinha pode usar toda a vCPU do plano enquanto as outras estão quietas.
* **Disputa:** quando todos precisam ao mesmo tempo, a vCPU do plano é dividida na proporção das garantias. O total do workspace nunca passa da vCPU do plano.

Veja o plano, o uso e os limites em **Workspace → Plano e uso**, ou pela API em `GET /v1/workspaces/{id}/plan`.

## Período de teste [#período-de-teste]

* O **primeiro** workspace que você cria entra em teste. Hoje o teste dura 14 dias, com 1 vCPU, 1 GB de memória e 3 membros.
* Cada pessoa tem um teste só. Os outros workspaces que você criar começam **sem plano** até contratar um.
* Alguns dias antes do fim, os proprietários e administradores do workspace recebem um aviso por e-mail.
* Quando o teste termina, começa uma **carência** de 7 dias: o que já existe continua rodando, mas não é possível criar nem aumentar recursos. A data do fim da carência aparece na página do plano e no e-mail. Quando a carência acaba, as [aplicações](/docs/aplicacoes) são paradas, sem apagar nada, até o workspace assinar um plano.

## Planos pagos [#planos-pagos]

O catálogo está em **Plano e uso**, no site da AcquaCloud e em `GET /v1/plans` (público, sem login; preço mensal em centavos de real e `featured` no plano em destaque). A assinatura é feita em **Plano e uso**; veja [Cobrança](/docs/cobranca).

Quando um plano muda de preço ou de limites, quem já assinou continua com as condições em que entrou.

## Status do plano [#status-do-plano]

| Status          | O que significa                                                               |
| --------------- | ----------------------------------------------------------------------------- |
| Em teste        | Pode criar e aumentar recursos dentro dos limites do teste, até a data de fim |
| Ativo           | Plano pago em vigor                                                           |
| Teste encerrado | Carência: recursos existentes continuam, nada novo é criado                   |
| Sem plano       | Nenhum recurso novo; só o proprietário como membro                            |

## Limites [#limites]

A memória do plano vale para o workspace inteiro. Um pedido que não cabe responde `409 quota_exceeded`, dizendo quanto foi pedido e quanto está disponível. A vCPU não é reservada: ela é o teto dos picos, dividido entre todos.

Tamanho mínimo por tipo de recurso (a vCPU é a garantida pela memória; o disco mínimo é técnico e o disco não tem limite no plano):

| Tipo       | Memória | vCPU garantida | Disco mínimo |
| ---------- | ------- | -------------- | ------------ |
| Aplicação  | 100 MB  | 0,1            | 0            |
| PostgreSQL | 256 MB  | 0,25           | 1 GB         |
| MySQL      | 512 MB  | 0,25           | 1 GB         |
| MariaDB    | 256 MB  | 0,25           | 1 GB         |
| MongoDB    | 512 MB  | 0,25           | 1 GB         |
| Redis      | 64 MB   | 0,1            | 256 MB       |

Abaixo do mínimo, a resposta é `422 resource_below_minimum`. Sem plano em vigor, `403 plan_required`.

**Membros:** membros + convites pendentes contam para o limite. Ao atingir o limite, novos convites respondem `409 member_limit_reached`.

## Acima da quota [#acima-da-quota]

Se o plano mudar para um menor que o uso atual, o workspace fica **acima da quota**. Nada é apagado nem parado: você pode reduzir e remover recursos normalmente, mas não pode criar nem aumentar até voltar a caber no plano.