MapEFI Platform

1. Pitch de Elevador

Uma plataforma full-stack orientada a produto, combinando um backend robusto em Java/Spring com um frontend moderno em Next.js, para sustentar evolução contínua com governança técnica.

2. Problema e Contexto

O projeto exigia uma base arquitetural forte para evoluir funcionalidades de forma previsível, preservando qualidade de código e alinhamento entre frontend, backend e regras de domínio.

3. Escopo e Atuação

• Estruturação arquitetural.
• Definição de stack e diretrizes técnicas.
• Organização da documentação funcional e técnica (ADRs, documentos de análise, guidelines).

4. Solução Implementada

Uma implementação em camadas, com separação clara de responsabilidades e documentação viva para sustentar decisões técnicas de médio e longo prazo.

5. Stack e Arquitetura

• Backend: Java 25, Spring Boot 3.5, JPA, Validation, Security, OpenAPI, Liquibase.
• Frontend: Next.js 15 (App Router), React 19, TypeScript, Mantine.
• Dados: estratégia de PostgreSQL documentada via ADRs/guidelines.
• Arquitetura: Clean Architecture, API REST, modelo de erro Problem Details.

6. Qualidade e Práticas de Engenharia

• ADRs cobrindo stack, arquitetura e estratégia de testes.
• Guidelines de backend/frontend/segurança/banco de dados.
• Base preparada para desenvolvimento e testes padronizados.

7. Relevância para o Portfólio

Um caso forte de nível sênior para liderança de arquitetura, tomada de decisão técnica e execução disciplinada de projeto full-stack.

8. Links

• GitHub: https://github.com/josenaldo/mapefi
• Produção: nenhuma URL de produção pública declarada no repositório.
• Referência técnica (ADR de frontend): https://github.com/josenaldo/mapefi/blob/master/docs/adrs/0009-frontend-nextjs15-app-router.md

9. Evidência Visual