Module: LcpRuby::Auditing::Setup

Defined in:
lib/lcp_ruby/auditing/setup.rb

Class Method Summary collapse

Class Method Details

.apply!(loader) ⇒ Object

Boot-time setup for auditing infrastructure. Called after models are built and groups are set up.

Parameters:



8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
 
# File 'lib/lcp_ruby/auditing/setup.rb', line 8

def self.apply!(loader)
  # Only activate if at least one model has auditing: true
  any_audited = loader.model_definitions.values.any?(&:auditing?)
  return unless any_audited

  audit_model_name = LcpRuby.configuration.audit_model

  # Verify the audit model exists
  model_def = loader.model_definitions[audit_model_name]
  unless model_def
    message = "Model has auditing: true but audit model '#{audit_model_name}' is not defined. " \
              "Run: rails generate lcp_ruby:auditing"

    # When running inside a generator, skip the hard error so the generator
    # can boot the app and create the missing files (chicken-and-egg).
    if LcpRuby.generator_context?
      Rails.logger.warn("[LcpRuby::Auditing] #{message}")
      return
    end

    raise MetadataError, message
  end

  # Validate the model meets the contract
  result = ContractValidator.validate(model_def)
  unless result.valid?
    raise MetadataError, "Audit model '#{audit_model_name}' does not satisfy the contract:\n" \
                         "#{result.errors.map { |e| "  - #{e}" }.join("\n")}"
  end

  result.warnings.each do |warning|
    if defined?(Rails) && Rails.respond_to?(:logger)
      Rails.logger.warn("[LcpRuby::Auditing] #{warning}")
    end
  end

  # Mark registry as available
  Registry.mark_available!
end