renatosnt/matchservice

Trabalho Prático de PDS

Agendamento de Serviços Locais.

Membros

• Bruna Caroline Cardoso da Silva - 2021049404 - Fullstack
• Gabriel Teixeira - 2020054420 - Fullstack
• Michel Barros da Fonseca - 2020006906 - Fullstack
• Renato Santos - 2020006981 - Fullstack

Escopo

Objetivo do Sistema

Desenvolver uma plataforma que conecte usuários a prestadores de serviços locais de diversas categorias, permitindo agendar serviços de maneira eficiente, segura e confiável. O sistema visa facilitar o acesso a serviços essenciais, melhorar a gestão de agenda dos prestadores e proporcionar uma experiência de usuário que incentive a fidelização e o uso recorrente da plataforma.

Principais Features

Para Usuários (Clientes):

Cadastro e Login: Perfis personalizados com autenticação segura.

Busca de Serviços: Busca avançada por categoria, localização, avaliação e disponibilidade.

Agendamento Online: Interface intuitiva para agendar serviços com base na disponibilidade do prestador.

Pagamentos Integrados: Sistema de pagamento seguro para realizar pagamentos online.

Avaliações e Comentários: Após a conclusão do serviço, os usuários podem avaliar os prestadores e deixar comentários.

Histórico de Serviços: Acesso fácil a histórico de agendamentos e serviços contratados.

Para Prestadores de Serviços:

Perfil do Prestador: Páginas de perfil com detalhes sobre os serviços oferecidos, preços, localização, horários disponíveis e avaliações.

Gerenciamento de Agenda: Ferramentas para gerenciar horários de trabalho, disponibilidade para agendamentos e acompanhamento de compromissos.

Recebimento de Pagamentos: Integração com sistemas de pagamento para recebimento direto na plataforma.

Notificações: Alertas sobre novos agendamentos, mudanças de horário, e avaliações recebidas.

Tecnologias

Backend

• Node.js
• PostgreSQL

Frontend

• React + TypeScript

Docker

Como rodar:

• Para iniciar: execute docker compose up -d na raiz do projeto
• Para parar: execute docker stop matchservice-frontend-1 matchservice-backend-1 matchservice-db-1
• Para atualizar a imagem: execute docker compose up -d --build na raiz do projeto
• Para deletar o container e o banco de dados: execute docker rm matchservice-frontend-1 matchservice-backend-1 matchservice-db-1

Arquitetura Hexagonal

A arquitetura hexagonal do sistema backend consiste em:

• Domínio: O diretório backend/domain contém as entidades do sistema, que representam os conceitos do domínio do negócio. São as classes User, Service, Scheduling, ServiceProviderProfile.
• Portas: O diretório backend/domain/ports contém as interfaces de comunicação que definem como as entidades podem ser acessadas e manipuladas. São as interfaces IUserPort, IServicePort, ISchedulingPort, IServiceProviderProfilePort.
• Adaptadores: O diretório backend/adapters contém as implementações concretas das interfaces de comunicação. São as classes UserAdapter, ServiceAdapter, SchedulingAdapter, ServiceProviderProfileAdapter
• Aplicação: O diretório backend/application contém a lógica de aplicação do sistema, que é responsável por gerenciar as requisições e respostas do sistema. É aqui que está implementado a API do Express para comunicação externa.
• Infraestrutura: O diretório backend/infrastructure contém as implementações concretas das tecnologias específicas do sistema, como bancos de dados, APIs, etc. É aqui que a implementação da conexão com o Prisma e o PostgreSQL foi feita.

Backlog do Produto

