TeamPulse 👥

📋 Sobre o Projeto

TeamPulse é uma plataforma completa de gestão de equipes e feedback desenvolvida para otimizar a comunicação e produtividade em ambientes corporativos. O sistema oferece funcionalidades avançadas de gerenciamento de usuários, criação de squads, sistema de feedback estruturado com rascunhos e controle de permissões hierárquicas.

✨ Funcionalidades Principais

👤 Gerenciamento de Usuários

• Sistema de Autenticação - Login seguro com JWT
• Hierarquia de Permissões - Admin, Gerente e Colaborador
• CRUD Completo - Criação, edição e exclusão de usuários
• Filtros por Tipo - Listagem baseada em permissões
• Contadores Dinâmicos - Estatísticas de usuários por tipo

🏢 Sistema de Squads

• Criação de Equipes - Montagem de squads com validação
• Composição Balanceada - Validação de gerentes e colaboradores
• Gerenciamento Flexível - Adição e remoção de membros
• Consultas Especializadas - Por colaborador ou gerente
• Controle de Acesso - Baseado em hierarquia de usuários

💬 Sistema de Feedback Avançado

• Rascunhos de Feedback - Criação e edição antes do envio
• Sistema de Avaliação - Rating de 1 a 5 estrelas
• Status de Controle - DRAFT, SENT para organização
• Histórico Completo - Feedbacks enviados e recebidos
• Permissões Específicas - Gerentes enviam, colaboradores recebem

🔐 Segurança e Controle

• JWT Authentication - Tokens seguros para autenticação
• Validação de Permissões - Controle granular de acesso
• Criptografia de Senhas - BCrypt para proteção de dados
• Validação de Dados - Sanitização e verificação de entrada

📱 Layout da Aplicação

Tela do Administrador (Home)

Tela do Gerente (Home e Feedbacks)

Tela do Colaborador (Home e Feedbacks)

🚀 Tecnologias Utilizadas

Backend

• Java 17 - Linguagem de programação principal
• Spring Boot 3.0 - Framework para aplicações Java
• Spring Security - Segurança e autenticação
• Spring Data JPA - Persistência de dados
• JWT (JSON Web Tokens) - Sistema de autenticação stateless
• Lombok - Redução de boilerplate code
• Bean Validation - Validação de dados

Frontend

• HTML5 - Estruturação semântica das páginas
• CSS3 - Estilização e layout
• JavaScript - Interatividade e lógica client-side
• Bootstrap 5 - Framework CSS responsivo
• Font Awesome - Ícones e elementos visuais

Banco de Dados

• PostgreSQL - Banco de dados relacional principal
• H2 Database - Banco em memória para testes
• Flyway - Controle de versão do banco de dados

🏗️ Arquitetura do Sistema

Estrutura de Controllers

AuthController

• POST /auth/login - Autenticação de usuários
• POST /auth/register - Registro de gerentes e colaboradores
• POST /auth/register/admin - Registro exclusivo de administradores

UserController

• GET /user/list - Listagem de usuários com filtros
• GET /user/count - Contadores por tipo de usuário
• PUT /user/edit/{userId} - Edição de dados do usuário
• DELETE /user/delete/{userId} - Exclusão de usuários

SquadController

• POST /squads - Criação de novas squads
• PUT /squads/edit/{squadId} - Atualização de squads
• DELETE /squads/{squadId} - Exclusão de squads
• GET /squads - Listagem completa (gerentes)
• GET /squads/colaborador/{userId} - Squads de colaborador
• GET /squads/gerente/{userId} - Squads de gerente

FeedbackController

• POST /feedback/draft - Criação de rascunhos
• PUT /feedback/draft/{feedbackId} - Edição de rascunhos
• DELETE /feedback/draft/{feedbackId} - Exclusão de rascunhos
• POST /feedback/send - Envio de feedback
• GET /feedback/drafts - Rascunhos do usuário
• GET /feedback/received - Feedbacks recebidos
• GET /feedback/sent - Feedbacks enviados

📱 Interface do Usuário

Funcionalidades Frontend

• Dashboard interativo com estatísticas
• Formulários validados com feedback visual
• Tabelas dinâmicas com paginação
• Modais responsivos para ações rápidas
• Notificações toast para feedback do usuário

Modelo de Dados

Entidades Principais

-- Usuários
User {
  id: String (UUID)
  username: String (3-50 chars)
  email: String (unique, 100 chars)
  password: String (encrypted)
  userType: ADMIN | GERENTE | COLABORADOR
}

-- Squads
Squad {
  id: String (UUID)
  name: String (unique)
  createdAt: LocalDateTime
  members: List<User>
}

-- Feedbacks
Feedback {
  id: String (UUID)
  comment: String
  rating: Integer (1-5)
  status: DRAFT | SENT
  createdAt: LocalDateTime
  sentAt: LocalDateTime
  user: User (receptor)
  author: User (autor)
}

📦 Como Executar o Projeto

Pré-requisitos

• Java 17 ou superior
• Maven 3.6+
• PostgreSQL 12+ (ou H2 para desenvolvimento)
• Git

Configuração do Ambiente

1. Clone o Repositório

git clone https://github.com/usuario/teampulse
cd teampulse

2. Configuração do Banco de Dados

# application.properties
spring.datasource.url=jdbc:postgresql://localhost:5432/teampulse
spring.datasource.username=seu_usuario
spring.datasource.password=sua_senha

# JWT Configuration
jwt.secret=sua_chave_secreta_jwt
jwt.expiration=86400000

3. Instalação e Execução

# Instalar dependências
mvn clean install

# Executar aplicação
mvn spring-boot:run

# Ou gerar JAR e executar
mvn package
java -jar target/teampulse-1.0.0.jar

4. Acesso à Aplicação

• Backend API: http://localhost:8080
• Frontend: http://localhost:8080 (servido pelo Spring Boot)

📄 Licença

Este projeto está sob licença MIT. Veja o arquivo LICENSE para mais detalhes.

👨‍💻 Autores

Júlio Guimarães e Sérgio Adriani

• GitHub: @ocesar9,@Userkarf
• LinkedIn: Júlio Guimarães, Sérgio Adriani,

---

⭐ Se este projeto te ajudou, deixe uma estrela no repositório!