Kit de crescimento mewayz

Kit de crescimento em Mewayz

O complemento GrowthKit é um manual de crescimento com reconhecimento de estágio, com pipeline de CRM e rastreamento de metas, para parceiros, revendedores de marca branca e inquilinos.

Mewayz-módulo original — não Mewayz a montante. Documentação de autoria da fonte do pacote em packages/mewayz/GrowthKit/.

URL de demonstração

Introdução

GrowthKit resolve a questão abstrata "como faço para expandir meu negócio Mewayz?" em uma lista de verificação diária concreta. Na inscrição, o operador executa um único mago que captura sua meta de receita, moeda, notas do público, canais de divulgação e meta de atividade semanal. A partir dessas respostas, o GrowthKit seleciona o caminho certo manual para o estágio atual de receita da operadora – desde “em branco” (ainda sem pistas) até “operacional” (receita sustentável).

Cada dia, o Hoje visualizar superfícies as próximas três ações que o operador deve realizar. À medida que eles marcam as etapas como concluídas, o GrowthKit avança seu progresso e (eventualmente) os gradua para o manual do próximo estágio. Um embutido Gasoduto visualizar rastreia leads por meio de status (novo → contatado → demonstração → proposta → ganha/perdida) para que a atividade de vendas do operador alimente o mesmo painel.

Como habilitar este módulo

Envios do GrowthKit sempre ligado para qualquer locatário que tenha o pacote instalado. Não há alternância "GrowthKit Add-On" dentro dos Add-Ons; o módulo é controlado por um dedicado growthkit middleware que simplesmente verifica se o operador concluiu o assistente.

Para ativar todo o sinalizador de recurso do GrowthKit, defina em .env:

GROWTHKIT_ENABLED=true
GROWTHKIT_CURRENCY=USD

Depois que o sinalizador de recurso estiver ativado, Crescer aparece na barra lateral para cada operador autenticado.

Assistente (configuração de primeira execução)

Quando um operador visita pela primeira vez /grow, o GrowthKit detecta que eles não têm seller_goals linha ainda e os redireciona para o assistente em /grow/wizard.

O assistente captura:

• Receita desejada — O número que você está tentando atingir (por exemplo, 5.000)
• Moeda alvo - O padrão é GROWTHKIT_CURRENCY valor ambiental
• Data prevista - Quando você quiser acertar
• Receita básica - Onde você está hoje (o padrão é 0)
• Meta de ação semanal — Quantas ações de crescimento por semana você

comprometer-se com (padrão 5)

• Nota do público — Uma breve descrição em texto livre de quem você vende

para (por exemplo, "pequenas clínicas dentárias na UE")

• Canais - Seleção múltipla de: e-mail, Whatsapp, LinkedIn,

telefone, pessoalmente

Clique Salvar meta para perturbar o seller_goals linha (uma por vendedor – reenviar o assistente atualiza a meta existente em vez de criar uma duplicata).

Visualização Hoje – Manual Diário

• Navegue até Crescer → Hoje (ou apenas /grow).
• A página está dividida em três seções:

1. Cabeçalho do manual ativo — Mostra o nome do playbook, seu

estágio atual e uma barra de progresso circular (% de etapas concluídas).

2. Próximos 3 passos — As três etapas de maior prioridade que você tem

ainda não marcado como concluído. Cada etapa tem um título, corpo, um modelo/link opcional e um Marcar como concluído botão.

3. Cartões de KPI — Contagem de pipeline, demonstrações neste período, fechadas

negócios, receitas realizadas. Os números vêm de seller_leads e o livro-razão da carteira.

• Clicando Marcar como concluído POSTs para /grow/step/done com o passo

EU IA; a página avança para o próximo lote.

Visualização do pipeline – Lead CRM

• Navegue até Crescer → Pipeline (/grow/pipeline).
• A lista mostra todos os leads que você adicionou com: nome, empresa,

e-mail, telefone, status, valor estimado e próxima data de acompanhamento.

• Clique + Novo lead para adicionar uma linha. Obrigatório: nome + status.

Opcionais: empresa, e-mail, telefone, fonte, valor estimado, próximo acompanhamento, notas em formato livre.

Status de leads

GrowthKit fornece estes status:

• novo — Acabei de adicionar; nenhum contato ainda
• contatado - Entrei em contato pelo menos uma vez
• demonstração — Demonstração agendada ou entregue
• proposta — Proposta enviada
• ganhou - Fechado; closed_at e closed_value são carimbados automaticamente
• perdido - Fechado-perdido

Editando um lead

• Clique em qualquer linha para abrir a gaveta de edição.
• Atualizando status para won carimba automaticamente o closed_at e

closed_value campos. (Defina o valor primeiro – o sistema o lê como a receita realizada.)

• O next_followup_at campo é o que impulsiona o "acompanhamento"

lembretes na seção KPI da visualização Hoje.

Limites do nível do plano

GrowthKit impõe um limite de leads de nível gratuito de 10 leads via config('growthkit.plan_gates.pipeline_max_free'). As operadoras de plano pago não têm limite.

Atingir o limite retorna um 422 no formulário “criar lead” com uma mensagem clara “atualize seu plano para adicionar mais leads”.

Playbooks (como são escolhidos)

Os manuais vivem no playbooks mesa, com degraus em playbook_steps. Cada manual é marcado com:

• seller_type - parceiro, revendedor ou inquilino
• stage - em branco, prospecção, primeira venda, escalonamento, operação

O semeador padrão (TenantPlaybookSeeder) envia cinco manuais para fase de locatário. O AdapterResolver lê o operador seller_type (de sua conta) e estágio atual (calculado a partir de seu progresso em manuais anteriores) e escolhe o caminho certo.

Atualmente, os operadores não alternam os playbooks manualmente – o GrowthKit os gradua automaticamente. Para forçar um manual diferente, um administrador pode excluir o manual do operador seller_step_progress linhas diretamente por meio do banco de dados.

Tabelas de banco de dados

O pacote adiciona cinco tabelas:

• playbooks — Definições do manual (slug, seller_type, stage,

nome, dias_alvo, etc.)

• playbook_steps — Etapas ordenadas por playbook (slug, título, corpo,

tipo, carga útil opcional)

• seller_step_progress — Rastreia quais etapas cada operador possui

marcado como concluído

• seller_leads — Linhas de pipeline de leads (uma por lead, com escopo para

vendedor)

• seller_goals — Uma linha por vendedor; o gol conquistado pelo

mago

Permissões

O GrowthKit usa filtros de propriedade em vez de permissões Spatie – os controladores impõem que um operador só possa ver e editar suas próprias etapas + leads. Um 403 será gerado se um usuário tentar marcar uma etapa como concluída que não pertence ao seu manual ativo.

Notas do Operador

• O assistente é executado uma vez por vendedor. Reenviar atualizações

linha existente.

• Quando o manual de uma etapa é concluído, o operador se forma;

não existe um botão manual "ir para o próximo manual".

• As opções de canal no assistente são armazenadas como uma matriz JSON em

seller_goals.channels para uso por avisos e lembretes posteriores.

• GrowthKit é sempre ligado quando o sinalizador env está definido - não

ativação de complementos por locatário.