Cloud - SSO e Cobrança

O Mangati Cloud é o provedor central de identidade e hub de cobrança do Mangati Cloud Suite. Todos os demais serviços dependem dele para autenticação e validação de assinaturas.

Conceitos Principais

Organizações

Uma Organização representa um tenant - uma empresa, instituição ou equipe. Todos os dados dos serviços têm escopo por organização.

Organizações possuem:

• Um slug único (identificador amigável para URL, ex.: prefeitura-exemplo)
• Um domínio opcional (ex.: prefeitura.gov.br)

Usuários e Membros

Um Usuário pode pertencer a várias organizações com papéis diferentes. Cada membro pode assumir um dos papéis:

• Dono: Proprietário da organização, apenas ele pode transferir a propriedade para outro usuário.
• Gerente / Gestor: Possui acesso gerencial da organização, pode adicionar e remover membros.
• Editor: Possui acesso mais restrito que o gerencial, mas é capaz de gerenciar os cadastros.
• Visualizador: Usuário com acesso restrito a leitura somente.

A gestão de membros é feita via Convites - um administrador convida um usuário por e-mail, e o usuário confirma o convite.

Produtos e Assinaturas

Um Produto representa um serviço Mangati cobrado (ex.: NovoSGA Online, Agenda, Créditos). O produto pode ser uma assinatura ou uma compra única.

Uma Assinatura vincula uma organização a uma variação de produto com ciclo de cobrança e status (ativa, cancelada, em trial, etc.).

Checkout e Cobrança

A cobrança é feita via cartão de crédito e administrada pelo gateway de pagamento (Stripe). Toda assinatura é gerenciada pelo menu Financeiro > Assinaturas da organização.

Os valores são cobrados apenas enquanto as assinaturas estiverem ativas, e pode ser canceladas a qualquer momento.

Interface Web

Workspace

A interface web multi-tenant está em /workspace/{slug}/. Páginas principais:

Caminho	Função
/workspace/{slug}/subscriptions	Visualizar e gerenciar assinaturas
/workspace/{slug}/subscriptions/new	Iniciar nova assinatura
/workspace/{slug}/payments	Histórico de pagamentos
/workspace/{slug}/members	Gerenciar membros da organização
/workspace/{slug}/support/tickets	Chamados de suporte

Painel Administrativo

Administradores acessam /admin/ para gerenciar produtos, usuários, organizações e assinaturas globalmente.

Configurações e Perfil

• /settings/organizations - gerenciar organizações que você administra
• /profile - editar perfil pessoal

Ciclo de Vida da Assinatura

[Novo Checkout] → [Pagamento] → [Assinatura Ativa]
                                        ↓
                        [Serviço Notificado por Webhook]

Após o pagamento, o Cloud envia um webhook assíncrono ao serviço correspondente, que provisiona os recursos necessários (ex.: o NovoSGA Online cria uma instância).

Lista de Verificação para Integração

• [ ] Organização criada no Cloud
• [ ] Assinatura ativa para o produto desejado
• [ ] Token de acesso criado em cada serviço de extensão
• [ ] Webhook do NovoSGA configurado (se integrar Monitor, Avaliação ou Notificação)