Para quem é?

O MIDDAG Account atende cinco personas distintas. Cada uma interage com o sistema de forma diferente, por interfaces diferentes, com objetivos diferentes. Identificar qual persona você é ajuda a encontrar a documentação certa rapidamente.

WP Admin (Empresa Adotante)

Você instalou o MIDDAG Account no seu próprio site WordPress.

Você tem um negócio que vende produtos ou serviços para outras empresas. Escolheu o MIDDAG Account para centralizar o ciclo de vida do cliente B2B em vez de amarrar vários plugins com fita adesiva ou pagar por uma plataforma SaaS de billing.

O que você faz:

• Instala, configura e mantém o plugin no seu site WordPress
• Configura sua entidade empresarial, entitlement classes e policies
• Conecta sua conta Stripe, produtos WooCommerce e outras integrações
• Cria sua primeira organização e executa o fluxo de compra até o entitlement

O que você precisa da documentação: Guias de Início Rápido, tutoriais de configuração e receitas que mostram como configurar cenários comuns sem escrever código.

Comece aqui: Requisitos e Instalação.

Admin Interno (Operador de Backoffice)

Você gerencia as operações diárias de clientes pelo painel admin do WordPress.

Você pode trabalhar em operações, financeiro, suporte comercial ou customer success. Passa tempo na interface admin do MIDDAG Account cuidando do dia a dia da gestão de relacionamentos B2B: processando orçamentos, acompanhando entitlements, gerando faturas, monitorando entrega de serviços.

O que você faz:

• Consulta o panorama completo de qualquer cliente em segundos: entitlements, faturas, licenças, serviços
• Processa o pipeline desde o orçamento até o pagamento e o entitlement
• Gerencia o ciclo de vida das organizações: onboarding, verificação, suspensão, recuperação
• Gera documentos financeiros: faturas, notas fiscais de serviço (NFSe), conciliação de pagamentos
• Monitora entrega de serviços, analisa solicitações de serviço e acompanha conformidade com SLA

O que você precisa da documentação: As seções Guia do Admin e Modelo Operacional, que explicam o que cada tela faz e como os fluxos diários se conectam.

Comece aqui: Conceitos-Chave e Como Funciona.

Cliente Final (Usuário do Portal)

Você é o proprietário ou admin de uma organização que compra produtos ou serviços.

Você acessa o portal do cliente para ver o que sua empresa adquiriu, aceitar orçamentos, gerenciar licenças, baixar software e cuidar do faturamento. Você quer uma experiência self-service onde consiga encontrar respostas sem precisar ligar para ninguém.

O que você faz:

• Visualiza todos os seus entitlements em um só lugar: licenças, ambientes, serviços, assinaturas
• Aceita orçamentos e conclui pagamentos
• Baixa software e documentos aos quais tem direito
• Cria solicitações de serviço vinculadas a entitlements específicos
• Gerencia sua equipe: convida colaboradores, atribui permissões, remove ex-membros

O que você precisa da documentação: A documentação voltada ao portal está fora do escopo do docs-site (que é direcionado a WP Admins). Sua experiência é moldada pelo portal que seu admin configurou.

Colaborador (Membro da Equipe)

Você foi convidado para uma organização pelo proprietário ou admin.

Você acessa o portal do cliente com permissões limitadas ao seu papel. Um membro do financeiro vê faturas e pedidos. Um membro de TI vê licenças e downloads. Um convidado pode ver apenas documentos compartilhados. Você vê exatamente o que seus escopos permitem e nada mais.

O que você faz:

• Acessa os dados específicos que seu papel exige: faturas, licenças, tickets, documentos
• Executa ações dentro dos escopos atribuídos: ativar uma licença, criar uma solicitação de serviço, baixar um arquivo
• Opera dentro de limites claros: o sistema informa o que você pode e não pode fazer

O que você precisa da documentação: Assim como os Clientes Finais, sua experiência é voltada ao portal. WP Admins configuram quais escopos estão disponíveis e como colaboradores são convidados.

Desenvolvedor (Integrador de API)

Você constrói sobre o MIDDAG Account usando sua REST API, hooks ou filters.

Você pode estar construindo um portal de clientes customizado, integrando o MIDDAG Account com um sistema externo ou estendendo seu comportamento com lógica de provisionamento personalizada. Você precisa de documentação de API clara, catálogo de hooks e contratos estáveis.

O que você faz:

• Constrói portais para clientes que consomem a REST API v1
• Integra sistemas externos via webhooks e chamadas de API
• Estende lógica de negócio através de hooks e filters do WordPress
• Cria provisionamento, notificações ou relatórios customizados

O que você precisa da documentação: A seção Referência, que cobre arquitetura, endpoints da REST API, hooks, webhooks, modelo de dados e pontos de extensão.

Comece aqui: Referência (documentação para desenvolvedores).

Referência rápida

Persona	Interface	Seção da documentação
WP Admin (Empresa Adotante)	WordPress admin, documentação	Início Rápido, Receitas
Admin Interno (Backoffice)	WordPress admin (UI do MIDDAG Account)	Guia do Admin, Modelo Operacional
Cliente Final	Portal do cliente	Documentação do portal (fora do escopo)
Colaborador	Portal do cliente (com escopo)	Documentação do portal (fora do escopo)
Desenvolvedor	REST API, hooks, código	Referência

Uma nota sobre o público

A maior parte do docs-site é escrita para as personas de WP Admin e Admin Interno. São as pessoas que instalam, configuram e operam o MIDDAG Account no dia a dia. O conteúdo fora da seção de Referência pressupõe familiaridade com o WordPress admin, mas não pressupõe conhecimento de programação, APIs ou arquitetura de software.

A seção de Referência é escrita para Desenvolvedores e pressupõe proficiência técnica com REST APIs, PHP e JavaScript.