Planos

Planos são os modelos que definem como seus clientes serão cobrados. Cada plano agrupa produtos com preços específicos e configura ciclo de cobrança, período de trial e funcionalidades incluídas.

Campos do Plano

Campo	Descrição
Nome	Nome de exibição do plano (1-255 caracteres)
Slug	Identificador único amigável para URL (1-100 caracteres, apenas letras minúsculas, números e hífens)
Descrição	Texto descritivo sobre o que o plano inclui
Tipo	standard (padrão), custom (negociado) ou promotional (promocional)
Visibilidade	public (visível em listagens) ou private (apenas via link direto)
Ciclo de cobrança padrão	monthly, quarterly, semiannual ou annual
Ciclos disponíveis	Quais ciclos o cliente pode escolher ao assinar
Período de trial	0 a 90 dias de teste gratuito
Features	Lista de funcionalidades incluídas no plano
Limites	Quotas e restrições (ex: usuários, subcontas, API requests/dia)

Status e Ciclo de Vida

draft (rascunho) → active (ativo) → archived (arquivado)
        ↓                                    ↓
     DELETE                              RESTORE
   (apenas draft)                     (volta a active)

Status	Descrição
draft	Em construção. Pode ser publicado ou deletado
active	Disponível para novas assinaturas
archived	Desativado para novas assinaturas, mas existentes continuam funcionando

Regras de Transição

• Arquivar: Não é possível se existirem assinaturas ativas ou em trial
• Restaurar: Disponível apenas para planos arquivados; volta ao status active
• Deletar: Disponível apenas para planos em draft sem nenhuma assinatura associada

Itens do Plano

Cada plano contém itens que vinculam um produto a um preço específico:

Campo	Descrição
Produto	O produto incluído (apenas produtos raiz, sem filhos)
Preço	A variante de preço selecionada para o produto
Quantidade	Quantidade incluída (mínimo 1)
Incluído	Se o item faz parte do preço base ou é um add-on opcional

Regras dos Itens

• Apenas produtos raiz podem ser adicionados (produtos filhos são herdados automaticamente)
• Não é permitido duplicar o mesmo produto em um plano
• Todos os produtos devem pertencer à mesma organização e empresa do plano

Criando um Plano

1. Acesse Planos no dashboard
2. Clique em Novo Plano
3. Preencha os campos obrigatórios (nome, slug)
4. Adicione produtos e seus preços como itens do plano
5. Configure os ciclos de cobrança disponíveis
6. Opcionalmente defina um período de trial
7. Salve como rascunho ou publique diretamente

Duplicar Plano

Utilize a função de duplicação para copiar todos os detalhes de um plano. O sistema adiciona automaticamente "(Cópia)" ao nome e "-copy" ao slug. O plano duplicado é criado no status draft.

Operações em Lote

• Arquivar em lote: Arquiva múltiplos planos de uma vez (pula planos em uso)
• Deletar em lote: Remove múltiplos planos em draft (pula planos com assinaturas)
• Mover para grupo: Move múltiplos planos para um grupo específico

Empresa e Organização

• Todo plano pertence a uma organização (obrigatório)
• Opcionalmente pode estar vinculado a uma empresa específica (para faturamento por entidade jurídica)
• Todos os produtos do plano devem pertencer à mesma empresa/organização

Capturas de tela

Lista de planos

A tela /dashboard/plans lista os planos do catálogo com nome, ciclo, valor recorrente, número de assinaturas ativas, status (active/archived) e ações (editar, duplicar, arquivar).

Detalhe do plano

A página /dashboard/plans/[id] mostra itens do plano (produtos, preços, quantidades), regras de proration, política de cancelamento, lista de assinaturas vinculadas e auditoria.