Projeto de Aprendizagem Baseada em Projetos (ABP) — 2º Semestre DSM
Faculdade de Tecnologia de Jacareí (FATEC Jacareí)
Parceiro Acadêmico: UniLaunch · Equipe: DEVassos
O GreenER é uma plataforma web de observabilidade socioambiental e GreenOps projetada para monitorar continuamente aplicações e microsserviços distribuídos em nuvem.
A ferramenta traduz métricas computacionais brutas de infraestrutura (CPU, Memória RAM, Disco e Rede) em indicadores claros e acionáveis de consumo energético (kWh) e pegada de carbono estimada em gramas de CO₂ equivalente (gCO₂e), correlacionando o consumo de hardware com a intensidade de carbono da matriz energética regional onde o serviço está hospedado.
💡 Princípio Central: Software não consome energia diretamente, mas o hardware que o executa sim. O GreenER atua como uma ponte analítica entre infraestrutura de TI e metas corporativas de sustentabilidade e ESG.
| Avatar | Integrante | Função / Papel | GitHub |
|---|---|---|---|
 |
Gabriel Travensolli | Scrum Master / Desenvolvedor Front-end | @travensolli |
 |
Henrique Camargo | Product Owner (PO) | @henriqueptbd-cell |
 |
Andrea Turibio | Desenvolvedora Front-end | @DeaTuribio |
 |
Lucas Amorim | Desenvolvedor Back-end | @LUCASAMR23 |
 |
Vinicius Augusto | Desenvolvedor Back-end | @viniciusaugusto1997 |
- Descoberta Dinâmica de Serviços: Ingestão periódica resiliente via API (
/servicese/metrics), identificando adições, remoções e quedas de microsserviços sem intervenção manual e sem travar a coleta. - Motor de Cálculo Socioambiental: Aplicação rigorosa das equações de Green Software para conversão de recursos em Potência (W), Energia (kWh) e emissões de carbono (gCO₂e) ponderadas pelo fator regional da API de intensidade de carbono.
- Dashboard em Três Níveis de Experiência:
- Nível 1 (Visão Executiva): Indicadores agregados em tempo real (kWh total, gCO₂e acumulado, status dos serviços ativos/indisponíveis) com atualização sem reload.
- Nível 2 (Distribuição e Análise Comparativa): Ranking dos principais emissores e distribuição geográfica de emissões.
- Nível 3 (Investigação Detalhada): Histórico temporal de telemetria por serviço, curvas de carga e variação de potência.
- Simulação de Migração Regional: Estimativa de economia de carbono ao simular a transferência de serviços para regiões com matriz energética mais limpa.
- Mecanismo Global de Exportação: Relatórios executivos em PDF estilizado e exportação de dados brutos em CSV para auditoria e relatórios corporativos de ESG.
- Área Restrita Autenticada: Controle de acesso administrativo seguro com tokens JWT e senhas criptografadas via bcrypt.
O projeto foi construído atendendo rigorosamente aos padrões de qualidade e restrições do edital (RP01 a RP07):
- Front-end: React + TypeScript + Vite + Tailwind CSS
- Back-end: Node.js + TypeScript estruturado em arquitetura modular (Controllers, Services, Repositories)
- Banco de Dados: PostgreSQL nativo utilizando SQL puro parametrizado via driver
pg(100% livre de ORM) - Segurança & Autenticação: JWT (JSON Web Tokens) e bcrypt
- Infraestrutura & Deploy: Docker e Docker Compose com volume persistente para banco de dados
| Sprint | Período / Review | Foco Principal | Entregáveis Chave |
|---|---|---|---|
| Sprint 1 | 19/10/2026 | MVP Operacional, Ingestão, Auth & Docker | Ingestão resiliente, motor de cálculo, persistência SQL puro, Dashboard Nível 1 com KPIs em tempo real, exportação PDF/CSV, Auth JWT e ambiente Docker completo. |
| Sprint 2 | 09/11/2026 | Análises Avançadas, Histórico & Visualização | Consultas temporais agregadas, gráficos de tendências históricas, ranking de eficiência e visualização espacial em mapa de calor/bolhas. |
| Sprint 3 | 23/11/2026 | Comparações, Simulação de Migração & Polimento | Módulo comparativo lado a lado, simulador de migração para regiões limpas, refinamento de relatórios e validação final de carga. |
- Docker e Docker Compose instalados na máquina.
- Git para clonar o repositório.
-
Clone o repositório:
git clone https://github.com/DEVassos/Projeto-GreenER.git cd Projeto-GreenER -
Configure as variáveis de ambiente:
cp .env.example .env
-
Suba todo o ecossistema com um único comando:
docker compose up --build
-
Acesse no navegador:
- Frontend:
http://localhost:5173(ou porta configurada) - Backend API:
http://localhost:3000 - Healthcheck:
http://localhost:3000/health
- Frontend:
Para conferir detalhes aprofundados sobre regras de negócio, modelagem, endpoints e atas, consulte os documentos complementares:
- 📄 Visão do Produto (
docs/visao-do-produto.md) — Personas, fronteira de escopo e metas de produto. - 📐 Raciocínio Técnico & Arquitetura (
docs/abp-2026-2.md) — Algoritmo de reconciliação e integrações. - 📋 Product Backlog Geral (
docs/product-backlog.md) — Épicos, User Stories e critérios de aceitação. - ⏱️ Planejamento da Sprint 1 (
docs/sprints/sprint-1.md) — Detalhamento de tarefas, pontuações e DoD da Sprint 1. - 🔌 Especificação de APIs (
docs/especificacao-api.md) — Contratos e endpoints das APIs externas.