feat(spotify): basic controls + oauth state validation

README.md

@@ -16,6 +16,7 @@
 
 ## 📖 Sobre o Projeto
 
+**Study AI** é uma extensão para Chrome que implementa a técnica Pomodoro com recursos avançados de análise e personalização. O projeto foi desenvolvido com assistência de IA (GitHub Copilot), demonstrando como ferramentas de IA podem acelerar o desenvolvimento de software moderno.
 ---
 
 ## 📸 Demonstração Visual
@@ -51,7 +52,7 @@ Aqui está uma prévia da interface e das funcionalidades principais da extensã
 
 ### 🎯 Filosofia de Desenvolvimento
 
-Este projeto é um exemplo prático de **desenvolvimento assistido por IA**, onde:
+Este projeto é um exemplo prático de desenvolvimento assistido por IA, onde:
 - ✅ A arquitetura foi planejada com auxílio de IA
 - ✅ Código otimizado e revisado por ferramentas inteligentes
 - ✅ Documentação técnica gerada de forma eficiente
@@ -85,6 +86,17 @@ Este projeto é um exemplo prático de **desenvolvimento assistido por IA**, ond
 - Controles de reprodução direto no timer
 - Sincronização com suas playlists
 
+### ⚡ **Quick Start Spotify**
+1. Crie um app no Spotify Developer Dashboard.
+2. Configure a Redirect URI da extensão (`chrome.identity.getRedirectURL()`).
+3. Informe o Client ID em **Configurações > Spotify** no popup.
+4. Clique em **Conectar Spotify** e autorize.
+5. Abra o Spotify em algum dispositivo para usar play/pause/next/prev.
+
+Documentação completa:
+- [docs/SPOTIFY_INTEGRATION.md](docs/SPOTIFY_INTEGRATION.md)
+- [docs/MESSAGE_CONTRACT.md](docs/MESSAGE_CONTRACT.md)
+
 ---
 
 ## 🚀 Tecnologias Utilizadas
@@ -121,9 +133,9 @@ Este projeto é um exemplo prático de **desenvolvimento assistido por IA**, ond
    chrome://extensions/
    ```
 
-3. **Ative o "Modo do desenvolvedor"** (toggle no canto superior direito)
+3. **Ative o Modo do desenvolvedor** (toggle no canto superior direito)
 
-4. **Clique em "Carregar sem compactação"**
+4. **Clique em Carregar sem compactação**
 
 5. **Selecione a pasta do projeto** (onde está o `manifest.json`)
 
@@ -142,18 +154,18 @@ npm run build
 ### **1️⃣ Timer Básico**
 1. Clique no ícone da extensão no Chrome
 2. Selecione o modo desejado (Foco, Pausa Curta, Pausa Longa)
-3. Clique em **"Iniciar"**
+3. Clique em **Iniciar**
 4. O timer continua rodando mesmo se fechar o popup!
 5. Quando terminar, ouça a notificação sonora 🔔
 
 ### **2️⃣ Estatísticas**
-1. Clique na aba **"Estatísticas"**
+1. Clique na aba **Estatísticas**
 2. Veja seu gráfico semanal de produtividade
 3. Analise distribuição por categoria de estudo
 4. Exporte seus dados para backup (JSON)
 
 ### **3️⃣ Configurações**
-1. Clique na aba **"Configurações"**
+1. Clique na aba **Configurações**
 2. **Tipo de Som:** Escolha entre Sparkle, Piano, Chime, Bell
 3. **Volume:** Ajuste com o slider (0-100%)
 4. **Testar Som:** Clique no botão 🔊 para preview
@@ -221,7 +233,7 @@ study-ai/
 ### **Áudio não toca?**
 1. Verifique o volume do sistema (não está mudo?)
 2. Ajuste o volume no slider da extensão
-3. Teste com o botão 🔊 "Testar Som"
+3. Teste com o botão 🔊 Testar Som
 4. Console do offscreen deve mostrar: `[Offscreen] Teste de som: sparkle (volume: 70%)`
 
 ### **Estatísticas não aparecem?**
@@ -257,7 +269,7 @@ Este projeto está sob a licença **MIT**. Veja o arquivo [LICENSE](LICENSE) par
 
 ## 👨‍💻 Autor
 
-Desenvolvido com 💙 e ☕ por **[Daniel Mourão Lopes]**
+Desenvolvido com 💙 e ☕ por **Daniel Mourão Lopes**
 
 - GitHub: [@DanielMouraoti](https://github.com/DanielMouraoti)
 - LinkedIn: [Daniel Mourão](https://linkedin.com/in/daniel-mourão-backend)

_locales/en/messages.json

@@ -0,0 +1,13 @@
+{
+  "productivityTitle": { "message": "📊 Productivity" },
+  "languages": { "message": "Languages" },
+  "music": { "message": "Music" },
+  "noCategory": { "message": "No category" },
+  "sunday":   { "message": "Sun" },
+  "monday":   { "message": "Mon" },
+  "tuesday":  { "message": "Tue" },
+  "wednesday":{ "message": "Wed" },
+  "thursday": { "message": "Thu" },
+  "friday":   { "message": "Fri" },
+  "saturday": { "message": "Sat" }
+}

_locales/pt_BR/messages.json

@@ -0,0 +1,13 @@
+{
+  "productivityTitle": { "message": "📊 Produtividade" },
+  "languages": { "message": "Idiomas" },
+  "music": { "message": "Músicas" },
+  "noCategory": { "message": "Sem Categoria" },
+  "sunday":   { "message": "Dom" },
+  "monday":   { "message": "Seg" },
+  "tuesday":  { "message": "Ter" },
+  "wednesday":{ "message": "Qua" },
+  "thursday": { "message": "Qui" },
+  "friday":   { "message": "Sex" },
+  "saturday": { "message": "Sáb" }
+}