Como Integrar APIs de CPF em um Sistema Ruby on Rails com Devise

# db/migrate/XXXXXX_add_cpf_to_users.rb
class AddCpfToUsers < ActiveRecord::Migration[7.1]
    def change
    add_column :users, :cpf, :string
    add_column :users, :cpf_verificado, :boolean, default: false
    add_column :users, :nome_cpf, :string
    add_column :users, :genero_cpf, :string
    add_column :users, :data_nascimento_cpf, :date

    add_index :users, :cpf, unique: true
    end
end

# app/models/user.rb
class User < ApplicationRecord
    devise :database_authenticatable, :registerable,
    :recoverable, :rememberable, :validatable

    validates :cpf, presence: true, uniqueness: true
    validate :cpf_formato_valido
    validate :cpf_algoritmo_valido

    before_save :limpar_cpf

    private

    def limpar_cpf
    self.cpf = cpf.gsub(/\D/, "") if cpf.present?
    end

    def cpf_formato_valido
    return if cpf.blank?

    cpf_limpo = cpf.gsub(/\D/, "")
    unless cpf_limpo.match?(/\A\d{11}\z/)
    errors.add(:cpf, "deve conter 11 digitos")
    end
    end

    def cpf_algoritmo_valido
    return if cpf.blank?

    cpf_limpo = cpf.gsub(/\D/, "")
    return if cpf_limpo.length != 11

    if cpf_limpo.chars.uniq.size == 1
    errors.add(:cpf, "nao pode ter todos os digitos iguais")
    return
    end

    unless CpfValidator.digitos_validos?(cpf_limpo)
    errors.add(:cpf, "possui digitos verificadores invalidos")
    end
    end
end

# app/controllers/users/registrations_controller.rb
class Users::RegistrationsController < Devise::RegistrationsController
    before_action :configure_sign_up_params, only: [:create]
    before_action :configure_account_update_params, only: [:update]

    def create
    super do |user|
    if user.persisted?
    VerificarCpfJob.perform_later(user.id)
    end
    end
    end

    private

    def configure_sign_up_params
    devise_parameter_sanitizer.permit(
    :sign_up,
    keys: [:cpf, :nome]
    )
    end

    def configure_account_update_params
    devise_parameter_sanitizer.permit(
    :account_update,
    keys: [:cpf, :nome]
    )
    end
end

# config/routes.rb
Rails.application.routes.draw do
    devise_for :users, controllers: {
    registrations: "users/registrations"
    }
end

# app/jobs/verificar_cpf_job.rb
class VerificarCpfJob < ApplicationJob
    queue_as :default
    retry_on Faraday::TimeoutError, wait: :exponentially_longer, attempts: 3

    def perform(user_id)
    user = User.find(user_id)
    return if user.cpf_verificado?

    cliente = Faraday.new(url: "https://api.cpfhub.io") do |conn|
    conn.headers["x-api-key"] = ENV["CPFHUB_API_KEY"]
    conn.options.timeout = 10
    conn.adapter Faraday.default_adapter
    end

    resposta = cliente.get("/cpf/#{user.cpf}")
    resultado = JSON.parse(resposta.body)

    if resultado["success"]
    dados = resultado["data"]
    user.update!(
    cpf_verificado: true,
    nome_cpf: dados["name"],
    genero_cpf: dados["gender"],
    data_nascimento_cpf: dados["birthDate"]
    )

    UserMailer.cpf_verificado(user).deliver_later
    Rails.logger.info("[VerificarCpfJob] CPF #{user.cpf} verificado")
    else
    Rails.logger.warn(
    "[VerificarCpfJob] CPF #{user.cpf} nao encontrado na base"
    )
    end
    end
end

# app/services/cpf_validator.rb
class CpfValidator
    def self.digitos_validos?(cpf)
    numeros = cpf.chars.map(&:to_i)

    # Primeiro dígito verificador
    soma = (0..8).sum { |i| numeros[i] * (10 - i) }
    resto = (soma * 10) % 11
    resto = 0 if resto == 10
    return false unless resto == numeros[9]

    # Segundo dígito verificador
    soma = (0..9).sum { |i| numeros[i] * (11 - i) }
    resto = (soma * 10) % 11
    resto = 0 if resto == 10
    resto == numeros[10]
    end
end

# app/controllers/concerns/cpf_verificado_concern.rb
module CpfVerificadoConcern
    extend ActiveSupport::Concern

    included do
    before_action :exigir_cpf_verificado, if: :usuario_logado?
    end

    private

    def exigir_cpf_verificado
    return unless acao_requer_cpf_verificado?

    unless current_user.cpf_verificado?
    if request.format.json?
    render json: {
    erro: "CPF nao verificado",
    mensagem: "Aguarde a verificacao do seu CPF para acessar esta funcionalidade"
    }, status: :forbidden
    else
    redirect_to verificacao_pendente_path,
    alert: "Seu CPF ainda esta sendo verificado."
    end
    end
    end

    def acao_requer_cpf_verificado?
    self.class.const_defined?(:ACOES_REQUEREM_CPF) &&
    self.class::ACOES_REQUEREM_CPF.include?(action_name.to_sym)
    end

    def usuario_logado?
    user_signed_in?
    end
end

# app/controllers/pedidos_controller.rb
class PedidosController < ApplicationController
    include CpfVerificadoConcern
    ACOES_REQUEREM_CPF = %i[create update].freeze

    def create
    # Apenas usuários com CPF verificado chegam aqui
    end
end

<%# app/views/devise/registrations/new.html.erb %>
<%= form_for(resource, as: resource_name,
    url: registration_path(resource_name)) do |f| %>

    <div class="campo">
    <%= f.label :nome, "Nome completo" %>
    <%= f.text_field :nome, required: true, autofocus: true %>
    </div>

    <div class="campo">
    <%= f.label :email %>
    <%= f.email_field :email, required: true %>
    </div>

    <div class="campo">
    <%= f.label :cpf, "CPF" %>
    <%= f.text_field :cpf,
    required: true,
    inputmode: "numeric",
    maxlength: 14,
    placeholder: "000.000.000-00",
    data: { controller: "mascara-cpf" } %>
    <span class="info">
    Seu CPF sera verificado para seguranca da sua conta.
    </span>
    </div>

    <div class="campo">
    <%= f.label :password, "Senha" %>
    <%= f.password_field :password, required: true,
    minlength: Devise.password_length.min %>
    </div>

    <div class="acoes">
    <%= f.submit "Criar conta" %>
    </div>
<% end %>