📚 - Tutorial de Desenvolvimento Web com Django

👨‍💻 # Este repositório abriga um abrangente tutorial sobre o desenvolvimento web usando o framework Django. Aprenda passo a passo a criar um aplicativo web, desde a configuração inicial até o deploy em um ambiente de produção.

📜 Sumário

• Fase 1: Configuração Inicial e Ambiente de Desenvolvimento
• • 1.1. Instalação do Python e Pip.
• • 1.2. Configuração de um ambiente virtual (Virtual Environment).
• • 1.3. Instalação do Django usando o Pip.
• • 1.4. Inicialização de um novo projeto Django.
• • 1.5. Inicialização de um novo app Django.
• • 1.6. Executando o servidor com Runserver
• Fase 2: Estrutura de Diretórios e Primeiras Configurações
• • 2.1. Estrutura de Diretórios do Projeto
• • 2.2. Configuração do Banco de Dados
• • 2.3. Configuração do Banco de Dados no MySQL Workbench
• • 2.4. Configuração do Banco de Dados no Django
• • 2.5. Instalação de Pacotes Python para MySQL no Django
• Fase 3: Models e Banco de Dados
• • 3.1. Criar Modelos
• • 3.2. Migrações e Aplicação
• • 3.3. Django Admin
• • 3.4. Criar Superusuário
• Fase 4: Views e URLs
• • 4.1. Criar Views
• • 4.2. Definir URLs
• • 4.3. Configurando URLs de Setup
• • 4.4. Criar um Template
• Fase 5: Templates e Páginas HTML (static, partials, layout, media)
• • 5.1. Criar Templates HTML
• • 5.2. Configurando Arquivos Estáticos
• • 5.3. Arquivos Estáticos (CSS, JS, Imagens)
• • 5.4. Uso de Modelos Parciais (Partial Templates):
• • 5.5. Templates e Layouts:
• • 5.6. Configurando Arquivos de Mídia e Imagens do Banco:
• Fase 6: MVT (Model-View-Template) e Integração
• • 6.1. Integrando Model, View e Template
• • 6.2. Compreendendo a Integração
• • 6.3. Divisão das responsabilidades MVT
• Fase 7: Administração do Django
• • 7.1. Habilitar o Painel de Administração
• • 7.2. Personalizar a Interface de Administração
• • 7.3. Adicionar Informações no Banco de Dados
• • 7.4. Autorizações e Usuários
• • 7.5. Traduzindo Painel Admin
• Fase 8: Formulários e Validação
• • 8.1. Criando um Formulário
• • 8.2. Renderizando o Formulário em uma View
• • 8.3. Criando um Template para o Formulário
• • 8.4. Personalizando Formulário Template
• • 8.5. Mapear URLs
• Fase 9: Autenticação e Autorização
• • 9.1. Configurar a Autenticação de Usuário Padrão Django
• Fase 10: CRUD (Create, Read, Update, Delete)
• Fase 11: Testes e Depuração
• Fase 12: Deploy (Implantação) em Produção

---

📗 Fase 1: Configuração Inicial e Ambiente de Desenvolvimento

1.1. Instalação do Python e Pip.

• 🔔 Certifique-se de que o Python e Pip estejam instalados no seu sistema. Você pode verificar isso executando o seguinte comando no seu terminal ou prompt de comando:

python --version

pip --version

Caso contrário, você pode baixa-los em seus sites e seguirem as instruções de instalação em Python e Pip

Pip (Python Package Installer) geralmente é incluído na instalação do Python mais recente.

1.2. Configuração de um ambiente virtual (Virtual Environment).

🗃️ # Um ambiente virtual é uma prática recomendada para isolar as dependências do seu projeto. Isso garante que você possa ter várias versões do Django e de outras bibliotecas em diferentes projetos sem conflitos.

1. Abra um terminal ou prompt de comando

2. Navegue até o diretório onde deseja criar seu ambiente virtual.

3. Execute o seguinte comando para criar o ambiente virtual (substitua nome-do-ambiente pelo nome que você deseja para o seu ambiente):

• 🖥️ No Windows:

python -m venv nome-do-ambiente

• 💻 No macOS e Linux:

python3 -m venv nome-do-ambiente

4. Para ativar o ambiente virtual, utilize os seguintes comandos no terminal ou prompt de comando:

• 🖥️ No Windows:

nome-do-ambiente\Scripts\activate

• 💻 No macOS e Linux:

source nome-do-ambiente/bin/activate

Agora, você está dentro do ambiente virtual e pode instalar as dependências específicas do projeto, incluindo o Django, quando ativar a venv seu terminal ficará assim:

• 🔩 Lembrando que quando fechar o seu editor e abrir novamente, terá de ativar a venv (ambiente virtual) novamente seguindo a etapa 1.2.4

