Business Model — BoostEcom

Statut d'implémentation (2026-10-02). Ce document décrit un modèle cible, pas ce que la plateforme fait. Ce que le code fait aujourd'hui : frais marketplace vendeur 3 % (BOOSTECOM_MARKETPLACE_FEE_RATE, src/types/marketplace.ts), parrainage 30 % sur 12 factures versé en argent sans minimum (affiliate.md), boutiques illimitées sur les plans payants (ADR 0037), add-on boutique retiré. Non implémentés : take rate marketplace 25 %, split agents/workflows 80/20, bounty 70/30, cash-out 75 $ et minimum vendeur 50 $, Partner tier 35 % sur 6 mois, commission sur achats de crédits (10 % ou 15 %), remise de 10 % sur le premier mois d'un filleul. Les lignes concernées ci-dessous sont marquées « non implémenté » ou « historique ».

Source de vérité du modèle économique de la plateforme. Toute évolution se fait via PR sur ces fichiers, jamais en mémoire.

Version : v4.1 Dernière mise à jour : 2026-10-02 (Free = MCP sans essai ni crédit, trimestriel supprimé, parrainage en mois + seuil 50 $, sponsor en USD) Statut : Validé pour lancement Vision : Devenir le n°1 mondial des AI Teams pour Shopify e-commerce

Philosophie en une phrase

Modèle credits-only v0-style adapté B2B Shopify. Billing per-Org (1 sub Stripe = 1 Org), credits inclus en montant FIXE par palier — découplé du prix de l'abonnement depuis v4.0 — daily bonus per-Org sur tous paid plans, naming Claude-like (Pro / Max 5x / Max 20x) où le multiplicateur = nombre de stores inclus. Free = MCP relay vers Claude perso de l'user (zéro coût AI pour BoostEcom).

