Files
hub/docs/PLANS_AND_PRICING.md
kelly 7954804998 feat: add Brand Portal navigation, usage billing, and orchestrator improvements
Brand Portal:
- Add dedicated brand-portal-sidebar component with restricted navigation
- Add brand-portal-app layout for Brand Manager users
- Update all brand-portal views to use new restricted layout
- Add EnsureBrandManagerAccess middleware

Usage-Based Billing:
- Add usage_metrics, plan_usage_metrics, business_usage_counters tables
- Add UsageMetric, PlanUsageMetric, BusinessUsageCounter models
- Add UsageDashboard Filament page
- Add PlanUsageSeeder, UsageMetricsSeeder, SampleUsageDataSeeder

Orchestrator Enhancements:
- Add orchestrator_runs table for batch tracking
- Add OrchestratorRun model
- Add OrchestratorCrossBrandService for multi-brand campaigns
- Add orchestrator marketing config, message variants, playbook seeders

Promotions:
- Add promo tracking fields to orders
- Add key_selling_points to brands
- Add PromotionRecommendationEngine service
- Add InBrandPromoHelper, CrossBrandPromoHelper
- Add BuyerPromoIntelligence service
- Add promotion-templates config

Documentation:
- Add BRAND_MANAGER_SUITE.md
- Add USAGE_BASED_BILLING.md
- Add PLANS_AND_PRICING.md
- Add SALES_ORCHESTRATOR.md and related docs

Tests:
- Add BrandDashboardTest, BrandProfileAccessTest
- Add BrandSelectorTest, ProductPreviewTest
- Add OrchestratorBrandIntegrationTest
2025-12-01 14:24:47 -07:00

2.8 KiB

Plans & Pricing

Overview

Our platform uses a usage-based billing model where plans define:

  1. Base monthly price
  2. Included brands (sales-enabled brands in base price)
  3. Included usage per metric (menus, conversations, etc.)
  4. Overage pricing (per-unit cost for exceeding included)

Important: Plans are NOT hard caps. They define what's INCLUDED in the price. Businesses can exceed included amounts (tracked for billing, not blocked).

Current Plans

Starter - $199/month

For small teams and early-stage brands.

Metric Included
Brands 1
Menus Sent 100/month
Conversations 250/month
Active Promos 10
Contacts 500
Buyers 50
AI Actions 500/month
Campaigns 5/month
Products 100

Growth - $499/month

For growing operations managing multiple brands.

Metric Included
Brands 3
Menus Sent 500/month
Conversations 1,000/month
Active Promos 25
Contacts 2,000
Buyers 200
AI Actions 5,000/month
Campaigns 25/month
Products 500

Scale - Contact Sales

For MSOs and large operators with advanced needs.

Metric Included
Brands 10+
Menus Sent 2,000/month
Conversations 5,000/month
Active Promos 100
Contacts 10,000
Buyers 1,000
AI Actions 25,000/month
Campaigns 100/month
Products 2,000

Enterprise

Custom pricing with unlimited usage.

  • All metrics are unlimited
  • Usage is still tracked for analytics
  • No overage billing
  • Custom SLA and support

Admin Management

Plans are managed in the admin panel at /admin/plans:

  1. Create/Edit Plans: Set name, code, pricing, included brands
  2. Usage Metrics Tab: Define included amounts and overage pricing per metric
  3. Enterprise Toggle: Mark as enterprise for unlimited usage

How It Works

  1. Business is assigned to a Plan
  2. Business uses features (sends menus, creates conversations, etc.)
  3. Usage is tracked in business_usage_counters table
  4. Admin can view usage at /admin/usage
  5. Overages can be billed (manual or automated)

Key Principles

  • No hard blocks: Users are never prevented from taking actions due to plan limits
  • Soft warnings: UI can warn when approaching limits (advisory only)
  • Usage tracking: All usage is tracked regardless of plan
  • Enterprise override: Business-level flag can override plan limits

Configuration

Plans are stored in the database and managed via Filament admin panel.

Legacy configuration in config/plans.php is for reference only. The database is the source of truth.

See Also