Merge branch 'master' into develop

Signed-off-by: Benevanio <benevaniosantos930@gmail.com>

Author: Benevanio

.gitignore

@@ -21,3 +21,4 @@ backend/coverage/
 
 # Dist-electron
 dist-electron/.sfdx/
+pnpm-lock.yaml

ESCOPO.md

@@ -0,0 +1,293 @@
+# Documento Inicial de Produto (MVP)
+
+## 1. Visão do Produto
+
+### Nome Temporário
+
+A definir.
+
+### Problema
+
+Profissionais buscam oportunidades de trabalho em diversas plataformas, porém encontram informações dispersas, processos repetitivos e dificuldade em acompanhar vagas relevantes.
+
+### Solução
+
+Desenvolver uma plataforma simples e intuitiva para descoberta, pesquisa e acompanhamento de oportunidades profissionais.
+
+### Objetivo do MVP
+
+Permitir que usuários:
+
+* Criem uma conta;
+* Realizem login;
+* Pesquisem vagas;
+* Visualizem detalhes das vagas;
+* Possuam uma área autenticada para gerenciamento de oportunidades.
+
+---
+
+# 2. Público-Alvo
+
+## Primário
+
+* Desenvolvedores
+* Profissionais de tecnologia
+* Estudantes em busca de estágio
+* Pessoas em transição de carreira
+
+## Secundário
+
+* Recrutadores
+* Empresas parceiras
+
+---
+
+# 3. Regras de Negócio
+
+## Cadastro
+
+* Usuário deve possuir e-mail único.
+* Senha deve atender requisitos mínimos de segurança.
+* Cadastro gera conta ativa imediatamente.
+
+## Login
+
+* Autenticação por e-mail e senha.
+* Sessão protegida por token.
+
+## Busca de Vagas
+
+* Disponível para visitantes.
+* Pesquisa por palavra-chave.
+* Filtro por localização.
+* Filtro por modalidade (remoto, híbrido, presencial).
+
+## Painel de Vagas
+
+* Acesso exclusivo para usuários autenticados.
+* Exibe vagas visualizadas.
+* Exibe vagas salvas.
+* Permite acompanhamento de oportunidades.
+
+## Landing Page
+
+* Apresentação da plataforma.
+* Benefícios do produto.
+* Estatísticas do projeto.
+* Seção de colaboradores.
+* Links para GitHub e redes sociais.
+
+---
+
+# 4. Escopo MVP
+
+## Dentro do MVP
+
+* Landing Page
+* Cadastro
+* Login
+* Recuperação de senha
+* Busca de vagas
+* Visualização de vagas
+* Painel autenticado
+
+## Fora do MVP
+
+* Inteligência artificial
+* Matching avançado
+* Chat interno
+* Aplicação automática
+* Dashboard analítico
+* Assinaturas pagas
+
+---
+
+# 5. Critérios de Sucesso
+
+## Produto
+
+* Usuário consegue se cadastrar em menos de 2 minutos.
+* Usuário encontra uma vaga em menos de 3 cliques.
+
+## Tecnologia
+
+* Disponibilidade superior a 99%.
+* Tempo de carregamento inferior a 3 segundos.
+
+## Comunidade
+
+* Projeto apresentável para eventos.
+* Participação ativa dos colaboradores.
+* Documentação pública atualizada.
+
+</content>
+
+### Metas por Área
+
+## Frontend
+
+### Objetivo
+
+Entregar uma experiência simples, rápida e responsiva.
+
+### Entregas
+
+**Sprint 1**
+
+* Estrutura base do projeto
+* Sistema de rotas
+* Layout global
+* Landing Page
+
+**Sprint 2**
+
+* Tela Login
+* Tela Cadastro
+* Integração com autenticação
+
+**Sprint 3**
+
+* Busca de Vagas
+* Lista de vagas
+* Filtros
+
+**Sprint 4**
+
+* Painel autenticado
+* Controle de acesso
+* Ajustes de UX
+
+### Critérios de Aceite
+
+* Responsivo Mobile/Desktop
+* Acessibilidade básica
+* Feedback visual de carregamento
+* Tratamento de erros
+
+---
+
+## Backend
+
+### Objetivo
+
+Disponibilizar APIs seguras e escaláveis para suportar o MVP.
+
+### Entregas
+
+**Sprint 1**
+
+* Arquitetura
+* Banco de dados
+* Setup ambiente
+
+**Sprint 2**
+
+* Cadastro
+* Login
+* JWT/Auth
+
+**Sprint 3**
+
+* API de vagas
+* Filtros
+* Busca
+
+**Sprint 4**
+
+* Painel do usuário
+* Histórico de ações
+* Hardening de segurança
+
+### Critérios de Aceite
+
+* APIs documentadas
+* Cobertura mínima de testes
+* Logs estruturados
+* Tratamento de exceções
+
+---
+
+## QA
+
+### Objetivo
+
+Garantir qualidade desde o início.
+
+### Entregas
+
+**Sprint 1**
+
+* Estratégia de testes
+* Plano de testes
+
+**Sprint 2**
+
+* Casos de teste Login/Cadastro
+
+**Sprint 3**
+
+* Casos de teste Busca de Vagas
+
+**Sprint 4**
+
+* Testes E2E do fluxo principal
+
+### Critérios de Aceite
+
+* Fluxo completo validado
+* Bugs críticos zerados
+* Regressão executada a cada release
+
+---
+
+## Design
+
+### Objetivo
+
+Criar identidade visual profissional para apresentação em comunidade e mercado.
+
+### Entregas
+
+**Sprint 1**
+
+* Branding
+* Logo
+* Definição de cores
+
+**Sprint 2**
+
+* Design System
+* Componentes reutilizáveis
+
+**Sprint 3**
+
+* Fluxos Login/Cadastro
+
+**Sprint 4**
+
+* Fluxos Busca e Painel
+
+### Critérios de Aceite
+
+* Consistência visual
+* Componentização
+* Responsividade
+* Protótipo navegável
+
+---
+
+## Próxima decisão estratégica (mais importante)
+
+Antes de qualquer desenvolvimento adicional, o time precisa responder uma única pergunta:
+
+**"Qual é o diferencial dessa plataforma em relação ao LinkedIn, Gupy, Indeed e Programathor?"**
+
+Essa resposta será a base para:
+
+* Nome do produto;
+* Pitch para eventos;
+* Regras de negócio futuras;
+* Priorização do backlog;
+* Possível validação de mercado.
+
+Sem essa definição, existe o risco de construir apenas mais um agregador de vagas. Com ela, o produto passa a ter identidade, posicionamento e direção clara para evolução.

