🎤 Artist Showcase API

API REST desenvolvida com Java 17 + Spring Boot 3 para gerenciamento do portfólio da cantora Isa Tavares. Agenda de shows, repertório, vídeos e contato.

---

🌐 Produção

Backend em produção no Render — infrastructure as code com deploy automático via GitHub Actions.

	Link
🚀 API	artist-showcase-api.onrender.com
📄 Swagger	Documentação interativa

---

📌 Sobre o projeto

Este projeto consiste em uma API REST completa que serve como backend para o portfólio digital da cantora Isa. A aplicação permite que o público visualize informações da artista, consulte a agenda de shows, o repertório musical e entre em contato — enquanto o admin gerencia tudo via painel protegido com autenticação JWT.

📋 Kanban

🗂️ Acompanhe o progresso: Kanban - artist-showcase

⚠️ Projeto em desenvolvimento ativo. Novas funcionalidades serão adicionadas a cada fase.

---

⚙️ Funcionalidades

Públicas

• ✅ Visualizar perfil da artista
• ✅ Listar e buscar músicas do repertório (filtro por gênero e título)
• ✅ Listar vídeos do YouTube com thumbnail e embed gerados automaticamente
• ✅ Consultar datas indisponíveis na agenda
• ✅ Solicitar agendamento de show com validação de conflito de horário
• ✅ Enviar mensagem de contato (rate limiting — 3 mensagens/hora por IP)

Admin (requer autenticação JWT)

• ✅ Gerenciar perfil da artista
• ✅ CRUD completo de músicas
• ✅ CRUD completo de vídeos
• ✅ Gerenciar agendamentos (confirmar / cancelar)
• ✅ Visualizar mensagens de contato recebidas

---

🛠️ Tecnologias utilizadas

Tecnologia	Uso no projeto
Java 17	Linguagem principal
Spring Boot 3.3.x	Configuração e execução da aplicação
Spring Web MVC	Endpoints REST
Spring Data JPA / Hibernate	Persistência e consultas
Spring Security + JWT	Autenticação e autorização
Spring Cache + Redis	Cache de endpoints de leitura
Spring Mail	Envio de e-mails via SMTP
Jakarta Validation	Validação dos dados de entrada
PostgreSQL	Banco de dados relacional
Lombok	Redução de código repetitivo nas entidades
Gradle	Dependências, build e execução
Docker + docker-compose	Containerização dos serviços
GitHub Actions	CI/CD automatizado
Swagger / OpenAPI 3	Documentação interativa da API

---

🧱 Arquitetura do projeto

O projeto segue uma arquitetura em camadas:

flowchart LR
    Client["Cliente HTTP"] --> Security["Spring Security / JWT"]
    Security --> Controller["Controllers REST"]
    Controller --> Service["Services / regras de negócio"]
    Service --> Cache["Redis Cache"]
    Service --> Repository["Repositories Spring Data JPA"]
    Repository --> DB[("PostgreSQL")]
    DTO["DTOs + Bean Validation"] --> Controller
    Mail["Spring Mail / SMTP"] --> Service

O fluxo de uma requisição passa pelo filtro de segurança JWT, pelas regras de negócio no service e pela camada de persistência. Endpoints de leitura frequente são cacheados no Redis. Os DTOs definem os contratos de entrada e saída da API.

---

📈 Evolução do projeto

• #1 Setup inicial do projeto
• #2 Módulo de perfil da artista
• #3 Migração para PostgreSQL com Docker
• #4 Módulo de repertório musical
• #5 Módulo de vídeos com integração YouTube
• #6 Módulo de agenda com validação de conflitos
• #7 Módulo de contato com e-mail e rate limiting
• #8 Autenticação JWT e proteção de rotas admin
• #9 Documentação Swagger, testes e logs estruturados
• #10 Cache Redis e Docker completo
• #11 Pipeline de CD e deploy no Render

---

▶️ Como executar o projeto

Pré-requisitos

• Java 17+
• Docker + docker-compose

1. Clonar o repositório

git clone https://github.com/willfelixd/artist-showcase-api.git

2. Entrar na pasta

cd artist-showcase-api

3. Configurar variáveis de ambiente

cp src/main/resources/application-dev.properties.example \
   src/main/resources/application-dev.properties

# Edite o arquivo com suas credenciais locais

4. Subir PostgreSQL e Redis

docker compose up postgres redis -d

5. Rodar a aplicação

• Opção A — rodar via IntelliJ/Gradle (desenvolvimento normal)

