vert-core 1.0.14 → 1.0.15

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 43861cbbafbe1e9d6410050fda4af949e74e31b2eed69d9d780e18b4762e1f0b
-  data.tar.gz: c638c39ff50c9c564c6f8c38d6150e661a17103519097ce7fb44db567f3a56f8
+  metadata.gz: c81e24d685ccd2412787e971650108ad2d507fea03121aecf9f74f442cdeee29
+  data.tar.gz: 6da8dfb2a6d8fcc3ed751a0d04958446e392417c4ed33d2a60ed4a5cbf870236
 SHA512:
-  metadata.gz: f12d181a2866e0bd90d6934c2fc453b840a542401bdd863b5f1e77c69df2743ddaa96949b9ac0f493264931004f790ec827d18fdd0f8240588b5b88e5f600860
-  data.tar.gz: 172bb3d173c04219c4c211f188ba2d74085caadb872705d44f4be50f7b2975951d68b87e7a98185ebbe8930f2e8aca6351b67da49feddf1288c4a209f47587b6
+  metadata.gz: d9c5b091cb5a213aa0b14cc27f31817617096d89ceb58bd74f327c56a422b7f17cd57681ad4a9f4cc010ce42b9002807ac6ae34bce5dae84e5ced185b62265db
+  data.tar.gz: 1ffaaf2ae131b78aa452abccf4ccacebaf454c594e8b9bff6d6b458c13c498ce06e5936df5bb8502f5945cf3f69e9f59d03ad71caf455e133529bac4de5d56b1

data/CHANGELOG.md

@@ -1,5 +1,44 @@
 # Changelog
 
+## [1.0.15] - 2026-05-24
+
+### Added
+
+- `Vert::Concerns::MultiTenant.multi_tenant_options(include_system_records: true)` — opt-in para que o `default_scope` inclua registros com `tenant_id IS NULL` (system records visíveis globalmente). Útil para `Role`, `Plan`, `Permission` catálogo e outros modelos com registros "globais" compartilhados entre tenants.
+  - Quando ativado, o scope vira `WHERE tenant_id = ? OR tenant_id IS NULL`.
+  - Quando ativado, `tenant_id` deixa de ser obrigatório na validação.
+
+### Fixed
+
+- **Bug crítico latente** — sem a opção `include_system_records`, o `default_scope` do `MultiTenant` escondia silenciosamente todos os registros com `tenant_id NULL` durante requests autenticadas. Isso quebrava qualquer associação `belongs_to` para system records (ex: `User#role` apontando para system role) retornando nil mesmo com `role_id` presente. Consequência: TODAS as Pundit policies que checavam `user.role` retornavam 403 mesmo para Proprietário do tenant.
+  - Workaround anterior (sem essa release): `Role.unscoped.find_by(id:)` em cada chamada.
+  - Com 1.0.15: declarar `multi_tenant_options include_system_records: true` no model e remover workarounds.
+
+### Migration guide
+
+```ruby
+# Antes (workaround):
+class User < ApplicationRecord
+  belongs_to :role, optional: true
+
+  def role
+    return super if association(:role).loaded?
+    @role_with_fallback ||= Role.unscoped.find_by(id: role_id)
+  end
+end
+
+# Depois (vert-core 1.0.15):
+class Role < ApplicationRecord
+  include Vert::Concerns::MultiTenant
+  multi_tenant_options include_system_records: true  # ← novo
+end
+
+class User < ApplicationRecord
+  belongs_to :role, optional: true
+  # Sem override — agora `user.role` carrega normalmente
+end
+```
+
 ## [1.0.14] - 2026-05-24
 
 ### Added

data/lib/vert/concerns/multi_tenant.rb

@@ -2,22 +2,55 @@
 
 module Vert
   module Concerns
+    # MultiTenant
+    # -----------
+    # Adiciona escopo automático por `tenant_id` baseado em `Vert::Current.tenant_id`.
+    #
+    # ## Uso básico
+    #   class Order < ApplicationRecord
+    #     include Vert::Concerns::MultiTenant
+    #   end
+    #
+    # ## System records (tenant_id NULL)
+    #
+    # Alguns modelos têm registros "globais" que devem ser visíveis em todos
+    # os tenants — ex: `Role` system, `Plan`, `Permission` catálogo. Esses
+    # registros são identificados por `tenant_id IS NULL`.
+    #
+    # Por default, o `default_scope` filtra `where(tenant_id = current)`, o que
+    # exclui esses registros silenciosamente quando há tenant ativo. Para
+    # incluí-los, use o opt-in:
+    #
+    #   class Role < ApplicationRecord
+    #     include Vert::Concerns::MultiTenant
+    #     multi_tenant_options include_system_records: true
+    #   end
+    #
+    # Com essa opção, o default_scope passa a ser:
+    #   where("tenant_id = ? OR tenant_id IS NULL", Vert::Current.tenant_id)
+    #
+    # Aplica-se também à validação: `tenant_id` deixa de ser obrigatório.
+    #
+    # ## Bypass manual
+    #
+    # Para queries específicas que precisam ignorar o escopo:
+    #
+    #   Order.unscoped.where(id: external_id)
+    #   Order.unscoped_for_tenant(other_tenant_id).find(id)
     module MultiTenant
       extend ActiveSupport::Concern
 
-      included do
-        validates :tenant_id, presence: true, if: :require_tenant_id?
-        default_scope do
-          if Vert::Current.tenant_id.present?
-            where(tenant_id: Vert::Current.tenant_id)
-          else
-            all
-          end
+      class_methods do
+        # Configura comportamento do MultiTenant. Aceita:
+        #   - include_system_records: true  → default_scope inclui tenant_id NULL
+        def multi_tenant_options(include_system_records: false)
+          @multi_tenant_include_system_records = include_system_records
+        end
+
+        def multi_tenant_include_system_records?
+          @multi_tenant_include_system_records == true
         end
-        before_validation :set_tenant_id, on: :create
-      end
 
-      class_methods do
         def unscoped_for_tenant(tenant_id)
           unscoped.where(tenant_id: tenant_id)
         end
@@ -31,9 +64,30 @@ module Vert
         end
       end
 
+      included do
+        validates :tenant_id, presence: true, if: :require_tenant_id?
+
+        default_scope do
+          current_tenant = Vert::Current.tenant_id
+          if current_tenant.present?
+            if multi_tenant_include_system_records?
+              where("#{table_name}.tenant_id = ? OR #{table_name}.tenant_id IS NULL", current_tenant)
+            else
+              where(tenant_id: current_tenant)
+            end
+          else
+            all
+          end
+        end
+
+        before_validation :set_tenant_id, on: :create
+      end
+
       private
 
       def require_tenant_id?
+        return false if self.class.multi_tenant_include_system_records?
+
         true
       end
 

data/lib/vert/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Vert
-  VERSION = "1.0.14"
+  VERSION = "1.0.15"
 end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: vert-core
 version: !ruby/object:Gem::Version
-  version: 1.0.14
+  version: 1.0.15
 platform: ruby
 authors:
 - Vert Team
 bindir: exe
 cert_chain: []
-date: 2026-05-24 00:00:00.000000000 Z
+date: 2026-05-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport