rede5/gohorsejobs
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions 1
gohorsejobs/docs/ROADMAP.md
Tiago Yamamoto 69534f5810 docs: update roadmap and add admin handler tests
2025-12-28 03:04:18 -03:00

7.4 KiB
Raw Blame History

🗺️ 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)

  • Clean Arch + DDD: Separação estrita entre Handlers, Services, UseCases e Repositories.
  • 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.
  • Testes de Integração: Setup de sqlmock e testify para cobertura crítica de Handlers e Services.
  • Logs Estruturados: slog com rastreamento de RequestID para observabilidade total.

1.2 Frontend & UX (Next.js)

  • Design System: Componentes ShadCN/UI padronizados e responsivos.
  • Auth Híbrida: Suporte a JWT Bearer e Cookies para segurança máxima em clientes web e mobile.
  • 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." 🚀