Restructure omni services and add Chatwoot research snapshot

research/chatwoot/app/controllers/public/api/v1/portals/articles_controller.rb

@@ -0,0 +1,88 @@
+class Public::Api::V1::Portals::ArticlesController < Public::Api::V1::Portals::BaseController
+  before_action :ensure_custom_domain_request, only: [:show, :index]
+  before_action :portal
+  before_action :set_category, except: [:index, :show, :tracking_pixel]
+  before_action :set_article, only: [:show]
+  layout 'portal'
+
+  def index
+    @articles = @portal.articles.published.includes(:category, :author)
+
+    @articles = @articles.where(locale: permitted_params[:locale]) if permitted_params[:locale].present?
+
+    @articles_count = @articles.count
+
+    search_articles
+    order_by_sort_param
+    limit_results
+  end
+
+  def show
+    @og_image_url = helpers.set_og_image_url(@portal.name, @article.title)
+  end
+
+  def tracking_pixel
+    @article = @portal.articles.find_by(slug: permitted_params[:article_slug])
+    return head :not_found unless @article
+
+    @article.increment_view_count if @article.published?
+
+    # Serve the 1x1 tracking pixel with 24-hour private cache
+    # Private cache bypasses CDN but allows browser caching to prevent duplicate views from same user
+    expires_in 24.hours, public: false
+    response.headers['Content-Type'] = 'image/png'
+
+    pixel_path = Rails.public_path.join('assets/images/tracking-pixel.png')
+    send_file pixel_path, type: 'image/png', disposition: 'inline'
+  end
+
+  private
+
+  def limit_results
+    return if list_params[:per_page].blank?
+
+    per_page = [list_params[:per_page].to_i, 100].min
+    per_page = 25 if per_page < 1
+    @articles = @articles.page(list_params[:page]).per(per_page)
+  end
+
+  def search_articles
+    @articles = @articles.search(list_params) if list_params.present?
+  end
+
+  def order_by_sort_param
+    @articles = if list_params[:sort].present? && list_params[:sort] == 'views'
+                  @articles.order_by_views
+                else
+                  @articles.order_by_position
+                end
+  end
+
+  def set_article
+    @article = @portal.articles.find_by(slug: permitted_params[:article_slug])
+    @parsed_content = render_article_content(@article.content)
+  end
+
+  def set_category
+    return if permitted_params[:category_slug].blank?
+
+    @category = @portal.categories.find_by!(
+      slug: permitted_params[:category_slug],
+      locale: permitted_params[:locale]
+    )
+  end
+
+  def list_params
+    params.permit(:query, :locale, :sort, :status, :page, :per_page)
+  end
+
+  def permitted_params
+    params.permit(:slug, :category_slug, :locale, :id, :article_slug)
+  end
+
+  def render_article_content(content)
+    ChatwootMarkdownRenderer.new(content).render_article
+  end
+end
+
+Public::Api::V1::Portals::ArticlesController.prepend_mod_with('Public::Api::V1::Portals::ArticlesController')

research/chatwoot/app/controllers/public/api/v1/portals/base_controller.rb

@@ -0,0 +1,63 @@
+class Public::Api::V1::Portals::BaseController < PublicController
+  include SwitchLocale
+
+  before_action :show_plain_layout
+  before_action :set_color_scheme
+  before_action :set_global_config
+  around_action :set_locale
+  after_action :allow_iframe_requests
+
+  private
+
+  def show_plain_layout
+    @is_plain_layout_enabled = params[:show_plain_layout] == 'true'
+  end
+
+  def set_color_scheme
+    @theme_from_params = params[:theme] if %w[dark light].include?(params[:theme])
+  end
+
+  def portal
+    @portal ||= Portal.find_by!(slug: params[:slug], archived: false)
+  end
+
+  def set_locale(&)
+    switch_locale_with_portal(&) if params[:locale].present?
+    switch_locale_with_article(&) if params[:article_slug].present?
+
+    yield
+  end
+
+  def switch_locale_with_portal(&)
+    @locale = validate_and_get_locale(params[:locale])
+
+    I18n.with_locale(@locale, &)
+  end
+
+  def switch_locale_with_article(&)
+    article = Article.find_by(slug: params[:article_slug])
+    Rails.logger.info "Article: not found for slug: #{params[:article_slug]}"
+    render_404 && return if article.blank?
+
+    article_locale = if article.category.present?
+                       article.category.locale
+                     else
+                       article.portal.default_locale
+                     end
+    @locale = validate_and_get_locale(article_locale)
+    I18n.with_locale(@locale, &)
+  end
+
+  def allow_iframe_requests
+    response.headers.delete('X-Frame-Options') if @is_plain_layout_enabled
+  end
+
+  def render_404
+    portal
+    render 'public/api/v1/portals/error/404', status: :not_found
+  end
+
+  def set_global_config
+    @global_config = GlobalConfig.get('LOGO_THUMBNAIL', 'BRAND_NAME', 'BRAND_URL', 'INSTALLATION_NAME')
+  end
+end

research/chatwoot/app/controllers/public/api/v1/portals/categories_controller.rb

@@ -0,0 +1,23 @@
+class Public::Api::V1::Portals::CategoriesController < Public::Api::V1::Portals::BaseController
+  before_action :ensure_custom_domain_request, only: [:show, :index]
+  before_action :portal
+  before_action :set_category, only: [:show]
+  layout 'portal'
+
+  def index
+    @categories = @portal.categories.order(position: :asc)
+  end
+
+  def show
+    @og_image_url = helpers.set_og_image_url(@portal.name, @category.name)
+  end
+
+  private
+
+  def set_category
+    @category = @portal.categories.find_by(locale: params[:locale], slug: params[:category_slug])
+
+    Rails.logger.info "Category: not found for slug: #{params[:category_slug]}"
+    render_404 && return if @category.blank?
+  end
+end