Add Home.jsx with detailed dashboard logic, UI, and animations

Author: kauankelvin7

PRODUCT_IDEAS.md

@@ -0,0 +1,68 @@
+# Syntax — Ideias de Produto 💡
+
+Este backlog contém sugestões para futuras melhorias na plataforma Syntax, focando em aumentar o engajamento, valor educacional e usabilidade.
+
+## 🚀 Alta Prioridade
+
+### 1. Flashcards Automáticos
+- **Descrição**: A Ada detecta conceitos-chave durante as conversas e sugere salvá-los como flashcards.
+- **Exemplo**: "Você mencionou SOLID. Quer salvar esse princípio como um flashcard para revisar depois?"
+- **Complexidade**: Média | **Valor**: Alto
+
+### 2. Resumo da Conversa
+- **Descrição**: Ao encerrar uma conversa, a Ada gera um resumo em bullet points dos principais tópicos aprendidos.
+- **Complexidade**: Baixa | **Valor**: Alto
+
+### 3. Code Challenge (10min)
+- **Descrição**: A Ada propõe desafios práticos rápidos baseados no tópico que o usuário está estudando.
+- **Complexidade**: Média | **Valor**: Alto
+
+---
+
+## ⚡ Média Prioridade
+
+### 4. Modo Entrevista
+- **Descrição**: A Ada assume o papel de uma entrevistadora técnica. Ativado pelo comando `/interview`.
+- **Complexidade**: Baixa | **Valor**: Alto
+
+### 5. Adaptação de Nível
+- **Descrição**: Salva o nível do usuário (Júnior, Pleno, Sênior) e a Ada adapta o vocabulário e profundidade das explicações.
+- **Complexidade**: Baixa | **Valor**: Médio
+
+### 6. Roadmap Personalizado
+- **Descrição**: Sugere uma trilha de estudos com base nas lacunas de conhecimento identificadas pela Ada nas conversas.
+- **Complexidade**: Alta | **Valor**: Alto
+
+### 7. Snippets com Contexto
+- **Descrição**: Ao salvar um snippet de código, a Ada gera automaticamente um título, a linguagem e tags relevantes.
+- **Complexidade**: Baixa | **Valor**: Médio
+
+---
+
+## 🔮 Futuro / Baixa Prioridade
+
+### 8. Pair Programming Mode
+- **Descrição**: A Ada faz perguntas provocativas ao invés de dar a resposta, incentivando o usuário a pensar na solução.
+- **Complexidade**: Baixa | **Valor**: Alto (Engajamento)
+
+### 9. Integração GitHub
+- **Descrição**: A Ada analisa commits e PRs reais do usuário para dar feedbacks de Clean Code e arquitetura.
+- **Complexidade**: Alta | **Valor**: Alto
+
+### 10. Dashboard de Evolução
+- **Descrição**: Visualização de progresso por tópicos (ex: 80% em Algoritmos, 30% em DevOps).
+- **Complexidade**: Alta | **Valor**: Médio
+
+---
+
+## 🧠 Melhorias no Comportamento da Ada
+- **Detecção de Frustração**: Identificar frases como "não entendi" e mudar a abordagem didática automaticamente.
+- **Memória Intra-sessão**: Evitar repetir explicações já dadas na mesma conversa.
+- **Sugestão de Próximo Tópico**: Ao final de cada explicação, sugerir o que estudar em seguida.
+- **Citação de Fontes**: Referenciar livros clássicos (Clean Code, Pragmatic Programmer) em explicações relevantes.
+
+## 🎨 Melhorias de UX
+- **Onboarding Interativo**: Três perguntas iniciais (nível, stack, objetivo) para configurar a Ada.
+- **Comandos de Atalho**: `/new` (nova conversa), `/save` (salvar resumo), `/review` (revisar flashcards).
+- **Feedback de Respostas**: Botões de 👍/👎 nas mensagens da Ada para melhorar a precisão da IA.
+- **Modo Foco**: Opção de esconder a sidebar para uma sessão de estudos sem distrações.

UX_Writing_Changelog.md

