Relatório de estágio

Abstract

Este relatório descreve o estágio realizado na Softinsa, integrado numa equipa de mais de 10 estagiários no desenvolvimento de um sistema CMMS (Computerized Maintenance Management System) com arquitetura de microsserviços. O projeto seguiu a metodologia Scrum, dividido em sprints de uma a duas semanas. Os principais objetivos incluíram a implementação de autenticação segura com tokens JWT, gestão de ativos, ciclo de ordens de trabalho, dashboard com KPIs, documentação interativa da API (Swagger UI) e migrações versionadas da base de dados (Flyway), tudo orquestrado com Docker. O estágio começou no frontend (React, TypeScript, Tailwind CSS), onde fui responsável pela gestão de tokens e proteção de rotas. Após o Segundo sprint, mudei para o backend (Java, Spring Boot 3.4), onde especifiquei e implementei endpoints (criação de assets, lista dropdown, perfil de utilizador), criei scripts Flyway para templates de e-mail de reposição de palavra-passe, expus Swagger UI interativo em múltiplos microsserviços e reduzi a dívida técnica com SonarQube (cobertura de testes de 90%, duplicação 0%). Foram concluídas 25 user stories. Enfrentei desafios como falta de experiência inicial em React/Spring Boot, ambiente ruidoso e uma semana de indisponibilidade dos servidores, superados com estudo autónomo, apoio da equipa e planeamento de contingência. O projeto atingiu o MVP e foi apresentado a outras equipas da Softinsa com feedback positivo. O estágio consolidou competências técnicas e profissionais relevantes para o mercado de trabalho.

Abstract: This report describes the internship carried out at Softinsa, integrated into a team of more than ten interns developing a CMMS (Computerized Maintenance Management System) with a microservices architecture. The project followed a Scrum methodology, divided into one to two-week sprints. The main objectives included implementing secure authentication with JWT tokens, asset management, work order lifecycle, KPI dashboard, interactive API documentation (Swagger UI), and versioned database migrations (Flyway), all orchestrated with Docker. The internship started on the Frontend (React, TypeScript, Tailwind CSS), where I was responsible for token management and route protection. After the second sprint, I moved to the Backend (Java, Spring Boot 3.4), where I specified and implemented endpoints (asset creation, dropdown list, user profile), created Flyway scripts for password reset e-mail templates, exposed interactive Swagger UI across multiple microservices, and reduced technical debt using SonarQube (90% test coverage, 0% duplication). A total of 25 user stories were completed. I faced challenges such as lack of initial experience in React/Spring Boot, noisy environment, and a one-week server outage, overcome through self-study, team support, and contingency planning. The project achieved its MVP and was presented to other Softinsa teams with positive feedback. The internship consolidated relevant technical and professional skills for the job market.