@fayz-ai/plugin-courses 0.2.2 → 0.2.4

package/src/connectors/stripe.ts

@@ -0,0 +1,34 @@
+import type { ConnectorDefinition } from '@fayz-ai/core'
+import { getCoursesProvider } from '@fayz-ai/courses'
+
+// Stripe Connect modeled as a connector so it surfaces in the plugin's unified
+// "Integrations" settings tab (same pattern as Financial Settings → Integrações),
+// instead of a bespoke block in the General tab. The host plugin is 'courses'.
+export function createStripeConnector(): ConnectorDefinition {
+  return {
+    id: 'stripe-connect',
+    hostPluginId: 'courses',
+    name: 'Stripe',
+    description: 'Receba os pagamentos dos alunos; a taxa da plataforma é aplicada automaticamente.',
+    icon: 'CreditCard',
+    authKind: 'oauth',
+    async getStatus() {
+      try {
+        const account = await getCoursesProvider().getCreatorAccount()
+        const fee = (account.platformFeeBps / 100).toFixed(2)
+        return {
+          connected: !!account.stripeAccountId && account.chargesEnabled,
+          detail: `Taxa da plataforma: ${fee}%`,
+        }
+      } catch {
+        return { connected: false }
+      }
+    },
+    async startOAuth(_redirectTo?: string): Promise<string> {
+      // Stage 3 wires this to the `courses-connect-onboard` edge function and
+      // returns the Stripe account-link URL to redirect to. Until then, surface
+      // a clear message (ConnectorsHub toasts a thrown error's message).
+      throw new Error('O onboarding do Stripe Connect é ligado na Etapa 3.')
+    },
+  }
+}

package/src/dashboardWidgets.tsx

@@ -0,0 +1,51 @@
+import * as React from 'react'
+import type { DashboardWidgetDef } from '@fayz-ai/core'
+import { useTranslation } from '@fayz-ai/core'
+import { KpiCard, defineKpiWidget } from '@fayz-ai/ui'
+import { getCoursesProvider, type FinancialSummary } from '@fayz-ai/courses'
+import { formatMoney, formatPercent } from './lib/format'
+
+// Course KPIs contributed to the central admin Dashboard (rendered by
+// @fayz-ai/plugin-dashboard's DashboardCanvas, which auto-collects every
+// plugin's dashboardWidgets for surface 'home'). Mirrors Kiwify's dashboard.
+
+function useSummary(): FinancialSummary | null {
+  const [summary, setSummary] = React.useState<FinancialSummary | null>(null)
+  React.useEffect(() => {
+    void getCoursesProvider().getFinancialSummary().then(setSummary)
+  }, [])
+  return summary
+}
+
+function RevenueKpi() {
+  const t = useTranslation()
+  const s = useSummary()
+  return <KpiCard label={t('courses.kpi.revenue') || 'Total revenue'} icon="DollarSign" loading={!s} value={s ? formatMoney(s.totalRevenue, s.currency) : undefined} />
+}
+
+function SalesKpi() {
+  const t = useTranslation()
+  const s = useSummary()
+  return <KpiCard label={t('courses.kpi.sales') || 'Sales'} icon="TrendingUp" loading={!s} value={s ? String(s.salesCount) : undefined} sub={s ? formatPercent(s.refundRate, 1) + ' ' + (t('courses.kpi.refunds') || 'refunds') : undefined} />
+}
+
+function MrrKpi() {
+  const t = useTranslation()
+  const s = useSummary()
+  return <KpiCard label={t('courses.kpi.mrr') || 'MRR'} icon="Repeat" loading={!s} value={s ? formatMoney(s.mrr, s.currency) : undefined} sub={s ? `${s.activeSubscriptions} ${t('courses.kpi.activeSubs') || 'active'}` : undefined} />
+}
+
+function FeesKpi() {
+  const t = useTranslation()
+  const s = useSummary()
+  return <KpiCard label={t('courses.kpi.fees') || 'Platform fees'} icon="Percent" loading={!s} value={s ? formatMoney(s.platformFeeTotal, s.currency) : undefined} />
+}
+
+export function createCoursesDashboardWidgets(): DashboardWidgetDef[] {
+  return [
+    defineKpiWidget({ id: 'courses.kpi.revenue', title: 'courses.kpi.revenue', domain: 'courses', defaultOrder: 0, component: RevenueKpi }),
+    defineKpiWidget({ id: 'courses.kpi.sales', title: 'courses.kpi.sales', domain: 'courses', defaultOrder: 1, component: SalesKpi }),
+    defineKpiWidget({ id: 'courses.kpi.mrr', title: 'courses.kpi.mrr', domain: 'courses', defaultOrder: 2, component: MrrKpi }),
+    defineKpiWidget({ id: 'courses.kpi.fees', title: 'courses.kpi.fees', domain: 'courses', defaultOrder: 3, component: FeesKpi }),
+  ]
+}

