📄 Card 63 [M12] — Power-Ups (Portal de Integrações)

📚 Referência SULTS: https://www.sults.com.br/produtos/power-ups Portal corporativo que centraliza sistemas externos, dashboards de BI e links em um único ambiente. Incorporação via iframe/embed + atalhos externos.

🎯 Objetivo

Criar o módulo Power-Ups — central de integrações externas do GENIOON:

Embed via iframe (Power BI, Metabase, Grafana, Looker, Google Analytics)
Atalhos externos (links para ERPs, CRMs, portais de RH que não permitem embed)
Organização hierárquica (categorias e subcategorias)
Controle de acesso por perfil (operador não vê painel financeiro)
Personalização visual (cores, ícones)
Relatórios de consumo (quem acessou, frequência)

📚 Documentação de Referência

prisma/schema.prisma — novo model

🛠️ Especificação Técnica

Schema Prisma (novo)

model PowerUp {
  id              String   @id @default(cuid())
  name            String
  description     String?
  type            PowerUpType                        // EMBED, LINK
  url             String
  embedUrl        String?                            // se EMBED (URL de iframe)
  iconUrl         String?
  color           String   @default("#3B82F6")
  category        String                             // "BI", "Financeiro", "RH", "Pedagógico"
  order           Int      @default(0)
  // Permissões
  targetRoles     String[]
  targetBranches  String[]                           // vazio = todas
  // Tracking
  viewCount       Int      @default(0)
  isPublished     Boolean  @default(true)
  createdAt       DateTime @default(now())
}

enum PowerUpType { EMBED  LINK }

Rotas (page.tsx)

/powerups — grade de integrações visíveis ao usuário
/powerups/[id] — embed em tela cheia (se EMBED) ou redirect (se LINK)
/master/powerups — admin (CRUD + analytics)

Procedures tRPC

master.powerups.* (CRUD)
powerups.list (filtra por role/branch)
powerups.track (incrementa viewCount)

✅ Critérios de Aceite

MASTER cria Power-Ups EMBED (iframe) ou LINK
Organização por categoria
Permissões por role + branch
Embed em tela cheia para tipo EMBED
Analytics de consumo (views)
Personalização visual (cor, ícone)
Build passa + lint OK

🔌 Handoff

Container <iframe sandbox /> para embeds (segurança)
Integração com Card 22 (Dashboard Master) — pode embedar Power BI externo

🎯 Próximo

Card 64: CRM Expansão (Franquias) + Sync Post-Venda

EXECUCAO — 2026-08-15

1. O que foi implementado

PowerUp EMBED (iframe sandbox em modal fullscreen) / LINK (nova aba+track). Grade por categoria com cor/ícone próprios, permissões targetRoles/targetBranches. /powerups + /master/powerups (CRUD+analytics views).

Commit: fcd05d1 (router src/server/trpc/routers/ + páginas src/app/ + CSS modules src/styles/).

2. Critérios de aceite

Validados via typecheck/lint/build (0 erros) + deploy DEV (CI verde) + smoke HTTP 200 das rotas.

3. Deploy DEV

https://sistemaescolar.wellka.com.br — migration 20260815180000_m10_m13_foundation (60 tabelas) aplicada via CI
Routers registrados no root: m10, m11, m12, m13, m13b (+ shell do M14)
Navegação e i18n (pt-BR/en-US/es-ES) atualizados para todas as roles

4. Próximo card

Após M13 (65-74): M7 Go-Live (cards 32-37) — marco final.