continuous learningcompany
Voltar para publicações
Rafael Nogueira
RafaelNogueira Conheça o autor

Django: do Python para a web, bloco por bloco

Entenda a responsabilidade de cada peça e acompanhe o caminho de uma requisição em um blog.

24/10/2026 Desenvolvimento
Infográfico Django: projeto e apps, URLs, views, models e ORM, templates e migrations; admin, autenticação e formulários; fluxo de listagem de posts e cuidados de segurança.

Quando você abre um blog, faz login ou preenche um cadastro, há mais acontecendo do que a exibição de uma página. O servidor recebe pedidos, aplica regras, consulta informações e prepara uma resposta. Django é um framework web escrito em Python que reúne ferramentas para organizar esse trabalho. Ele não é outra linguagem nem um banco de dados: é uma base sobre a qual você desenvolve a aplicação.

O infográfico apresenta as peças principais dessa base. A seguir, cada bloco ganha uma explicação e um exemplo, usando um blog fictício como fio condutor. A ideia é entender as responsabilidades antes de decorar nomes ou comandos.

Para que serve o Django?

Django pode ser usado em blogs, portais de conteúdo, sistemas internos e aplicações que trabalham com usuários e informações persistidas. Num blog, ajuda a organizar a publicação de textos; num portal, o gerenciamento de conteúdo; num sistema interno, cadastros e processos específicos da organização. A documentação apresenta justamente uma aplicação web orientada a dados.

Imagine um blog com autores, títulos, textos e uma indicação de publicação. Precisamos mostrar apenas os posts liberados, oferecer uma área de edição e controlar quem pode alterar os conteúdos. Django fornece peças reutilizáveis, mas as regras desse blog continuam sendo decisões de desenvolvimento. Ele não transforma uma ideia em um produto pronto sem programação.

1. Projeto e apps: separar configuração de funcionalidade

O projeto reúne as configurações e as aplicações que compõem um site. É nele que você define, por exemplo, quais apps estão instalados, como acessar o banco e qual é a configuração principal de endereços. Já um app organiza uma funcionalidade, como blog, cadastro ou catálogo. Um projeto pode reunir vários apps; um app também pode ser preparado para reutilização em outros projetos.

No exemplo, o projeto poderia se chamar portal e conter um app blog. O projeto conecta as partes; o app blog concentra seus modelos, views, templates e testes. Não é preciso criar um app para cada página: a divisão deve refletir responsabilidades compreensíveis, evitando tanto uma pasta gigante quanto fragmentação sem necessidade.

2. URLs: encaminhar o pedido para o lugar certo

A configuração de URLs associa um caminho a uma view. Quando o navegador pede /posts/, Django compara esse caminho com os padrões configurados e chama a view correspondente. Um endereço de detalhe, como /posts/12/, pode capturar o número do post e repassá-lo como argumento. O endereço não precisa reproduzir a organização de pastas no servidor.

Pense na URL como uma indicação de destino, não como a implementação da tarefa. A rota aponta quem atenderá o pedido; ela não deve concentrar toda a lógica do blog. Dar nomes às rotas também permite construir links sem repetir caminhos fixos por todo o código.

3. Views: coordenar o atendimento da requisição

Uma view recebe a requisição, executa a lógica necessária e devolve uma resposta. Pode ser uma função ou uma classe com comportamento apropriado ao atendimento. No blog, a view de listagem decide quais posts devem aparecer e quais dados serão entregues ao template. Outras views podem retornar um erro, um redirecionamento ou outro tipo de resposta.

Nem toda view consulta um banco, e nem toda resposta é uma página HTML. O importante é distinguir a responsabilidade: a view coordena o pedido; o template apresenta informações; os models descrevem os dados. Uma view de listagem pública, por exemplo, não deve expor rascunhos só porque eles existem no banco.

4. Models e ORM: representar e consultar os dados

Um model é uma classe Python que descreve informações da aplicação por meio de campos e comportamentos. No nosso exemplo, um model Post pode ter título, texto, data de publicação e um indicador de conteúdo publicado. Relacionamentos permitem representar associações, como o autor de cada post.

O ORM, mapeamento objeto-relacional, oferece uma interface Python para trabalhar com essas informações no banco configurado. Você pode filtrar posts publicados e ordená-los pela data usando a API de consultas, em vez de escrever SQL para toda operação. Isso não elimina a importância de compreender o banco, seus relacionamentos e o custo das consultas.

