Link:
https://github.com/webfansplz/vite-plugin-vue-devtools

Após fazer npm install, tem vários avisos de bibliotecas desatualizadas....
Ver quais libs tem atualizações, vue, vuetify, axios ....

Hoje os endpoints estão usando from django.views.decorators.csrf import csrf_exempt

Isto é uma falha de segurança? Em API quais são as práticas de segurança para POST?

Adicionar nas questões do cookiecutter, a opção de utilizar pip-tools ao invés de apenas o requirements.txt padrão.

Fazer isto como opção e não para todos projetos

Assim o dev consegue escolher os plugins ativos com base no módulo que irá dar manutenção

hoje cada versão do projeto (com django-ninja, django puro ou openapi) temos um arquivo .in específico.
Mas é possível remover estes arquivos duplicados e gerá-los automaticamente utilizando o pyproject.toml como fonte:

https://pip-tools.readthedocs.io/en/stable/#requirements-from-pyproject-toml

• https://github.com/pydantic/logfire
• https://signoz.io/blog/loki-vs-elasticsearch/
• https://grafana.com/oss/loki/
• open telemetry

Hoje o Djavue tem uma documentação inicial que foi feita para ajudar algumas pessoas que não falam Português, assim fiz em Inglês mesmo ou o arquivo markdown no repo, mas a motivação maior é criar documentação em Português. Assim, qualquer ajuda na melhoria ou tradução é mais que bem-vinda.

Você pode pegar qualquer parte da documentação, criar um Issue, exemplo, "Rodando o backend sem docker" e fazer um PR com esta documentação.

Exemplos de partes que podem ser traduzidas para pt-br:

• Introduction
• D-Jà Vue template requirements
• Creating my first project using D-Jà Vue
• Run locally using Docker vs not using Docker (containers)
• Running the 🦄 backend without docker
• Running the ⚡️ frontend without docker
• Running all with docker
• Package Management with Poetry

Exemplos de precisam da criação da documentação e podem ser feitas diretamente em Português:

• Debugging the Django API
• Debugging the VueJS web
• Package Management with requirements
• Package Management with Pip-tools
• Backend structure & organization
• Frontend structure & organization
• Frontend using API MOCK
• Build, CI & Deploy workflow
• Contributing

Qualquer dúvida, é só enviar uma mensagem aqui mesmo nesta Issue.

Valeu

Links:

• https://github.com/evolutio/djavue3/blob/main/docs/README_EN.md
• https://djavue3.vercel.app/README_EN.html
• https://vitepress.dev/

Como começar:

• Fazer fork
• Clonar
• Entra na pasta docs
• Utilizar node 18
• Rodar npm install e depois npm run docs:dev
• Criar uma branch issue57_adiciona_docs_pt_br_poetry (fazer PR pequenos)

Atualmente só conseguimos criar tarefas e falta a funcionalidade de deletar

O que falta:

• Escrever o teste da camada de API
• Escrever o teste da camada de serviço que com base no ID e os novos dados, a task foi alterada
• Novo endpoint para alterar tarefa (DELETE no /tarefas) - levando em conta que os endpoints serão mais RESTful
• criar novo campo no model para fazer o soft delete (note que ao inves de deleted, poderia ser algo como status e assim tarefas completadas seria resolvido com esta funcionalidade também, faz sentido?)
• Alterar página de listagem de forma a poder chamar a nova funcionalidade, exibir toast mostrando que a ação foi executada
• Testar que a nova funcionalidade funciona independente se foi escolhido: django_only, django_ninja ou openapi

Hoje por padrão tem uma tabela (ActivityLogs) para registrar logs, mas a ideia é colocar algo externo ou algo que não deixe o banco de negócio ter o gargalo do log....

Algo como o Papertrail ou qualquer outro opensource, alguma sugestão???

Problema

Não sabemos se este template funciona de primeira no Windows

Atualmente só conseguimos criar tarefas e falta a funcionalidade de alterar

O que falta:

