DoeTech

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 Móvel em um Ambiente de Negócio

2º semestre de 2025 (2025/2)

• Caio Augusto de Carvalho Rosa (desenvolvimento)
• Diovane Marcelino Azevedo (desenvolvimento)
• Felipe Miguel Nery Lunkes (Scrum Master, arquiteto de software, desenvolvimento)
• João Paulo Fernandes Salviano (Project Owner, desenvolvimento)

• Diego Roberto Gonçalves de Pontes

O DoeTech está hospedado no serviço Azure, da Microsoft.

Você pode utilizar o DoeTech o instalando em seu dispositivo Android, utilizando o APK disponível aqui. Após instalá-lo, crie sua conta e faça login com suas credenciais.

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 up

Apó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.

⚠️ A aplicação automaticamente irá executar as migrations, isto é, criar o schema no banco, bem como todas as tabelas. Nenhuma intervenção é necessária.

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 DELETE exigem 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 -d

insira, no shell, no mesmo diretório do arquivo docker-compose.yml, inserir:

docker compose down

Para executar a aplicação mobile localmente, vocë precisa:

1. Atualizar suas dependências, utilizando:

   npm install

2. Executar a aplicação, utilizando, no terminal:

   npx expo start

3. Executar a aplicação localmente em http://localhost:8081 ou utilizar o Expo Go para executar a aplicação em seu dispositivo Android.

1. Documentação de Contexto
2. Especificação do Projeto
3. Metodologia
4. Projeto de Interface
5. Arquitetura da Solução
6. Template Padrão da Aplicação
7. Programação de Funcionalidades
8. Plano de Testes de Software
9. Registro de Testes de Software
10. Plano de Testes de Usabilidade
11. Registro de Testes de Usabilidade
12. Apresentação do Projeto
13. Referências