Class: ProductLine::PublicationRetriever

Inherits:
BaseService show all
Defined in:
app/services/product_line/publication_retriever.rb

Overview

Service object: publication retriever.

Defined Under Namespace

Classes: Result

Instance Attribute Summary

Attributes inherited from BaseService

#options

Instance Method Summary collapse

Methods inherited from BaseService

#initialize, #log_debug, #log_error, #log_info, #log_warning, #logger, #tagged_logger

Constructor Details

This class inherits a constructor from BaseService

Instance Method Details

#process(product_line_url, categories: nil, locale: nil, tags: nil, product_category_ids: nil, ignore_item_specific_documents: false, publication_category_paths: nil) ⇒ Object

A Result object with

  • +all_publications+ - an array of all publications combined
  • +publications_grouped+ - a hash of publications grouped by their category


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
47
 
# File 'app/services/product_line/publication_retriever.rb', line 13

def process(product_line_url, categories: nil, locale: nil, tags: nil, product_category_ids: nil, ignore_item_specific_documents: false, publication_category_paths: nil)
  locale ||= I18n.locale unless locale == :all
  store_id = Store.store_id_for_locale(locale) unless locale == :all || locale.nil?
  categories = %i[support sales] if categories.blank?
  categories = [categories].flatten.compact
  publications = []

  if categories.include?(:all) || categories.blank?
    publications += retrieve_all_publications(product_line_url, store_id,
                                              tags:,
                                              product_category_ids:,
                                              ignore_item_specific_documents:,
                                              publication_category_paths:)
  else
    if categories.include?(:support)
      publications += retrieve_support_publications(product_line_url, store_id,
                                                    tags:,
                                                    product_category_ids:,
                                                    ignore_item_specific_documents:,
                                                    publication_category_paths:)
    end
    if categories.include?(:sales)
      publications += retrieve_sales_publications(product_line_url, store_id,
                                                  tags:,
                                                  product_category_ids:,
                                                  ignore_item_specific_documents:,
                                                  publication_category_paths:)
    end
  end

  publications = publications.compact.sort_by { |p| [p.product_category_priority, (p.name.presence || p.name_en).downcase] }.uniq
  publications_grouped = publications.group_by(&:product_category)

  Result.new(all_publications: publications, publications_grouped:)
end

#publication_query(query, product_line_paths, store_id: nil, tags: nil, product_category_ids: nil, ignore_item_specific_documents: false, publication_category_paths: nil) ⇒ Object

Uses ltree paths for efficient queries (no additional DB lookups for path resolution)

Parameters:

  • publication_category_paths (String, Array<String>, nil) (defaults to: nil) —

    ltree paths (e.g., LtreePaths::PC_PUBLICATIONS_INSTALLATION)

  • query (Object)
  • product_line_paths (Object)
  • store_id (Object, nil) (defaults to: nil)
  • tags (Object, nil) (defaults to: nil)
  • product_category_ids (Object, nil) (defaults to: nil)
  • ignore_item_specific_documents (Boolean) (defaults to: false) 


85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
 
# File 'app/services/product_line/publication_retriever.rb', line 85

def publication_query(query, product_line_paths, store_id: nil, tags: nil, product_category_ids: nil, ignore_item_specific_documents: false, publication_category_paths: nil)
  # We use full tree query because if provided e.g snow_melting.mat.120_v we want snow_melting.mat and snow_melting publications
  logger.debug "Publication query with product_line_paths: #{product_line_paths.inspect}, product_category_ids: #{product_category_ids.inspect}, store_id: #{store_id.inspect}, tags: #{tags.inspect}, ignore_item_specific_documents: #{ignore_item_specific_documents}"
  res = query.publications.with_publication_attached.active.includes(:product_category).by_product_line_path_full(product_line_paths)
  res = res.in_store(store_id) if store_id.present?
  res = res.where.not(ignore_product_line_on_item_view: true) if ignore_item_specific_documents
  res = res.tagged_with(tags) if tags.present?
  # Use ltree paths directly for hierarchical query (no DB lookup needed)
  if publication_category_paths.present?
    paths = [publication_category_paths].flatten.compact
    res = res.by_product_category_path(paths.first) if paths.any?
  end
  if product_category_ids.present?
    # Take publications tagged specifically for this product category or which don't have a product category specified
    # e.g if you ask for goods-infrared-heating-panels-hardwired you get goods, infrared-heating-panels, and hardwired, and nil
    pc_ids = ProductCategory.self_and_ancestors_ids([product_category_ids].flatten.compact) + [nil]
    res = res.where(secondary_product_category_id: pc_ids)
  end
  res
end

#retrieve_all_publications(product_line_url, store_id, tags: nil, product_category_ids: nil, ignore_item_specific_documents: false, publication_category_paths: nil) ⇒ Object 



68
69
70
71
72
73
74
75
 
# File 'app/services/product_line/publication_retriever.rb', line 68

def retrieve_all_publications(product_line_url, store_id, tags: nil, product_category_ids: nil, ignore_item_specific_documents: false, publication_category_paths: nil)
  pl = ProductLine.find_by(slug_ltree: LtreePaths.slug_ltree_from_legacy_hyphen_url(product_line_url)) ||
       ProductLine.find_by(slug_ltree: product_line_url)
  return [] unless pl

  resolved_pl_paths = [pl.get_first_public&.ltree_path_slugs, pl.ltree_path_slugs].compact.uniq
  publication_query(Item.publications, resolved_pl_paths, store_id:, tags:, product_category_ids:, ignore_item_specific_documents:, publication_category_paths:)
end

#retrieve_sales_publications(product_line_url, store_id, tags: nil, product_category_ids: nil, ignore_item_specific_documents: false, publication_category_paths: nil) ⇒ Object 



59
60
61
62
63
64
65
66
 
# File 'app/services/product_line/publication_retriever.rb', line 59

def retrieve_sales_publications(product_line_url, store_id, tags: nil, product_category_ids: nil, ignore_item_specific_documents: false, publication_category_paths: nil)
  pl = ProductLine.find_by(slug_ltree: LtreePaths.slug_ltree_from_legacy_hyphen_url(product_line_url)) ||
       ProductLine.find_by(slug_ltree: product_line_url)
  return [] unless pl

  resolved_pl_paths = [pl.get_first_public_for_sales&.ltree_path_slugs, pl.ltree_path_slugs].compact.uniq
  publication_query(Item.publications_for_sales_portal, resolved_pl_paths, store_id:, tags:, product_category_ids:, ignore_item_specific_documents:, publication_category_paths:)
end

#retrieve_support_publications(product_line_url, store_id, tags: nil, product_category_ids: nil, ignore_item_specific_documents: false, publication_category_paths: nil) ⇒ Object 



49
50
51
52
53
54
55
56
57
 
# File 'app/services/product_line/publication_retriever.rb', line 49

def retrieve_support_publications(product_line_url, store_id, tags: nil, product_category_ids: nil, ignore_item_specific_documents: false, publication_category_paths: nil)
  # Get the product line and its first public for support - use ltree paths directly
  pl = ProductLine.find_by(slug_ltree: LtreePaths.slug_ltree_from_legacy_hyphen_url(product_line_url)) ||
       ProductLine.find_by(slug_ltree: product_line_url)
  return [] unless pl

  resolved_pl_paths = [pl.get_first_public_for_support&.ltree_path_slugs, pl.ltree_path_slugs].compact.uniq
  publication_query(Item.publications_for_support_portal, resolved_pl_paths, store_id:, tags:, product_category_ids:, ignore_item_specific_documents:, publication_category_paths:)
end