Conceitos-Chave

Este é um glossário executivo dos principais conceitos do MIDDAG Account. Cada termo é explicado em linguagem simples para quem está encontrando-os pela primeira vez. Páginas detalhadas para cada conceito estão disponíveis na seção Conceitos Fundamentais.

Organização

Uma organização é uma empresa ou instituição que é seu cliente. É o container de nível mais alto para tudo: entitlements, colaboradores, faturas, contratos, licenças e serviços — tudo pertence a uma organização. Pense nisso como "o cadastro do cliente" — mas no nível da empresa, não do usuário individual.

Colaborador

Um colaborador é uma pessoa que pertence a uma organização. Cada colaborador tem um papel (proprietário, admin ou membro) e um conjunto de escopos que determinam o que pode ver e fazer. O proprietário gerencia a conta. Um admin pode convidar outros. Um membro vê apenas o que seus escopos atribuídos permitem — por exemplo, um membro da equipe financeira pode ver apenas faturas e pedidos.

Entitlement

Um entitlement é um registro único que representa "Organização X tem acesso ao Produto ou Serviço Y." É o conceito central do MIDDAG Account. Todo entitlement possui um código único (como PLG-2026050001), um estado de ciclo de vida (ativo, suspenso, expirado ou cancelado) e vínculos com todos os recursos downstream que esse acesso concede: licenças, contratos, serviços, ambientes, faturas e documentos.

Entitlements são soberanos

Um Entitlement não exige uma Organização. Todos os relacionamentos são opcionais — um Entitlement pode existir completamente standalone, sem um registro de Contact, Organização ou Cliente.

Isso torna o middag-account flexível além do B2B:

• Gift cards e acesso promocional — entitlements emitidos sem uma compra ou registro de cliente
• Clientes pessoa física (B2C) — uma pessoa, não uma empresa, pode possuir entitlements diretamente
• Entitlements de migração — importados de sistemas externos onde o mapeamento de organização ainda não existe
• Licenças compartilhadas — entitlements que não estão vinculados a uma única organização

O Entitlement é a entidade soberana do sistema. Tudo mais se conecta a ele opcionalmente.

Entitlement Class

Uma entitlement class define que tipo de acesso um entitlement representa. O sistema vem com classes como Plugin (licença de software), Environment (hospedagem gerenciada), Service (trabalho ou projeto contínuo), Order (compra geral), Affiliate (programa de parceiros) e Education (treinamento ou curso). Cada classe determina como o entitlement é provisionado, renovado e exibido. As classes são configuráveis pelo painel admin.

Policy

Uma policy é uma regra configurável que governa como os entitlements se comportam. As policies cobrem áreas como janelas de renovação, recuperação de pagamento, períodos de carência para cancelamento, metas de SLA, termos de trial, condições de reembolso e notificações. As policies podem ser definidas em cinco níveis — global, entitlement class, organização, produto ou entitlement individual — com o nível mais específico prevalecendo. As policies disponíveis são:

• Renewal Policy -- Comportamento de renovação automática, períodos de carência antes da expiração, preços de renovação
• Payment Recovery Policy -- O que acontece quando um pagamento falha, quanto tempo até a suspensão se tornar cancelamento
• Cancellation Policy -- Períodos de carência, retenção de dados, visibilidade no portal após expiração
• SLA Policy -- Tempos de resposta, tempos de resolução, metas de uptime, regras de escalonamento
• Credit Policy -- Expiração de créditos, ordem de consumo, limites para entitlements baseados em serviço
• Provisioning Policy -- Se o acesso é configurado automaticamente ou requer aprovação do admin
• Trial Policy -- Duração do trial, comportamento de conversão, prevenção de abuso
• Refund Policy -- Janela de reembolso, aprovação automática vs manual, impacto no entitlement
• Tier Change Policy -- Comportamento de upgrade/downgrade, períodos de cooldown, requisitos de aprovação
• Notification Policy -- Quais canais usar, quando enviar lembretes, configurações de opt-out

Pedido

Um pedido é um registro de compra, normalmente criado pelo WooCommerce. Quando um cliente finaliza um pedido, o MIDDAG Account o vincula à organização correspondente e cria entitlements com base nos produtos adquiridos. Os pedidos fazem a ponte entre o motor de comércio do WooCommerce e a gestão de ciclo de vida do MIDDAG Account.

Fatura

Uma fatura é um registro financeiro vinculado a um pedido ou entitlement. Faturas rastreiam valores, status de pagamento e datas de vencimento. Para operações brasileiras, o MIDDAG Account também suporta emissão de nota fiscal de serviço (NFSe) através da integração com o ISSNet.

Orçamento

Um orçamento é uma proposta comercial enviada a um cliente. Orçamentos têm seu próprio ciclo de vida: rascunho, enviado, visualizado, aceito, rejeitado, expirado, convertido ou cancelado. Quando um cliente aceita um orçamento, ele pode ser convertido automaticamente em um pedido, que por sua vez dispara a criação do entitlement.

Licença

Uma licença é uma licença de software vinculada a um entitlement. Licenças rastreiam quais sites estão autorizados a usar o software, gerenciam ativação e desativação, controlam acesso a downloads e lidam com renovação. Se o entitlement pai for suspenso ou cancelado, a licença acompanha.

Contrato

Um contrato é um acordo de serviço vinculado a um entitlement. Contratos definem os termos, duração e escopo de um relacionamento de serviço. Eles rastreiam datas de início e término, termos de renovação, e podem ter documentos anexados (acordos assinados, aditivos, escopos de trabalho).

Ambiente

Um ambiente é uma instalação de hospedagem gerenciada vinculada a um entitlement. Ambientes podem ser organizados em clusters pai-filho (por exemplo, um servidor de produção com filhos de staging e desenvolvimento). Eles rastreiam status de saúde, configuração e podem receber solicitações de serviço.

Serviço

Um serviço representa um tipo de trabalho que sua empresa entrega: hospedagem, suporte, gestão de infraestrutura, consultoria, desenvolvimento ou migração. Serviços são vinculados a entitlements e definem quais capacidades estão incluídas. Entitlements baseados em serviço frequentemente usam saldos de crédito para rastrear o consumo.

Solicitação de Serviço

Uma solicitação de serviço é uma tarefa ou ticket criado contra um entitlement. Ela rastreia trabalho que precisa ser feito: uma dúvida de suporte, um relato de bug, uma solicitação de mudança. Solicitações de serviço possuem rastreamento de SLA (tempo de resposta, tempo de resolução) governado pela SLA Policy vinculada ao entitlement pai.

Como tudo se conecta

Tudo no MIDDAG Account flui através da Organização e do Entitlement.

Uma organização é seu cliente. Um entitlement é aquilo a que ele tem acesso. Todos os outros conceitos ou pertencem a uma organização (colaboradores), pertencem a um entitlement (licenças, contratos, serviços, ambientes, solicitações de serviço) ou conectam os dois (pedidos, faturas, orçamentos, documentos).

Quando um cliente compra um produto, esta cadeia é criada: o pedido dispara um entitlement, que provisiona recursos downstream (uma licença, um contrato, um serviço ou um ambiente). Faturas registram o lado financeiro. Solicitações de serviço rastreiam trabalho contra o que foi adquirido. Policies governam as regras em cada etapa. Colaboradores determinam quem na organização pode ver e gerenciar o quê.

Uma organização, múltiplos entitlements, cada um com seu próprio ciclo de vida e recursos downstream — tudo visível a partir de uma única interface admin.