@@ -0,0 +1,45 @@
+# UX Writing Changelog — Syntax Platform 📝
+
+Este changelog documenta as alterações de textos, mensagens e personalidade da IA (Ada) realizadas para alinhar a plataforma com o novo Guia de Tom de Voz.
+
+## 🔑 Autenticação (`LoginMinimal.jsx`)
+
+| Elemento | Antes | Depois | Motivo |
+| :--- | :--- | :--- | :--- |
+| Título (Login) | "Establish_Session" | "Entrar" | Clareza universal e remoção de jargão inventado. |
+| Título (Registro) | "Registry_Node" | "Criar conta" | Padrão reconhecível por desenvolvedores. |
+| Subtítulo (Login) | "Credenciais para acesso ao mainframe" | "Entre com sua conta para continuar." | Tom profissional e direto. |
+| Label Email | "Network_Address" | "Email" | Glossário oficial. |
+| Label Senha | "Access_Hash" | "Senha" | Glossário oficial. |
+| Placeholder | "node@syntax.network" | "seu@email.com" | Facilita o preenchimento intuitivo. |
+| Erros | "Target_Not_Found:..." | "Email não encontrado. Crie..." | Padrão [O que aconteceu] + [O que fazer]. |
+
+## 🤖 Agente Ada (`useSyntaxSessoes.js` & `AdaBot.jsx`)
+
+| Elemento | Antes | Depois | Motivo |
+| :--- | :--- | :--- | :--- |
+| Boas-vindas | Genérico ("Qual o problema?") | Contextual e motivador | Demonstra as capacidades técnicas da Ada. |
+| System Prompt | Focado em "Personalidade" | Focado em "Especialidades" | Melhora a precisão técnica da IA como Engenheira Sênior. |
+| Títulos de Sessão | Truncava o texto | Categorias com ícones (🐛, 📐, ⚙️) | Melhor organização visual do histórico. |
+| Erros de API | Jargão técnico (429, API Key) | Instruções claras de ação | Reduz a frustração do usuário em falhas técnicas. |
+
+## 📊 Dashboard e Navegação (`Home.jsx`, `Materias.jsx`, `Resumos.jsx`, `Flashcards.jsx`)
+
+| Elemento | Antes | Depois | Motivo |
+| :--- | :--- | :--- | :--- |
+| Badges de Status | "Node_Active" | "Online" | Humanização do sistema. |
+| KPIs | "Streak", "Logic_Units", "Docs" | "Sequência", "Flashcards", "Resumos" | Consistência com o PT-BR padrão do glossário. |
+| Empty States | "Repository_Empty" | "Repositório vazio" | Clareza e instrução para criar o primeiro item. |
+| Botões de Ação | "Initialize_Sync", "Commit_Stack" | "Iniciar revisão", "Salvar Matéria" | Foco na tarefa do usuário, não no processo técnico. |
+
+## ⚙️ Core e Contexto (`useSyntaxContext.js`)
+
+| Campo | Antes | Depois | Motivo |
+| :--- | :--- | :--- | :--- |
+| `streakAtual` | `streakAtual` | `diasSeguidos` | PT-BR consistente. |
+| `longestStreak` | `longestStreak` | `maiorSequencia` | Remoção de termos em EN desnecessários. |
+| `totalResumos` | `totalResumos` | `resumosSalvos` | Reflete melhor o estado de persistência. |
+| `ultimoProjeto` | (Não existia no estado) | `projetoRecente` | Adicionado para permitir saudações contextuais da Ada. |
+
+---
+*Alterações realizadas seguindo rigorosamente as Regras de Conduta do projeto Syntax.*

VOICE_GUIDE.md

@@ -0,0 +1,43 @@
+# Syntax — Guia de Tom de Voz 🚀
+
+## Quem é a plataforma Syntax
+A **Syntax** é uma plataforma de estudos de alto desempenho para engenheiros de software. Ela combina inteligência artificial (Ada), repetição espaçada (SM-2) e documentação técnica para acelerar o aprendizado de conceitos complexos, desde algoritmos até arquitetura de sistemas.
+
+## Quem é a Ada
+A **Ada** é a sua assistente especializada em engenharia de software. Ela não é apenas um chatbot; ela é uma colega de profissão sênior, direta, didática e motivadora. Ela entende código, padrões de projeto e desafios reais de desenvolvimento.
+
+## Glossário Oficial
+
+| CONCEITO          | USE            | NUNCA USE             |
+| :---------------- | :------------- | :-------------------- |
+| Usuário           | você / dev     | node, cliente         |
+| Conta             | conta          | registry, endpoint    |
+| Chat              | conversa       | sessão, thread        |
+| Agente de IA      | Ada            | bot, KakaBot, AI      |
+| Senha             | senha          | hash, access key      |
+| Email             | email          | network address       |
+| Login             | entrar         | establish session     |
+| Cadastro          | criar conta    | generate node         |
+
+## Padrões de Mensagem
+
+### ❌ O que evitar
+- Jargões inventados que dificultam a compreensão (ex: "Registry_Node", "Logic_Unit").
+- Mensagens de erro puramente técnicas sem instrução (ex: "Target_Not_Found").
+- Mistura aleatória de PT-BR e EN.
+- Tom frio ou excessivamente robótico.
+
+### ✅ O que fazer
+- **Padrão de erro**: `[O que aconteceu]` + `[O que fazer]`.
+  - *Ex: "Email não encontrado. Verifique ou crie uma conta."*
+- **Padrão de empty state**: `[O que está vazio]` + `[Ação para resolver]`.
+  - *Ex: "Nenhuma conversa ainda. Comece uma nova sessão com a Ada."*
+- **Padrão de loading**: Específico e contextual.
+  - *Ex: "Carregando seu histórico de estudos..."*
+- **Tom Dev-to-Dev**: Use termos técnicos consagrados (Code Review, Debug, Deploy, Stack) de forma natural no PT-BR.
+
+## Regra de Ouro da Ada
+Toda mensagem ou prompt da Ada deve ter **no máximo 2000 caracteres**. Isso garante performance e foco na resposta.
+
+---
+*Este guia deve ser seguido por todos os agentes e desenvolvedores para manter a consistência da plataforma Syntax.*