Um resultado de consulta costuma ser representado por um QuerySet. Ele pode ser refinado com filtros e ordenações antes de buscar efetivamente os resultados: criar um QuerySet não significa necessariamente executar a consulta naquele instante. Essa avaliação adiada ajuda a entender por que a consulta pode acontecer apenas quando os dados são utilizados.

5. Templates: combinar HTML e dados

Um template define a apresentação da resposta. Ele combina marcação HTML com valores e estruturas da linguagem de templates, como repetição e condição. A view fornece um contexto com os posts; o template percorre esse conjunto e apresenta os títulos. Se não houver posts, pode mostrar uma mensagem de lista vazia.

A renderização acontece no servidor: o navegador recebe o HTML resultante, não o código Python da view. O template não deve virar o lugar onde se concentra toda a regra de negócio. A separação facilita mudar o visual sem misturar essa mudança com a seleção dos dados.

6. Migrations: acompanhar a evolução da estrutura

O blog pode começar simples e depois ganhar um novo campo, como um resumo. Alterar a classe Python não basta para concluir que a estrutura de um banco existente foi atualizada. As migrations registram mudanças nos models em arquivos que permitem aplicar a evolução do esquema de forma organizada.

makemigrations cria arquivos de migração a partir das mudanças detectadas nos models; migrate aplica as migrações necessárias ao banco. São etapas diferentes. Os arquivos devem acompanhar o código do projeto. Eles não são um backup dos posts, e mudanças em produção exigem planejamento, teste e proteção dos dados. Adicionar um campo obrigatório a registros existentes, por exemplo, requer decidir como preencher os valores anteriores.

O que já vem no pacote: admin

O admin fornece uma interface orientada aos models para usuários confiáveis gerenciarem dados. No blog, um responsável pode cadastrar, editar ou remover posts, depois de configurar e registrar os models necessários. O Django inclui a infraestrutura, mas ela precisa estar habilitada e ajustada ao projeto.

O admin não é o site público. A documentação recomenda seu uso como ferramenta interna de gestão, não como base para toda a experiência do usuário final. Leitores navegam pelas páginas do blog; editores autorizados acessam o painel administrativo. Uma experiência editorial mais específica pode exigir views e telas próprias.

O que já vem no pacote: autenticação e permissões

Autenticar significa verificar quem está usando o sistema. Autorizar significa determinar o que essa pessoa pode fazer. Django oferece recursos relacionados a usuários, senhas, sessões, grupos e permissões. No blog, um leitor pode não precisar de conta, enquanto um editor precisa de acesso para alterar conteúdo.

Estar autenticado não significa poder fazer tudo. A aplicação precisa verificar permissões nos pontos corretos; esconder um botão não substitui uma verificação no servidor. Regras específicas, como permitir que cada autor edite apenas os próprios posts, também precisam ser implementadas e testadas conforme o projeto.

O que já vem no pacote: formulários

Formulários ajudam a descrever os campos de entrada, apresentar controles e validar dados recebidos. Um cadastro de post pode exigir um título e informar ao usuário por que um campo foi recusado. Django diferencia o formulário HTML que aparece na página do processamento e da validação realizados no servidor.

A validação do navegador melhora a experiência, mas não substitui a validação no servidor. Um Form não salva automaticamente qualquer informação: a view precisa tratar os dados válidos e executar a operação pretendida. ModelForm facilita a integração com um model. Para operações que alteram dados, também é necessário cuidar do método HTTP e da proteção contra requisições forjadas, o CSRF.

Exemplo: listar os posts de um blog

Vamos acompanhar uma requisição de leitura, sem misturar esse caminho com a criação ou a edição de um post. É uma aplicação possível das peças anteriores, não uma sequência obrigatória para toda resposta Django.

  1. Navegador: a pessoa acessa o endereço de listagem, como /posts/, e envia uma requisição HTTP.
  2. URL: o resolvedor encontra a rota correspondente e encaminha o pedido à view de listagem.
  3. View e ORM: a view define o filtro de posts publicados e a ordenação. O banco é consultado quando o conjunto de resultados é avaliado.
  4. Template: os dados são usados para montar a lista em HTML, incluindo uma alternativa quando não há conteúdo.
  5. Resposta HTML: a resposta volta ao navegador, que apresenta a página ao leitor.