• Escrever o teste da camada de API
• Escrever o teste da camada de serviço que com base no ID e os novos dados, a task foi alterada
• Novo endpoint para alterar tarefa (PATCH no /tarefas) - levando em conta que os endpoints serão mais RESTful
• Criar nova rota e nova página para a página de alterar
• Reutilizar o formulário de campos, mas alterar o comportamento para preencher os dados quando tiver

nota: Poderia ser um PUT, mas como não vamos enviar todos os campos do modelo e sim alguns específicos, pode ser que o PATCH encaixa melhor

Problema:
O padrão é fazer CI com Github Actions

Solução:
Ajustar o arquivo .gitlab-ci.yml de forma que faça o build corretamente e ao fazer push, gerar imagem, rodar testes, linter usando a infra do gitlab

Para quem quer começar sem docker está um pouco difícil, principalmente se é a primeira vez. Também é algo bastante pedido nos grupos onde é falado de D-jà Vue

• Tem alterar diversas variáveis (na pasta raiz e na pasta frontend)
• Tem que resolver problemas de cors

pode ser um pouco contra o princípio de rodar localmente o mais próximo de produção, mas pode ser interessante do ponto de vista de iniciantes não ter a complexidade do docker.

• Configurar o DATABASE_URL para apontar para um sqlite
• Subir o backend sem precisar do docker nenhum
• Ter comentando no backend o django cors e forma q seja possível descomentar
• garantir que o frotend funciona via localshost:3000 sem dar erro de CORS

1) Deploy no fly.io

2) Deploy na Digital Ocean

3) Deploy na AWS

eae galera, qual desses você acha mais importante para começar?

• usar os recursos so python-dotenv para pegar DEBUG=True
• remover os os.gentenv
• colocar variáveis como CSRF_TRUSTED_ORIGINS que está hard coded

Talvez trocar para o python decouple faça mais sentido

❯ hadolint Dockerfile 
Dockerfile:8 DL3008 warning: Pin versions in apt get install. Instead of `apt-get install <package>` use `apt-get install <package>=<version>`
Dockerfile:8 DL3013 warning: Pin versions in pip. Instead of `pip install <package>` use `pip install <package>==<version>` or `pip install --requirement <requirements file>`
Dockerfile:8 DL3042 warning: Avoid use of cache directory with pip. Use `pip install --no-cache-dir <package>`
Dockerfile:17 DL4005 warning: Use SHELL to change the default shell
Dockerfile:17 SC2140 warning: Word is of the form "A"B"C" (B indicated). Did you mean "ABC" or "A\"B\"C"?
Dockerfile:29 DL3042 warning: Avoid use of cache directory with pip. Use `pip install --no-cache-dir <package>`

Como instalar hadolint no Debian:

sudo wget -O /bin/hadolint https://github.com/hadolint/hadolint/releases/download/v2.9.3/hadolint-Linux-x86_64
sudo chmod +x /bin/hadolint

#check hadolint install 
hadolint --help

Colocar de forma explícita o header:

  headers: {
    'Content-Type': 'application/json'
  }

Utilizar a recomendação do Django para usar AbstractUser ao invés de Profile. Dica do Walison Felipe.

https://docs.djangoproject.com/en/4.1/topics/auth/customizing/#using-a-custom-user-model-when-starting-a-project

Tem versões novas do Django e Django Ninja!

Da para revisar todas libs e ver o que pode ser atualizado...

pip list --outdated
pip-upgrader
pip-check

Alterar para funcionar sem o network_mode: host do docker-compose.yml e assim deixar mais compatível com outros S.O.

links:
https://stackoverflow.com/questions/46286741/is-there-a-workaround-to-use-the-hosts-network-in-docker-for-mac

Testar a criação utilizando um nome dierente no lugar de coree fazer um teste completo

Existe uma classe Csv() que podeira ser usada aqui:

O código atual:

ALLOWED_HOSTS = config(
    "ALLOWED_HOSTS",
    default="{{cookiecutter.deploy_domain}}",
    cast=lambda v: [s.strip() for s in v.split(",")],
)

O código depois da modificação:

ALLOWED_HOSTS = config(
    "ALLOWED_HOSTS",
    default="{{cookiecutter.deploy_domain}}",
    cast=Csv(),
)

https://github.com/Tobi-De/cookiecutter-fastapi/blob/main/tests/test_project_generation.py