firestore.rules

@@ -143,8 +143,9 @@ service cloud.firestore {
     // ============================================================
 
     // -- USUÁRIOS (perfil público para busca) --
-    // O perfil /users/{userId} original permite apenas owner.
-    // Para buscas sociais, permitimos leitura autenticada de campos públicos.
+    // O perfil /users/{userId} original permite apenas owner para escrita.
+    // Para buscas sociais, permitimos leitura autenticada.
+    // IMPORTANTE: Evitar salvar PII (email, etc) no documento principal.
     match /users/{userId} {
       allow read: if isAuthenticated();
     }

frontend/src/pages/Simulado.jsx

@@ -1,9 +1,9 @@
 /**
- * 🎯 TEST_SUITE_ENGINE (Simulado Infinito) — Syntax Theme Premium
- * * Geração autônoma de testes via LLM (Gemini 2.5/2.0 Fallback).
+ * 🎯 TEST_SUITE_ENGINE 
+ * * Geração autônoma de testes via LLM (Gemini 2.5-flash).
  * - Features: PDF Data Extraction, Real-time Feedback, Performance Analytics.
  * - Design: QA Monitoring Interface (Slate-950 / Cyan / Indigo).
- * - v4.6: Fixed Gemini Models (2.5-flash + 2.0-flash + 2.0-flash-lite fallback).
+ * - v4.7: Fixed Gemini Model → gemini-2.5-flash only.
  */
 
 import React, { useState, useRef, useCallback, useEffect } from 'react';
@@ -45,11 +45,8 @@ import { Input } from '../components/ui/Input';
 
 pdfjsLib.GlobalWorkerOptions.workerSrc = 'https://cdnjs.cloudflare.com/ajax/libs/pdf.js/3.11.174/pdf.worker.min.js';
 
-// ✅ CORRIGIDO: modelos atualizados — 1.5-flash e 1.5-pro foram descontinuados
 const MODEL_CANDIDATES = [
-  'gemini-2.5-flash-preview-04-17',
-  'gemini-2.0-flash',
-  'gemini-2.0-flash-lite',
+  'gemini-2.5-flash',
 ];
 
 /* ═══════════════════════════════════════════
@@ -205,7 +202,6 @@ function Simulado() {
     } finally { setIsExtractingPdf(false); }
   };
 
-  // ✅ CORRIGIDO: fallback melhorado com retry em 429 e log de erro por modelo
   const generateWithFallback = async (prompt) => {
     const apiKey = import.meta.env.VITE_GEMINI_API_KEY;
     const genAI = new GoogleGenerativeAI(apiKey);
@@ -221,16 +217,14 @@ function Simulado() {
         lastError = err;
         const s = String(err?.status || err?.message || '');
         const is429 = s.includes('429');
-        const is404 = s.includes('404');
 
         console.warn(`[Simulado] Modelo ${modelName} falhou:`, s);
 
-        // 429 no primeiro modelo → aguarda antes de tentar o próximo
-        if (is429 && i === 0) {
+        // 429 → aguarda antes de tentar novamente
+        if (is429) {
           await new Promise(r => setTimeout(r, 3000));
         }
 
-        // Continua para o próximo modelo em qualquer erro
         continue;
       }
     }