Estudo de caso ↘
E-commerce com Django
Conectar o catálogo ao pedido e ao pagamento.
O foco é o percurso de compra: encontrar um produto, ajustar quantidades, criar um pedido e delegar a etapa de pagamento ao Stripe. Cada parte do fluxo fica organizada em uma aplicação Django.
- Meu papel
- Desenvolvedor · projeto pessoal de aprendizado
- Contexto
- Fluxos de comércio e integração de pagamentos com Django
- Estado do projeto
- Implementação educacional
- Período
- Jan 2025 – Jan 2026
O desafio
Tudo começa com um problema.
O problema
Uma compra conecta navegação e estado temporário do carrinho a pedidos autenticados e um serviço externo de pagamento. Cada transição precisa de um lugar claro na aplicação.
A abordagem
Construir um monolito modular com aplicações para catálogo, contas, carrinho, pedidos e pagamentos. Guardar o carrinho na sessão e criar sessões do Stripe Checkout no fluxo de pagamento.
Minha contribuição
Da ideia à implementação.
Catálogo e carrinho
Conexão de categorias e marcas a um carrinho por sessão que permite adicionar, atualizar, remover e calcular totais.
Contas e pedidos
Implementação de pedidos autenticados e modelos com estados pendente e pago.
Pagamento e confirmação
Integração da criação de sessões do Stripe Checkout e do fluxo de e-mail de confirmação de pedidos.
Arquitetura
Como as peças se conectam.
Monolito Django dividido em account, web, cart, order e payment, com modelos ORM, views baseadas em classes e templates renderizados no servidor.
Explorar o catálogo
Modelos de produtos, categorias e marcas alimentam as páginas do catálogo.
Manter o carrinho na sessão
O carrinho guarda seu dicionário de itens em request.session e gerencia quantidades e totais.
Criar um pedido
O fluxo autenticado conecta o carrinho a registros persistentes de pedidos.
Iniciar o pagamento
A view de pagamento cria uma sessão do Stripe Checkout; o projeto também inclui fluxos de estado pago e confirmação.
Ferramentas do projeto
- Python
- Django
- PostgreSQL
- Stripe
- JavaScript
Decisões
O raciocínio por trás do código.
01Manter a loja em um monolito Django
Separar as responsabilidades comerciais em aplicações Django dentro de um mesmo monolito.
Por que esta decisão / compromisso
Um ambiente compartilhado facilita a integração; os limites entre aplicações exigem cuidado conforme o projeto cresce.
02Guardar o carrinho na sessão
Representar o carrinho por um dicionário gerenciado pela sessão do Django.
Por que esta decisão / compromisso
O estado temporário fica simples, enquanto persistência e continuidade entre dispositivos dependem da sessão.
03Usar o Stripe Checkout hospedado
Criar uma sessão de Checkout e delegar a interface de pagamento ao Stripe.
Por que esta decisão / compromisso
Reduz o trabalho de interface de pagamento; a conciliação confiável dos estados de pagamento continua sendo uma responsabilidade de engenharia separada.
O resultado
O que o projeto entrega.
Catálogo organizado por produtos, categorias e marcas.
Carrinho por sessão com alteração de quantidades, remoção de itens e cálculo de totais.
Fluxo de pedidos conectado à criação de sessões do Stripe Checkout e à lógica de e-mail de confirmação.
O que aprendi
A integração de pagamentos envolve dados de sessão, pedidos persistentes e uma sessão de pagamento externa. Acompanhar essas transições ajuda a entender os limites e responsabilidades de cada aplicação Django.
Explore a implementação
Aprofunde-se nos detalhes consultando o código-fonte.
Continue explorando
Vamos construir algo útil.
Vamos conversar