package/src/index.ts

@@ -5,15 +5,28 @@ import {
   getCoursesProviderOptional,
   setCoursesProvider,
   createMockCoursesProvider,
+  setCoursesTenantResolver,
 } from '@fayz-ai/courses'
+import { useOrganizationStore } from '@fayz-ai/saas'
 import { coursesLocales } from './locales'
 import { CoursesListPage } from './pages/CoursesListPage'
 import { CourseEditorPage } from './pages/CourseEditorPage'
+import { SalesPage } from './pages/SalesPage'
+import { SubscriptionsPage } from './pages/SubscriptionsPage'
+import { FinancialPage } from './pages/FinancialPage'
+import { ReportsPage } from './pages/ReportsPage'
+import { MembersAreaPage } from './pages/MembersAreaPage'
+import { CoursesSettingsTab } from './settings/CoursesSettings'
+import { createCoursesDashboardWidgets } from './dashboardWidgets'
+import { createStripeConnector } from './connectors/stripe'
 
 // ---------------------------------------------------------------------------
-// @fayz-ai/plugin-courses — admin management for the courses domain. Mirrors
-// @fayz-ai/plugin-shop: a navigation entry + routes pointing at custom admin pages
-// built directly on @fayz-ai/courses. Native from day one (no saas-core imports).
+// @fayz-ai/plugin-courses — admin management for the courses domain. This is a
+// PLUGIN, not an app: it only contributes nav + routes + settings + dashboard
+// widgets to the @fayz-ai/saas admin scaffold. Login, auth, permissions, the
+// sidebar/AppShell chrome and layout all come from @fayz-ai/saas — the plugin
+// never rebuilds them. Its screens render inside the saas AdminShell and use
+// @fayz-ai/ui primitives.
 // ---------------------------------------------------------------------------
 
 export interface CoursesPluginOptions {
@@ -24,16 +37,26 @@ export interface CoursesPluginOptions {
   verticalId?: VerticalId
 }
 
+const asComp = (c: unknown) => c as React.ComponentType<unknown>
+const read = (feature: string) => ({ feature, action: 'read' as const })
+
 export function createCoursesPlugin(options?: CoursesPluginOptions): PluginManifest {
   // Register locales globally so keys resolve even before the I18nProvider mounts.
   registerTranslations(coursesLocales)
 
+  // Scope Supabase queries to the active organization (the creator/tenant). The
+  // mock provider ignores this; the Supabase provider appends .eq('tenant_id').
+  setCoursesTenantResolver(() => useOrganizationStore.getState().currentOrg?.id)
+
   // Defensive default: if the host app didn't set a provider, fall back to a
   // mock so the admin still renders. Apps that share admin↔member set their own.
   if (!getCoursesProviderOptional()) {
     setCoursesProvider(createMockCoursesProvider())
   }
 
+  const base = options?.navPosition ?? 1
+  const section = options?.navSection ?? 'main'
+
   return {
     id: 'courses',
     name: options?.navLabel ?? 'Courses',
@@ -43,20 +66,36 @@ export function createCoursesPlugin(options?: CoursesPluginOptions): PluginManif
     verticalId: options?.verticalId,
     defaultEnabled: true,
     dependencies: [],
+    declaredFeatures: [
+      { id: 'courses', label: 'Courses', group: 'Courses' },
+      { id: 'courses.sales', label: 'Sales', group: 'Courses' },
+      { id: 'courses.finance', label: 'Financial', group: 'Courses' },
+    ],
     navigation: [
-      {
-        section: options?.navSection ?? 'main',
-        position: options?.navPosition ?? 1,
-        label: options?.navLabel ?? 'Courses',
-        route: '/courses',
-        icon: 'BookOpen',
-      },
+      { section, position: base, label: options?.navLabel ?? 'Courses', route: '/courses', icon: 'BookOpen', permission: read('courses') },
+      { section, position: base + 1, label: 'Members area', route: '/courses/members', icon: 'GraduationCap', permission: read('courses') },
+      { section, position: base + 2, label: 'Sales', route: '/courses/sales', icon: 'TrendingUp', permission: read('courses.sales') },
+      { section, position: base + 3, label: 'Subscriptions', route: '/courses/subscriptions', icon: 'Repeat', permission: read('courses.sales') },
+      { section, position: base + 4, label: 'Financial', route: '/courses/financial', icon: 'CreditCard', permission: read('courses.finance') },
+      { section, position: base + 5, label: 'Reports', route: '/courses/reports', icon: 'BarChart3', permission: read('courses.sales') },
     ],
     routes: [
-      { path: '/courses', component: CoursesListPage as React.ComponentType<unknown> },
-      { path: '/courses/:id', component: CourseEditorPage as React.ComponentType<unknown> },
+      // Static segments outscore the `:id` param in the saas router, so these
+      // resolve before the editor route (AdminShell sorts by routeScore).
+      { path: '/courses', component: asComp(CoursesListPage), permission: read('courses') },
+      { path: '/courses/members', component: asComp(MembersAreaPage), permission: read('courses') },
+      { path: '/courses/sales', component: asComp(SalesPage), permission: read('courses.sales') },
+      { path: '/courses/subscriptions', component: asComp(SubscriptionsPage), permission: read('courses.sales') },
+      { path: '/courses/financial', component: asComp(FinancialPage), permission: read('courses.finance') },
+      { path: '/courses/reports', component: asComp(ReportsPage), permission: read('courses.sales') },
+      { path: '/courses/:id', component: asComp(CourseEditorPage) },
     ],
     widgets: [],
+    dashboardWidgets: createCoursesDashboardWidgets(),
+    connectors: [createStripeConnector()],
+    settings: [
+      { id: 'courses', label: 'Courses', icon: 'BookOpen', component: asComp(CoursesSettingsTab), order: 20, permission: read('courses') },
+    ],
     locales: coursesLocales,
   }
 }

package/src/lib/format.ts

@@ -0,0 +1,22 @@
+// Small display helpers shared across the courses admin pages. Kept local so the
+// plugin depends only on @fayz-ai/core + @fayz-ai/ui + @fayz-ai/courses.
+
+export function formatMoney(value: number, currency = 'BRL'): string {
+  try {
+    return new Intl.NumberFormat('pt-BR', { style: 'currency', currency }).format(value)
+  } catch {
+    return `${currency} ${value.toFixed(2)}`
+  }
+}
+
+export function formatDate(iso: string): string {
+  try {
+    return new Intl.DateTimeFormat('pt-BR', { day: '2-digit', month: '2-digit', year: 'numeric' }).format(new Date(iso))
+  } catch {
+    return iso.slice(0, 10)
+  }
+}
+
+export function formatPercent(fraction: number, digits = 0): string {
+  return `${(fraction * 100).toFixed(digits)}%`
+}

package/src/locales/en.ts

@@ -30,4 +30,113 @@ export const en: Record<string, string> = {
   'courses.editor.untitledCourse': 'Untitled course',
   'courses.editor.untitledModule': 'New module',
   'courses.editor.untitledLesson': 'New lesson',
+  // Editor tabs
+  'courses.editor.tab.details': 'General',
+  'courses.editor.tab.curriculum': 'Curriculum',
+  'courses.editor.tab.offers': 'Offers',
+  'courses.editor.tab.members': 'Members area',
+  'courses.editor.tab.settings': 'Payment',
+  'courses.editor.tab.checkout': 'Checkout',
+  'courses.editor.tab.links': 'Links',
+  'courses.editor.membersHelp': 'Buyers of this course are added to its members area automatically. Access groups per offer:',
+  'courses.editor.defaultGroup': 'Default group',
+  'courses.editor.settingsHelp': 'Payment methods offered at checkout (Stripe).',
+  'courses.editor.payCard': 'Credit card (up to 12x)',
+  'courses.editor.payPix': 'Pix',
+  'courses.editor.payBoleto': 'Boleto',
+  'courses.editor.settingsNote': 'Method availability depends on Stripe in your region; wired in Stage 3.',
+  'courses.editor.checkoutSoon': 'Custom checkout builder comes in a later milestone. A default checkout is generated per offer.',
+  'courses.editor.linksHelp': 'Shareable checkout links, one per offer.',
+  // Offers
+  'courses.offers.help': 'Price points a customer can buy. Mark one default; order-bumps show on other checkouts.',
+  'courses.offers.name': 'Offer name',
+  'courses.offers.price': 'Price',
+  'courses.offers.oneTime': 'One-time',
+  'courses.offers.subscription': 'Subscription',
+  'courses.offers.default': 'Default',
+  'courses.offers.bump': 'Bump',
+  'courses.offers.remove': 'Remove',
+  'courses.offers.add': 'Add offer',
+  'courses.offers.newName': 'New offer',
+  // Sales
+  'courses.sales.title': 'Sales',
+  'courses.sales.subtitle': 'Every transaction across your courses.',
+  'courses.sales.date': 'Date',
+  'courses.sales.customer': 'Customer',
+  'courses.sales.method': 'Method',
+  'courses.sales.status': 'Status',
+  'courses.sales.fee': 'Platform fee',
+  'courses.sales.amount': 'Amount',
+  'courses.sales.count': 'Sales',
+  'courses.sales.revenue': 'Revenue',
+  'courses.sales.empty': 'No sales yet.',
+  'courses.financialStatus.paid': 'Paid',
+  'courses.financialStatus.pending': 'Pending',
+  'courses.financialStatus.refunded': 'Refunded',
+  'courses.financialStatus.chargeback': 'Chargeback',
+  // Subscriptions
+  'courses.subs.title': 'Subscriptions',
+  'courses.subs.subtitle': 'Recurring plans and MRR.',
+  'courses.subs.start': 'Start date',
+  'courses.subs.customer': 'Customer',
+  'courses.subs.status': 'Status',
+  'courses.subs.value': 'Net value',
+  'courses.subs.active': 'Active subscriptions',
+  'courses.subs.mrr': 'Monthly recurring revenue',
+  'courses.subs.empty': 'No subscriptions yet.',
+  'courses.subStatus.active': 'Active',
+  'courses.subStatus.canceled': 'Canceled',
+  'courses.subStatus.past_due': 'Past due',
+  'courses.interval.month': 'month',
+  'courses.interval.year': 'year',
+  // Financial
+  'courses.financial.title': 'Financial settings',
+  'courses.financial.subtitle': 'Balance, payouts and your Stripe connection.',
+  'courses.financial.available': 'Available balance',
+  'courses.financial.pending': 'Pending balance',
+  'courses.financial.revenue': 'Total revenue',
+  'courses.financial.feeCollected': 'Platform fees',
+  'courses.financial.refundRate': 'refund rate',
+  'courses.financial.payouts': 'Payouts',
+  'courses.financial.noPayouts': 'No payouts yet.',
+  'courses.financial.date': 'Date',
+  'courses.financial.amount': 'Amount',
+  'courses.financial.status': 'Status',
+  'courses.financial.connect': 'Connect Stripe',
+  'courses.financial.connected': 'Stripe connected',
+  'courses.financial.notConnected': 'Connect your Stripe account to receive payouts. The platform fee is applied automatically on each sale.',
+  'courses.financial.platformFee': 'Platform fee',
+  'courses.financial.connectSoon': 'Stripe Connect onboarding wires up in Stage 3.',
+  'courses.payoutStatus.paid': 'Paid',
+  'courses.payoutStatus.pending': 'Pending',
+  'courses.payoutStatus.failed': 'Failed',
+  // Reports
+  'courses.reports.title': 'Reports',
+  'courses.reports.subtitle': 'Revenue by course.',
+  'courses.reports.byCourse': 'Revenue by course',
+  'courses.reports.course': 'Course',
+  'courses.reports.sales': 'Sales',
+  'courses.reports.revenue': 'Revenue',
+  'courses.reports.empty': 'No revenue yet.',
+  // Members area
+  'courses.membersArea.title': 'Members area',
+  'courses.membersArea.subtitle': 'One area per course; students land here after purchase.',
+  'courses.membersArea.name': 'Members area',
+  'courses.membersArea.status': 'Status',
+  'courses.membersArea.students': 'Students',
+  'courses.membersArea.empty': 'No members areas yet.',
+  // Settings
+  'courses.settings.title': 'Course settings',
+  'courses.settings.subtitle': 'Payments, currency and checkout methods',
+  'courses.settings.payments': 'Payments',
+  'courses.settings.paymentsHelp': 'Connect Stripe in the Integrations tab; the platform fee applies automatically.',
+  'courses.settings.currency': 'Default currency',
+  'courses.settings.methods': 'Payment methods',
+  // Dashboard KPIs
+  'courses.kpi.revenue': 'Total revenue',
+  'courses.kpi.sales': 'Sales',
+  'courses.kpi.refunds': 'refunds',
+  'courses.kpi.mrr': 'Recurring revenue (MRR)',
+  'courses.kpi.activeSubs': 'active',
+  'courses.kpi.fees': 'Platform fees',
 }

package/src/locales/pt-BR.ts

@@ -30,4 +30,113 @@ export const ptBR: Record<string, string> = {
   'courses.editor.untitledCourse': 'Curso sem título',
   'courses.editor.untitledModule': 'Novo módulo',
   'courses.editor.untitledLesson': 'Nova aula',
+  // Editor tabs
+  'courses.editor.tab.details': 'Geral',
+  'courses.editor.tab.curriculum': 'Conteúdo',
+  'courses.editor.tab.offers': 'Ofertas',
+  'courses.editor.tab.members': 'Área de membros',
+  'courses.editor.tab.settings': 'Pagamento',
+  'courses.editor.tab.checkout': 'Checkout',
+  'courses.editor.tab.links': 'Links',
+  'courses.editor.membersHelp': 'Quem compra este curso entra automaticamente na área de membros. Grupos de acesso por oferta:',
+  'courses.editor.defaultGroup': 'Grupo padrão',
+  'courses.editor.settingsHelp': 'Métodos de pagamento no checkout (Stripe).',
+  'courses.editor.payCard': 'Cartão de crédito (até 12x)',
+  'courses.editor.payPix': 'Pix',
+  'courses.editor.payBoleto': 'Boleto',
+  'courses.editor.settingsNote': 'A disponibilidade de cada método depende do Stripe na sua região; ligado na Etapa 3.',
+  'courses.editor.checkoutSoon': 'O construtor de checkout chega numa etapa futura. Um checkout padrão é gerado por oferta.',
+  'courses.editor.linksHelp': 'Links de checkout compartilháveis, um por oferta.',
+  // Offers
+  'courses.offers.help': 'Preços que o cliente pode comprar. Marque um padrão; order-bumps aparecem nos checkouts das outras.',
+  'courses.offers.name': 'Nome da oferta',
+  'courses.offers.price': 'Preço',
+  'courses.offers.oneTime': 'Único',
+  'courses.offers.subscription': 'Assinatura',
+  'courses.offers.default': 'Padrão',
+  'courses.offers.bump': 'Bump',
+  'courses.offers.remove': 'Remover',
+  'courses.offers.add': 'Adicionar oferta',
+  'courses.offers.newName': 'Nova oferta',
+  // Sales
+  'courses.sales.title': 'Vendas',
+  'courses.sales.subtitle': 'Todas as transações dos seus cursos.',
+  'courses.sales.date': 'Data',
+  'courses.sales.customer': 'Cliente',
+  'courses.sales.method': 'Método',
+  'courses.sales.status': 'Status',
+  'courses.sales.fee': 'Taxa da plataforma',
+  'courses.sales.amount': 'Valor',
+  'courses.sales.count': 'Vendas',
+  'courses.sales.revenue': 'Receita',
+  'courses.sales.empty': 'Nenhuma venda ainda.',
+  'courses.financialStatus.paid': 'Pago',
+  'courses.financialStatus.pending': 'Pendente',
+  'courses.financialStatus.refunded': 'Reembolsado',
+  'courses.financialStatus.chargeback': 'Chargeback',
+  // Subscriptions
+  'courses.subs.title': 'Assinaturas',
+  'courses.subs.subtitle': 'Planos recorrentes e MRR.',
+  'courses.subs.start': 'Início',
+  'courses.subs.customer': 'Cliente',
+  'courses.subs.status': 'Status',
+  'courses.subs.value': 'Valor líquido',
+  'courses.subs.active': 'Assinaturas ativas',
+  'courses.subs.mrr': 'Receita recorrente mensal',
+  'courses.subs.empty': 'Nenhuma assinatura ainda.',
+  'courses.subStatus.active': 'Ativa',
+  'courses.subStatus.canceled': 'Cancelada',
+  'courses.subStatus.past_due': 'Em atraso',
+  'courses.interval.month': 'mês',
+  'courses.interval.year': 'ano',
+  // Financial
+  'courses.financial.title': 'Financeiro',
+  'courses.financial.subtitle': 'Saldo, saques e sua conexão com o Stripe.',
+  'courses.financial.available': 'Saldo disponível',
+  'courses.financial.pending': 'Saldo pendente',
+  'courses.financial.revenue': 'Receita total',
+  'courses.financial.feeCollected': 'Taxas da plataforma',
+  'courses.financial.refundRate': 'taxa de reembolso',
+  'courses.financial.payouts': 'Saques',
+  'courses.financial.noPayouts': 'Nenhum saque ainda.',
+  'courses.financial.date': 'Data',
+  'courses.financial.amount': 'Valor',
+  'courses.financial.status': 'Status',
+  'courses.financial.connect': 'Conectar Stripe',
+  'courses.financial.connected': 'Stripe conectado',
+  'courses.financial.notConnected': 'Conecte sua conta Stripe para receber os saques. A taxa da plataforma é aplicada automaticamente em cada venda.',
+  'courses.financial.platformFee': 'Taxa da plataforma',
+  'courses.financial.connectSoon': 'O onboarding do Stripe Connect é ligado na Etapa 3.',
+  'courses.payoutStatus.paid': 'Concluído',
+  'courses.payoutStatus.pending': 'Pendente',
+  'courses.payoutStatus.failed': 'Falhou',
+  // Reports
+  'courses.reports.title': 'Relatórios',
+  'courses.reports.subtitle': 'Receita por curso.',
+  'courses.reports.byCourse': 'Receita por curso',
+  'courses.reports.course': 'Curso',
+  'courses.reports.sales': 'Vendas',
+  'courses.reports.revenue': 'Receita',
+  'courses.reports.empty': 'Nenhuma receita ainda.',
+  // Members area
+  'courses.membersArea.title': 'Área de membros',
+  'courses.membersArea.subtitle': 'Uma área por curso; o aluno entra após a compra.',
+  'courses.membersArea.name': 'Área de membros',
+  'courses.membersArea.status': 'Status',
+  'courses.membersArea.students': 'Alunos',
+  'courses.membersArea.empty': 'Nenhuma área de membros ainda.',
+  // Settings
+  'courses.settings.title': 'Configurações do curso',
+  'courses.settings.subtitle': 'Pagamentos, moeda e métodos de checkout',
+  'courses.settings.payments': 'Pagamentos',
+  'courses.settings.paymentsHelp': 'Conecte o Stripe na aba Integrações; a taxa da plataforma é aplicada automaticamente.',
+  'courses.settings.currency': 'Moeda padrão',
+  'courses.settings.methods': 'Métodos de pagamento',
+  // Dashboard KPIs
+  'courses.kpi.revenue': 'Receita total',
+  'courses.kpi.sales': 'Vendas',
+  'courses.kpi.refunds': 'reembolsos',
+  'courses.kpi.mrr': 'Receita recorrente (MRR)',
+  'courses.kpi.activeSubs': 'ativas',
+  'courses.kpi.fees': 'Taxas da plataforma',
 }