Documentação Técnica

Referência interna da arquitetura, módulos e integrações do SystemHub.

Versão 2.0 · Enterprise

Estrutura do projeto

Organização de pastas recomendada

src/
├── components/     UI reutilizável (marketplace, admin, ui)
├── layouts/        Layouts de página
├── routes/         Rotas file-based do TanStack Router
├── hooks/          React hooks e stores (Context + localStorage)
├── services/       Serviços de integração (Supabase, Auth, Log)
├── repositories/   Camada de acesso a dados (facade sobre stores)
├── providers/      Providers globais
├── lib/            Regras de negócio puras
├── utils/          Helpers e utilitários
├── integrations/   Auto-gen (Supabase client, types)
├── types/          Tipos compartilhados
└── assets/         Imagens e mídias

Módulos principais

  • Marketplace público

    Vitrine, categorias, coleções, bundles, comparador e favoritos.

  • Área do cliente

    Biblioteca, licenças, downloads, suporte e perfil.

  • Área administrativa

    CRUD completo do catálogo, clientes, pedidos, financeiro, marketing.

  • Business Intelligence

    15 dashboards especializados com KPIs, insights e alertas.

  • Enterprise

    RBAC, Health Center, Launch Readiness, Auditoria e Backup.

  • Desenvolvedores

    Dashboard, cadastro de produtos, fluxo de aprovação e ranking.

  • Comercial

    Afiliados, parceiros, campanhas, cupons, comissões e landing pages.

  • Operacional

    Automações, integrações, tickets, changelog, roadmap e notificações.

Entidades e relacionamentos

  • Product

    Category, Reviews, Docs, Downloads, Versions

  • Customer

    Orders, Licenses, Tickets

  • Order

    Customer, OrderItems, Invoice, Payment

  • License

    Order, Product, Customer, Renewals

  • Ticket

    Customer, Product, Messages

  • Developer

    Products, Approvals, Sales

  • Affiliate

    Referrals, Commissions

  • Tenant

    Products, Customers, Settings

Integrações

  • Supabase

    Auth, Postgres, Storage, RLS.

    Conectado
  • Mercado Pago

    Checkout, webhooks e conciliação.

    Configurado
  • Resend

    Emails transacionais e marketing.

    Preparado
  • OpenAI / Lovable AI

    IA distribuída em produto, CRM, suporte.

    Preparado
  • GitHub

    Sincronização de repositórios e releases.

    Preparado
  • Cloudflare

    CDN, R2 storage e proteção.

    Preparado
  • N8N

    Orquestração de automações.

    Preparado

Rotas principais

  • / — Marketplace
  • /system/$id — Produto
  • /cart · /checkout
  • /dashboard — Cliente
  • /library · /licenses
  • /admin — Central
  • /admin/health · /admin/launch
  • /admin/bi/* — 15 dashboards
  • /developer/* — Desenvolvedor
  • /affiliate/dashboard

Roadmap técnico

  • ✅ Enterprise v2 — RBAC, Repositories, Health, Launch
  • ◻ Migração completa para Supabase (RLS + triggers)
  • ◻ IA real conectada via OpenAI/Lovable AI Gateway
  • ◻ 2FA e Refresh Token
  • ◻ Multi-tenant produção com domínios
  • ◻ i18n completo (PT/EN/ES)