feat(payments): money-viewing flow for students, admins & super-admin

Wire the standard "view it" surfaces now that multi-provider checkout works:

- Student billing hub (/dashboard/student/billing): all-provider purchase
  receipts from transactions, active subscription (read-only), and offline
  invoice downloads from payment_requests.
- Admin payouts (/dashboard/admin/payouts) and invoices
  (/dashboard/admin/invoices) registry pages.
- Super-admin revenue dashboard (/platform/revenue): platform fees earned,
  GMV, SaaS MRR, and by-provider / by-school / monthly breakdowns, backed by
  a new cross-tenant get_platform_revenue() RPC whose fee math mirrors the
  school revenue view so the numbers reconcile.
- Checkout success page (/checkout/success) with plan-vs-product CTAs;
  repoint the three success redirects in checkout-form to it.
- Sidebar nav entries + en/es i18n.

Receipts are backed by transactions + payment_requests (the invoices table
is schema-only). The RPC migration is local-only, consistent with the rest
of this branch.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

Author: guillermoscript

app/[locale]/(public)/checkout/success/page.tsx

@@ -0,0 +1,57 @@
+'use client';
+
+import { Suspense } from 'react';
+import Link from 'next/link';
+import { useSearchParams } from 'next/navigation';
+import { useTranslations } from 'next-intl';
+import { IconCircleCheckFilled } from '@tabler/icons-react';
+import { Button } from '@/components/ui/button';
+import { Card, CardContent } from '@/components/ui/card';
+
+function CheckoutSuccessInner() {
+    const searchParams = useSearchParams();
+    const t = useTranslations('checkout.success');
+
+    const type = searchParams.get('type') ?? 'product';
+    const isPlan = type === 'plan';
+
+    const primaryHref = isPlan ? '/dashboard/student/browse' : '/dashboard/student/courses';
+    const primaryLabel = isPlan ? t('browseCourses') : t('goToCourses');
+
+    return (
+        <div className="flex min-h-[60vh] items-center justify-center px-4 py-16">
+            <Card className="w-full max-w-md border-border shadow-sm">
+                <CardContent className="flex flex-col items-center gap-6 px-8 py-10 text-center">
+                    {/* Icon */}
+                    <div className="flex h-16 w-16 items-center justify-center rounded-full bg-emerald-100 dark:bg-emerald-950">
+                        <IconCircleCheckFilled className="h-9 w-9 text-emerald-600 dark:text-emerald-400" />
+                    </div>
+
+                    {/* Copy */}
+                    <div className="space-y-2">
+                        <h1 className="text-xl font-semibold tracking-tight">{t('title')}</h1>
+                        <p className="text-sm leading-relaxed text-muted-foreground">{t('subtitle')}</p>
+                    </div>
+
+                    {/* CTAs */}
+                    <div className="flex w-full flex-col gap-3 pt-2">
+                        <Link href={primaryHref} className="w-full">
+                            <Button className="w-full">{primaryLabel}</Button>
+                        </Link>
+                        <Link href="/dashboard/student/billing" className="w-full">
+                            <Button variant="outline" className="w-full">{t('viewBilling')}</Button>
+                        </Link>
+                    </div>
+                </CardContent>
+            </Card>
+        </div>
+    );
+}
+
+export default function CheckoutSuccessPage() {
+    return (
+        <Suspense fallback={null}>
+            <CheckoutSuccessInner />
+        </Suspense>
+    );
+}

app/[locale]/dashboard/admin/invoices/page.tsx

