Pular para o estudo de caso
Todos os projetos
Projetos selecionados03 / 04 · 2 min de leitura

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.

Esquema conceitual do sistema · não é uma captura do produto
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.

01 /

Catálogo e carrinho

Conexão de categorias e marcas a um carrinho por sessão que permite adicionar, atualizar, remover e calcular totais.

02 /

Contas e pedidos

Implementação de pedidos autenticados e modelos com estados pendente e pago.

03 /

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.

  1. Explorar o catálogo

    Modelos de produtos, categorias e marcas alimentam as páginas do catálogo.

  2. Manter o carrinho na sessão

    O carrinho guarda seu dicionário de itens em request.session e gerencia quantidades e totais.

  3. Criar um pedido

    O fluxo autenticado conecta o carrinho a registros persistentes de pedidos.

  4. 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.

01

Manter 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.

02

Guardar 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.

03

Usar 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