Criar página de listagem de expedições

[LuizGustavoNascimeto]

Listagem de expedições

Visão geral

Construir a tela de listagem de expedições, que será a página inicial do módulo.

A tela deve apresentar, na mesma página, duas listagens:

• Expedições que já aconteceram;
• Próximas expedições.

A separação entre as duas deve ser visualmente clara, ficando a solução de UI a critério do desenvolvimento.

Listagem

A apresentação deve ser feita em cards.

Cada card deve apresentar:

• Data de início;
• Data de fim, quando houver;
• Destino;
• Descrição;
• Quantidade de participantes.

Caso o desenvolvimento identifique que cards não estão alinhados à estética do restante do app, pode ser utilizada uma lista convencional.

A ordenação deve considerar data_inicio:

• Próximas expedições: crescente;
• Expedições realizadas: decrescente.

Ao clicar no card, acessar:

/expedicoes/detalhes/[id]

Cada item deve possuir a ação de excluir.

A ação de editar deve ser exibida, mas sua implementação não faz parte desta task.

Filtros

A tela deve possuir filtros, seguindo o padrão das demais listagens do HCF.

Devem ser contemplados os filtros relevantes para expedições, principalmente:

• Período de início;
• Período de fim;
• Destino.

Filtros de data devem utilizar datepicker.

Paginação

Utilizar paginação tradicional.

• Padrão: 20 itens por página;
• Permitir alteração da quantidade de itens por página;
• Seguir o comportamento utilizado nas listagens existentes, especialmente a de Tombos.

Estados

Implementar os estados necessários da listagem seguindo o padrão já existente no HCF, tendo a listagem de Tombos como referência:

• Loading;
• Lista vazia;
• Nenhum resultado após filtros;
• Erro;
• Feedback das ações de exclusão.

API

A API de expedições ainda está em construção.

Para contrato da API, campos disponíveis, filtros, paginação e demais dúvidas relacionadas ao backend, alinhar com Eduardo Tyio.

Não definir contrato de API no frontend antes desse alinhamento.

Fora de escopo

• Backend;
• App Mobile;
• Implementação da edição de expedições.

Critérios de aceite

• A página apresenta as listagens de expedições realizadas e próximas expedições.
• É visualmente claro em qual das duas categorias cada expedição se encontra.
• As expedições são exibidas em cards com data de início, data de fim quando disponível, destino, descrição e quantidade de participantes.
• Próximas expedições são ordenadas pela data_inicio mais próxima.
• Expedições realizadas são ordenadas pela data_inicio mais recente.
• É possível acessar /expedicoes/detalhes/[id] através do card.
• Cada expedição possui ação de exclusão.
• A ação de editar é exibida, mas não precisa ser implementada.
• A tela possui filtros, botão Pesquisar e opção para limpar filtros.
• Filtros de data utilizam datepicker.
• A listagem permite alterar a quantidade de itens por página.
• Loading, empty state, erros e feedbacks seguem o comportamento já utilizado nas listagens existentes do HCF.
• O contrato da API utilizado na tela foi alinhado com a equipe do back.