O DoeTech é uma plataforma que visa criar uma interface entre empresas e pessoas físicas, interessadas em doar equipamentos eletrônicos que seriam descartados, e instituições sociais ou pessoas carentes que desejam receber esse tipo de equipamento. A proposta do DoeTech é diminuir a produção de lixo eletrônico enquanto favorece a reutilização de equipamentos eletrônicos por instituições de cunho social e pessoas de baixa renda.
Graduação em Análise e Desenvolvimento de Sistemas
Pontifícia Universidade Católica de Minas Gerais (PUC Minas)
Projeto: Desenvolvimento de uma aplicação interativa
1º semestre de 2025 (2025/2)
- Diovane Marcelino Azevedo (desenvolvimento)
- Felipe Miguel Nery Lunkes (Scrum Master, arquiteto de software, desenvolvimento)
- João Paulo Fernandes Salviano (Project Owner, desenvolvimento)
- Verônica Hoffmann Fernandes Adler (UX lead, desenvolvimento)
- Bernardo Jeunon de Alencar
O DoeTech está hospedado no serviço Azure, da Microsoft.
Para acessar o DoeTech, clique aqui.
Para executar a aplicação localmente, você precisa das seguintes dependências:
- Docker (Linux) ou Docker Desktop (Windows, caso você não esteja usando o Docker no WSL);
- JetBrains Rider (Linux e Windows) ou Visual Studio Community 2022 (Windows);
- Postman.
Caso tenha todas as dependências satisfeitas, siga os passos à seguir:
- Abra o projeto em
src/DoeTech/com sua IDE de escolha; - Localize o arquivo
docker-compose.yml. Ele será utilizado para subir um contêiner com uma imagem do MySQL e qualquer outra dependência necessária;
Agora, vamos subir as dependências, utilizando, no shell ou terminal de sua escolha:
docker compose upApós, inicie a aplicação em modo Release/http. Uma janela do seu navegador padrão deve se abrir, mostrando o status da aplicação (Healthy, Unhealthy). Caso esteja como Unhealthy, alguma dependência não foi satisfeita. Verifique o log no console.
A aplicação será iniciada na porta 8080.
Importe o arquivo Postman.json, disponível dentro do diretório do projeto (src/DoeTech/Postman.json), no Postman, para acessar a API já implementada.
Lembre-se! Vários endpoints requerem autenticação via token. Veja em cada request no Postman ou nos controllers da aplicação. Caso alguma requisição não seja autorizada, há grande chance dela exigir um token. Para isso, faça login com um usuário criado por você. O endpoint de criação de usuário não requer autenticação via token. Lembre-se ainda que endpoints
DELETEexigem que o usuário tenha role de administrador.
Após encerrar a execução pela IDE, basta, no shell usado para executar o comando anterior, usar a combinação Ctrl-C. Caso tenha subido os contêiners com:
docker compose up -dinsira, no shell, no mesmo diretório do arquivo docker-compose.yml, inserir:
docker compose downPara executar o frontend, você precisa ter as seguintes dependências:
- Aplicação backend sendo executada;
- npm. Veja, na página do projeto, como instalar o
npmem cada sistema operacional suportado; - ng. Veja, na página do projeto, como instalar o
ngem cada sistema operacional suportado.
Após ter as dependências necessárias instaladas, navegue, no terminal, até src/DoeTech-frontend. À seguir, execute, no terminal:
npm i
ng serveO comando npm i irá instalar todas as dependências necessárias para a execução da aplicação. Já o comando ng serve irá iniciar a execução da aplicação frontend desenvolvida em Angular.
O ng irá fornecer o endereço local para acesso à aplicação.
No terminal aberto com a execução do comando ng serve, pressione a combinação Ctrl-C.
- Documentação de Contexto
- Especificação do Projeto
- Metodologia
- Projeto de Interface
- Arquitetura da Solução
- Template Padrão da Aplicação
- Programação de Funcionalidades
- Plano de Testes de Software
- Registro de Testes de Software
- Plano de Testes de Usabilidade
- Registro de Testes de Usabilidade
- Apresentação do Projeto
- Referências