• Como usuário gostaria de criar e acessar uma conta no sistema.
• Como cliente gostaria de visualizar os serviços disponíveis.
• Como prestador de serviço gostaria de anunciar meus serviços no meu perfil.
• Como cliente gostaria de filtrar os serviços disponíveis baseado em vários critérios.
• Como cliente gostaria de ver mais informações sobre o prestador de algum serviço.
• Como cliente gostaria de visualizar o número de telefone de um prestador de serviço para entrar em contato.
• Como prestador de serviço gostaria de ver o número de vezes que algum serviço meu foi visto por clientes.
• Como prestador de serviço gostaria de deletar serviços do meu perfil.
• Como cliente gostaria de ver o meu histórico de serviços visitados/solicitados.
• Como prestador de serviço gostaria de ver os meus serviços do ponto de vista de um cliente.
• Como prestador de serviço gostaria de disponibilizar meu calendário de dias disponíveis para os clientes.
• Como cliente gostaria de agendar o serviço na data especificada do prestador de serviço.
• Como cliente gostaria de ver os serviços que agendei com diversos prestadores de serviço.
• Como prestador de serviço gostaria de ver os meus serviços que foram agendados.
• Como prestador de serviço gostaria de cancelar os serviços agendados por quaisquer motivos.

Backlog do Sprint

História 1: Como usuário, gostaria de criar e acessar uma conta no sistema.

• Criar e estruturar a base de dados para armazenar usuários (Michel)
• Implementar a lógica de autenticação e criação de contas (Michel)
• Criar a interface de login e cadastro (Bruna)

História 2: Como cliente, gostaria de visualizar os serviços disponíveis.

• Modelar e criar tabela para serviços, bem como implementar a sua relação com a tabela de prestadores de Serviço (Gabriel)
• Criar a interface de listagem de serviços. (Bruna)
• Integrar a interface de listagem com a API de serviços (Michel)

História 3: Como prestador de serviço, gostaria de anunciar meus serviços no meu perfil.

• Criar rotas para a adição, edição e remoção de serviços. (Michel)
• Incluir campos no banco de dados como nome, descrição, preço e fotos. (Gabriel)
• Adicionar modal com a confirmação de que as alterações foram salvas. (Renato)

História 4: Como cliente, gostaria de ver mais informações sobre o prestador de algum serviço.

• Criar página de perfil do prestador de serviços e seus serviços oferecidos. (Renato)
• Criar estrutura de avaliações e comentários de trabalhos anteriores do prestador. (Michel)

História 5: Como cliente, gostaria de filtrar os serviços disponíveis baseado em vários critérios.

• Implementar a lógica de busca de serviços. (Bruna)
• Implementar filtros por categoria de serviço. (Michel)
• Implementar filtros por localização do prestador de serviço. (Renato)
• Implementar filtros por avaliação do prestador de serviço. (Renato)
• Implementar filtros por horário de funcionamento do prestador. (Renato)

História 6: Como cliente, gostaria de visualizar o número de telefone de um prestador de serviço para entrar em contato.

• Exibir nas interfaces de um serviço e de perfil de um prestador, informações de contato claras para comunicação direta. (Gabriel)

História 7: Como prestador de serviço, gostaria de deletar serviços do meu perfil.

• Implementar rota de DELETE para serviços na API. (Michel)
• Implementar validação da rota de DELETE (apenas o prestador de serviço criador de serviço X deve poder deletá-lo). (Michel)
• Criar um botão de delete, que deve ser exibido a um prestador de serviço, para cada um de seus serviços, quando acessar seu próprio perfil. (Gabriel)
• Implementar modal de confirmação de remoção do serviço. (Gabriel)
• Implementar tela/modal/pop-up de confirmação de remoção com sucesso. (Gabriel)

História 8: Como prestador de serviço, gostaria de disponibilizar meu calendário de dias disponíveis para os clientes.

• Fornecer, no momento de criação de um serviço, a possibilidade de estabelecer datas de disponibilidade de serviço. (Bruna)
• Exibir, em cada serviço, seus dias disponíveis. (Bruna)
• Viabilizar a alteração da data de disponibilidade de um serviço, por parte do prestador de serviço. (Bruna)