@@ -0,0 +1,250 @@
+import { createAdminClient } from '@/lib/supabase/admin'
+import { redirect } from 'next/navigation'
+import { getTranslations } from 'next-intl/server'
+import { format } from 'date-fns'
+import { es, enUS } from 'date-fns/locale'
+import { getCurrentTenantId, getCurrentUserId } from '@/lib/supabase/tenant'
+import { AdminBreadcrumb } from '@/components/admin/admin-breadcrumb'
+import { Card, CardContent, CardHeader, CardTitle } from '@/components/ui/card'
+import { Badge } from '@/components/ui/badge'
+import Link from 'next/link'
+import {
+  IconFileInvoice,
+  IconAlertCircle,
+  IconInfoCircle,
+  IconExternalLink,
+} from '@tabler/icons-react'
+
+export default async function AdminInvoicesPage({
+  params,
+}: {
+  params: Promise<{ locale: string }>
+}) {
+  const { locale } = await params
+  const t = await getTranslations('dashboard.admin.invoices')
+  const tBreadcrumbs = await getTranslations('dashboard.admin.breadcrumbs')
+  const dateLocale = locale === 'es' ? es : enUS
+
+  const userId = await getCurrentUserId()
+  if (!userId) {
+    redirect('/auth/login')
+  }
+
+  const tenantId = await getCurrentTenantId()
+  const supabase = createAdminClient()
+
+  // Verify admin role for this tenant
+  const { data: membership } = await supabase
+    .from('tenant_users')
+    .select('role')
+    .eq('user_id', userId)
+    .eq('tenant_id', tenantId)
+    .eq('status', 'active')
+    .single()
+
+  if (!membership || membership.role !== 'admin') {
+    return (
+      <div className="flex min-h-screen items-center justify-center bg-background">
+        <div className="text-center">
+          <IconAlertCircle className="mx-auto mb-3 h-10 w-10 text-destructive" strokeWidth={1.5} />
+          <h2 className="text-lg font-semibold">{t('accessDenied')}</h2>
+          <p className="mt-1 text-sm text-muted-foreground">{t('accessDeniedDesc')}</p>
+        </div>
+      </div>
+    )
+  }
+
+  // Query payment_requests that have an invoice_number (the only real invoice documents)
+  const { data: requests } = await supabase
+    .from('payment_requests')
+    .select('request_id, invoice_number, status, payment_amount, payment_currency, created_at, payment_confirmed_at, user_id, product_id')
+    .eq('tenant_id', tenantId)
+    .not('invoice_number', 'is', null)
+    .order('created_at', { ascending: false })
+
+  const rows = requests || []
+
+  // Resolve product names in one batch
+  const productIds = [...new Set(rows.map((r) => r.product_id).filter(Boolean))]
+  const { data: products } = productIds.length > 0
+    ? await supabase.from('products').select('product_id, name').in('product_id', productIds)
+    : { data: [] }
+
+  const productsMap = new Map((products || []).map((p) => [p.product_id, p.name]))
+
+  const fmt = (amount: number | null, currency: string | null) =>
+    new Intl.NumberFormat(locale, {
+      style: 'currency',
+      currency: (currency || 'USD').toUpperCase(),
+    }).format(amount || 0)
+
+  const statusBadge = (status: string) => {
+    switch (status) {
+      case 'approved':
+      case 'completed':
+        return (
+          <Badge className="bg-emerald-100 text-emerald-700 dark:bg-emerald-950 dark:text-emerald-400 text-[10px]">
+            {t('status.paid')}
+          </Badge>
+        )
+      case 'pending':
+        return (
+          <Badge className="bg-amber-100 text-amber-700 dark:bg-amber-950 dark:text-amber-400 text-[10px]">
+            {t('status.pending')}
+          </Badge>
+        )
+      case 'rejected':
+      case 'cancelled':
+        return (
+          <Badge variant="destructive" className="text-[10px]">
+            {t('status.cancelled')}
+          </Badge>
+        )
+      default:
+        return (
+          <Badge variant="secondary" className="text-[10px]">
+            {status}
+          </Badge>
+        )
+    }
+  }
+
+  return (
+    <div className="min-h-screen bg-background" data-testid="invoices-page">
+      {/* Header */}
+      <header className="border-b bg-card">
+        <div className="mx-auto max-w-7xl px-4 py-5 sm:px-6 lg:px-8">
+          <div className="mb-4">
+            <AdminBreadcrumb
+              items={[
+                { label: tBreadcrumbs('admin'), href: '/dashboard/admin' },
+                { label: tBreadcrumbs('monetization'), href: '/dashboard/admin/monetization' },
+                { label: t('title') },
+              ]}
+            />
+          </div>
+          <h1 className="text-2xl font-bold tracking-tight">{t('title')}</h1>
+          <p className="mt-0.5 text-sm text-muted-foreground">{t('description')}</p>
+        </div>
+      </header>
+
+      <main className="mx-auto max-w-7xl px-4 py-6 sm:px-6 lg:px-8">
+        {/* Contextual note */}
+        <div className="mb-6 flex items-start gap-3 rounded-lg border bg-muted/40 px-4 py-3 text-sm text-muted-foreground">
+          <IconInfoCircle className="mt-0.5 h-4 w-4 shrink-0" strokeWidth={1.75} />
+          <p>
+            {t('note.text')}{' '}
+            <Link
+              href="/dashboard/admin/transactions"
+              className="font-medium text-foreground underline-offset-4 hover:underline"
+            >
+              {t('note.transactionsLink')}
+            </Link>
+            .
+          </p>
+        </div>
+
+        {/* Invoices table */}
+        <Card>
+          <CardHeader>
+            <CardTitle>{t('table.title')}</CardTitle>
+          </CardHeader>
+          <CardContent>
+            <div className="overflow-x-auto">
+              <table className="w-full text-sm">
+                <thead className="border-b">
+                  <tr>
+                    <th className="px-4 py-3 text-left text-[11px] font-medium uppercase tracking-wider text-muted-foreground">
+                      {t('table.headers.invoiceNumber')}
+                    </th>
+                    <th className="px-4 py-3 text-left text-[11px] font-medium uppercase tracking-wider text-muted-foreground">
+                      {t('table.headers.item')}
+                    </th>
+                    <th className="px-4 py-3 text-right text-[11px] font-medium uppercase tracking-wider text-muted-foreground">
+                      {t('table.headers.amount')}
+                    </th>
+                    <th className="px-4 py-3 text-left text-[11px] font-medium uppercase tracking-wider text-muted-foreground">
+                      {t('table.headers.status')}
+                    </th>
+                    <th className="px-4 py-3 text-left text-[11px] font-medium uppercase tracking-wider text-muted-foreground">
+                      {t('table.headers.date')}
+                    </th>
+                    <th className="px-4 py-3 text-left text-[11px] font-medium uppercase tracking-wider text-muted-foreground">
+                      {t('table.headers.actions')}
+                    </th>
+                  </tr>
+                </thead>
+                <tbody className="divide-y">
+                  {rows.length > 0 ? (
+                    rows.map((req) => (
+                      <tr
+                        key={req.request_id}
+                        className="border-b last:border-0 transition-colors hover:bg-muted/40"
+                      >
+                        <td className="px-4 py-3">
+                          <code className="rounded bg-muted px-1.5 py-0.5 text-[10px] font-mono">
+                            {req.invoice_number}
+                          </code>
+                        </td>
+                        <td className="px-4 py-3">
+                          <p className="font-medium">
+                            {req.product_id
+                              ? (productsMap.get(req.product_id) ?? t('table.unknownProduct'))
+                              : t('table.unknownProduct')}
+                          </p>
+                        </td>
+                        <td className="px-4 py-3 text-right font-semibold tabular-nums">
+                          {fmt(req.payment_amount, req.payment_currency)}
+                        </td>
+                        <td className="px-4 py-3">
+                          {statusBadge(req.status || '')}
+                          {req.payment_confirmed_at && (
+                            <p className="mt-0.5 text-[10px] text-muted-foreground">
+                              {format(new Date(req.payment_confirmed_at), 'MMM d, yyyy', { locale: dateLocale })}
+                            </p>
+                          )}
+                        </td>
+                        <td className="px-4 py-3 text-xs tabular-nums text-muted-foreground">
+                          {req.created_at
+                            ? format(new Date(req.created_at), 'MMM d, yyyy', { locale: dateLocale })
+                            : '—'}
+                        </td>
+                        <td className="px-4 py-3">
+                          <Link
+                            href={`/api/invoices/${req.invoice_number}`}
+                            target="_blank"
+                            rel="noopener noreferrer"
+                            className="inline-flex items-center gap-1 text-xs font-medium text-primary underline-offset-4 hover:underline"
+                          >
+                            {t('table.viewInvoice')}
+                            <IconExternalLink className="h-3 w-3" strokeWidth={2} />
+                          </Link>
+                        </td>
+                      </tr>
+                    ))
+                  ) : (
+                    <tr>
+                      <td colSpan={6} className="py-12 text-center">
+                        <div className="flex flex-col items-center gap-3">
+                          <div className="flex h-12 w-12 items-center justify-center rounded-full bg-muted">
+                            <IconFileInvoice className="h-6 w-6 text-muted-foreground" strokeWidth={1.5} />
+                          </div>
+                          <div>
+                            <p className="font-medium text-sm">{t('empty.title')}</p>
+                            <p className="mt-1 text-xs text-muted-foreground max-w-sm mx-auto">
+                              {t('empty.description')}
+                            </p>
+                          </div>
+                        </div>
+                      </td>
+                    </tr>
+                  )}
+                </tbody>
+              </table>
+            </div>
+          </CardContent>
+        </Card>
+      </main>
+    </div>
+  )
+}