Mewayz 中的生长套件
GrowthKit 附加组件是一个阶段感知的增长手册，具有 CRM 管道和目标跟踪，适用于合作伙伴、白标经销商和租户。
Mewayz-原始模块 — 没有 Mewayz 上游。文档由包源编写，位于
packages/mewayz/GrowthKit/。
简介
GrowthKit 转变了抽象问题“我如何发展我的 Mewayz 业务？”到具体的每日清单中。注册时，运营商运行一次性 向导 捕获他们的收入目标、货币、观众笔记、外展渠道和每周活动目标。 GrowthKit 从这些答案中选择正确的 剧本 对于运营商当前的收入阶段——从“空白”（尚无线索）一直到“运营”（可持续收入）。
每一天， 今天 查看操作员应采取的接下来三个操作。当他们标记步骤完成时，GrowthKit 会推进他们的进度并（最终）将他们升级到下一阶段的剧本。内置一个 管道 视图通过状态（新→联系→演示→提案→赢得/失去）跟踪销售线索，以便运营商的销售活动提供相同的仪表板。
如何启用该模块
GrowthKit 发货 永远在线 对于任何已安装该软件包的租户。附加组件内没有“GrowthKit附加组件”切换开关；该模块由专用门控 growthkit 中间件仅检查操作员是否已完成向导。
要在标志范围内启用 GrowthKit 功能，请设置 .env:
GROWTHKIT_ENABLED=true
GROWTHKIT_CURRENCY=USD
功能标志打开后， 成长 显示在每个经过身份验证的操作员的侧栏中。
向导（首次运行设置）
当操作员第一次访问时 /grow，GrowthKit检测到他们没有 seller_goals 行并将其重定向到向导 /grow/wizard。
向导捕获：
- 目标收入 — 您想要达到的数字（例如 5,000）
- 目标货币 — 默认为
GROWTHKIT_CURRENCY环境值 - 目标日期 — 当你想击中它时
- 基线收入 — 您今天在哪里（默认为 0）
- 每周行动目标 — 您每周有多少次成长行动
- 观众备注 — 关于您销售对象的简短自由文本描述
- 渠道 — 多项选择：电子邮件、whatsapp、linkedin、
提交（默认 5）
至（例如“欧盟的小型牙科诊所”）
电话、亲自
点击 保存目标 更新插入 seller_goals 行（每个卖家一个 - 重新提交向导会更新现有目标，而不是创建重复目标）。
今日视图 — 每日剧本
- 导航至 成长 → 今天 （或者只是
/grow）。 - 该页面分为三个部分：
- 活动剧本标题 — 显示剧本名称，您的
- 接下来 3 个步骤 — 您拥有的三个最高优先级步骤
- 关键绩效指标卡 — 管道计数，本期演示，已关闭
当前阶段和圆形进度条（已完成步骤的百分比）。
尚未标记为完成。每个步骤都有标题、正文、可选模板/链接和 标记完成 按钮。
交易，已实现的收入。数字来自 seller_leads 和钱包分类帐。
- 点击 标记完成 发帖至
/grow/step/done随着步骤
ID;页面前进到下一批。
管道视图 — Lead CRM
- 导航至 成长 → 管道 （
/grow/pipeline）。 - 该列表显示您添加的每条潜在客户：姓名、公司、
- 点击 + 新线索 添加一行。必填：姓名+身份。
电子邮件、电话、状态、估计值和下一个跟进日期。
可选：公司、电子邮件、电话、来源、估计值、下一步跟进、自由格式注释。
潜在客户状态
GrowthKit 提供以下状态：
- 新的 ——刚刚补充；还没有联系
- 接触过 — 至少伸出过一次手
- 演示 — 预定或交付的演示
- 提案 — 已发送提案
- 赢了 — 关闭；
closed_at和closed_value是自动盖章的 - 迷失了 — 封闭-丢失
编辑线索
- 单击任意行可打开编辑抽屉。
- 正在将状态更新为
won自动标记closed_at和 - 的
next_followup_at字段是驱动“后续”的因素
closed_value 字段。 （首先设置该值 - 系统将其读取为已实现收入。）
今日视图的 KPI 部分中的提醒。
计划层级限制
GrowthKit 强制执行 免费铅帽 10 条线索通过 config('growthkit.plan_gates.pipeline_max_free')。付费计划的运营商没有上限。
达到上限后，“创建潜在客户”表单上会返回 422，并带有明确的“升级您的计划以添加更多潜在客户”消息。
剧本（如何挑选）
剧本住在 playbooks 表，其中包含步骤 playbook_steps。每个剧本都标记有：
seller_type— 合作伙伴、经销商或租户stage— 空白、勘探、首次销售、扩展、运营
默认播种者 (TenantPlaybookSeeder）发布了五本租户阶段的剧本。的 AdapterResolver 读取操作员的 seller_type （来自他们的帐户）和当前阶段（根据他们之前的剧本的进度计算）并选择正确的一个。
运营商目前不手动切换剧本——GrowthKit 自动分级它们。要强制使用不同的剧本，管理员可以删除操作员的 seller_step_progress 直接通过数据库行。
数据库表
该包添加了五个表：
playbooks— Playbook 定义（slug、seller_type、stage、playbook_steps- 每个剧本的有序步骤（slug、标题、正文、seller_step_progress— 跟踪每个操作员的步数seller_leads— 潜在客户管道行（每个潜在客户一个，范围为seller_goals— 每个卖家一行；捕获的目标
名称、目标天数等）
种类，可选有效负载）
标记为完成
卖家）
向导
权限
GrowthKit 使用所有权过滤器而不是 Spatie 权限 - 控制器强制操作员只能查看和编辑自己的步骤 + 线索。如果用户尝试将不属于其活动剧本的步骤标记为已完成，则会引发 403。
操作员注意事项
- 向导运行 每个卖家一次。重新提交更新
- 当舞台剧本完成后，操作员就毕业了；
- 向导中的通道选择存储为 JSON 数组
- 生长套件是 永远在线 当设置 env 标志时 - 否
现有行。
没有手动“转到下一个剧本”按钮。
seller_goals.channels 供下游推动和提醒使用。
每租户附加组件激活。