Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/viniciusrbr/the-wild-oasis

App interno para gerenciar tudo sobre um hotel: reservas, cabines e hóspedes. Conta com Dashboard que exibe as informações mais importantes dos últimos 7, 30 ou 90 dias.
https://github.com/viniciusrbr/the-wild-oasis

react reacthookform styled-components tanstack-react-query

Last synced: about 2 months ago
JSON representation

App interno para gerenciar tudo sobre um hotel: reservas, cabines e hóspedes. Conta com Dashboard que exibe as informações mais importantes dos últimos 7, 30 ou 90 dias.

Awesome Lists containing this project

README

        

# The Wild Oasis 🏨

![dashboard-tela-inicial](previa.png)

🙋🏻‍♀️ Contextualização


  • “The Wild Oasis” é um pequeno hotel boutique com 8 luxuosas cabanas de madeira.

  • Eles precisam de um aplicativo personalizado para gerenciar tudo sobre o hotel: reservas, cabines e
    hóspedes.


  • Este é o aplicativo interno usado dentro do hotel para fazer check-in dos hóspedes
    assim que eles chegarem.

  • Eles não têm nada agora, então também precisam de uma API.


  • Mais tarde, eles provavelmente vão querer um website de atendimento voltado para os clientes
    também, onde eles poderão reservar estadias, usando a mesma API.

🛠️ Tecnologias Utilizadas


  • React

  • React Router

  • Styled Components

  • React Query

  • Context API

  • React Hook Form

  • Outros: Supabase, recharts, date-fns, react icons, etc...

❗ATENÇÃO❗


➡️ Se você deseja testar o projeto é preciso ter uma conta criada para acessar a plataforma. Se essa for a sua vontade, envie um email para [email protected] solicitando um login e senha. 😉

🎯 Requisitos:



Categoria
Requisitos




Autenticação


  1. ✅Os usuários do aplicativo são funcionários do hotel. Eles precisam estar logados no aplicativo
    para realizar tarefas.

  2. ✅Novos usuários só podem ser cadastrados dentro dos aplicativos (para garantir que apenas
    funcionários reais do hotel possam obter contas).

  3. ✅Os usuários devem poder fazer upload de um avatar e alterar seu nome e senha.





Cabines


  1. ✅O aplicativo precisa de uma tabela com todas as cabines, mostrando a foto da cabine, nome,
    capacidade, preço e desconto atual.

  2. ✅Os usuários devem poder atualizar ou excluir uma cabine e criar novas cabines (incluindo o
    upload de uma foto).





Reservas


  1. ✅O aplicativo precisa de uma tabela com todas as reservas, mostrando datas de chegada e saída,
    status e valor pago, bem como dados da cabine e dos hóspedes.

  2. ✅O status da reserva pode ser “não confirmado” (reservada mas ainda não com check-in), “check-in”
    ou “check-out”. A tabela deve ser filtrável por este importante status.

  3. ✅Outros dados de reserva incluem: número de hóspedes, número de noites, observações dos hóspedes,
    se reservaram o pequeno-almoço, preço do pequeno-almoço.





Check-in / Out


  1. ✅Os usuários devem poder excluir, fazer check-in ou check-out de uma reserva assim que o hóspede
    chegar (sem necessidade de edição por enquanto).

  2. ✅As reservas podem ainda não ter sido pagas na chegada do hóspede. Portanto, no check in, o
    usuário precisa aceitar o pagamento (fora do app), e em seguida, confirme se o pagamento foi
    recebido (dentro do aplicativo).

  3. ✅No momento do check in, o hóspede deverá ter a possibilidade de adicionar café da manhã para
    toda a estadia, caso ainda não o tenha feito.





hóspedes


  1. ✅Os dados do hóspede devem conter: nome completo, e-mail, documento de identidade nacional,
    nacionalidade e bandeira do país para fácil identificação.





Dashboard


  1. ✅A tela inicial do aplicativo deve ser um painel, para exibir informações importantes dos últimos
    7, 30 ou 90 dias:


    1. ✅Uma lista de hóspedes que farão check-in e check-out no dia atual. Os usuários devem ser
      capazes de realizar essas tarefas aqui.

    2. ✅Estatísticas sobre reservas recentes, vendas, check-ins e taxa de ocupação.

    3. ✅Um gráfico que mostra todas as vendas diárias do hotel, mostrando tanto as vendas “totais”
      como as vendas “extras” (apenas café da manhã no momento).

    4. ✅Um gráfico que mostra estatísticas sobre a duração da estadia, pois esta é uma métrica
      importante para o hotel.






Configurações


  1. ✅Os usuários devem ser capazes de definir algumas configurações em todo o aplicativo: preço do
    café da manhã, mínimo e máximo de noites/reserva, máximo de hóspedes/reserva.





Outros


  1. ✅O aplicativo precisa de um modo escuro.