Ciclo de Vida de Contratos

Este diagrama ilustra o fluxo completo de um contrato no Vanguru, desde a criação até a conclusão.

Fluxo Mermaid

graph TD
    A[Criar Contrato] --> B{Tier?}
    B -->|Free| C[Contrato Free]
    B -->|Premium| D[Contrato Premium]

    C --> E[Enviar para Aceite]
    D --> E

    E --> F[Responsável Aceita]
    F --> G{Tier?}

    G -->|Free| H[Status: Active<br/>Gerar Cobranças Manual]
    G -->|Premium| I[Criar Subscription Asaas]

    I --> J[Status: Active<br/>Cobranças Automáticas]

    H --> K{Ação?}
    J --> K

    K -->|Suspender| L[Status: Suspended]
    K -->|Cancelar| M[Status: Canceled]
    K -->|Completar Parcelas| N[Status: Completed]

    L --> O{Reativar?}
    O -->|Sim| H
    O -->|Não| M

    N --> P[Fim]
    M --> P

Estados do Contrato

Draft (Rascunho)

• Contrato criado mas não enviado para aceite
• Pode ser editado livremente
• Não gera cobranças

Pending (Pendente)

• Enviado para aceite do responsável
• Aguardando confirmação
• Não gera cobranças

Active (Ativo)

• Responsável aceitou os termos
• Free: Gera cobranças manualmente
• Premium: Subscription ativa no Asaas
• Gera cobranças conforme frequência definida

Suspended (Suspenso)

• Temporariamente inativo
• Premium: Subscription deletada no Asaas
• Não gera novas cobranças
• Pode ser reativado

Completed (Concluído)

• Todas as parcelas foram pagas
• Premium: Subscription cancelada automaticamente
• Histórico preservado

Canceled (Cancelado)

• Cancelado antes da conclusão
• Premium: Subscription deletada no Asaas
• Histórico preservado

Transições de Estado

De	Para	Condição
Draft	Pending	Enviar para aceite
Pending	Active	Responsável aceita
Pending	Canceled	Usuário cancela
Active	Suspended	Usuário suspende
Active	Completed	Todas parcelas pagas
Active	Canceled	Usuário cancela
Suspended	Active	Usuário reativa
Suspended	Canceled	Usuário cancela

Diferenças Free vs Premium

Free

• Cobranças geradas manualmente pelo sistema
• Pagamentos registrados manualmente pelo usuário
• Sem integração com gateway de pagamento

Premium

• Subscription criada no Asaas após aceite
• Cobranças geradas automaticamente (40 dias antes)
• Pagamentos atualizados via webhook
• Auto-cancelamento ao completar parcelas

---

Diagrama: Ciclo de Vida de Contratos
Versão: 1.0
Data: Janeiro 2026