Incluir novo modo de visualização de busca de voluntários, permitindo acessar diretamente a página de detalhe dos voluntários

regiov commented 6 months ago

Sugestão: incluir ao final dos campos de busca de voluntários, logo após "Ordenado por: () Nome () Área de Trabalho", uma nova opção: "Modo de visualização: () paginação () sequencial". O modo de paginação é o que funciona atualmente. O modo sequencial, quando ativado, irá exibir diretamente a página de detalhe do primeiro voluntário retornado na busca, e essa página deverá exibir os botões "anterior" (quando houver) e "próximo" (quando houver) para navegação entre os resultados. Caso a busca não retorne ninguém, pode-se exibir a página do modo de paginação.

Diogojlq commented 6 months ago

@regiov, acredito que se colocarmos como "paginação" e "sequencial" não ficará claro a função dos modos de visualização, talvez algo como "visualização detalhada" ou algo que sugira que os resultados serão mostrados um a um.

regiov commented 6 months ago

@Diogojlq não sei se vamos conseguir encontrar palavras que consigam traduzir bem essa funcionalidade. Talvez seja o caso de incluir um ícone de ajuda com tooltip explicando melhor. De qualquer forma, é fácil alterar o nome depois. E também os usuários podem facilmente clicar em cada opção e simplesmente descobrir o que cada uma faz.

Diogojlq commented 6 months ago

Boa noite @regiov, coloquei os botões de navegação logo abaixo do nome do voluntário, porém, como está, eles irão aparecer sempre, não só quando estiver sendo feita a busca no modo de visualização sequencial, isso é um problema ? Estou fazendo da seguinte forma:

     `else: # Sequencial
        if voluntarios:  # Certifica que a lista não está vazia
            voluntario = voluntarios[0]
            proximo_voluntario = Voluntario.objects.filter(pk__gt=voluntario.pk).order_by('pk').first()
            voluntario_anterior = Voluntario.objects.filter(pk__lt=voluntario.pk).order_by('-pk').first()

            context = {'voluntario': voluntario,
                       'voluntario_anterior': voluntario_anterior.pk if voluntario_anterior else None,
                       'proximo_voluntario': proximo_voluntario.pk if proximo_voluntario else None}

            template = loader.get_template('vol/exibe_voluntario.html')

            return redirect('exibe_voluntario', voluntario.pk, voluntario_anterior.pk, proximo_voluntario.pk)`

Seria "correto" incluir os parâmetros "voluntario_anterior" e "próximo_voluntario" na view "exibe_voluntario"? Tentei criar um context e utilizar o HttpResponse, mas dessa forma não consigo passar o voluntário anterior e o próximo para a view "exibe_voluntario", então a navegação só funciona no primeiro clique, pois a view não estava recebendo os parâmetros.

Obs: Sei que está cheio de erros bobos, mas queria te atualizar

regiov commented 6 months ago

@Diogojlq, não ligo pra erros "bobos". O mais importante é ver que a pessoa está se dedicando, se esforçando, não tem medo de se expor, de interagir e tem disposição para ouvir e aprender. Acredite, isso é o mais importante e o mais difícil de conquistar.

Quanto aos botões, sim, só faz sentido exibir em modo sequencial. Lembre que existem outras situações que a gente pode chamar a página de voluntário - por exemplo na lista de voluntários inscritos para uma vaga - que não tem sequer uma busca prévia por trás.

Mas isso é algo fácil de resolver: acho que basta alterar o template de exibição do voluntário e colocar um "if parâmetro modo sequencial ativado", daí exibe os botões. A view de exibição do voluntário penso que poderia se manter totalmente inalterada. Só mexer no template mesmo.

Outro detalhe é que o clique nos botões próximo/anterior talvez devesse chamar uma outra view que faria o controle da paginação um a um. Sugestão de url: voluntario/busca/sequencial. Sugestão de view: busca_sequencial_voluntarios. Só que pra funcionar, essa view precisará dos parâmetros de busca, que você deverá passar no clique dos botões. Pode até usar um form com método GET, colocando os parâmetros e seus valores em campos "hidden". A lógica dessa view será praticamente a mesma da busca (mesmo código da view busca_voluntarios ao montar os filtros), ou seja, montando a query com base nos parâmetros, só que você não precisará necessariamente do objeto paginador, podendo fazer você mesmo a paginação um a um utilizando um parâmetro para indicar em que ponto está na sequência e colocando o valor parâmetro no final do queryset sob a forma de array slice: myquery.[pos:pos+1]. Daí essa view pode no fim chamar a view de exibir o voluntário da mesma forma que você fez no código de exemplo.

Muita coisa estou falando de cabeça, talvez tenha algum erro ou imprecisão no que eu falei, ou algum jeito melhor de implementar. Fique à vontade pra interagir...

Diogojlq commented 6 months ago

@regiov o código dentro do else para modo de visualização sequencial da view 'busca_voluntarios' está assim:

       `else: # Sequencial
        if voluntarios:
            voluntario = voluntarios[0]
            context = {'voluntario': voluntario,
                       'voluntarios': voluntarios,
                       'modo_visualizacao': modo_visualizacao}
            template = loader.get_template('vol/exibe_voluntario.html')
            return HttpResponse(template.render(context, request))`

Será que não é possível passar a lista de voluntários, já filtrada pelos parâmetros de busca, diretamente para a view nova(busca_sequencial_voluntarios)? Assim apenas precisaria configurar a paginação um a um ao clicar nos botões, partindo do primeiro voluntário da lista, que já estará sendo exibido. Foi pensando nisso que abarquei 'voluntarios' no context.

