feat: Add support for the references in FAQs (#10699)

Currently, it’s unclear whether an FAQ item is generated from a
document, derived from a conversation, or added manually.

This PR resolves the issue by providing visibility into the source of
each FAQ. Users can now see whether an FAQ was generated or manually
added and, if applicable, by whom.

- Move the document_id to a polymorphic relation (documentable).
- Updated the APIs to accommodate the change.
- Update the service to add corresponding references. 
- Updated the specs.

<img width="1007" alt="Screenshot 2025-01-15 at 11 27 56 PM"
src="https://github.com/user-attachments/assets/7d58f798-19c0-4407-b3e2-748a919d14af"
/>

---------

Co-authored-by: Sivin Varghese <64252451+iamsivin@users.noreply.github.com>

db/migrate/20250116061033_convert_document_to_polymorphic_association.rb

@@ -0,0 +1,33 @@
+class ConvertDocumentToPolymorphicAssociation < ActiveRecord::Migration[7.0]
+  def up
+    add_column :captain_assistant_responses, :documentable_type, :string
+
+    # rubocop:disable Rails/SkipsModelValidations
+    Captain::AssistantResponse
+      .where
+      .not(document_id: nil)
+      .update_all(documentable_type: 'Captain::Document')
+    # rubocop:enable Rails/SkipsModelValidations
+    remove_index :captain_assistant_responses, :document_id if index_exists?(
+      :captain_assistant_responses, :document_id
+    )
+
+    rename_column :captain_assistant_responses, :document_id, :documentable_id
+    add_index :captain_assistant_responses, [:documentable_id, :documentable_type],
+              name: 'idx_cap_asst_resp_on_documentable'
+  end
+
+  def down
+    if index_exists?(
+      :captain_assistant_responses, [:documentable_id, :documentable_type], name: 'idx_cap_asst_resp_on_documentable'
+    )
+      remove_index :captain_assistant_responses, name: 'idx_cap_asst_resp_on_documentable'
+    end
+
+    rename_column :captain_assistant_responses, :documentable_id, :document_id
+    remove_column :captain_assistant_responses, :documentable_type
+    add_index :captain_assistant_responses, :document_id unless index_exists?(
+      :captain_assistant_responses, :document_id
+    )
+  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[7.0].define(version: 2025_01_16_000103) do
+ActiveRecord::Schema[7.0].define(version: 2025_01_16_061033) do
   # These extensions should be enabled to support this database
   enable_extension "pg_stat_statements"
   enable_extension "pg_trgm"
@@ -250,14 +250,15 @@ ActiveRecord::Schema[7.0].define(version: 2025_01_16_000103) do
     t.text "answer", null: false
     t.vector "embedding", limit: 1536
     t.bigint "assistant_id", null: false
-    t.bigint "document_id"
+    t.bigint "documentable_id"
     t.bigint "account_id", null: false
     t.datetime "created_at", null: false
     t.datetime "updated_at", null: false
     t.integer "status", default: 1, null: false
+    t.string "documentable_type"
     t.index ["account_id"], name: "index_captain_assistant_responses_on_account_id"
     t.index ["assistant_id"], name: "index_captain_assistant_responses_on_assistant_id"
-    t.index ["document_id"], name: "index_captain_assistant_responses_on_document_id"
+    t.index ["documentable_id", "documentable_type"], name: "idx_cap_asst_resp_on_documentable"
     t.index ["embedding"], name: "vector_idx_knowledge_entries_embedding", using: :ivfflat
     t.index ["status"], name: "index_captain_assistant_responses_on_status"
   end