CommerceIQ
Plataforma de inteligência para e-commerce em Python: pedidos de todos os canais, estoque por armazém, risco de ruptura, margem real e previsão de demanda
- Meu papel
- Designer UX/UI · Análise de arquitetura
CommerceIQContexto
CommerceIQ é uma plataforma de inteligência operacional para lojistas que vendem na loja própria e em marketplaces: pedidos de todos os canais na mesma fila, estoque por armazém, risco de ruptura, margem real de cada produto, relatórios e previsão de demanda.
Fiz o produto, o UX/UI e a análise de arquitetura. A fundação de comércio é o Saleor, em Python e Django, com catálogo, estoque, pedidos e webhooks; a inteligência roda num App próprio em FastAPI que se conecta a ele.
Problema de negócio
Quem vende em vários canais vive com o estoque desencontrado: o produto acaba no marketplace enquanto ainda aparece na loja, a margem real se perde entre taxas diferentes e a compra com o fornecedor é feita no chute, quando o item já esgotou.
O CommerceIQ junta tudo: um pedido, um estoque e uma margem de verdade por produto, e avisa o que vai acabar antes de acabar, com quanto comprar.
A fundação técnica
Do Saleor vêm o catálogo com variantes e atributos, os canais de venda com preço e preço de custo por variante, o estoque por armazém com quantidade, alocação e reserva, os pedidos com status e atendimentos, os webhooks de pedido e de estoque, os grupos de permissão, a exportação CSV e as tarefas em Celery.
O produto CommerceIQ
A camada de inteligência e toda a interface: visão comercial com margem depois das taxas, risco de ruptura com cobertura em dias e sugestão de compra, conectores de marketplace com importação idempotente, movimentações rastreáveis, relatórios, previsão de demanda e o app do lojista.
Arquitetura
O Saleor continua como fonte da verdade de catálogo, estoque e pedidos. O CommerceIQ é um App do Saleor em FastAPI: recebe os eventos por webhook, guarda o histórico num banco analítico próprio, roda importações e previsão em Celery e devolve ações pela API GraphQL. Relatório pesado nunca disputa banco com o checkout.
Decisões de arquitetura e trade-offs
Seis decisões registradas como ADRs: o contexto, o que foi decidido, o custo de cada uma e como ela aparece para quem usa o produto.
Arquitetura de informação e fluxos
O mapa do produto, os cinco grupos de permissão e os três fluxos que mais importam: pedido de marketplace até o envio, risco de ruptura até a compra e importação que falha.
As telas no Figma
Treze telas desktop com protótipo navegável, para quem cuida da operação e da gestão comercial.
- 01 / 11
Visão geral comercial
Receita, pedidos, ticket médio e margem bruta depois das taxas, receita e lucro bruto por dia, a divisão por canal, os produtos em risco de ruptura e os mais vendidos.
- 02 / 11
Estoque e ruptura
Para cada SKU, em estoque, alocado e disponível, a venda média, a cobertura em dias contra o prazo do fornecedor e a sugestão de compra. Excesso também aparece, para pausar a compra.
- 03 / 11
Produtos
O catálogo com preço, custo, margem e saúde do estoque de cada produto, busca por nome, SKU ou código de barras, filtros e paginação.
- 04 / 11
Edição de produto
Dados do produto, variantes com preço, custo e margem calculada na hora, estoque por armazém, publicação por canal, o alerta de ruptura com a quantidade a comprar e o histórico de quem mudou o quê.
- 05 / 11
Pedidos
Loja online e marketplaces na mesma fila, com os status do Saleor: não confirmado, não atendido, parcialmente atendido, atendido, devolvido e cancelado.
- 06 / 11
Detalhe do pedido
Cada item com o armazém de onde sai, o lucro bruto do pedido depois da taxa do canal e a linha do tempo desde a importação, com a chave de idempotência.
- 07 / 11
Integrações e importações
Canais conectados, importações em segundo plano com recebidos, gravados, repetidos e falhas, e o detalhe de cada falha: o erro do canal, a próxima tentativa e se precisa de ação manual.
- 08 / 11
Movimentações
Todo item que entra, sai ou muda de armazém, com a origem e quem fez. Nada é editado nem apagado: uma correção entra como novo ajuste, com motivo.
- 09 / 11
Relatórios
Receita por semana, participação e margem por categoria e margem por canal depois das taxas, com exportação em CSV.
- 10 / 11
Previsão de demanda
Quanto cada produto deve vender nas próximas semanas, com uma faixa de 80% em vez de um número único, o método, os dados usados, os limites e a qualidade medida em backtest.
- 11 / 11
Equipe e permissões
Grupos de permissão aplicados na API: o financeiro vê margem sem editar nada, a expedição atende pedidos e ajusta estoque, e nenhuma consulta cruza empresas.
Estados da interface
Carregando, vazio, erro com código para o suporte e o retorno das tarefas em segundo plano, como a exportação pronta, a importação em andamento e os pedidos repetidos que não foram duplicados.
App do lojista
O resumo do dia com o que precisa de atenção, o alerta de estoque com a quantidade sugerida e o pedido com o lucro bruto e o botão de atender.
Previsão de demanda com os pés no chão
A previsão é um módulo analítico, e a tela foi desenhada para não vender certeza:
Sistema Visual
Design system próprio no Figma, com variáveis de cor, espaçamento e raio, estilos de texto e componentes com variantes: botão, status do pedido, saúde do estoque, item de menu e card de indicador. Violeta para agir, verde para dinheiro e uma cor fixa por canal de venda.
Paleta
Violeta
#5B4BF5
Ação principal e marca
Verde Dinheiro
#0FA47A
Margem e lucro
Tinta
#14112B
Títulos e textos
Âmbar
#B54708
Atenção e excesso
Vermelho Ruptura
#B42318
Risco de ruptura e cancelado
Amarelo Marketplace
#F5C542
Canal Mercado Livre
Tipografia
Manrope
800
Títulos e números
Inter
400 / 500 / 600 / 700
Interface, tabelas e formulários
JetBrains Mono
400
SKUs e números de pedido
Próximas versões
O que vem a seguir no roadmap do produto:
Referências e créditos
A fundação técnica do CommerceIQ é o Saleor, da Saleor Commerce e da comunidade open source, publicado sob a licença BSD-3-Clause.
Aprendizado
Em e-commerce multicanal, o número que importa é o disponível de verdade e a margem depois das taxas, não o estoque bruto nem o preço de vitrine. Separar o núcleo de comércio da inteligência, com eventos idempotentes entre os dois, deixa o produto confiável mesmo quando os canais mandam o mesmo pedido duas vezes.
