Django — o framework
que vem com tudo

# 1. Crie e ative o ambiente virtual
python -m venv venv
source venv/bin/activate    # Linux/Mac
venv\Scripts\activate       # Windows

# 2. Instale o Django
pip install django

# 3. Crie o projeto Django
django-admin startproject meublog .
# O ponto (.) cria na pasta atual — evita pasta duplicada

# 4. Rode o servidor de desenvolvimento
python manage.py runserver

meublog/
├── manage.py              # comando principal do Django
└── meublog/               # pacote de configuração do projeto
    ├── __init__.py
    ├── settings.py        # todas as configurações do projeto
    ├── urls.py            # URLs raiz do projeto
    ├── asgi.py            # ponto de entrada para servidores async
    └── wsgi.py            # ponto de entrada para servidores tradicionais

python manage.py startapp posts

# Estrutura criada automaticamente:
posts/
├── __init__.py
├── admin.py       # registra models no painel admin
├── apps.py        # configuração do app
├── migrations/    # histórico de mudanças no banco
├── models.py      # define as tabelas do banco
├── tests.py       # testes automatizados
└── views.py       # lógica das requisições

INSTALLED_APPS = [
    "django.contrib.admin",
    "django.contrib.auth",
    "django.contrib.contenttypes",
    "django.contrib.sessions",
    "django.contrib.messages",
    "django.contrib.staticfiles",
    "posts",   # ← seu app aqui
]

from django.db import models

class Post(models.Model):
    titulo     = models.CharField(max_length=200)          # texto curto
    conteudo   = models.TextField()                         # texto longo
    publicado  = models.BooleanField(default=False)        # verdadeiro/falso
    criado_em  = models.DateTimeField(auto_now_add=True)   # data automática ao criar
    atualizado = models.DateTimeField(auto_now=True)       # data automática ao salvar

    class Meta:
        ordering = ["-criado_em"]   # mais recentes primeiro por padrão

    def __str__(self):
        return self.titulo          # como o objeto aparece no admin e no shell

# 1. Gera o arquivo de migration baseado nos seus Models
python manage.py makemigrations

# 2. Aplica as migrations ao banco de dados
python manage.py migrate

# Sempre nessa ordem: makemigrations → migrate

from posts.models import Post

# CREATE — criando um post
post = Post.objects.create(titulo="Meu primeiro post", conteudo="Olá!")

# READ — buscando todos os posts
todos = Post.objects.all()

# READ — filtrando publicados, ordenados por data
publicados = Post.objects.filter(publicado=True).order_by("-criado_em")

# READ — buscando um post pelo ID (lança exceção se não encontrar)
post = Post.objects.get(id=1)

# UPDATE — atualizando um campo
post.titulo = "Título atualizado"
post.save()

# DELETE — excluindo
post.delete()

# PESQUISA — título contendo "Django" (case-insensitive)
resultados = Post.objects.filter(titulo__icontains="django")

from django.shortcuts import render, get_object_or_404, redirect
from .models import Post

# Lista todos os posts publicados
def lista_posts(request):
    posts = Post.objects.filter(publicado=True)
    # render() = shortcut para render_template() do Django
    return render(request, "posts/lista.html", {"posts": posts})

# Detalhe de um post específico
def detalhe_post(request, pk):
    # get_object_or_404 busca pelo ID e retorna 404 se não existir
    post = get_object_or_404(Post, pk=pk, publicado=True)
    return render(request, "posts/detalhe.html", {"post": post})

# Criar um novo post via formulário
def criar_post(request):
    if request.method == "POST":
        titulo   = request.POST.get("titulo")
        conteudo = request.POST.get("conteudo")
        Post.objects.create(titulo=titulo, conteudo=conteudo, publicado=True)
        return redirect("lista_posts")   # redireciona pelo nome da URL
    return render(request, "posts/form.html")

posts/
└── templates/
    └── posts/        # pasta com o nome do app (convenção Django)
        ├── lista.html
        ├── detalhe.html
        └── form.html

{% extends "base.html" %}

{% block titulo %}Posts{% endblock %}

{% block conteudo %}
  <h1>Todos os Posts</h1>

  {% for post in posts %}
    <article>
      <h2><a href="{% url 'detalhe_post' post.pk %}">{{ post.titulo }}</a></h2>
      <p>{{ post.criado_em|date:"d/m/Y" }}</p>
      <p>{{ post.conteudo|truncatewords:30 }}</p>
    </article>
  {% empty %}
    <p>Nenhum post ainda.</p>
  {% endfor %}
{% endblock %}

from django.urls import path
from . import views

# app_name permite usar namespace nas URLs: {% url 'posts:lista' %}
app_name = "posts"

urlpatterns = [
    path("",           views.lista_posts,  name="lista_posts"),
    path("<int:pk>/",  views.detalhe_post, name="detalhe_post"),
    path("novo/",       views.criar_post,   name="criar_post"),
]

from django.contrib import admin
from django.urls import path, include

urlpatterns = [
    path("admin/", admin.site.urls),
    # inclui todas as URLs do app posts no prefixo /posts/
    path("posts/", include("posts.urls")),
]

python manage.py createsuperuser
# Vai pedir: username, email, password

from django.contrib import admin
from .models import Post

# Versão básica — apenas registra o Model
admin.site.register(Post)

# Versão personalizada — controla como aparece no admin
@admin.register(Post)
class PostAdmin(admin.ModelAdmin):
    list_display   = ["titulo", "publicado", "criado_em"]  # colunas na lista
    list_filter    = ["publicado"]                          # filtros na lateral
    search_fields  = ["titulo", "conteudo"]                 # campo de busca
    list_editable  = ["publicado"]                          # edita inline na lista