Growthkit mewayz

GrowthKit en Mewayz

El complemento GrowthKit es un manual de crecimiento adaptado a cada etapa, con un pipeline de CRM y seguimiento de objetivos, pensado para socios, revendedores de marca blanca e inquilinos.

módulo original de Mewayz — sin Mewayz aguas arriba. Documentación redactada a partir del código fuente del paquete en packages/mewayz/GrowthKit/.

URL de demostración

Introducción

GrowthKit convierte la pregunta abstracta "¿cómo hago crecer mi negocio de Mewayz?" en una lista de tareas diaria y concreta. Al registrarse, el operador ejecuta una única asistente that captures their revenue target, currency, audience notes, outreach channels, and weekly activity target. From those answers, GrowthKit selects the right guía práctica para la etapa de ingresos actual del operador, desde «en blanco» (aún sin clientes potenciales) hasta «en marcha» (ingresos sostenibles).

Cada día, el Hoy la vista muestra las tres próximas acciones que debe realizar el operador. A medida que marcan los pasos como completados, GrowthKit avanza su progreso y (con el tiempo) los promueve al manual de la siguiente etapa. Un Pipeline la vista hace seguimiento de los leads a través de estados (nuevo → contactado → demostración → propuesta → ganado/perdido) para que la actividad de ventas del operador alimente el mismo panel.

Cómo habilitar este módulo

GrowthKit incluye always-on para cualquier inquilino que tenga el paquete instalado. No existe ningún interruptor de «Complemento GrowthKit» dentro de Complementos; el módulo se controla mediante un acceso dedicado growthkit middleware que simplemente comprueba si el operador ha completado el asistente.

Para habilitar GrowthKit a nivel de feature-flag, configura en .env:

GROWTHKIT_ENABLED=true
GROWTHKIT_CURRENCY=USD

Una vez activado el indicador de funcionalidad, Crecer aparece en la barra lateral para todos los operadores autenticados.

Wizard (First-Run Setup)

Cuando un operador visita por primera vez /grow, GrowthKit detecta que no tienen ningún seller_goals row yet and redirects them to the wizard at /grow/wizard.

El asistente recopila:

• Ingresos objetivo — La cifra que intentas alcanzar (p. ej. 5000)
• Moneda de destino — De forma predeterminada es GROWTHKIT_CURRENCY valor de entorno
• Fecha objetivo — Cuando quieras alcanzarlo
• Ingresos de referencia — Dónde estás hoy (por defecto es 0)
• Objetivo de acción semanal — Cuántas acciones de crecimiento por semana

comprometerse a (5 por defecto)

• Nota sobre la audiencia — Una breve descripción en texto libre de a quién vendes

a (p. ej. "clínicas dentales pequeñas en la UE")

• Canales — Selección múltiple de: email, whatsapp, linkedin,

teléfono, en persona

Haz clic en Guardar objetivo para insertar el seller_goals fila (una por vendedor: reenviar el asistente actualiza el objetivo existente en lugar de crear un duplicado).

Vista de hoy: tu guía diaria

• Ve a Crecer → Hoy (o simplemente /grow).
• La página se divide en tres secciones:

1. Encabezado del playbook activo — Muestra el nombre del manual, tu

etapa actual y una barra de progreso circular (% de pasos completados).

2. Próximos 3 pasos — Los tres pasos de mayor prioridad que tienes

aún sin marcar como hecho. Cada paso tiene un título, un cuerpo, una plantilla/enlace opcional y un Marcar como hecho button.

3. Tarjetas de KPI — Número de oportunidades, demos de este periodo, cierres

negocios, ingresos realizados. Las cifras provienen de seller_leads y el libro mayor del monedero.

• Al hacer clic Marcar como hecho Envía POST a /grow/step/done with the step

ID; the page advances to the next batch.

Vista de Pipeline — CRM de Leads

• Ve a Crecer → Pipeline (/grow/pipeline).
• La lista muestra cada cliente potencial que has añadido con: nombre, empresa,

correo electrónico, teléfono, estado, valor estimado y fecha del próximo seguimiento.

• Haz clic en + Nuevo Cliente Potencial para añadir una fila. Obligatorio: nombre + estado.

Opcional: empresa, correo electrónico, teléfono, origen, valor estimado, próximo seguimiento y notas de formato libre.

Estados de los leads

GrowthKit incluye estos estados:

• nuevo — Recién añadido; aún sin contacto
• contactado — Contactado al menos una vez
• demo — Demostración programada o realizada
• propuesta — Propuesta enviada
• ganado — Cerrado; closed_at y closed_value se marcan automáticamente
• perdido — Perdido

Editar un lead

• Haz clic en cualquier fila para abrir el panel de edición.
• Actualizando el estado a won marca automáticamente el closed_at y

closed_value campos. (Establece el valor primero — el sistema lo interpreta como los ingresos obtenidos.)

• La next_followup_at es lo que impulsa el "seguimiento"

recordatorios en la sección de KPI de la vista Hoy.

Límites por nivel de plan

GrowthKit aplica un límite de leads del plan gratuito de 10 clientes potenciales a través de config('growthkit.plan_gates.pipeline_max_free'). Los operadores con un plan de pago no tienen límite.

Al alcanzar el límite, el formulario de "crear lead" devuelve un error 422 con un mensaje claro: "actualiza tu plan para agregar más leads".

Manuales de estrategia (cómo se eligen)

Los manuales operativos están en el playbooks tabla, con los pasos en playbook_steps. Cada manual está etiquetado con:

• seller_type — socio, distribuidor o inquilino
• stage — en blanco, prospección, primera_venta, escalado, operación

El seeder predeterminado (TenantPlaybookSeeder) incluye cinco playbooks por etapa de tenant. El AdapterResolver lee el del operador seller_type (desde su cuenta) y la etapa actual (calculada a partir de su progreso por los playbooks anteriores) y elige la indicada.

Operators do not currently switch playbooks manually — GrowthKit auto-graduates them. To force a different playbook, an admin can delete the operator's seller_step_progress filas directamente a través de la base de datos.

Tablas de la base de datos

El paquete añade cinco tablas:

• playbooks — Definiciones de manuales (slug, seller_type, stage,

nombre, días_objetivo, etc.)

• playbook_steps — Pasos ordenados por guía (slug, título, cuerpo,

tipo, carga útil opcional)

• seller_step_progress — Hace seguimiento de qué pasos ha completado cada operador

marcado como hecho

• seller_leads — Filas del flujo de prospectos (una por prospecto, acotado a

vendedor)

• seller_goals — Una fila por vendedor; el objetivo registrado por el

asistente

Permisos

GrowthKit utiliza filtros de propiedad en lugar de permisos de Spatie: los controladores garantizan que un operador solo pueda ver y editar sus propios pasos y leads. Se genera un error 403 si un usuario intenta marcar como completado un paso que no pertenece a su playbook activo.

Notas del operador

• El asistente se ejecuta una vez por vendedor. Reenviar actualiza el

fila existente.

• Cuando el playbook de una etapa se completa, el operador asciende;

no hay un botón manual de "ir al siguiente playbook".

• Channel choices in the wizard are stored as a JSON array on

seller_goals.channels para su uso por avisos y recordatorios posteriores.

• GrowthKit es always-on cuando la marca de entorno está activada — no

activación de complementos por inquilino.