Store e Marketplace de Plugins

Resumo

Duas dimensões complementares: (1) loja de produtos/addons para o cliente final (Store - produtos, pedidos, frete) e (2) marketplace de plugins da plataforma (catálogo, ativação por tenant, trial, precificação). Concentra a monetização e extensibilidade do SaaS.

Para quem é (papel/role)

• super-admin - catálogo global de plugins.
• tenant-admin - quais plugins exibir aos clientes, produtos próprios da loja.

O que você pode fazer

Store - Dashboard

• Resumo: vendas, pedidos em aberto, produtos mais vendidos.

Store - Produtos

• CRUD de produtos: nome, descrição, preço, estoque, imagens, variações.
• Categorias e tags.

Store - Pedidos

• Lista, detalhe do pedido.
• Mudar status.
• Cancelar / reembolsar.

Store - Shipping

• Métodos de frete: nome, regras (peso, região), tabela de preço.
• Ativar / desativar.

Marketplace de plugins (Whitelabel → Marketplace)

• Catálogo: 48+ plugins disponíveis.
• Ativar / desativar plugin por tenant.
• Configurar acesso: quais planos liberam quais plugins.
• Trial de plugin: período gratuito configurável.
• Precificação por plugin.

Plugin management (nível instalação)

• Listar plugins instalados.
• Status de dependências.
• Metadados de plugin (plugin.json).

Plugin settings

• Configuração individual de cada plugin.

Como acessar

1. /admin.
2. Settings → Loja ou /admin/settings/store (produtos).
3. Settings → Whitelabel → Marketplace ou /admin/settings/whitelabel/marketplace (plugins).

Tutoriais

Cadastrar produto físico na loja

1. /admin/settings/store/products/create.
2. Nome, preço, estoque, imagens.
3. Categoria e tags.
4. Publicar.

Processar um pedido

1. /admin/settings/store/orders.
2. Abra o pedido.
3. Marque como Em preparação, depois Enviado (informe código de rastreio).
4. Após entrega, Concluído.

Ativar plugin SMM para um tenant com trial de 14 dias

1. /admin/settings/whitelabel/marketplace.
2. Selecione o tenant.
3. Localize SMM e clique em Trial 14d.
4. Confirme.

Configurar frete por região

1. /admin/settings/store/shipping/create.
2. Nome: PAC Sudeste, regra por CEP, tabela por peso.
3. Ativar.

Integrações

• Planos - plugins podem ser liberados por plano (planos-e-pacotes.md).
• Billing - vendas de loja geram faturas (billing-gateways.md).
• Receita - vendas entram no dashboard (receita-e-financeiro.md).
• Compliance - dados fiscais de vendas (compliance-lgpd.md).
• Eventos - plugin.activated, plugin.deactivated.

Perguntas frequentes

Quantos plugins existem? 48 plugins registrados (incluindo Fitness, 48º).

Plugin em trial converte automaticamente? Conforme configuração de precificação do plugin.

Tenant pode instalar plugins por conta própria? Apenas entre os liberados pelo super-admin para o marketplace.

Produtos da loja podem ser digitais? Sim; frete é opcional para digitais.

Pedido cancelado libera estoque? Sim, automaticamente.

Posso vender assinatura via loja? Use o módulo de planos; loja é para produtos/addons avulsos.

Plugin desativado perde dados? Não. Dados são preservados para reativação.

Trial dispara cobrança automática? Se configurado com conversão, sim.

Limitações, políticas e avisos

• Plugins não podem criar CSS próprio - usam o sistema global.
• Dependências de plugin são verificadas na ativação.
• Pedido pago não pode ser excluído, apenas cancelado/reembolsado.
• Frete é calculado na finalização com base na tabela vigente.

Relacionados

• plans-and-packages.md
• billing-gateways.md
• revenue-and-finance.md
• tenants-whitelabel-management.md