https://github.com/isakbosman/full-stack-fastapi-react-postgres-boilerplate/blob/master/scripts/test.sh

https://pypi.org/project/taskipy/

https://github.com/django-extensions/django-extensions

Tem um ferramenta bem legal para fazer testes end 2 end:
https://www.youtube.com/watch?v=-F0eCZK_vxE&list=PLhW3qG5bs-L9sJKoT1LC5grGT77sfW0Z8&index=5

Passos:

• Implementa os testes no projeto criado com Djavue (https://github.com/huogerac/mydjavuelist) na pasta frontend
• Faz push disto no repo acima na branch issue30_playwright
• utilizando o diff deste repo com a main, passamos isto para o repo do Djavue3

Ao acessar o /admin dá erro 500 pq a pasta /static tem algum erro de configuração.

• Testar localmente via container
• Revisar se está faltando algo no fly.toml
• Detalhar docs do Fly.io para deixar o CD funcionando (secrets do FLY_API_TOKEN)

Adicionar um campo string na tabela de usuário de forma que seja possível informar uma imagem no formato base 64 de exibir um avatar no frontend

Um endpoint de status pode ser útil para exibir o estado da aplicação, como se o banco de dados está rodando

Hoje alguns endpoints não tem muita informação, como código de retorno ou mesmo os dados de entrada/saída

• Uma ideia é implementar a funcionalidade de Like em uma tarefa chamando via uma tarefa async no celery.
• Mas a ideia principal da tarefa é adicionar suporte ao celery e configurações de como integrar django e celery

Documentação que pode ser melhorada:

• Ter a versão inglês do README.md principal e link do README padrão (pt-br) para o en-US
• Corrigir o "{{cookiecutter.project_slug}}/README.md" o qual está bem desatualizado
• Criar a documentação de como criar um projeto djavue3 no Windows
• Revisar os README.md de cada pasta do frontend
• Gerar a versão inglês dos READMEs do frontend
• Criar um README docker, poetry e pip-tools

problema

A tabela de tarefas cria tarefas independente do usuário, ou seja, não importa como quem fazemos login, sempre vamos ver as mesmas tasks

solução

• Adicionar foreignkey de User no model de Tasks
• Fazer o tasks_list fazer o filtro pelo usuário logado
• Criar testes para este cenário

O endpoint atual para inserir é /tarefas/add e a ideia é ser um POST para /tarefas

Envolve:

• Alterar o endpoint para o django_only para ter um if GET/POST
• Alterar o endpoint para o django_ninja onde a anotação muda
• Alterar o endpoint para o openapi
• a camada api (axios) no frontend que faz a chamada precisa ser alterada para o nova
• revisar que a documentação (swagger) foi atualizada

os testes estão misturando API e Services, seria legal separar um pouco

o que vocês acham que pode ser melhorado nestes testes aqui:

from unittest.mock import ANY

from twitterclone.accounts.models import User
from twitterclone.accounts.tests import fixtures
from twitterclone.core.models import Tweet


def test_criar_tweet_sem_login(client):
    resp = client.post("/api/core/tweets/add", {"new_tweet": "walk the dog"})
    assert resp.status_code == 401


def test_criar_tweet_com_login(client, db):
    fixtures.user_jon()
    client.force_login(User.objects.get(username="jon"))
    payload = {"description": "estudar pytest"}
    resp = client.post("/api/core/tweets/add", payload, content_type="application/json")
    assert resp.status_code == 200


def test_listar_tweet_com_login(client, db):
    fixtures.user_jon()
    Tweet.objects.create(description="walk the dog")

    client.force_login(User.objects.get(username="jon"))
    resp = client.get("/api/core/tweets/list")
    data = resp.json()

    assert resp.status_code == 200
    assert data == {
        "tweets": [{"description": "walk the dog", "done": False, "id": ANY}]
    }

Adicionar o https://miragejs.com/ como forma de fazer API MOCK no frontend sem utilizar o backend

Mais uma dica do Walison Felipe. Utilizar a biblioteca dj-database-url para facilitar a geração da url do banco de dados. Isto facilitar também o deploy em infra com serviços