🥔✨ Journal: Sprout Keywords#show (#1649)

* 🥔✨ `Journal`: Sprout `Keywords#show`

- https://github.com/zinc-collective/convene/issues/1566
- https://github.com/zinc-collective/convene/issues/1662

* Show Entries that match a Keyword or it's Aliases

* Use the canonical-keyword when building urls

* `Journal`: Extract `Entry.matching_keywords([...])` scope

* Spiff up the Presentation a touch

app/furniture/journal/entry.rb

@@ -32,6 +32,8 @@ class Entry < ApplicationRecord
     has_one :space, through: :journal
     before_save :extract_keywords, if: :will_save_change_to_body?
 
+    scope :matching_keywords, ->(keywords) { where("keywords::text[] && ARRAY[?]::text[]", keywords) }
+
     def published?
       published_at.present?
     end

app/furniture/journal/keyword.rb

@@ -1,6 +1,7 @@
 class Journal
   class Keyword < ApplicationRecord
     location(parent: :journal)
+    extend StripsNamespaceFromModelName
 
     self.table_name = "journal_keywords"
     validates :canonical_keyword, presence: true, uniqueness: {case_sensitive: false, scope: :journal_id}
@@ -11,6 +12,14 @@ class Keyword < ApplicationRecord
           .or(where("lower(canonical_keyword) IN (?)", keywords.map(&:downcase)))
     end)
 
+    def entries
+      journal.entries.matching_keywords([canonical_keyword] + (aliases.presence || []))
+    end
+
+    def to_param
+      canonical_keyword
+    end
+
     def self.extract_and_create_from!(body)
       body.scan(/#(\w+)/)&.flatten&.map do |keyword|
         existing_keyword = search(keyword).first

app/furniture/journal/keyword_policy.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+class Journal
+  class KeywordPolicy < ApplicationPolicy
+    alias_method :keyword, :object
+
+    def show?
+      true
+    end
+
+    class Scope < ApplicationScope
+      def resolve
+        scope
+      end
+    end
+  end
+end

app/furniture/journal/keywords/show.html.erb

@@ -0,0 +1,11 @@
+<h1><%= keyword.canonical_keyword %></h1>
+<%- if keyword.aliases.present? %>
+  <p class="italic">Also known as <%= to_sentence(keyword.aliases) %></p>
+<%- end %>
+
+<h2>Entries about <span class="italic"><%= keyword.canonical_keyword %></span></h2>
+<ul>
+  <%- policy_scope(keyword.entries).each do |entry|%>
+    <li><%= link_to(entry.headline, entry.location) %></li>
+  <%- end %>
+</ul>

app/furniture/journal/keywords_controller.rb

@@ -0,0 +1,11 @@
+class Journal
+  class KeywordsController < FurnitureController
+    expose(:keyword, scope: -> { policy_scope(journal.keywords) }, model: Keyword,
+      find: ->(id, scope) { scope.find_by(canonical_keyword: id) })
+
+    expose(:journal, -> { Journal.find(params[:journal_id]) })
+    def show
+      authorize(keyword)
+    end
+  end
+end

app/furniture/journal/routes.rb

@@ -1,8 +1,9 @@
 class Journal
   class Routes
     def self.append_routes(router)
-      router.resources :journals do
-        router.resources :entries, module: "journal"
+      router.resources :journals, module: "journal" do
+        router.resources :entries
+        router.resources :keywords, only: [:show]
       end
     end
   end

spec/factories/furniture/journal.rb

@@ -11,6 +11,7 @@
   end
 
   factory :journal_keyword, class: "Journal::Keyword" do
+    canonical_keyword { Faker::Fantasy::Tolkien.location }
     journal
   end
 end

spec/furniture/journal/keywords_controller_request_spec.rb

@@ -0,0 +1,14 @@
+require "rails_helper"
+
+RSpec.describe Journal::KeywordsController, type: :request do
+  describe "#show" do
+    subject(:perform_request) do
+      get polymorphic_path(keyword.location)
+      response
+    end
+
+    let(:keyword) { create(:journal_keyword) }
+
+    it { is_expected.to be_ok }
+  end
+end