Growthkit mewayz

GrowthKit in Mewayz

Das GrowthKit-Add-On ist ein phasenbewusstes Wachstums-Playbook mit einer CRM-Pipeline und Zielverfolgung, für Partner, White-Label-Reseller und Tenants.

Mewayz-original module — no Mewayz upstream. Documentation authored from package source at packages/mewayz/GrowthKit/.

Demo-URL

Einführung

GrowthKit turns the abstract question "how do I grow my Mewayz business?" into a concrete, daily checklist. At signup, the operator runs a one-time Assistent der ihr Umsatzziel, ihre Währung, Zielgruppennotizen, Outreach-Kanäle und ihr wöchentliches Aktivitätsziel erfasst. Aus diesen Antworten wählt GrowthKit das passende Playbook für die aktuelle Umsatzphase des Betreibers – von „leer“ (noch keine Leads) bis hin zu „operativ“ (nachhaltiger Umsatz).

Jeden Tag wird der Heute Ansicht zeigt die nächsten drei Aktionen, die der Betreiber durchführen sollte. Während er Schritte als abgeschlossen markiert, treibt GrowthKit seinen Fortschritt voran und (schließlich) befördert ihn zum Playbook der nächsten Phase. Ein integriertes Pipeline Ansicht verfolgt Leads durch Status (neu → kontaktiert → Demo → Angebot → gewonnen/verloren), sodass die Vertriebsaktivität des Betreibers dasselbe Dashboard speist.

How to enable this module

GrowthKit liefert immer aktiv für jeden Mandanten, der das Paket installiert hat. Es gibt kein „GrowthKit-Add-on“ zum Umschalten innerhalb der Add-ons; das Modul wird über eine dedizierte growthkit Middleware, die lediglich prüft, ob der Betreiber den Assistenten abgeschlossen hat.

Um GrowthKit feature-flag-weit zu aktivieren, setzen Sie in .env:

GROWTHKIT_ENABLED=true
GROWTHKIT_CURRENCY=USD

Sobald das Feature-Flag aktiviert ist, Wachsen erscheint für jeden authentifizierten Betreiber in der Seitenleiste.

Assistent (Ersteinrichtung)

Wenn ein Betreiber zum ersten Mal besucht /grow, erkennt GrowthKit, dass sie kein seller_goals noch keine Zeile hat, und leitet sie zum Assistenten weiter unter /grow/wizard.

Der Assistent erfasst:

• Zielumsatz — Die Zahl, die Sie erreichen möchten (z. B. 5.000)
• Zielwährung — Defaults to GROWTHKIT_CURRENCY env-Wert
• Zieldatum — Wann Sie zuschlagen wollen
• Basisumsatz — Wo Sie heute stehen (Standard ist ⟦0⟧)
• Wöchentliches Aktionsziel — Wie viele Wachstumsaktionen pro Woche Sie

zusagen (Standard 5)

• Hinweis zur Zielgruppe — Eine kurze Freitextbeschreibung, an wen Sie verkaufen

an (z. B. „kleine Zahnkliniken in der EU“)

• Kanäle — Mehrfachauswahl aus: E-Mail, WhatsApp, LinkedIn,

phone, in_person

Klicken Sie auf Ziel speichern um den/die … zu upserten seller_goals Zeile (eine pro Verkäufer – ein erneutes Absenden des Assistenten aktualisiert das bestehende Ziel, statt ein Duplikat zu erstellen).

Heute-Ansicht — Tägliches Playbook

• Navigiere zu Grow → Heute (oder einfach /grow).
• Die Seite ist in drei Abschnitte unterteilt:

1. Aktiver Playbook-Header – Zeigt den Namen des Playbooks, Ihren

aktuelle Phase und ein kreisförmiger Fortschrittsbalken (% der abgeschlossenen Schritte).

2. Nächste 3 Schritte — Die drei Schritte mit der höchsten Priorität, die du hast

noch nicht als erledigt markiert. Jeder Schritt hat einen Titel, einen Text, eine optionale Vorlage/einen Link und eine Als erledigt markieren Schaltfläche.

3. KPI cards — Pipeline-Anzahl, Demos in diesem Zeitraum, abgeschlossen

Deals, realisierter Umsatz. Die Zahlen stammen von seller_leads und das Wallet-Hauptbuch.

• Clicking Als erledigt markieren POSTet an /grow/step/done mit dem Schritt