Backlog do Sprint (nova versão)

História 1: Como usuário, gostaria de criar e acessar uma conta no sistema.

• Criar e estruturar a base de dados para armazenar usuários (Michel)
• Implementar a lógica de autenticação e criação de contas (Michel)
• Criar rotas para a adição, edição e remoção de usuários. (Michel / Gabriel)
• Criar a interface de login e cadastro (Bruna)
• Integrar o cadastro com o back-end e implementar os diferentes tipos de cadastros para Cliente e Prestador de Serviço (Renato)
• Integrar o login com o back-end (Bruna)
• Criação da primeira versão da estrutura do projeto e adicionado primeiras ferramentas de desenvolvimento(Bruna)
• Adicionar Eslint ao projeto que permite definir regras que devem ser seguidas no código (Bruna)
• Criar arquivo routes para interface frontend (Bruna)
• Integrar axios ao frontend (Bruna)

História 2: Como cliente, gostaria de visualizar os serviços disponíveis.

• Modelar e criar tabela para serviços, bem como implementar a sua relação com a tabela de prestadores de Serviço (Gabriel)
• Criar a interface de listagem de serviços. (Renato)
• Integrar a interface de listagem com a API de serviços (Renato)
• Criar Header para ser exibido na pagina home e serviços (Bruna)

História 3: Como prestador de serviço, gostaria de anunciar meus serviços no meu perfil.

• Criar rotas para a adição, edição e remoção de serviços. (Michel / Gabriel)
• Incluir campos no banco de dados como nome, descrição, preço e fotos. (Gabriel)
• Criar e integrar com a API a interface para anunciar serviços (Renato)
• Adicionar modal com a confirmação de que as alterações foram salvas. (Renato)

História 4: Como cliente, gostaria de ver mais informações sobre o prestador de algum serviço.

• Criar e integrar página de perfil do cliente. (Renato)
• Criar estrutura de avaliações e comentários de trabalhos anteriores do prestador na API. (Michel)
• Criar e integrar Modal interface que mostra mais detalhes sobre um serviço, junto com modal para confirmar um agendamento (Renato)
• Criar interface da Agenda e avaliação dos serviços (Renato)

História 5: Como cliente, gostaria de filtrar os serviços disponíveis baseado em vários critérios.

• Implementar a lógica de busca de serviços. (Bruna)
• Implementar filtros por categoria de serviço. (Michel)
• Implementar filtros por localização do prestador de serviço. (Renato)

História 6: Como cliente, gostaria de visualizar o número de telefone de um prestador de serviço para entrar em contato.

• Exibir nas interfaces de um serviço e de perfil de um prestador, informações de contato claras para comunicação direta. (Gabriel)

História 7: Como prestador de serviço, gostaria de deletar serviços do meu perfil.

• Implementar rota de DELETE para serviços na API. (Michel / Gabriel)
• Implementar validação da rota de DELETE (apenas o prestador de serviço criador de serviço X deve poder deletá-lo). (Michel)
• Criar um botão de delete, que deve ser exibido a um prestador de serviço, para cada um de seus serviços, quando acessar seu próprio perfil. (Gabriel)
• Implementar modal de confirmação de remoção do serviço. (Gabriel)
• Implementar tela/modal/pop-up de confirmação de remoção com sucesso. (Gabriel)

História 8: Como prestador de serviço, gostaria de disponibilizar meu calendário de dias disponíveis para os clientes.

• Fornecer, no momento de criação de um serviço, a possibilidade de estabelecer datas de disponibilidade de serviço. (Bruna)
• Exibir, em cada serviço, seus dias disponíveis. (Bruna)
• Viabilizar a alteração da data de disponibilidade de um serviço, por parte do prestador de serviço. (Bruna)

História 9: Como cliente, gostaria de poder agendar serviços de prestadores

• Criar rotas para criação, edição e recuperação de dados de agendamentos (Gabriel)