README.md

@@ -16,6 +16,7 @@ O produto evoluiu para um modelo orientado a serviços (API + scraper Go + cache
 - Documentação backend detalhada: [BACKEND.md](BACKEND.md)
 - Documentação scraper Go: [SCRAPER.md](SCRAPER.md)
 - Guia de testes: [TESTING.md](TESTING.md)
+- Documentação inicial do MVP (Visão PO) [ESCOPO.md](ESCOPO.md)
 
 ## Sumário
 

backend/drizzle/meta/_journal.json

@@ -29,6 +29,13 @@
       "when": 1779191875793,
       "tag": "0003_hot_miek",
       "breakpoints": true
+    },
+    {
+      "idx": 4,
+      "version": "7",
+      "when": 1780927293836,
+      "tag": "0004_small_psylocke",
+      "breakpoints": true
     }
   ]
 }

backend/package.json

@@ -39,6 +39,7 @@
     "cheerio": "^1.2.0",
     "cors": "^2.8.6",
     "dotenv": "^17.4.2",
+    "drizzle-orm": "^0.45.2",
     "express": "^5.2.1",
     "iron-session": "^8.0.4",
     "pdfkit": "^0.18.0",
@@ -56,8 +57,10 @@
     "@types/pg": "^8.20.0",
     "@types/supertest": "^7.2.0",
     "@vitest/coverage-v8": "^4.1.8",
+    "drizzle-kit": "^0.31.10",
     "nodemon": "^3.1.14",
     "supertest": "^7.2.2",
+    "tsx": "^4.22.4",
     "typescript": "^6.0.3",
     "vitest": "^4.1.8"
   }

backend/src/app.ts

@@ -19,6 +19,9 @@ export function createJobsApiApp() {
   app.use(securityHeaders);
   app.use(cors(corsOptions));
 
+  //Confia no proxy reverso (nginx) para lidar com HTTPS e IPs reais dos clientes
+  app.set("trust proxy", 1);
+
   app.use("/api/auth", withSession, authRoutes);
   app.use("/api/users", withSession, requireAuth, userRoutes);
   app.use("/api/jobs", withSession, requireAuth, jobsRoutes);