ID; die Seite springt zum nächsten Stapel.

Pipeline-Ansicht – Lead-CRM

• Navigiere zu Wachsen → Pipeline (/grow/pipeline).
• Die Liste zeigt jeden Lead, den Sie hinzugefügt haben, mit: Name, Unternehmen,

E-Mail, Telefon, Status, geschätzter Wert und nächstes Follow-up-Datum.

• Klicken Sie auf + Neuer Lead um eine Zeile hinzuzufügen. Erforderlich: Name + Status.

Optional: Unternehmen, E-Mail, Telefon, Quelle, geschätzter Wert, nächste Nachfassaktion, freie Notizen.

Lead-Status

GrowthKit liefert diese Status:

• neu — Gerade hinzugefügt; noch kein Kontakt
• kontaktiert — Mindestens einmal kontaktiert
• Demo — Demo geplant oder durchgeführt
• Angebot — Angebot gesendet
• gewonnen — Geschlossen; closed_at und closed_value werden automatisch gestempelt
• verloren — Verloren

Einen Lead bearbeiten

• Klicken Sie auf eine beliebige Zeile, um den Bearbeitungsbereich zu öffnen.
• Status aktualisieren auf won stempelt automatisch das closed_at und

closed_value fields. (Set the value first — the system reads it as the realized revenue.)

• Der next_followup_at Feld ist das, was die „Nachfassaktion“ auslöst

Erinnerungen im KPI-Bereich der Heute-Ansicht.

Limits der Tarifstufen

GrowthKit erzwingt ein Lead-Obergrenze der kostenlosen Stufe von 10 Leads über config('growthkit.plan_gates.pipeline_max_free'). Operators on a paid plan have no cap.

Beim Erreichen des Limits gibt das Formular „Lead erstellen“ einen 422-Fehler mit einer klaren Meldung „Upgraden Sie Ihren Plan, um mehr Leads hinzuzufügen“ zurück.

Playbooks (Wie sie ausgewählt werden)

Playbooks befinden sich im playbooks Tabelle, mit Schritten in playbook_steps. Each playbook is tagged with:

• seller_type — Partner, Reseller oder Mandant
• stage — leer, prospecting, first_sale, scaling, operating

Der Standard-Seeder (TenantPlaybookSeeder) liefert fünf Playbooks für Mandanten-Phasen. Das AdapterResolver liest die seller_type (aus ihrem Konto) und die aktuelle Phase (berechnet aus ihrem Fortschritt durch frühere Playbooks) und wählt die richtige aus.

Operatoren wechseln derzeit nicht manuell zwischen Playbooks — GrowthKit stuft sie automatisch hoch. Um ein anderes Playbook zu erzwingen, kann ein Admin das des Operators löschen seller_step_progress Zeilen direkt über die Datenbank.

Datenbanktabellen

Das Paket fügt fünf Tabellen hinzu:

• playbooks — Playbook-Definitionen (Slug, seller_type, Phase,

name, target_days usw.)

• playbook_steps – Geordnete Schritte pro Playbook (Slug, Titel, Text,

Art, optionaler Payload)

• seller_step_progress — Verfolgt, welche Schritte jeder Operator hat

als erledigt markiert

• seller_leads — Lead-Pipeline-Zeilen (eine pro Lead, beschränkt auf

Verkäufer)

• seller_goals – Eine Zeile pro Verkäufer; das vom

Assistent

Berechtigungen

GrowthKit nutzt Eigentümerfilter statt Spatie-Berechtigungen – die Controller stellen sicher, dass ein Bearbeiter nur seine eigenen Schritte und Leads sehen und bearbeiten kann. Ein 403 wird ausgelöst, wenn ein Benutzer versucht, einen Schritt als erledigt zu markieren, der nicht zu seinem aktiven Playbook gehört.

Betreibernotizen

• Der Assistent läuft einmal pro Verkäufer. Durch erneutes Absenden werden die

bestehende Zeile.

• Wenn das Playbook einer Phase abgeschlossen ist, steigt der Betreiber auf;

es gibt keine manuelle Schaltfläche „zum nächsten Playbook gehen“.

• Kanalauswahlen im Assistenten werden als JSON-Array gespeichert auf

seller_goals.channels zur Verwendung durch nachgelagerte Nudges und Erinnerungen.

• GrowthKit ist immer aktiv wenn das Env-Flag gesetzt ist – kein

Add-on-Aktivierung pro Tenant.