Related gapped and gapless audio (#642)

* Add audio reprocess pipeline design spec

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

* add basic regex based Quran search

* add test cases

* use linear regexp

* Related gapped and gapless audio

---------

Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Author: naveed-ahmad

app/admin/audio/audio_file.rb

@@ -82,6 +82,40 @@
       row :created_at
       row :updated_at
     end
+
+    panel 'Audio URLs by source' do
+      resource_content = resource.recitation&.resource_content
+      sources = resource_content&.audio_sources || []
+
+      table do
+        thead do
+          tr do
+            th 'Source'
+            th 'URL'
+          end
+        end
+
+        tbody do
+          tr do
+            td 'default'
+            td do
+              link_to resource.audio_url, resource.audio_url, target: '_blank', rel: 'noopener' if resource.audio_url.present?
+            end
+          end
+
+          sources.each do |source, mapping|
+            tr do
+              td source
+              td do
+                url = resource.get_audio_url(source: mapping)
+                link_to url, url, target: '_blank', rel: 'noopener' if url.present?
+              end
+            end
+          end
+        end
+      end
+    end
+
     active_admin_comments
   end
 

app/admin/audio/audio_recitation.rb

@@ -18,6 +18,7 @@
                 :recitation_style_id,
                 :qirat_type_id,
                 :reciter_id,
+                :gapped_recitation_id,
                 :segment_locked
 
   scope :all
@@ -233,6 +234,11 @@
       row :resource_content do
         resource.get_resource_content
       end
+      row :gapped_recitation do
+        if resource.gapped_recitation
+          link_to resource.gapped_recitation.humanize, [:cms, resource.gapped_recitation]
+        end
+      end
       row :recitation_style
       row :qirat_type
       row :arabic_name
@@ -327,6 +333,9 @@
       f.input :qirat_type_id,
               as: :searchable_select,
               ajax: { resource: QiratType }
+      f.input :gapped_recitation_id,
+              as: :searchable_select,
+              ajax: { resource: Recitation }
     end
 
     f.actions

app/admin/audio/recitation.rb

@@ -133,6 +133,7 @@
       recitation_style_id
       resource_content_id
       qirat_type_id
+      gapless_recitation_id
       style
       segment_locked
       reciter_name
@@ -174,13 +175,36 @@
         end
       end
 
+      row :gapless_recitation do |r|
+        if r.gapless_recitation
+          link_to r.gapless_recitation.humanize, [:cms, r.gapless_recitation]
+        end
+      end
+
       row :approved do
         resource.approved?
       end
       row :segment_locked
       row :created_at
       row :updated_at
     end
+
+    panel "Audio files (#{resource.audio_files.size})" do
+      table_for resource.audio_files.order(:chapter_id, :verse_number) do
+        column :id do |audio_file|
+          link_to audio_file.id, [:cms, audio_file]
+        end
+        column :verse_key do |audio_file|
+          audio_file.verse_key
+        end
+        column :audio_url do |audio_file|
+          if audio_file.audio_url.present?
+            link_to audio_file.audio_url, audio_file.audio_url, target: '_blank', rel: 'noopener'
+          end
+        end
+      end
+    end
+
     active_admin_comments
   end
 
@@ -201,18 +225,15 @@
       f.input :qirat_type_id,
               as: :searchable_select,
               ajax: { resource: QiratType }
+      f.input :gapless_recitation_id,
+              as: :searchable_select,
+              ajax: { resource: Audio::Recitation }
       f.input :segment_locked
     end
 
     f.actions
   end
 
-  sidebar 'Audio files', only: :show do
-    div do
-      link_to 'View audio files', "/cms/audio_files?utf8=✓&q%5Brecitation_id_eq%5D=#{resource.id}"
-    end
-  end
-
   member_action :download_segments, method: ['get', 'put'] do
     authorize! :download, :from_admin
 

app/admin/content/resource_content.rb

@@ -449,9 +449,9 @@
     div do
       if resource.translation?
         if resource.one_word?
-          link_to 'WBW Translations', "/cms/word_translations?q%5Bresource_content_id_eq%5D==#{resource.id}"
+          link_to 'WBW Translations', "/cms/word_translations?q%5Bresource_content_id_eq%5D=#{resource.id}"
         else
-          link_to 'Translations', "/cms/translations?q%5Bresource_content_id_eq%5D==#{resource.id}"
+          link_to 'Translations', "/cms/translations?q%5Bresource_content_id_eq%5D=#{resource.id}"
         end
       elsif resource.tafsir?
         link_to 'Tafsir', "/cms/tafsirs?q%5Bresource_content_id_eq%5D=#{resource.id}&order=id_desc&commit=Filter"

app/models/audio/recitation.rb

@@ -49,6 +49,7 @@ class Recitation < QuranApiRecord
     has_many :related_recitations, class_name: 'Audio::RelatedRecitation', foreign_key: :audio_recitation_id, dependent: :delete_all
     has_many :audio_change_logs, class_name: 'Audio::ChangeLog', foreign_key: :audio_recitation_id, dependent: :delete_all
     has_many :audio_segments, class_name: 'Audio::Segment', foreign_key: :audio_recitation_id, dependent: :delete_all
+    has_one :gapped_recitation, class_name: 'Recitation', foreign_key: :gapless_recitation_id, dependent: :nullify
 
     belongs_to :section, class_name: 'Audio::Section', optional: true
     belongs_to :recitation_style, optional: true
@@ -292,7 +293,6 @@ def update_audio_stats
     end
 
     protected
-
     def update_related_resources
       if get_resource_content.nil?
         resource = build_resource_content

app/models/audio_file.rb

@@ -101,6 +101,14 @@ def file_name
     url.split('/').last
   end
 
+  def get_audio_url(source:)
+    cdn = source[:cdn]
+    path = source[:audio_path]
+    name = "#{chapter_id.to_s.rjust(3, '0')}#{verse_number.to_s.rjust(3, '0')}.mp3"
+
+    "#{cdn}/#{path}/#{name}"
+  end
+
   def segment_progress
     if segments_count.to_i.zero?
       0

app/models/recitation.rb

@@ -31,8 +31,10 @@ class Recitation < QuranApiRecord
   belongs_to :recitation_style
   belongs_to :qirat_type, optional: true
   belongs_to :resource_content, optional: true
+  belongs_to :gapless_recitation, class_name: 'Audio::Recitation', optional: true
 
   has_many :audio_files
+
   alias get_resource_content resource_content
 
   scope :approved, -> { where(approved: true) }

app/models/resource_content.rb

@@ -196,6 +196,24 @@ module SubType
     RootDetail = 'root-detail'
   end
 
+  def audio_sources
+    meta = fetch_metadata
+    sources = meta&.keys
+                .to_a
+                .select { |key| key.to_s.include?('cdn') }
+
+    source_mapping = {}
+    sources.each do |cdn_key|
+      source = cdn_key.split('-').first
+
+      source_mapping[source] ||= {}
+      source_mapping[source][:cdn] = meta_value(cdn_key)
+      source_mapping[source][:audio_path] = meta_value("#{source}-path")
+    end
+
+    source_mapping
+  end
+
   def get_language_name
     language_name.presence || language&.name
   end

db/migrate/20260623000000_add_gapless_recitation_to_recitations.rb

@@ -0,0 +1,8 @@
+class AddGaplessRecitationToRecitations < ActiveRecord::Migration[8.0]
+  def change
+    c = Recitation.connection
+
+    c.add_column :recitations, :gapless_recitation_id, :integer, if_not_exists: true
+    c.add_index :recitations, :gapless_recitation_id, unique: true, if_not_exists: true
+  end
+end

db/schema.rb

@@ -10,7 +10,7 @@
 #
 # It's strongly recommended that you check this file into your version control system.
 
-ActiveRecord::Schema[8.0].define(version: 2026_05_18_000000) do
+ActiveRecord::Schema[8.0].define(version: 2026_06_23_000000) do
   # These are extensions that must be enabled in order to support this database
   enable_extension "pg_catalog.plpgsql"
 
@@ -530,10 +530,10 @@
 
   create_table "synonyms", force: :cascade do |t|
     t.string "text"
-    t.text "synonyms"
     t.datetime "created_at", precision: nil, null: false
     t.datetime "updated_at", precision: nil, null: false
     t.jsonb "approved_synonyms", default: []
+    t.jsonb "synonyms", default: []
   end
 
   create_table "uloom_contents", force: :cascade do |t|
@@ -629,17 +629,6 @@
     t.index ["reviewed"], name: "index_versions_on_reviewed"
   end
 
-  create_table "word_mistakes", force: :cascade do |t|
-    t.integer "word_id", null: false
-    t.integer "mistake_count", default: 0, null: false
-    t.integer "char_start"
-    t.integer "char_end"
-    t.datetime "created_at", null: false
-    t.datetime "updated_at", null: false
-    t.index ["word_id", "char_start", "char_end"], name: "index_word_mistakes_on_word_id_and_char_start_and_char_end"
-    t.index ["word_id"], name: "index_word_mistakes_on_word_id"
-  end
-
   create_table "word_synonyms", force: :cascade do |t|
     t.integer "synonym_id"
     t.integer "word_id"