Arquitetura da Plataforma

🔍 Preview

A plataforma é organizada em aplicações independentes, cada uma com uma responsabilidade clara, permitindo flexibilidade no frontend, segurança no backend e integrações controladas.

Essa separação é a base do modelo headless adotado pela plataforma.

---

🧩 Visão Geral da Organização

A plataforma é composta por 5 aplicações principais:

• Store Theme (Frontend)
• Checkout (Frontend)
• Área Restrita (Frontend)
• API Pública (Backend)
• API Privada (Backend)

Cada camada possui um papel específico dentro do ecossistema.

🛍️ Store Theme

O Store Theme é responsável pela interface pública da loja.

Responsabilidades

• Página inicial (home)
• Listagem de produtos
• Página de produto
• Exibição de vitrines e banners
• Carrinho lateral com informações básicas

💳 Checkout

O Checkout é responsável pelo fluxo de finalização da compra.

Responsabilidades

• Resumo do carrinho
• Cálculo de valores
• Opções de frete
• Definição do meio de pagamento
• Confirmação do pedido

🔐 Área Restrita

A Área Restrita é acessível apenas para clientes autenticados. Permitindo que o cliente gerencie suas informações e acompanhe seus pedidos de forma segura.

Responsabilidades

• Histórico de compras
• Dados da carteira
• Edição e visualização de dados pessoais
• Endereços do cliente

🔗 API Pública

A API Pública é a principal camada de comunicação entre os frontends e a plataforma.

Características

• Comunicação via HTTP
• Utilizada por Store, Checkout e Área Restrita
• Dados públicos e operacionais
• Não requer autenticação administrativa

🔒 API Privada

A API Privada é destinada ao lojista e a integrações externas.

Características

• Acesso restrito
• Dados sensíveis da loja
• Uso exclusivo do lojista

Casos de uso

• Integrações com ERPs
• Automações externas

Responsabilidade

Toda integração via API Privada é de responsabilidade do lojista, incluindo:

• Segurança
• Uso correto
• Manutenção

🏁 Próximo passo

Agora que você entende a organização da plataforma, é hora de aprofundar dois conceitos fundamentais — cada um com um papel diferente na uappi:

🔄 Sessão

Entenda como a persistência de dados do cliente funciona entre as aplicações (Store Theme, Checkout e Área Restrita), garantindo carrinho ativo e login contínuo.

Persistência de dados: o que é e como funciona?

🔐 Autenticação

Aprenda como funcionam as autenticações para integrações externas, ferramentas de automação e consumo da API Privada, com foco em segurança e controle de acesso.

Autenticação: integrações e API Privada