BoostEcom est une plateforme hybride (subscription + credits usage-based + marketplace + écosystème) avec ~68% de marge brute consolidée et ~34% de marge nette nette atteignables à maturité. Ces deux chiffres sont repris de financial-model.md, qui les calcule ; ils y ont été révisés le 2026-09-06 (markup d'achat, ADR 0010) puis à nouveau le 2026-09-06 (repricing, ADR 0012).

Architecture billing

1 User profile (auth NextAuth)
  └─ N Orgs (entité business — Stripe customer, peut être revendue/transférée plus tard)
      ├─ 1 Subscription Stripe (facture séparée, VAT propre)
      ├─ Credits pool (isolé par Org, pas de cross-org transfer)
      ├─ Daily bonus per-Org (calibré par plan : Pro $1, Max 5x $3, Max 20x $5)
      └─ N Stores (inclus par palier : Free 1, Pro 3, Max 5x 10, Max 20x 25, Custom négocié)
          └─ N Users (illimités sur les plans payants, 1 sur Free)

Carte des flux

                    ┌──────────────────────────────┐
                    │     BoostEcom Platform       │
                    └──────────────┬───────────────┘
                                   │
       ┌───────────────────────────┼────────────────────────────┐
       │                           │                            │
   ENTRANTS                  CIRCULATION                    SORTANTS
   (revenue)                 (commissions)                  (rewards)
       │                           │                            │
  Subscriptions             Marketplace 3% (vendeur)       Affiliate payouts
  (Pro/Max5x/Max20x)        Agent runs (non impl.)        Marketplace payouts (M9+)
  Credit purchases (1:1)    Workflow runs (non impl.)     Bounty payments (non impl.)
  (add-on store retiré, ADR 0039)     Featured listings            Partner deals
  Custom plans              Premium support              Daily bonus credits
  Marketplace M0-M9 100%    Sponsored (M12+)

Index des documents

TL;DR — décisions clés v4.0

Marges cibles (validées)

À $300k MRR : ~$101k/mo net après IS. Capacité hire 4-5 personnes + marketing $30k/mo + saving $50k/mo.

Ce tableau annonçait ~72% / ~55% / ~42% et « ~$125k/mo net », des chiffres qu'aucune ligne de financial-model.md ne produisait, même avant la correction du markup. Ils sont désormais repris de ses projections, pas ré-estimés ici.

Note v3.0 (historique) : marges légèrement compressées vs v2.0 (-2pp) en raison de :

• Credits 100% inclus (vs 50% v2.0) absorbe plus de coût AI
• Daily bonus per-Org sur tous paid plans (incl. Pro $1)
• Ecosystem ajusté creator-friendly (cible, non implémentée : M9+ 25%, runs 80/20)

Tradeoff assumé : marge compressée pour UX v0-style + écosystème dynamique.

Note v4.0 : le repricing (ADR 0012) découple le prix du grant de credits (grant inchangé, prix monté) et récupère la majorité de la compression v3.0 sans revenir sur aucune décision UX ci-dessus : +6pp gross, +5pp net net, sur le même mix et la même consommation.

Règles de mise à jour

1. Toute modification = PR. Jamais d'édit direct sur main.
2. Toute décision critique (pricing, take rates, commission %) doit être tracée dans la table TL;DR de ce README et dans le doc concerné.
3. Versioning sémantique :
   • Major (v2.0 → v3.0) : changement de modèle (ex : suppression caps msg, architecture billing)
   • Minor (v3.1) : ajout d'une feature (ex : marketplace activation, daily bonus calibration)
   • Patch (v3.0.1) : correction de marge, ajustement de %
4. Bumper la version + date en haut de ce README à chaque PR.
5. Aucune décision pricing ne s'applique rétroactivement : grandfather les users existants quand on change le pricing.

Liens code

Décisions architecturales (ADR)

• 2026-05-04 — v1.0 : Slider unique vs tiers fixes, take rate marketplace 25%, suppression daily bonus permanent
• 2026-05-04 — v1.1 : Ajout opex-and-taxes.md (équipe, marketing, leviers 80%+, optim fiscale JEI/CIR)
• 2026-05-04 — v2.0 : PIVOT 3 tiers Claude-like (Pro $49 / Max 5x $149 / Max 20x $299) avec 50% credits inclus + caps usage par session. Marge nette nette passe de 5-15% à 30-45%
• 2026-05-04 — v2.1 : Ajout model-curation.md et risks-and-fortifications.md. Position assumée : curated, pas vendor-agnostic
• 2026-05-12 — v3.0 — PIVOT V0-STYLE B2B :
  • Architecture billing per-Org confirmée (1 User → N Orgs, 1 sub Stripe per Org, users illimités, team RBAC hors scope)
  • Suppression caps msg/5h et Opus/jour (remplacés par pre-stream + mid-stream guards déjà existants)
  • Credits inclus 50% → 100% (style v0, lisible "$X = $X credits")
  • Daily bonus per-Org activé sur tous paid plans : Pro $1/jour, Max 5x $3/jour, Max 20x $5/jour
  • Stores per tier alignés au naming : Pro 1 / Max 5x 5 / Max 20x 20
  • Stores extras $9/store/mo (Shopify-aligned, baissé vs $19 v2.0)
  • Workflows concurrents = stores inclus (pas d'extras séparés)
  • Free MCP relay tightened : 50/min, 2k/jour (vs 100/min v2.0) pour push upgrade
  • Slider achat $10-$5000 step $1 (vs $25 v2.0)
  • Rollover 65 jours sur subscription credits (vs zero rollover v2.0)
  • Ecosystem ajusté creator-friendly : marketplace M9+ 25% (vs 30%), affiliate credits 10% (vs 15%), agent runs 80/20 (vs 75/25) : historique, non implémenté
  • BYOK retiré (illégal/risqué — Free MCP relay couvre l'usage power user avec Claude perso)
  • Orchestrator rename : @Atlas → @Atlas
  • Marges compressées (~62% gross / ~30% net vs 74%/45% v2.0) : tradeoff assumé pour UX moderne + écosystème dynamique, dont ~4pp qui n'étaient pas un tradeoff mais une erreur de modèle (markup d'achat 2.0× jamais appliqué, corrigé le 2026-09-06)
• 2026-09-06 — v4.0 — REPRICING : prix découplé des credits (ADR 0012) :
  • Prix de l'abonnement monté : Pro $49→$79, Max 5x $149→$199, Max 20x $299→$399
  • Grant de credits inchangé : $49 / $149 / $299 — même montant, même rollover, même ordre de consommation
  • Raison : v3.0 rendait 100% du prix en credits, donc zéro marge fixe sur la subscription ; benchmark concurrentiel (un outil spy mono-feature du marché à $89/mo en Pro) montrait aussi un sous-pricing face à un opérateur IA complet
  • Marges récupérées : ~62% gross / ~30% net → ~68% gross / ~34% net, sans changement de mix ni de consommation
  • Aucun impact sur un abonné existant : même grant, même balance, pas de migration