Documentação Técnica
Referência interna da arquitetura, módulos e integrações do SystemHub.
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
- Conectado
Supabase
Auth, Postgres, Storage, RLS.
- Configurado
Mercado Pago
Checkout, webhooks e conciliação.
- Preparado
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.
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)