GrowthKit dans Mewayz
Le module complémentaire GrowthKit est un guide de croissance adapté à chaque étape, avec un pipeline CRM et un suivi des objectifs, destiné aux partenaires, aux revendeurs en marque blanche et aux locataires.
module Mewayz-original — aucun Mewayz en amont. Documentation rédigée à partir du code source du package à l'adresse
packages/mewayz/GrowthKit/.
Introduction
GrowthKit transforme la question abstraite « comment développer mon entreprise Mewayz ? » en une checklist concrète et quotidienne. À l'inscription, l'opérateur lance une assistant qui capture leur objectif de chiffre d'affaires, leur devise, leurs notes d'audience, leurs canaux de prospection et leur objectif d'activité hebdomadaire. À partir de ces réponses, GrowthKit sélectionne le bon guide pratique selon l'étape de revenus actuelle de l'exploitant — de « vierge » (aucun prospect encore) jusqu'à « en activité » (revenus durables).
Chaque jour, le Aujourd'hui fait apparaître les trois prochaines actions que l'opérateur devrait entreprendre. À mesure qu'il marque les étapes comme terminées, GrowthKit fait avancer sa progression et finit par le faire passer au playbook de l'étape suivante. Un Pipeline vue suit les prospects à travers les statuts (nouveau → contacté → démo → proposition → gagné/perdu) afin que l'activité commerciale de l'opérateur alimente le même tableau de bord.
Comment activer ce module
GrowthKit livre toujours actif pour tout locataire ayant le package installé. Il n'existe aucun bouton « Module complémentaire GrowthKit » dans les Modules complémentaires ; le module est conditionné par un growthkit middleware qui vérifie simplement si l'opérateur a terminé l'assistant.
Pour activer GrowthKit à l'échelle des feature flags, définissez dans .env:
GROWTHKIT_ENABLED=true
GROWTHKIT_CURRENCY=USD
Une fois l'indicateur de fonctionnalité activé, Développer apparaît dans la barre latérale pour chaque opérateur authentifié.
Assistant (configuration initiale)
Lorsqu’un opérateur se connecte pour la première fois /grow, GrowthKit détecte qu'ils n'ont aucun seller_goals ligne pour l'instant et les redirige vers l'assistant à /grow/wizard.
L’assistant capture :
- Revenu cible — Le chiffre que vous essayez d'atteindre (par ex. 5 000)
- Devise cible — Par défaut
GROWTHKIT_CURRENCYvaleur env - Date cible — Quand vous voulez l'atteindre
- Revenus de référence — Où vous en êtes aujourd'hui (par défaut 0)
- Objectif d'action hebdomadaire — Combien d'actions de croissance par semaine vous
- Note sur l'audience — Une courte description en texte libre de qui vous vendez
- Canaux — Sélection multiple parmi : e-mail, whatsapp, linkedin,
s'engager à (par défaut 5)
à (par ex. « petites cliniques dentaires dans l'UE »)
téléphone, en_personne
Cliquez Enregistrer l'objectif pour upsert le seller_goals ligne (une par vendeur — soumettre à nouveau l'assistant met à jour l'objectif existant plutôt que de créer un doublon).
Vue Aujourd'hui — Manuel quotidien
- Accédez à Croissance → Aujourd'hui (ou simplement
/grow). - La page est divisée en trois sections :
- En-tête du playbook actif — Affiche le nom du guide, votre
- 3 prochaines étapes — Les trois étapes les plus prioritaires que vous avez
- Cartes d’indicateurs clés — Nombre de pipelines, démos sur la période, conclues
l’étape en cours et une barre de progression circulaire (% des étapes terminées).
pas encore marquée comme terminée. Chaque étape comporte un titre, un corps, un modèle/lien facultatif et un Marquer comme terminé bouton.
affaires, chiffre d'affaires réalisé. Les chiffres proviennent de seller_leads et le grand livre du portefeuille.
- En cliquant Marquer comme terminé POST vers
/grow/step/doneavec l'étape
ID ; la page passe au lot suivant.
Vue pipeline — CRM des prospects
- Accédez à Développer → Pipeline (
/grow/pipeline). - La liste affiche chaque prospect que vous avez ajouté avec : le nom, l'entreprise,
- Cliquez + Nouveau prospect pour ajouter une ligne. Requis : nom + statut.
e-mail, téléphone, statut, valeur estimée et date du prochain suivi.
Facultatif : entreprise, e-mail, téléphone, source, valeur estimée, prochain suivi, notes libres.
Statuts des prospects
GrowthKit propose ces statuts :
- nouveau — Vient d'être ajouté ; aucun contact pour l'instant
- contacté — Contacté au moins une fois
- démo — Démo planifiée ou réalisée
- proposition — Proposition envoyée
- gagné — Fermé ;
closed_atetclosed_valuesont horodatés automatiquement - perdu — Perdu-clôturé
Modifier un lead
- Cliquez sur n'importe quelle ligne pour ouvrir le volet d'édition.
- Mise à jour du statut vers
wonhorodate automatiquement leclosed_atet - Le
next_followup_atchamp est ce qui pilote le « suivi »
closed_value champs. (Renseignez d'abord la valeur — le système la lit comme le revenu réalisé.)
rappels dans la section KPI de la vue Aujourd'hui.
Limites par niveau de forfait
GrowthKit impose un plafond de prospects de l'offre gratuite sur 10 leads via config('growthkit.plan_gates.pipeline_max_free'). Les opérateurs sur un forfait payant n'ont aucune limite.
Atteindre le plafond renvoie une erreur 422 sur le formulaire « créer un lead » avec un message clair « passez à un plan supérieur pour ajouter plus de leads ».
Playbooks (comment ils sont choisis)
Les playbooks vivent dans le playbooks tableau, avec les étapes dans playbook_steps. Chaque playbook est étiqueté avec :
seller_type— partenaire, revendeur ou locatairestage— vide, prospection, première_vente, croissance, exploitation
Le seeder par défaut (TenantPlaybookSeeder) propose cinq playbooks par étape de locataire. Le AdapterResolver lit celui de l'opérateur seller_type (depuis leur compte) et l'étape actuelle (calculée à partir de leur progression dans les playbooks précédents) et choisit le bon.
Les opérateurs ne changent pas actuellement de playbook manuellement — GrowthKit les fait progresser automatiquement. Pour forcer un playbook différent, un administrateur peut supprimer le seller_step_progress les lignes directement via la base de données.
Tables de la base de données
Le package ajoute cinq tables :
playbooks— Définitions des playbooks (slug, seller_type, stage,playbook_steps— Étapes ordonnées par playbook (slug, titre, corps,seller_step_progress— Suit les étapes que chaque opérateur a réaliséesseller_leads— Lignes du pipeline de prospects (une par prospect, limitée àseller_goals— Une ligne par vendeur ; l'objectif capturé par la
name, target_days, etc.)
type, charge utile optionnelle)
marqué comme terminé
vendeur)
assistant
Autorisations
GrowthKit utilise des filtres de propriété plutôt que les autorisations Spatie — les contrôleurs garantissent qu'un opérateur ne peut voir et modifier que ses propres étapes et prospects. Une erreur 403 est levée si un utilisateur tente de marquer comme terminée une étape qui n'appartient pas à son playbook actif.
Notes de l’opérateur
- L'assistant s'exécute une fois par vendeur. La re-soumission met à jour le
- Lorsque le playbook d’une étape est terminé, l’opérateur passe au niveau supérieur ;
- Les choix de canaux dans l'assistant sont stockés sous forme de tableau JSON dans
- GrowthKit est toujours actif lorsque l'indicateur d'environnement est défini — pas
ligne existante.
il n'y a pas de bouton manuel « passer au playbook suivant ».
seller_goals.channels pour être utilisé par les relances et rappels en aval.
activation des modules complémentaires par locataire.