WIP

Author: iHiD

app/commands/localization/glossary_entry/create.rb

@@ -0,0 +1,14 @@
+class Localization::GlossaryEntry::Create
+  include Mandate
+
+  initialize_with :locale, :term, :translation, :llm_instructions
+
+  def call
+    Localization::GlossaryEntry.create!(
+      locale:,
+      term:,
+      translation:,
+      llm_instructions:
+    )
+  end
+end

app/commands/localization/glossary_entry_proposal/approve.rb

@@ -0,0 +1,53 @@
+class Localization::GlossaryEntryProposal::Approve
+  include Mandate
+
+  initialize_with :proposal, :user
+
+  def call
+    ActiveRecord::Base.transaction do
+      proposal.update!(
+        status: :approved,
+        reviewer: user
+      )
+      handle_glossary_update!
+    end
+  end
+
+  private
+  def handle_glossary_update!
+    send("handle_#{proposal.type.to_s.camelize(:lower)}!")
+  end
+
+  def handle_addition!
+    raise "Glossary entry already exists" if Localization::GlossaryEntry.exists?(locale: proposal.locale, term: proposal.term)
+
+    Localization::GlossaryEntry.create!(
+      locale: proposal.locale,
+      term: proposal.term,
+      translation: proposal.translation,
+      llm_instructions: proposal.llm_instructions
+    )
+  end
+
+  def handle_modification!
+    raise "No glossary entry to modify" if glossary_entry.nil?
+
+    glossary_entry.update!(
+      translation: proposal.translation,
+      llm_instructions: proposal.llm_instructions
+    )
+  end
+
+  def handle_deletion!
+    raise "No glossary entry to delete" if glossary_entry.nil?
+
+    # Retrieve this before destroying else we have a race
+    glossary_entry = proposal.glossary_entry
+
+    # Disassociate before deletion to avoid FK issues
+    proposal.update!(glossary_entry: nil)
+    glossary_entry.destroy!
+  end
+
+  delegate :glossary_entry, to: :proposal
+end

app/commands/localization/glossary_entry_proposal/create_addition.rb

@@ -0,0 +1,22 @@
+class Localization::GlossaryEntryProposal
+  class CreateAddition
+    include Mandate
+
+    initialize_with :term, :locale, :user, :translation, :llm_instructions
+
+    def call
+      ActiveRecord::Base.transaction do
+        Localization::GlossaryEntryProposal.create!(
+          type: :addition,
+          proposer: user,
+          term: term,
+          locale: locale,
+          translation: translation,
+          llm_instructions: llm_instructions
+        )
+      end.tap do |proposal| # rubocop:disable Style/MultilineBlockChain
+        VerifyWithLLM.defer(proposal)
+      end
+    end
+  end
+end

app/commands/localization/glossary_entry_proposal/create_deletion.rb

@@ -0,0 +1,17 @@
+class Localization::GlossaryEntryProposal
+  class CreateDeletion
+    include Mandate
+
+    initialize_with :glossary_entry, :user
+
+    def call
+      ActiveRecord::Base.transaction do
+        Localization::GlossaryEntryProposal.create!(
+          type: :deletion,
+          glossary_entry: glossary_entry,
+          proposer: user
+        )
+      end
+    end
+  end
+end

app/commands/localization/glossary_entry_proposal/create_modification.rb

@@ -0,0 +1,21 @@
+class Localization::GlossaryEntryProposal
+  class CreateModification
+    include Mandate
+
+    initialize_with :glossary_entry, :user, :translation, :llm_instructions
+
+    def call
+      ActiveRecord::Base.transaction do
+        Localization::GlossaryEntryProposal.create!(
+          type: :modification,
+          glossary_entry: glossary_entry,
+          proposer: user,
+          translation: translation,
+          llm_instructions: llm_instructions
+        )
+      end.tap do |proposal| # rubocop:disable Style/MultilineBlockChain
+        VerifyWithLLM.defer(proposal)
+      end
+    end
+  end
+end

app/commands/localization/glossary_entry_proposal/reject.rb

@@ -0,0 +1,16 @@
+class Localization::GlossaryEntryProposal::Reject
+  include Mandate
+
+  initialize_with :proposal, :user
+
+  def call
+    ActiveRecord::Base.transaction do
+      proposal.update!(
+        status: :rejected,
+        reviewer: user
+      )
+    end
+  end
+
+  delegate :glossary_entry, to: :proposal
+end

app/commands/localization/glossary_entry_proposal/update_value.rb

@@ -0,0 +1,13 @@
+class Localization::GlossaryEntryProposal
+  class UpdateValue
+    include Mandate
+
+    initialize_with :proposal, :user, :term, :translation, :llm_instructions
+
+    def call
+      proposal.update!(term:, translation:, llm_instructions:)
+
+      VerifyWithLLM.defer(proposal)
+    end
+  end
+end

app/commands/localization/glossary_entry_proposal/verify_with_llm.rb

@@ -0,0 +1,53 @@
+class Localization::GlossaryEntryProposal::VerifyWithLLM
+  include Mandate
+
+  initialize_with :proposal
+
+  def call
+    LLM::ExecGeminiFlash.(prompt, endpoint)
+  end
+
+  def endpoint
+    "localization_verify_glossary_entry_proposal?proposal_uuid=#{proposal.uuid}"
+  end
+
+  def prompt
+    <<~PROMPT
+      You are a localization expert.#{' '}
+      Your task is to verify the quality of a glossary entry proposal.
+      This glossary entry will be sent to future LLM translators when doing translation work.
+
+      The proposal has three parts:
+      - A term in English
+      - A proposed translation of that term into the target language
+      - Proposed instructions on how the term should be used by the LLM translator in the future
+
+      Respond with JSON containing two fields:
+      - `result`: "approved", "rejected" or "spam" based on the quality of the glossary entry.
+      - `reason`: A brief explanation of your decision.
+
+      You should use "approved" if the glossary entry is generally accurate and appropriate for the given context.
+      You should use "rejected" if the glossary entry has issues such as inaccuracies, poor phrasing, or is not suitable for the context.
+      You should use "spam" if the glossary entry is a serious step away from the intended purpose. For example, if it is trying to inject spam onto the website, or contains profanity etc. Use this with care as it will automatically block the user that proposed the change.
+
+      The target locale is `#{proposal.locale}`
+
+      The original glossary term was:
+      ~~~~~~
+      #{proposal.term}
+      ~~~~~~
+
+      This is information about how it's used:
+      ~~~~~~
+      #{proposal.llm_instructions}
+      ~~~~~~
+
+      The proposed glossary entry is:
+      ~~~~~~
+      #{proposal.translation}
+      ~~~~~~
+
+      Respond with JSON.
+    PROMPT
+  end
+end

app/commands/localization/translation_proposal/create.rb

@@ -13,7 +13,7 @@ def call
           modified_from_llm: true
         )
       end.tap do |proposal| # rubocop:disable Style/MultilineBlockChain
-        VerifyWithLLM.(proposal)
+        VerifyWithLLM.defer(proposal)
       end
     end
   end

app/commands/localization/translation_proposal/verify_with_llm.rb

@@ -8,7 +8,7 @@ def call
   end
 
   def endpoint
-    "localization_verify_llm_proposal?proposal_uuid=#{proposal.uuid}"
+    "localization_verify_translation_proposal?proposal_uuid=#{proposal.uuid}"
   end
 
   def prompt