Revisão final do texto

[dunossauro]

Para liberar a versão final, revisar todas as aulas individualmente. O objetivo dessa issue não é reescrever nada, mas tentar aplicar todos os passos (fazer o curso de fato) e buscar por possíveis problemas (de código ou explicação) que podem ocorrer em algumas aulas. Validar códigos no Windows também é um passo importante.

• [x] Abertura
• [x] Aula 01 - Configurando o Ambiente de Desenvolvimento
  • [x] Melhorias gerais no texto
  • [x] Adicionar o isort no comando de lint (8a0244692a998be6e5ae80a62589fd315f3d628f)
  • [x] Adicionar o código dessa aula no repositório (045ecbcf32933b90376164d7cf074acfa52b6820)
  • [x] Trocar a dupla Isort + blue pelo Ruff (check e formatter)
  • [x] #120
  • [x] #122
• [x] Aula 02 - Introdução ao desenvolvimento WEB
  • [x] Melhorias gerais no texto
  • [x] Ajustar link do swagger e redoc [Notificado por @YuriMotoshima] (b8347660683461e57ca4a713d2f3106f0e659c51)
  • [x] #120
  • [x] #122
• [x] Aula 03 - Estruturando o Projeto e Criando Rotas CRUD
  • [x] Melhorias gerais no texto
  • [x] #120
  • [x] #122
• [ ] Aula 04 - Configurando o Banco de Dados e Gerenciando Migrações com Alembic
  • [x] #120
  • [x] #122
  • [x] #90
  • [ ] Melhorias gerais no texto #93
  • [x] Remover comandos específicos de unix [touch] (001e7e53e32e973b3e16987ca4118230a7d0680a)
  • [x] Comentar a linha do yield e levar ela para alguma referência
  • [x] A tree da migration destacando a linha errada (fb524538512aa42a8c9fe7c6d83f5e1958a0b126)
  • [x] Instalar sqlite3 no windows com winget: winget install --id SQLite.SQLite (3e4e48b4e0134feff539c37f95ce601a2cd06340)
  • [x] Melhorar o texto e os commandos envolvendo o sqlite3. Não contar que pessoas tenham experiências anteriores com sqlite (14a3591d4d8c39974f6f0cd9b5e1fe9d13bed6b1)
    • [x] Explicar que o sqlite3 é um shell (14a3591d4d8c39974f6f0cd9b5e1fe9d13bed6b1)
    • [x] Explicar o que faz o comando .schema (14a3591d4d8c39974f6f0cd9b5e1fe9d13bed6b1)
    • [x] Explicar o que faz o comando .exit (14a3591d4d8c39974f6f0cd9b5e1fe9d13bed6b1)
    • [x] Explicar session.scalars e session.scalar
    • [x] #164
  • [x] Fazer o link com a nova live de sqlalchemy
• [ ] Aula 05 - Integrando Banco de Dados a API
  • [x] #120
  • [x] #122
  • [x] Melhorias gerais no texto
  • [x] Explicar o with na session (ou linkar)
  • [x] Comentar todos os commandos da session commit, add, refresh, delete, ...
  • [x] Explicar sobre query strings no endpoint de GET (Modificando o Endpoint GET /users)
  • [x] Erro da ordem de imports no ConfigDict (8a0244692a998be6e5ae80a62589fd315f3d628f)
  • [x] No arquivo de exemplo da remoção de UserDB não existe a config_model (8a0244692a998be6e5ae80a62589fd315f3d628f)
  • [x] Explicar que não dá pra ter a cobertura de get_session
  • [x] Em Modificando o Endpoint PUT /users remover if db_user is None: por if db_user (5cab0f20156269fec67d333fa2569852e488a515)
  • [x] Fazer o link com a nova live de sqlalchemy
• [ ] Aula 06 - Autenticação e Autorização com JWT
  • [ ] Melhorias gerais no texto
  • [x] #90
  • [x] #120
  • [x] #94
  • [x] #102
  • [x] #120
  • [x] #121
  • [x] #122
  • [x] Criar um teste para cobrir DecodeError
• [ ] Aula 07 - Refatorando a Estrutura do Projeto
  • [ ] Melhorias gerais no texto
  • [x] Investigar #74
  • [x] Cobrir o caso do PUT atuando como POST
  • [x] #102
  • [x] #120
  • [x] #121
  • [x] #122
• [ ] Aula 08 - Tornando o sistema de autenticação robusto
  • [ ] Melhorias gerais no texto
  • [x] #102
  • [x] #120
  • [x] #90
  • [x] #121
  • [x] #122
• [ ] Aula 09 - Criando Rotas CRUD para Gerenciamento de Tarefas em FastAPI
  • [ ] Melhorias gerais no texto
  • [x] #102
  • [x] #120
  • [x] #90
  • [x] #121
  • [x] #122
• [ ] Aula 10 - Dockerizando a nossa aplicação e introduzindo o PostgreSQL
  • [x] #121
  • [x] #122
  • [x] #161
  • [ ] Melhorias gerais no texto
  • [ ] Windows e Docker :(
    • [ ] Vagrant e WSL? - @devgiordane
• [ ] Aula 11 - Automatizando os testes com Integração Contínua (CI)
  • [ ] Melhorias gerais no texto
  • [x] #161
  • [x] #121
  • [x] #122
• [ ] Aula 12 - Fazendo deploy no Fly.io e configurando o PostgreSQL
  • [ ] Melhorias gerais no texto
  • [x] #161
  • [x] #121
  • [x] #122
  • [ ] Fly faz build no windows corretamente?
• [ ] Despedida
  • [ ] Melhorias gerais no texto
  • [x] Adicionar série sobre opentelemetry
• [ ] Appendices #87
  • [ ] Resolução dos exercícios #90
    • [ ] Aula 01
    • [ ] Aula 02
    • [ ] Aula 03
      • [ ] Exercício 01
      • [ ] Exercício 02
      • [ ] Exercício 03
    • [ ] Aula 05
      • [ ] Exercício 01
      • [ ] Exercício 02
      • [ ] Exercício 03

Quando essa issue for finalizada, o curso em texto está em sua primeira versão estável!

• post edit 23/jan/2024: A inclusão da nova aula 02 foi adicionada a essa issue
• post edit 04/fev/2024: Inclusão de alguns pontos de melhoria
• post edit 28/fev/2024: Inclusão da issue #102 nos planos de revisão, inclusão da live de sqlalchemy, testes para erro de decode
• post edit 02/mar/2024: Testes no windows realizados até aula 09. Tudo OK!
• post edit 01/abr/2024: Adição de #90, #120 , #121 e #122

[dunossauro]

Revisões na aula 01 e na abertura mergeadas!

[dunossauro]

Iniciando o trabalho de revisão da aula 02, relacionando também a sugestão em #80

[dunossauro]

A aula 02 foi finalizada, está disponível na branch revisao_67. Ainda não foi disponibilizada, pois existem muitos assuntos cruzados entre a nova 02 e antiga 02, agora 03.

Então a aula 02 e 03 serão abertas em um mesmo pull request. Esse PR será bastante estranho e extenso, pois ele muda a estrutura de todo o repositório após a aula 02

[dunossauro]

Notas para revisão

• 03 - Explicar variáveis em strings de endpoint (/{variável})
• 05 - Explicar sobre query strings no endpoint de GET (Modificando o Endpoint GET /users)