Configuração Inicial

Funcionalidade Planejada

O Assistente de Configuração descrito nesta página ainda não existe. Este documento especifica a experiência de primeiro uso pretendida. Até que o assistente seja implementado, estes passos devem ser realizados manualmente pelas telas de configurações do MIDDAG Account.

Após instalar e ativar o MIDDAG Account, o Assistente de Configuração guia você pela configuração essencial para colocar seu primeiro ciclo de vida de cliente em funcionamento.

O assistente abre automaticamente na primeira vez que você acessa MIDDAG Account no admin do WordPress após a ativação. Você também pode executá-lo novamente depois em MIDDAG Account > Configurações > Assistente de Configuração.

Passo 1: Configurar sua entidade empresarial

Informe ao MIDDAG Account os dados da sua empresa. Essas informações aparecem em faturas, contratos, orçamentos e comunicações com o cliente.

Campo	Descrição	Exemplo
Nome da empresa	Razão social da empresa	Acme Software Ltda
País	País de constituição	Brasil
Moeda	Moeda principal de operação	BRL
Identificação fiscal	CNPJ ou número de identificação fiscal (opcional)	12.345.678/0001-90
Endereço	Endereço comercial para documentos	Rua Principal, 123, São Paulo, SP

Se você opera em vários países (por exemplo, uma entidade nos EUA e outra no Brasil), é possível adicionar entidades legais adicionais depois em MIDDAG Account > Configurações > Entidades Legais.

Por que isso é importante

A entidade empresarial determina qual moeda aparece nas faturas, qual formato de documento fiscal é usado (ex.: NFSe para o Brasil) e qual conta Stripe processa os pagamentos quando você conectar as integrações posteriormente.

Passo 2: Definir suas Entitlement Classes

As Entitlement Classes definem os tipos de produtos e serviços que sua empresa oferece. Quando um cliente compra algo, o MIDDAG Account cria um entitlement da classe correspondente. Cada classe determina quais recursos são provisionados automaticamente.

As classes padrão são:

Classe	Código	Ideal para
Plugin	PLG	Licenças de software, produtos para download
Environment	ENV	Hospedagem gerenciada, instalações de plataforma
Service	SVC	Serviços contínuos, projetos de consultoria, contratos de suporte
Order	ORD	Compras gerais que não se encaixam em outras categorias
Affiliate	AFL	Programas de parceiros
Education	EDU	Cursos, treinamentos, programas de mentoria

O que fazer aqui:

• Revise as classes padrão e decida quais se aplicam ao seu negócio
• Habilite as classes que você precisa, desabilite as que não precisa
• Opcionalmente, renomeie classes para adequar à sua terminologia (ex.: renomear "Plugin" para "App" ou "Environment" para "Workspace")

Não é preciso acertar tudo agora. Classes podem ser adicionadas, renomeadas ou reconfiguradas a qualquer momento em MIDDAG Account > Configurações > Entitlement Classes.

Passo 3: Conectar o WooCommerce

O MIDDAG Account usa o WooCommerce como motor de comércio — o WooCommerce cuida dos produtos, checkout e processamento de pagamentos, enquanto o MIDDAG Account gerencia o ciclo de vida do cliente após a compra.

Neste passo:

1. Verificar se o WooCommerce está ativo — O assistente verifica se o WooCommerce está instalado e em execução
2. Mapear produtos para Entitlement Classes — Para cada produto WooCommerce (ou categoria de produto), defina qual Entitlement Class deve ser criada quando um cliente comprar o produto
3. Configurar automação — Escolha se os entitlements devem ser criados automaticamente quando um pedido é concluído, ou manualmente por um administrador

Para uma explicação mais detalhada da integração com WooCommerce, veja Conectar WooCommerce.

Ainda não tem produtos?

Se você ainda não criou produtos no WooCommerce, pode pular este passo e voltar depois. O MIDDAG Account funciona com ou sem produtos WooCommerce — você também pode criar entitlements manualmente.

Passo 4: Criar sua primeira Organização

Organizações são o núcleo do MIDDAG Account. Todo cliente é uma organização — uma empresa, agência, instituição ou equipe — não um usuário WordPress individual.

Crie sua primeira organização para ver o sistema em ação:

Campo	Descrição	Exemplo
Nome da organização	Razão social do cliente	Beta Corp
País	Onde a organização está sediada	Brasil
E-mail de contato principal	Ponto de contato principal	admin@betacorp.com

Após criar a organização, você pode:

• Adicionar colaboradores (membros da equipe) com diferentes níveis de permissão
• Atribuir entitlements manualmente
• Visualizar o dashboard da organização

Passo 5: Criar seu primeiro Entitlement

Com uma organização criada, crie seu primeiro entitlement para ver o ciclo de vida em ação.

1. Selecione a Organização que você acabou de criar
2. Escolha uma Entitlement Class (ex.: Plugin, Service, Environment)
3. O sistema gera um Código de Entitlement único (ex.: PLG-2026050001)
4. Defina o status como Ativo
5. Opcionalmente defina uma data de expiração

Uma vez criado, o entitlement aparece no dashboard da organização. Dependendo da classe, recursos downstream podem ser provisionados automaticamente — por exemplo, um entitlement Plugin pode disparar a geração de chave de licença.

O que vem depois

Após completar estes cinco passos, você tem:

• Uma entidade empresarial configurada
• Entitlement Classes adequadas às suas ofertas
• WooCommerce conectado como seu motor de comércio
• Sua primeira organização e entitlement

A partir daqui, os próximos passos típicos são:

• Conectar WooCommerce — Entenda a ponte de comércio em detalhes
• Criar sua primeira Organização — Guia detalhado de gestão de organizações
• Criar seu primeiro Entitlement — Guia detalhado de criação de entitlements e ciclo de vida
• Primeiro Ciclo de Vida — Percorra um ciclo completo: organização, pedido, entitlement, renovação

Tempo estimado

O Assistente de Configuração foi projetado para levar de 15 a 30 minutos na primeira configuração. A maior parte desse tempo é gasta decidindo quais Entitlement Classes combinam com o seu negócio — o restante é preencher campos.