docker compose up postgres redis -d   # só banco e Redis
./gradlew bootRun                     # backend pelo Gradle

• Opção B — rodar tudo containerizado

docker compose up --build             # tudo via Docker, NÃO roda ./gradlew bootRun junto

# Sempre escolha um dos dois para rodar, nunca os dois ao mesmo tempo

A aplicação sobe em http://localhost:8080

O admin padrão é criado automaticamente no primeiro boot:

• Usuário: admin
• Senha: definida em application-dev.properties

6. Documentação da API

Após subir a aplicação, acesse: http://localhost:8080/swagger-ui/index.html

---

🔐 Segurança

Gere um JWT_SECRET seguro com:

openssl rand -base64 64

Gere um ADMIN_PASSWORD seguro com:

openssl rand -base64 16

MAIL_PASSWORD: App password do Gmail em — Gerenciar sua Conta do Google → Segurança → Senhas de app

⚠️ Nunca commite credenciais reais. Os arquivos application-dev.properties e .env estão no .gitignore.

---

🔀 Fluxo de desenvolvimento

Este projeto segue o GitHub Flow adaptado com branch de desenvolvimento:

main (protegida — só via PR de release)
└── develop (branch principal de trabalho)
    └── feature/nome-da-feature
         ↓ commit
         ↓ push
         ↓ PR → develop
         ↓ CI passa
         ↓ merge
         ↓ git checkout develop
         ↓ git pull origin develop       ← atualiza o local
         ↓ git branch -d feature/nome    ← deleta a branch local

Padrão de branches

Branch	Descrição
main	Produção — protegida, só recebe PR de release
develop	Desenvolvimento — base para todas as features
feature/*	Nova funcionalidade — ex: feature/artist-profile
hotfix/*	Correção urgente em produção

Padrão de commits

Conventional Commits:

feat: add artist profile module
fix: correct booking conflict validation
chore: update CI pipeline
docs: update README with Kanban GIF

Ciclo completo de uma feature

1. Criar Issue no GitHub
2. git checkout develop
3. git checkout -b feature/nome-da-feature
4. Desenvolver e commitar
5. git push origin feature/nome-da-feature
6. Abrir PR → develop com template
7. CI passa
8. Merge → develop
9. Deletar branch da feature

Release para produção

develop → PR → main → CI/CD → deploy automático no Render

---

🔌 Endpoints da API

A documentação completa e interativa está disponível em http://localhost:8080/swagger-ui/index.html

Autenticação — /api/auth

Método	Endpoint	Acesso	Descrição
POST	/api/auth/login	Público	Login admin, retorna JWT

Perfil — /api/artist

Método	Endpoint	Acesso	Descrição
GET	/api/artist	Público	Retorna perfil da artista
PUT	/api/artist	Admin	Atualiza perfil

Repertório — /api/songs

Método	Endpoint	Acesso	Descrição
GET	/api/songs	Público	Lista músicas com filtros
GET	/api/songs/most-requested	Público	Músicas mais pedidas
GET	/api/songs/{id}	Público	Busca música por ID
POST	/api/songs	Admin	Cria música
PUT	/api/songs/{id}	Admin	Atualiza música
DELETE	/api/songs/{id}	Admin	Remove música

Vídeos — /api/videos

Método	Endpoint	Acesso	Descrição
GET	/api/videos	Público	Lista vídeos
GET	/api/videos/featured	Público	Vídeos em destaque
GET	/api/videos/{id}	Público	Busca vídeo por ID
POST	/api/videos	Admin	Adiciona vídeo
PUT	/api/videos/{id}	Admin	Atualiza vídeo
DELETE	/api/videos/{id}	Admin	Remove vídeo

Agenda — /api/bookings

Método	Endpoint	Acesso	Descrição
GET	/api/bookings/unavailable-dates	Público	Datas indisponíveis
POST	/api/bookings	Público	Solicita agendamento
GET	/api/bookings	Admin	Lista agendamentos
GET	/api/bookings/status/{status}	Admin	Filtra por status
PATCH	/api/bookings/{id}/status	Admin	Atualiza status
DELETE	/api/bookings/{id}	Admin	Remove agendamento

Contato — /api/contact

Método	Endpoint	Acesso	Descrição
POST	/api/contact	Público	Envia mensagem
GET	/api/contact	Admin	Lista mensagens
GET	/api/contact/failed	Admin	Mensagens com falha no e-mail
GET	/api/contact/{id}	Admin	Detalhe da mensagem

---

🧪 Testes

./gradlew test

Ver relatório HTML:

# Linux / macOS
open build/reports/tests/test/