O DoeTech uma plataforma que visa criar uma interface entre empresas e pessoas fsicas, interessadas em doar equipamentos eletrnicos que seriam descartados, e instituies sociais ou pessoas carentes que desejam receber esse tipo de equipamento. A proposta do DoeTech diminuir a produo de lixo eletrnico enquanto favorece a reutilizao de equipamentos eletrnicos por instituies de cunho social e pessoas de baixa renda.

Graduao em Anlise e Desenvolvimento de Sistemas

Pontifcia Universidade Catlica de Minas Gerais (PUC Minas)

Projeto: Desenvolvimento de uma aplicao interativa

1 semestre de 2025 (2025/2)

Integrantes

• Diovane Marcelino Azevedo (desenvolvimento)
• Felipe Miguel Nery Lunkes (Scrum Master, arquiteto de software, desenvolvimento)
• Joo Paulo Fernandes Salviano (Project Owner, desenvolvimento)
• Vernica Hoffmann Fernandes Adler (UX lead, desenvolvimento)

Orientador

• Bernardo Jeunon de Alencar

Instrues de utilizao

Execuo remota (DoeTech hospedado)

O DoeTech est hospedado no servio Azure, da Microsoft.

Acessar o DoeTech

Para acessar o DoeTech, clique aqui.

Execuo local

Executar a aplicao backend localmente

Para executar a aplicao localmente, voc precisa das seguintes dependncias:

• Docker (Linux) ou Docker Desktop (Windows, caso voc no esteja usando o Docker no WSL);
• JetBrains Rider (Linux e Windows) ou Visual Studio Community 2022 (Windows);
• Postman.

Caso tenha todas as dependncias 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 continer com uma imagem do MySQL e qualquer outra dependncia necessria;

Agora, vamos subir as dependncias, utilizando, no shell ou terminal de sua escolha:

shell docker compose up

Aps, inicie a aplicao em modo Release/http. Uma janela do seu navegador padro deve se abrir, mostrando o status da aplicao (Healthy, Unhealthy). Caso esteja como Unhealthy, alguma dependncia no foi satisfeita. Verifique o log no console.

A aplicao ser iniciada na porta 8080.

:warning: A aplicao automaticamente ir executar as migrations, isto , criar o schema no banco, bem como todas as tabelas. Nenhuma interveno necessria.

Importe o arquivo Postman.json, disponvel dentro do diretrio do projeto (src/DoeTech/Postman.json), no Postman, para acessar a API j implementada.

Lembre-se! Vrios endpoints requerem autenticao via token. Veja em cada request no Postman ou nos controllers da aplicao. Caso alguma requisio no seja autorizada, h grande chance dela exigir um token. Para isso, faa login com um usurio criado por voc. O endpoint de criao de usurio no requer autenticao via token. Lembre-se ainda que endpoints DELETE exigem que o usurio tenha role de administrador.

Instrues para finalizar a aplicao backend

Aps encerrar a execuo pela IDE, basta, no shell usado para executar o comando anterior, usar a combinao Ctrl-C. Caso tenha subido os continers com:

shell docker compose up -d

insira, no shell, no mesmo diretrio do arquivo docker-compose.yml, inserir:

shell docker compose down

Executar a aplicao frontend localmente

Para executar o frontend, voc precisa ter as seguintes dependncias:

• Aplicao backend sendo executada;
• npm. Veja, na pgina do projeto, como instalar o npm em cada sistema operacional suportado;
• ng. Veja, na pgina do projeto, como instalar o ng em cada sistema operacional suportado.

Aps ter as dependncias necessrias instaladas, navegue, no terminal, at src/DoeTech-frontend. seguir, execute, no terminal:

shell npm i ng serve

O comando npm i ir instalar todas as dependncias necessrias para a execuo da aplicao. J o comando ng serve ir iniciar a execuo da aplicao frontend desenvolvida em Angular.

O ng ir fornecer o endereo local para acesso aplicao.

Instrues para finalizar a aplicao frontend

No terminal aberto com a execuo do comando ng serve, pressione a combinao Ctrl-C.

Documentao

1. Documentao de Contexto
2. Especificao do Projeto
3. Metodologia
4. Projeto de Interface
5. Arquitetura da Soluo
6. Template Padro da Aplicao
7. Programao 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. Apresentao do Projeto
13. Referncias

Cdigo

Apresentao