1.3. Instalação do Django usando o Pip.

• 🔔 Dentro do ambiente virtual, você pode instalar o Django executando o seguinte comando no terminal ou prompt de comando:

pip install django

Isso instalará a versão mais recente do Django no seu ambiente virtual.

1.4. Inicialização de um novo projeto Django.

• 🔔 Agora que o Django está instalado, você pode criar um novo projeto Django com o seguinte comando (substitua nome-do-projeto pelo nome que você deseja para o projeto):

• 📌 Recomendo que o nome seja setup, dessa forma fica mais fácil para diferenciar a pasta de setup onde serão guardadas as configurações do seu site, depois é só renomear o nome do projeto para nome-do-projeto que você desejar.

django-admin startproject nome-do-projeto

ou

django-admin startproject setup

👨‍👦 # Assim criará a estrutura inicial do seu projeto Django, incluindo arquivos e diretórios necessários, pode renomear o diretório "pai" do projeto sem alterar o diretório setup que estiver dentro dele, normalmente os 2 possuem o mesmo nome, por isso que haverá complicações na hora de navegar.

1.5. Inicialização de um novo app Django.

• 🔔 Para criar um novo aplicativo dentro do projeto, execute o seguinte comando no terminal ou prompt de comando dentro do diretório (nome-do-projeto) onde é o seu projeto (substitua nome-do-app pelo nome do aplicativo):

cd nome-do-projeto
python manage.py startapp nome-do-app

Isso criará a estrutura de diretórios e arquivos para o seu novo aplicativo Django.

1.6. Executando o servidor com Runserver

📌 # O servidor de desenvolvimento é uma ferramenta que permite que você teste e visualize seu aplicativo enquanto o desenvolve. Lembre-se de que o servidor de desenvolvimento é destinado apenas para uso durante o desenvolvimento e testes.

1. Abra um terminal ou prompt de comando.

2. Navegue até a pasta raiz do seu projeto Django, onde está localizado o arquivo manage.py. Use o comando cd para acessar a pasta (WebBooks é o nome da minha pasta Raiz/Pai do projeto).

3. Agora que você está na pasta do projeto e com o ambiente virtual ativado, você pode iniciar o servidor de desenvolvimento com o seguinte comando:

• 🖥️ No Windows:

python manage.py runserver

• 💻 No macOS e Linux:

python3 manage.py runserver

4. Após executar o comando, o servidor de desenvolvimento começará a ser executado. Você verá mensagens no terminal indicando que o servidor está "exibindo" em um endereço, normalmente em http://127.0.0.1:8000/, é só clicar por cima e entrar no link e você conseguirá observar a página inicial do seu projeto:

5. Para desligar o Runserver, é só pressionar Crtl + C no terminal ou prompt de comando.

---

📗 Fase 2: Estrutura de Diretórios e Primeiras Configurações

2.1. Estrutura de Diretórios do Projeto

🗂️ # Um projeto Django possui uma estrutura de diretórios organizada. Vamos dar uma olhada nos diretórios e arquivos principais, usaremos os meus exemplos como referência:

• WebBooks/: Este é o diretório raiz do seu projeto, no seu caso será o nome-do-projeto que você escolheu, além de que pode ser possível renomea-lo sem problemas
• • setup/: O diretório interno com o mesmo nome contém as configurações do projeto, caso renomea-lo terá de reconfigurar todos os arquivos internos dele.
• • • settings.py: Arquivo de configurações do projeto.
• • • urls.py: Arquivo de configurações de URLs.
• • • wsgi.py: Arquivo de configuração do servidor WSGI (usado para implantação em produção).
• • Website/: O diretório do seu aplicativo.
• • • __init__.py: Um arquivo Python vazio que informa ao Python que o diretório deve ser tratado como um pacote.
• • • admin.py: Este arquivo é usado para configurar a administração do aplicativo, permitindo que você gerencie os modelos de dados por meio da interface de administração.
• • • apps.py: Arquivo de configuração do aplicativo, onde você pode definir metadados do aplicativo.
• • • models.py: Neste arquivo, você define os modelos de dados do aplicativo, que representam as tabelas do banco de dados.
• • • tests.py: Este é o local para escrever testes de unidade para o aplicativo.
• • • views.py: Neste arquivo, você define as visualizações que controlam a lógica de exibição do aplicativo.
• • • migrations/: Este diretório é criado quando você executa migrações e contém os arquivos de migração do aplicativo.
• • • templates/: Aqui, você pode criar diretórios e arquivos de modelos HTML usados para renderizar as páginas do aplicativo.

🔩 - Algumas dessas estruturas iremos criar ao longo do tutorial

2.2. Configuração do Banco de Dados

🔔 # Nesse tutorial iremos utilizar uma das formas de configurar o banco