gohorsejobs/docs/ROADMAP.md
2025-12-28 03:04:18 -03:00

146 lines
7.4 KiB
Markdown

# 🗺️ GoHorse Jobs & Marketplace - "The Intense" Roadmap (10X)
**O Roadmap Definitivo.**
Este documento não é apenas uma lista de tarefas; é o **DNA estratégico e técnico** para transformar o GoHorse Jobs na plataforma dominante de empregos e serviços digitais no Brasil (e futuramente LATAM/Global).
> **Meta:** Deixar de ser um "Job Board" e tornar-se um **Ecossistema de Carreira**.
> **Filosofia:** "Extreme GoHorse" na velocidade, "Solid/Clean Arch" na fundação.
---
## 🏗️ Pilar 1: Fundação & Arquitetura (Já Consolidado)
*O alicerce que permite escalar sem quebrar.*
### 1.1 Backend & Core (Go)
- [x] **Clean Arch + DDD:** Separação estrita entre Handlers, Services, UseCases e Repositories.
- [x] **UUID v7:** Migração completa de INT para UUIDv7 (time-sorted) em todas as tabelas críticas (`users`, `jobs`, `applications`).
- *Por que?* Evita fragmentação de índices e permite sharding futuro sem conflitos.
- [x] **Testes de Integração:** Setup de `sqlmock` e `testify` para cobertura crítica de Handlers e Services.
- [x] **Logs Estruturados:** `slog` com rastreamento de RequestID para observabilidade total.
### 1.2 Frontend & UX (Next.js)
- [x] **Design System:** Componentes ShadCN/UI padronizados e responsivos.
- [x] **Auth Híbrida:** Suporte a JWT Bearer e Cookies para segurança máxima em clientes web e mobile.
- [x] **Dashboards Dedicados:** Áreas distintas e otimizadas para Candidatos (foco: aplicar rápido) e Recrutadores (foco: triagem rápida).
---
## 💎 Pilar 2: Marketplace B2C & Monetização (Q1 2025)
*Transformando usuários gratuitos em receita recorrente.*
### 2.1 Engine de Pagamentos (Stripe Integration)
**Objetivo:** Permitir fluxo financeiro fluido para B2B e B2C.
- [ ] **Checkout de Vagas (B2B):**
- Empresas pagam para destacar vagas ("Featured") ou furar a fila de moderação.
- **Regra de Negócio:** Vaga paga entra como `status: published` automaticamente (após check de fraude). Vaga grátis entra como `review`.
- **Técnico:** Webhook Stripe (`checkout.session.completed`) atualiza tabela `job_payments` e dispara evento de publicação.
- [ ] **Assinaturas Recorrentes (SaaS):**
- Planos "Pro" para Recrutadores (Acesso ao Banco de Talentos, Filtros Avançados).
- Planos "Prime" para Candidatos (Destaque na busca, feedback detalhado de rejeição).
- [ ] **Marketplace de Serviços (Stripe Connect):**
- Candidatos vendem "Mentorias" ou "Revisão de CV".
- **Split de Pagamento:** Plataforma retém X% (ex: 15%), o resto vai para o prestador.
- **Técnico:** Uso de Stripe Connect Express para onboarding simplificado de vendedores (KYC automático).
### 2.2 Gamificação & Engajamento
**Objetivo:** Viciar o usuário na plataforma (Retenção).
- [ ] **Sistema de Níveis (XP):**
- Ações geram XP: Completar perfil (+50XP), Aplicar (+10XP), Receber entrevista (+100XP).
- **Benefício:** Níveis altos ganham destaque visual ou acesso antecipado a vagas.
- [ ] **Badges Conquistáveis:** "Verificado", "Top Voice", "Dev Sênior", "Early Adopter".
- [ ] **Daily Streak:** Incentivo para login diário (ex: manter a visibilidade do perfil no topo).
---
## 📦 Pilar 3: E-commerce & Logística (Q2 2025)
*Expansão física: Venda de Merch e Equipamentos para Home Office.*
### 3.1 Loja Oficial (Merch)
- [ ] **Catálogo de Produtos:** Camisetas, Canecas, Adesivos "GoHorse".
- [ ] **Integração de Estoque:** Controle simples de estoque (`product_variants`, `inventory_logs`).
- [ ] **Checkout Unificado:** O mesmo carrinho serve para Vagas Premium e Camisetas.
### 3.2 Logística & Frete (Brasil)
**Foco:** Adaptação total ao mercado brasileiro.
- [ ] **Cálculo de Frete (Correios/Melhor Envio):**
- Integração via API para cálculo em tempo real (SEDEX, PAC) baseado no CEP do usuário.
- **Fallback:** Tabela de contingência para frete fixo caso API caia.
- [ ] **Rastreamento:**
- Webhook de atualização de status de entrega (`código de rastreio` salvo no pedido).
- Notificação via WhatsApp/Email quando sair para entrega.
- [ ] **Regras Fiscais:** Integração básica para emissão de NF-e (via Bling ou eNotas) no momento da confirmação do pagamento.
---
## 🧠 Pilar 4: Inteligência & Automação (Q3 2025 - "GoHorse AI")
*Onde a mágica acontece. O diferencial competitivo.*
### 4.1 Matching Semântico (Vector Search)
- [ ] **Embeddings:** Gerar vetores (OpenAI ou Local LLM) para:
- Descrições de Vagas.
- Currículos/Bios de Candidatos.
- [ ] **Busca Vetorial (pgvector):**
- Substituir o `LIKE` ou `Fuzzy` por busca semântica (`cosine similarity`).
- **Resultado:** Busca por "Frontend Ninja" retorna perfis com "React", "Vue", "Angular" mesmo sem a palavra exata.
### 4.2 Assistente de Carreira (LLM Agent)
- [ ] **Review de Currículo Automático:**
- AI analisa o PDF e sugere melhorias (ex: "Use verbos de ação", "Quantifique resultados").
- [ ] **Gerador de Cover Letter:**
- Bot lê a vaga + perfil do usuário e gera uma carta personalizada em segundos.
- [ ] **Pre-Screening Bot:**
- Chatbot no WhatsApp/Site que faz perguntas de triagem ("Você tem 3 anos de Exp?", "Inglês Fluente?") e classifica o candidato para o RH.
---
## 📱 Pilar 5: Mobile First & Notificações (Ongoing)
*Estar onde o usuário está: No celular.*
- [ ] **PWA (Progressive Web App):**
- Service Workers para cache offline agressivo (funcionar no metrô/ônibus).
- "Add to Home Screen" com ícone nativo.
- [ ] **Notificações Push (FCM):**
- Alerta de vaga nova (match).
- Alerta de "Visto por um recrutador".
- Alerta de status de entrega de produto.
- [ ] **Integração WhatsApp (Twilio/ZAP):**
- Candidato recebe link de entrevista direto no Wpp.
- Recrutador recebe aviso de "Candidato Perfeito" no Wpp.
---
## 🛡️ Pilar 6: Segurança & Compliance (LGPD)
*Protegendo o ativo mais valioso: Dados.*
- [ ] **Anonimização de Dados:** Opção para candidato "esconder" nome/contato até o match.
- [ ] **Auditoria Completa (Audit Trail):**
- Quem acessou o currículo de quem? (Já iniciado em `activity_logs`).
- Registro imutável de alterações salariais ou contratuais.
- [ ] **Pre-signed URLs:** Curriculos no S3/R2 com links temporários (TTL 15min) para evitar scraping.
- [ ] **Anti-Fraud:** Rate-limiting agressivo em endpoints de login e cadastro. Detecção de emails temporários.
---
## 📊 Gap Analysis Técnico (O que precisamos resolver JÁ)
| Área | Gap | Solução Técnica Proposta | Complexidade |
|------|-----|--------------------------|--------------|
| **Busca** | Postgres `Semântico` | Implementar `pgvector` ou ElasticSearch. A busca atual não escala. | Alta |
| **Email** | SMTP Síncrono | Migrar para Fila (Redis/RabbitMQ) + Worker assíncrono para envio de emails em massa. | Média |
| **Cache** | Inexistente | Implementar Redis para cache de `GET /jobs` e Sessões de Usuário. | Média |
| **Img** | Upload Direto | Implementar Image Processing (Sharp/Go) para resize/compression antes do S3. | Baixa |
| **Logs** | Arquivo Local | Centralizar logs (Loki/Elastic) para visualização no Grafana. | Alta |
---
## 📅 Cronograma Estimado (Dev)
- **Semana 1-2:** Fixar Testes Backend, Estabilizar Deploy, Finalizar C4 Model.
- **Semana 3-4:** Implementar Stripe Checkout (Pagamento Básico).
- **Semana 5-6:** Módulo de Logística (Básico - Frete Correios).
- **Semana 7-8:** Início do Módulo AI (Matching Vetorial).
> *"O futuro pertence a quem deploya na sexta-feira."* 🚀