Planos e Pacotes

Resumo

Gestão dos planos de assinatura oferecidos pela plataforma e pelos tenants. Inclui criação de planos, definição de features incluídas, limites por plano, configuração de períodos de trial e visualização das assinaturas ativas dos clientes.

Para quem é (papel/role)

• super-admin - gerencia planos globais da plataforma.
• tenant-admin - gerencia planos comerciais do próprio tenant.

O que você pode fazer

Planos

• Criar plano: nome, descrição, preço mensal/anual, moeda, status.
• Editar plano: atualizar preço, descrição, limites, ordem de exibição.
• Excluir plano: remoção controlada (se não há assinaturas ativas).
• Publicar / despublicar: controla visibilidade na página pública.

Features

• Catálogo de features: registrar features que podem ser incluídas em planos.
• Associar features: marcar quais features cada plano inclui e com quais limites.
• Limites por plano: quota de uso, número de usuários, volume de dados, etc.

Trials

• Configurar trial: dias de teste, feature set do trial, conversão automática.
• Listar trials ativos: quem está em período de teste.

Assinaturas

• Listar assinaturas: todas as assinaturas ativas, pausadas e canceladas.
• Detalhe da assinatura: histórico de cobranças, status, próximo vencimento.
• Ajustes manuais: pausar, reativar, cancelar, renovar.

Preços (payable resources / recharge options)

• Recursos cobráveis: definir itens avulsos cobráveis (addons, créditos).
• Opções de recarga: pacotes de recarga disponíveis aos usuários.

Como acessar

1. /admin.
2. Settings → Planos ou /admin/settings/plans.
3. Abas internas: Planos, Features, Trials, Assinaturas.

Tutoriais

Criar um plano com 5 plugins incluídos

1. Acesse /admin/settings/plans/create.
2. Informe nome, descrição e preço.
3. Em Features, marque as 5 features correspondentes aos plugins desejados.
4. Defina limites (usuários, volume, chamadas de API).
5. Salve e publique.

Configurar trial de 14 dias

1. Abra o plano em /admin/settings/plans/{id}/edit.
2. Na aba Trials, ative Trial habilitado e defina 14 dias.
3. Selecione se há conversão automática ao fim do período.
4. Salve.

Cancelar uma assinatura manualmente

1. Acesse /admin/settings/plans/subscriptions.
2. Localize a assinatura e clique em Cancelar.
3. Informe motivo e confirme.

Integrações

• Billing - assinaturas geram faturas automaticamente (billing-gateways.md).
• Receita - MRR e churn são calculados com base nos planos ativos (receita-e-financeiro.md).
• Plugins - features podem liberar acesso a plugins (store-marketplace-plugins.md).
• Afiliados - comissões podem ser configuradas por plano (afiliados-admin.md).

Perguntas frequentes

Posso editar preço de um plano com clientes ativos? Sim, mas clientes atuais mantêm o preço contratado até renovação, conforme política.

Posso excluir um plano com assinaturas ativas? Não. Primeiro migre ou cancele as assinaturas.

Trial exige cartão? Depende da configuração do gateway e da política do plano.

Posso ter planos por tenant? Sim. Tenants podem criar pacotes próprios dentro dos limites liberados pelo super-admin.

Como cobro pacotes adicionais (créditos extras)? Use Recharge options para pacotes avulsos e Payable resources para itens sob demanda.

Features podem ter limites numéricos? Sim. Cada vínculo feature-plano aceita um limite específico.

O que acontece quando o usuário excede o limite? Depende do feature flag - pode bloquear, cobrar overage ou apenas notificar.

Plano anual aplica desconto automático? Configure o preço anual explicitamente no plano; a plataforma não calcula desconto automático.

Limitações, políticas e avisos

• Alterações de preço não se aplicam retroativamente a assinaturas ativas.
• Excluir feature associada a planos exige tratamento manual.
• Trials expirados convertem conforme regra; sem cartão na base, a assinatura cai em pendente.

Relacionados

• billing-gateways.md
• revenue-and-finance.md
• store-marketplace-plugins.md
• affiliates-admin.md