O infográfico resume o percurso principal como navegador, URL, view e resposta HTML. A consulta pelo ORM e a renderização do template detalham o trabalho coordenado pela view. Isso evita a interpretação de que o banco ou o template são endereços que o navegador precisa acessar separadamente.

Laboratório guiado: o que deve aparecer na página?

Considere três posts fictícios: “Primeiros passos”, publicado; “Meu próximo texto”, ainda em rascunho; e “Organizando o projeto”, publicado. O objetivo é montar uma listagem pública sem expor material em preparação.

  • Defina quais informações o model Post precisa guardar, incluindo a indicação de publicação.
  • Associe o endereço de listagem à view responsável.
  • Na view, selecione somente posts publicados e defina a ordem desejada.
  • Entregue o conjunto ao template e apresente os títulos, com uma mensagem para a lista vazia.
  • Confira o resultado: os dois posts publicados aparecem; o rascunho não. Verifique também o caso sem nenhum post publicado.

Esta é uma atividade de raciocínio: o artigo e o jogo não executam Python nem se conectam a um banco real. Em um projeto implementado, a conferência deve incluir testes das views, filtros e permissões, além da apresentação. No jogo abaixo, você pratica a ordem das peças desse percurso.

Segurança também exige configuração e manutenção

Ter ferramentas prontas não torna um sistema automaticamente seguro. Antes de colocar a aplicação em produção, revise a configuração, mantenha versões suportadas e atualizadas, proteja segredos, confira os hosts aceitos e use HTTPS. O checklist oficial orienta, entre outros cuidados, não manter o modo de depuração DEBUG ativo em produção e proteger credenciais e backups.

Controle quem acessa o admin, aplique as permissões necessárias e valide as entradas. Teste se usuários sem autorização conseguem consultar ou alterar dados que não deveriam. Segurança é parte da operação contínua, não uma etapa encerrada apenas porque o site abriu no navegador.

Menos repetição. Mais foco na sua aplicação.

Essa é a ideia central do infográfico: reutilizar uma base de desenvolvimento para concentrar esforço no problema que o sistema precisa resolver. Projeto e apps organizam; URLs encaminham; views coordenam; models e ORM trabalham com dados; templates apresentam; migrations acompanham mudanças. Admin, autenticação e formulários complementam esse conjunto.

Ao reconhecer a responsabilidade de cada peça, fica mais fácil entender um projeto existente, planejar um novo recurso e investigar onde um problema pode estar. Use o jogo para reconstruir o caminho do blog e o quiz para revisar as diferenças entre os componentes.

Monte o caminho do post

Uma pessoa abriu /blog/primeiro-post/. Construa o caminho até ela ler o post: escolha o componente que resolve cada desafio. Um erro mantém a etapa para você tentar de novo. Após acertar, leia a explicação e use “Próxima etapa”.

Use Tab para navegar e Enter ou Espaço para escolher, ou toque nos botões. Sem cronômetro. Cada etapa vale 20 pontos na primeira tentativa ou 10 após algum erro; máximo de 100. Você pode reiniciar quando quiser.

Simulação didática no navegador: não executa Django. Este percurso representa uma página de blog com consulta ao banco; nem toda view precisa de ORM ou template. A view coordena a consulta e a renderização e devolve a resposta; as etapas não são processos independentes.

Teste seu conhecimento

Revise as responsabilidades das peças do Django.

1. Qual é a diferença entre projeto e app?

2. O que models e ORM permitem fazer?

3. Qual é o papel de um template no fluxo do blog?

4. Qual afirmação sobre migrations está correta?

5. Qual cuidado é correto ao usar o admin e contas de usuário?

6. Sobre formulários, qual prática está correta?

Fontes e contexto

Explicação dos blocos do infográfico da CLC “Django: do Python para a web”. Documentação oficial do Django 5.2 consultada em 24/10/2026 como base conceitual; o artigo não anuncia a versão mais recente nem substitui as instruções da versão usada no seu projeto. O blog, o laboratório e o jogo são exemplos didáticos.

  1. Django em visão geral
  2. Tutorial 1: projeto, apps, views e URLs
  3. Tutorial 3: views, templates e nomes de URLs
  4. Tutorial 2: models, banco e migrations
  5. Consultas com o ORM e avaliação de QuerySets
  6. Interface administrativa e seus limites
  7. Autenticação, usuários e permissões
  8. Trabalhando com formulários
  9. Checklist de implantação

Continue sua trilha

Trilha de Python · 0% concluído · 0 de 21 conteúdos concluídos