Status Atual
O MIDDAG Account está em desenvolvimento ativo. Esta página oferece uma visão honesta do que existe hoje, do que vem a seguir e do que faz parte da visão de longo prazo.
Disponibilidade de funcionalidades
Disponível agora
Estas funcionalidades possuem implementações funcionais no codebase atual.
Domínios principais
| Funcionalidade | Descrição |
|---|---|
| Organizações | Criação, visualização e gestão de organizações de clientes B2B |
| Colaboradores | Membros de equipe com acesso baseado em papéis por organização |
| Entitlements | Rastreamento central de ciclo de vida com códigos únicos, quatro estados (ativo, suspenso, expirado, cancelado) e seis entitlement classes |
| Pedidos | Integração com pedidos do WooCommerce, vinculados a organizações e entitlements |
| Faturas | Registros financeiros vinculados a pedidos e entitlements |
| Notas Fiscais de Serviço (NFSe) | Emissão de nota fiscal de serviço brasileira via integração com ISSNet |
| Orçamentos | Propostas comerciais com gestão de ciclo de vida |
| Licenças | Gestão de licenças de software com ativação por site |
| Contratos | Acordos de serviço com anexação de documentos |
| Ambientes | Ambientes de hospedagem gerenciados com hierarquia pai-filho |
| Serviços | Definições de tipos de serviço (hospedagem, suporte, consultoria, desenvolvimento, etc.) |
| Solicitações de Serviço | Rastreamento de tarefas e tickets contra entitlements com monitoramento de SLA |
| Documentos e Downloads | Gestão e distribuição de arquivos vinculados a entitlements |
| Afiliados | Rastreamento de programa de parceiros via integração com SolidAffiliate |
Integrações
| Integração | Status | O que faz |
|---|---|---|
| Stripe | Disponível | Processamento de pagamentos, suporte a duas contas (BR e US), tratamento de webhooks |
| HubSpot | Disponível | Sincronização de CRM, suporte a duas contas (BR e US), integração de pipeline de deals |
| ISSNet | Disponível | Emissão de nota fiscal de serviço (NFSe) brasileira para Brasília/DF via SOAP |
| Banco Inter | Disponível | Meios de pagamento brasileiros: Pix e Boleto |
| Cloudflare | Disponível | Banco de dados D1 e armazenamento de objetos R2 |
| Jira | Disponível | Sincronização de solicitações de serviço, gestão de issues e worklogs |
Infraestrutura
| Funcionalidade | Descrição |
|---|---|
| REST API v1 | API completa com tripla autenticação (nonce do WordPress, JWT, chaves WooCommerce) |
| UI Admin | Interface admin baseada em React dentro do WordPress (Inertia.js) |
| Integração WooCommerce | Produtos, checkout, mapeamento de status de pagamento |
| Policy Engine | Regras configuráveis em cinco níveis: global, classe, organização, produto, entitlement |
| Entitlement Classes | Seis classes: Plugin, Environment, Service, Order, Affiliate, Education |
| Suporte multi-entidade | Roteamento por entidade legal dupla (BR e US) |
| Tratamento de webhooks | Webhooks de entrada do Stripe, HubSpot e Banco Inter com válidação de assinatura |
Planejado
Estas funcionalidades estão no próximo ciclo de desenvolvimento. As especificações estão em andamento.
Novos domínios
| Funcionalidade | Descrição |
|---|---|
| Contato | Leads de pré-registro, antes de se tornarem colaboradores |
| Projeto | Instâncias de entrega de serviço, vinculando contratos a marcos |
| Saldo de Crédito | Rastreamento de créditos por entitlement, histórico de consumo, recargas |
| Registro de Produtos | Ponte entre produtos WooCommerce e entitlement classes com overrides de policies |
| Entidade Legal | Modelagem formal de entidades empresariais com regras de roteamento multi-entidade |
Novas integrações
| Integração | Descrição |
|---|---|
| Chatwoot | Sincronização de tickets de suporte ao cliente |
| Webhooks de saída | Catálogo de eventos para notificações de sistemas externos |
Melhorias
| Funcionalidade | Descrição |
|---|---|
| Assistente de Configuração | Configuração inicial guiada: entidade, entitlement classes, conexão com WooCommerce, primeira organização |
| Portal do cliente | Portal self-service para clientes finais (aceitação de orçamentos, gestão de licenças, solicitações de serviço) |
| Auto-provisionamento | Criação automática de recursos downstream quando um entitlement é criado após pagamento |
| Automação de renovação | Fluxos automatizados de renovação com períodos de carência e lógica de retentativa configuráveis |
| Dashboard admin | Métricas, alertas e visão operacional na tela principal do admin |
Aspiracional
Estas funcionalidades fazem parte da visão do produto. Representam direção comprometida, não uma lista de desejos, mas não possuem cronogramas definidos.
| Funcionalidade | Descrição |
|---|---|
| Hospedagem SaaS (Campus EAD / MIDDAG Pro) | Instâncias Moodle gerenciadas como linha de serviço |
| Relatórios e analytics de billing | Dashboards de receita, analytics de entitlements, conciliação financeira |
| Monitoramento de saúde do cron | Avisos no admin sobre saúde dos cron jobs e status de tarefas agendadas |
| Templates de e-mail sobrescrevíveis pelo tema | Notificações de e-mail customizáveis com sistema de templates |
| Pacote de tipos TypeScript | Pacote npm publicado com tipos de resposta da API para desenvolvedores de portais |
| Especificação OpenAPI | Especificação legível por máquina da REST API v1 |
| Suporte a portal white-label | Customização de marca para agências que constroem portais para seus clientes |
| Gate de testes automatizados CI/CD | Integração contínua com thresholds de cobertura e quality gates |
Cobertura da UI Admin
A interface admin está sendo construída progressivamente. Estado atual:
| Tela | Status |
|---|---|
| Dashboard | Disponível |
| Organizações | Disponível |
| Entitlements | Disponível |
| Demais telas do admin | Planejado |
Cobertura da documentação
Este site de documentação (docs-site) está sendo escrito em paralelo com o produto. O conteúdo está organizado por fase:
| Seção | Status |
|---|---|
| Visão Geral | Em andamento (você está lendo) |
| Início Rápido | Planejado |
| Conceitos Fundamentais | Planejado |
| Modelo Operacional | Planejado |
| Guia do Admin | Planejado |
| Comércio | Planejado |
| Integrações | Planejado |
| Receitas | Planejado |
| Policies | Planejado |
| Referência (desenvolvedor) | Planejado |
| Roadmap | Planejado |
Como interpretar os marcadores de status
Ao longo desta documentação, você verá marcadores de status:
- Disponível -- A funcionalidade está implementada e funcionando na versão atual.
- Planejado -- A funcionalidade está no próximo ciclo de desenvolvimento. Uma especificação existe ou está sendo escrita.
- Aspiracional -- A funcionalidade faz parte da visão do produto. Representa direção comprometida, mas não possui cronograma definido.
Quando uma página no docs-site descreve comportamento que ainda não foi implementado, o frontmatter da página indicará status: planned ou status: aspirational. Páginas marcadas com status: spec descrevem comportamento pretendido que o código deve implementar.