Outra coisa, ao exibir o primeiro voluntário da forma que está, os botões ficam 'disabled' por não estar recebendo 'proximo_voluntario' e 'voluntario_anterior', devo enviar esses parâmetros direto da view 'busca_voluntarios' até o primeiro clique que começará usar a view nova ?

regiov commented 6 months ago

@Diogojlq em linhas gerais esse código em busca_voluntarios está correto, sim. Inclusive talvez nem seja necessário criar outra view como sugeri anteriormente. Podemos tentar implementar apenas com o busca_voluntarios e o exibe_voluntario. Veja se faz sentido pra vc:

Mantenha o exibe_voluntario da forma que está, acrescentando apenas um novo parâmetro opcional "seq" ou "sequencia" com valor default nulo. Esse parâmetro é que vai dizer em que lugar na sequência da busca está aquele voluntário, e você vai usar ele apenas no template exibe_voluntario.html para exibir ou não os botões, e para repassar os demais parâmetros de busca.
Os botões próximo e anterior devem usar "seq"-1 e seq+1 respectivamente, podendo apontar para o busca_voluntarios diretamente, mas lembre de construir a query_string (ou form com método GET e parâmetros hidden) com os demais parâmetros de busca vindos de request.
No código que vc mostrou acima, em busca_voluntarios, substitua [0] por [seq]. Neste caso, seq virá dos parâmetros GET no request, e caso não haja esse parâmetro, adote 0 como default.
Além disso, ao invés de renderizar o template exibe_voluntario.html, chame a função exibe_voluntario, passando request, id do voluntário e seq como parâmetros.
Melhor não exibir os botões próximo/anterior se não estivermos em modo sequencial.

Talvez funcione assim...

Diogojlq commented 6 months ago

@regiov no context contido no código do meu último comentário, 'voluntarios' já contém uma lista já filtrada pelos parâmetros de busca, não seria mais eficiente passar essa lista diretamente para a view exibe_voluntario ? Imagino que dessa forma seria necessário apenas iterar por essa lista sem precisar passar os parâmetros de busca para a view.

E também não ficou muito claro o que exatamente deve ser atribuído em "seq", e como substituir o 0 por "seq" e ainda assim indicar o primeiro da lista,

regiov commented 6 months ago

@Diogojlq antes de pensar em eficiência penso mais em tentar separar bem o que cada parte do sistema faz (o que nem sempre é muito fácil), ou seja, deixar que exibe_voluntario se concentre na tarefa de apenas exibir o voluntário, e que busca_voluntario se concentre na tarefa de buscar voluntários - incluindo aí a iteração. Existem alguns detalhes sutis nisso tudo. Por exemplo, no código original que você compartilhou, o busca_voluntarios faz uso direto do template exibe_voluntario.html. Sempre que precisarmos exibir um voluntário, acho melhor chamar a função exibe_voluntario, pois pode ser que exista (ou venha a existir) alguma coisa a mais a ser feita e que pode ficar lá na função (exemplo: contabilizar alguma estatística, fazer alguma verificação de permissão, etc). Melhor deixar tudo isso encapsulado num só lugar. Inclusive se algum dia quisermos trocar o nome do template, é só trocar naquele único lugar.

A ideia desse parâmetro (seq) é indicar em que ponto estamos na iteração: 0, 1, 2, 3, 4... e de quebra indicar que estamos em modo de busca sequencial (se seq for nulo, não estamos em busca sequencial). Pensando bem, talvez seja necessário mais um parâmetro, pois ao exibir um voluntário vamos precisar saber:

Se estamos em modo sequencial, para exibir ou não os botões, repassando os parâmetros da busca
Se existe ou não voluntário anterior (dá pra fazer apenas com o seq, fazendo if seq > 0)
Se existe ou não um próximo voluntário

Nesse último caso acho que valeria a pena também especificar o tamanho da lista com outro parâmetro adicional. Algo do tipo:

def exibe_voluntario(request, id_voluntario, modo_seq_posicao_atual=None, modo_seq_tamanho_lista=None):

Acho que aí sim teríamos tudo: exibe_voluntario já recebe o request, que tem todos os parâmetros da busca, já recebe o id do voluntário a ser exibido, e agora passaria a receber esses outros dois parâmetros para controlar a exibição dos botões. Daria inclusive pra exibir algo do tipo: registro 5 de 30 [anterior] [próximo].

Mas se quiser tentar de outro jeito, não tem problema. Sempre tem várias formas de fazer a mesma coisa. Só não vejo muito como fugir de propagar os parâmetros GET da busca entre as requisições, para a partir deles montar os filtros, reconstruir a query voluntarios e fazer as próximas iterações.

Diogojlq commented 5 months ago

Boa noite @regiov, estou tentando usar as sessions do Django para passar a lista entre views, da seguinte forma:

     `else: # Sequencial
        if voluntarios:
            id_voluntario = str(voluntarios[0].pk)
            lista_voluntarios = list(voluntarios.values())
            voluntarios_json = json.dumps(lista_voluntarios, cls=DjangoJSONEncoder)
            request.session['voluntarios'] = voluntarios_json
            modo_seq_posicao_atual = 1
            modo_seq_tamanho_lista = len(voluntarios)
            return exibe_voluntario(request,id_voluntario, modo_seq_posicao_atual, modo_seq_tamanho_lista)`

Gostaria de saber: há algum problema nessa abordagem?