diff --git a/.rubocop.yml b/.rubocop.yml
index 33e8566af..ced9311e7 100644
--- a/.rubocop.yml
+++ b/.rubocop.yml
@@ -23,4 +23,8 @@ inherit_from:
AllCops:
SuggestExtensions: false
- TargetRubyVersion: 3.1
\ No newline at end of file
+ TargetRubyVersion: 3.1
+ Exclude:
+ - 'app/javascript/**/*.js'
+ - 'node_modules/**/*'
+ - 'vendor/**/*'
\ No newline at end of file
diff --git a/Gemfile b/Gemfile
index f97394d1a..16f3a851b 100644
--- a/Gemfile
+++ b/Gemfile
@@ -6,7 +6,7 @@ git_source(:github) { |repo| "https://github.com/#{repo}.git" }
ruby "3.2.8"
# Bundle edge Rails instead: gem 'rails', github: 'rails/rails', branch: 'main'
-gem "rails", "~> 7.2.2.1"
+gem "rails", "~> 7.2.2.2"
# Use postgresql as the database for Active Record
gem "pg", "~> 1.1"
# Use Puma as the app server
diff --git a/Gemfile.lock b/Gemfile.lock
index 24437a1b6..df1316151 100644
--- a/Gemfile.lock
+++ b/Gemfile.lock
@@ -54,7 +54,7 @@ GEM
erubi (~> 1.11)
rails-dom-testing (~> 2.2)
rails-html-sanitizer (~> 1.6)
- active_storage_validations (2.0.2)
+ active_storage_validations (3.0.1)
activejob (>= 6.1.4)
activemodel (>= 6.1.4)
activestorage (>= 6.1.4)
@@ -73,7 +73,7 @@ GEM
activemodel (= 7.2.2.2)
activesupport (= 7.2.2.2)
timeout (>= 0.4.0)
- activerecord-import (2.1.0)
+ activerecord-import (2.2.0)
activerecord (>= 4.2)
activerecord-postgis-adapter (10.0.1)
activerecord (~> 7.2.0)
@@ -189,13 +189,13 @@ GEM
concurrent-ruby (1.3.4)
connection_pool (2.5.3)
crass (1.0.6)
- cssbundling-rails (1.4.1)
+ cssbundling-rails (1.4.3)
railties (>= 6.0.0)
csv (3.2.6)
cuprite (0.15.1)
capybara (~> 3.0)
ferrum (~> 0.15.0)
- database_consistency (2.0.4)
+ database_consistency (2.0.5)
activerecord (>= 3.2)
date (3.4.1)
debug_inspector (1.2.0)
@@ -219,9 +219,9 @@ GEM
erubi (1.13.1)
factory_bot (6.5.1)
activesupport (>= 6.1.0)
- factory_bot_rails (6.4.4)
+ factory_bot_rails (6.5.0)
factory_bot (~> 6.5)
- railties (>= 5.0.0)
+ railties (>= 6.1.0)
faker (3.5.1)
i18n (>= 1.8.11, < 2)
faraday (2.12.2)
@@ -280,9 +280,9 @@ GEM
pp (>= 0.6.0)
rdoc (>= 4.0.0)
reline (>= 0.4.2)
- jbuilder (2.13.0)
- actionview (>= 5.0.0)
- activesupport (>= 5.0.0)
+ jbuilder (2.14.1)
+ actionview (>= 7.0.0)
+ activesupport (>= 7.0.0)
jmespath (1.6.2)
jquery-rails (4.6.0)
rails-dom-testing (>= 1, < 3)
@@ -616,10 +616,9 @@ GEM
uniform_notifier (1.16.0)
uri (1.1.1)
useragent (0.16.11)
- view_component (3.22.0)
- activesupport (>= 5.2.0, < 8.1)
- concurrent-ruby (= 1.3.4)
- method_source (~> 1.0)
+ view_component (4.0.2)
+ activesupport (>= 7.1.0, < 8.1)
+ concurrent-ruby (~> 1)
warden (1.2.9)
rack (>= 2.0.9)
web-console (4.2.1)
@@ -705,7 +704,7 @@ DEPENDENCIES
rack (~> 2.2.20)
rack-attack
rack-mini-profiler (~> 2.0)
- rails (~> 7.2.2.1)
+ rails (~> 7.2.2.2)
rails-controller-testing
recaptcha
redis (~> 4.0)
diff --git a/app/assets/images/Atlanticcity.svg b/app/assets/images/Atlanticcity.svg
new file mode 100644
index 000000000..816def839
--- /dev/null
+++ b/app/assets/images/Atlanticcity.svg
@@ -0,0 +1 @@
+
\ No newline at end of file
diff --git a/app/assets/images/Bus.svg b/app/assets/images/Bus.svg
new file mode 100644
index 000000000..da1018ca3
--- /dev/null
+++ b/app/assets/images/Bus.svg
@@ -0,0 +1 @@
+
\ No newline at end of file
diff --git a/app/assets/images/California.svg b/app/assets/images/California.svg
new file mode 100644
index 000000000..81608ea36
--- /dev/null
+++ b/app/assets/images/California.svg
@@ -0,0 +1 @@
+
\ No newline at end of file
diff --git a/app/assets/images/Car.svg b/app/assets/images/Car.svg
new file mode 100644
index 000000000..427a028a7
--- /dev/null
+++ b/app/assets/images/Car.svg
@@ -0,0 +1 @@
+
\ No newline at end of file
diff --git a/app/assets/images/Caregiver.svg b/app/assets/images/Caregiver.svg
new file mode 100644
index 000000000..379d7b363
--- /dev/null
+++ b/app/assets/images/Caregiver.svg
@@ -0,0 +1 @@
+
\ No newline at end of file
diff --git a/app/assets/images/Donation.svg b/app/assets/images/Donation.svg
new file mode 100644
index 000000000..4fec48fdc
--- /dev/null
+++ b/app/assets/images/Donation.svg
@@ -0,0 +1 @@
+
\ No newline at end of file
diff --git a/app/assets/images/Donatioofgoos.svg b/app/assets/images/Donatioofgoos.svg
new file mode 100644
index 000000000..1cddb698b
--- /dev/null
+++ b/app/assets/images/Donatioofgoos.svg
@@ -0,0 +1 @@
+
\ No newline at end of file
diff --git a/app/assets/images/Event.svg b/app/assets/images/Event.svg
new file mode 100644
index 000000000..04f574129
--- /dev/null
+++ b/app/assets/images/Event.svg
@@ -0,0 +1 @@
+
\ No newline at end of file
diff --git a/app/assets/images/Explore.svg b/app/assets/images/Explore.svg
new file mode 100644
index 000000000..f52593c09
--- /dev/null
+++ b/app/assets/images/Explore.svg
@@ -0,0 +1 @@
+
\ No newline at end of file
diff --git a/app/assets/images/Hardship.svg b/app/assets/images/Hardship.svg
new file mode 100644
index 000000000..6297209b1
--- /dev/null
+++ b/app/assets/images/Hardship.svg
@@ -0,0 +1 @@
+
\ No newline at end of file
diff --git a/app/assets/images/Inperson.svg b/app/assets/images/Inperson.svg
new file mode 100644
index 000000000..f8fe5031d
--- /dev/null
+++ b/app/assets/images/Inperson.svg
@@ -0,0 +1 @@
+
\ No newline at end of file
diff --git a/app/assets/images/Inpersonremote.svg b/app/assets/images/Inpersonremote.svg
new file mode 100644
index 000000000..a82d5ba76
--- /dev/null
+++ b/app/assets/images/Inpersonremote.svg
@@ -0,0 +1 @@
+
\ No newline at end of file
diff --git a/app/assets/images/Longterm.svg b/app/assets/images/Longterm.svg
new file mode 100644
index 000000000..8d317bd36
--- /dev/null
+++ b/app/assets/images/Longterm.svg
@@ -0,0 +1 @@
+
\ No newline at end of file
diff --git a/app/assets/images/Makedonation.svg b/app/assets/images/Makedonation.svg
new file mode 100644
index 000000000..ba9e08543
--- /dev/null
+++ b/app/assets/images/Makedonation.svg
@@ -0,0 +1 @@
+
\ No newline at end of file
diff --git a/app/assets/images/Moneydonation.svg b/app/assets/images/Moneydonation.svg
new file mode 100644
index 000000000..dd89db029
--- /dev/null
+++ b/app/assets/images/Moneydonation.svg
@@ -0,0 +1 @@
+
\ No newline at end of file
diff --git a/app/assets/images/Myself.svg b/app/assets/images/Myself.svg
new file mode 100644
index 000000000..4d773f57c
--- /dev/null
+++ b/app/assets/images/Myself.svg
@@ -0,0 +1 @@
+
\ No newline at end of file
diff --git a/app/assets/images/Organization.svg b/app/assets/images/Organization.svg
new file mode 100644
index 000000000..91d86bf50
--- /dev/null
+++ b/app/assets/images/Organization.svg
@@ -0,0 +1 @@
+
\ No newline at end of file
diff --git a/app/assets/images/Partnership.svg b/app/assets/images/Partnership.svg
new file mode 100644
index 000000000..91b97d6d7
--- /dev/null
+++ b/app/assets/images/Partnership.svg
@@ -0,0 +1 @@
+
\ No newline at end of file
diff --git a/app/assets/images/Physical or remote opportunities.svg b/app/assets/images/Physical or remote opportunities.svg
new file mode 100644
index 000000000..1007f9712
--- /dev/null
+++ b/app/assets/images/Physical or remote opportunities.svg
@@ -0,0 +1 @@
+
\ No newline at end of file
diff --git a/app/assets/images/Recurringgivingengagement.svg b/app/assets/images/Recurringgivingengagement.svg
new file mode 100644
index 000000000..54f471fa6
--- /dev/null
+++ b/app/assets/images/Recurringgivingengagement.svg
@@ -0,0 +1 @@
+
\ No newline at end of file
diff --git a/app/assets/images/SeniorsorChild.svg b/app/assets/images/SeniorsorChild.svg
new file mode 100644
index 000000000..b4fc36f8b
--- /dev/null
+++ b/app/assets/images/SeniorsorChild.svg
@@ -0,0 +1 @@
+
\ No newline at end of file
diff --git a/app/assets/images/Someoneelse.svg b/app/assets/images/Someoneelse.svg
new file mode 100644
index 000000000..7582b711c
--- /dev/null
+++ b/app/assets/images/Someoneelse.svg
@@ -0,0 +1 @@
+
\ No newline at end of file
diff --git a/app/assets/images/Specific.svg b/app/assets/images/Specific.svg
new file mode 100644
index 000000000..90a978454
--- /dev/null
+++ b/app/assets/images/Specific.svg
@@ -0,0 +1 @@
+
\ No newline at end of file
diff --git a/app/assets/images/Specificlocation.svg b/app/assets/images/Specificlocation.svg
new file mode 100644
index 000000000..1ba09e463
--- /dev/null
+++ b/app/assets/images/Specificlocation.svg
@@ -0,0 +1 @@
+
\ No newline at end of file
diff --git a/app/assets/images/Student.svg b/app/assets/images/Student.svg
new file mode 100644
index 000000000..016e38880
--- /dev/null
+++ b/app/assets/images/Student.svg
@@ -0,0 +1 @@
+
\ No newline at end of file
diff --git a/app/assets/images/Tennesse.svg b/app/assets/images/Tennesse.svg
new file mode 100644
index 000000000..2d804543c
--- /dev/null
+++ b/app/assets/images/Tennesse.svg
@@ -0,0 +1 @@
+
\ No newline at end of file
diff --git a/app/assets/images/Update.svg b/app/assets/images/Update.svg
new file mode 100644
index 000000000..dc8388777
--- /dev/null
+++ b/app/assets/images/Update.svg
@@ -0,0 +1 @@
+
\ No newline at end of file
diff --git a/app/assets/images/Urgent.svg b/app/assets/images/Urgent.svg
new file mode 100644
index 000000000..3ac01e113
--- /dev/null
+++ b/app/assets/images/Urgent.svg
@@ -0,0 +1 @@
+
\ No newline at end of file
diff --git a/app/assets/images/Volunteeringorevents.svg b/app/assets/images/Volunteeringorevents.svg
new file mode 100644
index 000000000..19e99855e
--- /dev/null
+++ b/app/assets/images/Volunteeringorevents.svg
@@ -0,0 +1 @@
+
\ No newline at end of file
diff --git a/app/assets/images/Walking.svg b/app/assets/images/Walking.svg
new file mode 100644
index 000000000..5258ae0f2
--- /dev/null
+++ b/app/assets/images/Walking.svg
@@ -0,0 +1 @@
+
\ No newline at end of file
diff --git a/app/assets/images/accessible_opp.svg b/app/assets/images/accessible_opp.svg
new file mode 100644
index 000000000..83311076d
--- /dev/null
+++ b/app/assets/images/accessible_opp.svg
@@ -0,0 +1 @@
+
\ No newline at end of file
diff --git a/app/assets/images/anywhere.svg b/app/assets/images/anywhere.svg
new file mode 100644
index 000000000..5693a187f
--- /dev/null
+++ b/app/assets/images/anywhere.svg
@@ -0,0 +1 @@
+
\ No newline at end of file
diff --git a/app/assets/images/backstage.svg b/app/assets/images/backstage.svg
new file mode 100644
index 000000000..8cc2a340a
--- /dev/null
+++ b/app/assets/images/backstage.svg
@@ -0,0 +1 @@
+
\ No newline at end of file
diff --git a/app/assets/images/both_remote_inperson.svg b/app/assets/images/both_remote_inperson.svg
new file mode 100644
index 000000000..48b2b950f
--- /dev/null
+++ b/app/assets/images/both_remote_inperson.svg
@@ -0,0 +1 @@
+
\ No newline at end of file
diff --git a/app/assets/images/disability.svg b/app/assets/images/disability.svg
new file mode 100644
index 000000000..b2b8f2e12
--- /dev/null
+++ b/app/assets/images/disability.svg
@@ -0,0 +1 @@
+
\ No newline at end of file
diff --git a/app/assets/images/donation_donors.svg b/app/assets/images/donation_donors.svg
new file mode 100644
index 000000000..6a7766f62
--- /dev/null
+++ b/app/assets/images/donation_donors.svg
@@ -0,0 +1 @@
+
\ No newline at end of file
diff --git a/app/assets/images/family.svg b/app/assets/images/family.svg
new file mode 100644
index 000000000..4f47d885e
--- /dev/null
+++ b/app/assets/images/family.svg
@@ -0,0 +1 @@
+
\ No newline at end of file
diff --git a/app/assets/images/general_donation.svg b/app/assets/images/general_donation.svg
new file mode 100644
index 000000000..c4449b4c6
--- /dev/null
+++ b/app/assets/images/general_donation.svg
@@ -0,0 +1 @@
+
\ No newline at end of file
diff --git a/app/assets/images/goods_items.svg b/app/assets/images/goods_items.svg
new file mode 100644
index 000000000..4a8df43cf
--- /dev/null
+++ b/app/assets/images/goods_items.svg
@@ -0,0 +1 @@
+
\ No newline at end of file
diff --git a/app/assets/images/in-person.svg b/app/assets/images/in-person.svg
new file mode 100644
index 000000000..bbaab6107
--- /dev/null
+++ b/app/assets/images/in-person.svg
@@ -0,0 +1 @@
+
\ No newline at end of file
diff --git a/app/assets/images/lgbtqia.svg b/app/assets/images/lgbtqia.svg
new file mode 100644
index 000000000..093e63cbc
--- /dev/null
+++ b/app/assets/images/lgbtqia.svg
@@ -0,0 +1 @@
+
\ No newline at end of file
diff --git a/app/assets/images/near_me.svg b/app/assets/images/near_me.svg
new file mode 100644
index 000000000..2c3089196
--- /dev/null
+++ b/app/assets/images/near_me.svg
@@ -0,0 +1 @@
+
\ No newline at end of file
diff --git a/app/assets/images/no_id.svg b/app/assets/images/no_id.svg
new file mode 100644
index 000000000..0962c836a
--- /dev/null
+++ b/app/assets/images/no_id.svg
@@ -0,0 +1 @@
+
\ No newline at end of file
diff --git a/app/assets/images/open_volunteering.svg b/app/assets/images/open_volunteering.svg
new file mode 100644
index 000000000..6d8a33c41
--- /dev/null
+++ b/app/assets/images/open_volunteering.svg
@@ -0,0 +1 @@
+
\ No newline at end of file
diff --git a/app/assets/images/other_languages.svg b/app/assets/images/other_languages.svg
new file mode 100644
index 000000000..492a4d88c
--- /dev/null
+++ b/app/assets/images/other_languages.svg
@@ -0,0 +1 @@
+
\ No newline at end of file
diff --git a/app/assets/images/receive-help.svg b/app/assets/images/receive-help.svg
new file mode 100644
index 000000000..2ee108139
--- /dev/null
+++ b/app/assets/images/receive-help.svg
@@ -0,0 +1 @@
+
\ No newline at end of file
diff --git a/app/assets/images/recurring.svg b/app/assets/images/recurring.svg
new file mode 100644
index 000000000..9cc7a3f4b
--- /dev/null
+++ b/app/assets/images/recurring.svg
@@ -0,0 +1 @@
+
\ No newline at end of file
diff --git a/app/assets/images/recurring_giving.svg b/app/assets/images/recurring_giving.svg
new file mode 100644
index 000000000..6e624ba21
--- /dev/null
+++ b/app/assets/images/recurring_giving.svg
@@ -0,0 +1 @@
+
\ No newline at end of file
diff --git a/app/assets/images/remote.svg b/app/assets/images/remote.svg
new file mode 100644
index 000000000..77bfa1cf2
--- /dev/null
+++ b/app/assets/images/remote.svg
@@ -0,0 +1 @@
+
\ No newline at end of file
diff --git a/app/assets/images/scale_free.svg b/app/assets/images/scale_free.svg
new file mode 100644
index 000000000..313c1ecb7
--- /dev/null
+++ b/app/assets/images/scale_free.svg
@@ -0,0 +1 @@
+
\ No newline at end of file
diff --git a/app/assets/images/seniors2.svg b/app/assets/images/seniors2.svg
new file mode 100644
index 000000000..3bf6fff63
--- /dev/null
+++ b/app/assets/images/seniors2.svg
@@ -0,0 +1 @@
+
\ No newline at end of file
diff --git a/app/assets/images/seniors_children.svg b/app/assets/images/seniors_children.svg
new file mode 100644
index 000000000..9cb9adc02
--- /dev/null
+++ b/app/assets/images/seniors_children.svg
@@ -0,0 +1 @@
+
\ No newline at end of file
diff --git a/app/assets/images/specific_place.svg b/app/assets/images/specific_place.svg
new file mode 100644
index 000000000..256691b39
--- /dev/null
+++ b/app/assets/images/specific_place.svg
@@ -0,0 +1 @@
+
\ No newline at end of file
diff --git a/app/assets/images/specific_project.svg b/app/assets/images/specific_project.svg
new file mode 100644
index 000000000..cf80570ad
--- /dev/null
+++ b/app/assets/images/specific_project.svg
@@ -0,0 +1 @@
+
\ No newline at end of file
diff --git a/app/assets/images/updates.svg b/app/assets/images/updates.svg
new file mode 100644
index 000000000..a48d02990
--- /dev/null
+++ b/app/assets/images/updates.svg
@@ -0,0 +1 @@
+
\ No newline at end of file
diff --git a/app/assets/images/women_bipoc.svg b/app/assets/images/women_bipoc.svg
new file mode 100644
index 000000000..116b5521b
--- /dev/null
+++ b/app/assets/images/women_bipoc.svg
@@ -0,0 +1 @@
+
\ No newline at end of file
diff --git a/app/assets/stylesheets/base/_layout.scss b/app/assets/stylesheets/base/_layout.scss
index 06cf2042c..60fa7555c 100644
--- a/app/assets/stylesheets/base/_layout.scss
+++ b/app/assets/stylesheets/base/_layout.scss
@@ -11,4 +11,6 @@ body {
.main {
flex: 1;
-}
+ position: relative;
+ z-index: 1; // Lower than navbar
+}
\ No newline at end of file
diff --git a/app/components/application_view_component.rb b/app/components/application_view_component.rb
index 28819c4bc..b2bd15e9c 100644
--- a/app/components/application_view_component.rb
+++ b/app/components/application_view_component.rb
@@ -1,2 +1,3 @@
class ApplicationViewComponent < ViewComponent::Base
+ include InlineSvg::ActionView::Helpers
end
diff --git a/app/components/navbar/component.scss b/app/components/navbar/component.scss
index ea4623662..f1f51412f 100644
--- a/app/components/navbar/component.scss
+++ b/app/components/navbar/component.scss
@@ -6,6 +6,8 @@
padding: 0 24px;
color: $copy-white;
background-color: $primary-dark-blue;
+ position: relative;
+ z-index: 1000; // High z-index to stay above other elements
@media (min-width: 768px) {
height: 91px;
@@ -29,7 +31,7 @@
}
@media (min-width: 1024px) {
- padding: 0 49px 0 39px ;
+ padding: 0 49px 0 39px;
}
@media (min-width: 1280px) {
@@ -43,20 +45,22 @@
}
@keyframes slide-in {
- 0% {
- transform: translateX(-300%);
- visibility: hidden;
+ 0% {
+ transform: translateX(-300%);
+ visibility: hidden;
opacity: 0;
- }
+ }
+
30% {
transform: translateX(-150%);
opacity: 0.5;
}
- 100% {
- transform: translateX(0);
- visibility: visible;
+
+ 100% {
+ transform: translateX(0);
+ visibility: visible;
opacity: 1;
- }
+ }
}
.sidebar-slide-out {
@@ -68,9 +72,11 @@
transform: translateX(0);
visibility: visible;
}
+
70% {
transform: translateX(-150%);
}
+
100% {
transform: translateX(-300%);
visibility: hidden;
@@ -107,4 +113,4 @@
width: 100%;
}
}
-}
+}
\ No newline at end of file
diff --git a/app/components/smart_match_card/actions_menu/component.html.slim b/app/components/smart_match_card/actions_menu/component.html.slim
new file mode 100644
index 000000000..d0b2c2ba6
--- /dev/null
+++ b/app/components/smart_match_card/actions_menu/component.html.slim
@@ -0,0 +1,8 @@
+nav class="flex justify-between"
+ // Nonprofit website
+ - website_url = (@location.website rescue "#")
+ = link_to website_url, class: action_button_styles[:button], target: "_blank" do
+ = render CauseIcon::Component.new(svg_name: "non_profit_cards/website.svg", \
+ wrapper_options: {class: action_button_styles[:icon_wrapper]}, \
+ svg_options: {class: "w-1/2", aria_hidden: true})
+ span class="#{action_button_styles[:copy]}" Visit Website
\ No newline at end of file
diff --git a/app/components/smart_match_card/actions_menu/component.rb b/app/components/smart_match_card/actions_menu/component.rb
new file mode 100644
index 000000000..73f73ef81
--- /dev/null
+++ b/app/components/smart_match_card/actions_menu/component.rb
@@ -0,0 +1,19 @@
+class SmartMatchCard::ActionsMenu::Component < ApplicationViewComponent
+ include ActionButtonHelper
+
+ def initialize(user:, location:)
+ @user = user
+ @location = location
+ end
+
+ def website_action_params
+ existing_website_url = @location.decorate.website || @location.organization&.decorate&.website
+ {
+ href: existing_website_url || "javascript:void(0);",
+ target: ("_blank" if existing_website_url),
+ button_styles: existing_website_url ? action_button_styles[:button] : "relative grid place-items-center pb-4 text-gray-4 cursor-auto",
+ icon_wrapper_styles: existing_website_url ? action_button_styles[:icon_wrapper] : "w-10 h-10 border border-gray-4",
+ icon_styles: ("disabled-icon" unless existing_website_url)
+ }
+ end
+end
diff --git a/app/components/smart_match_card/component.html.slim b/app/components/smart_match_card/component.html.slim
new file mode 100644
index 000000000..f929a80c8
--- /dev/null
+++ b/app/components/smart_match_card/component.html.slim
@@ -0,0 +1,32 @@
+article class="overflow-hidden text-xs font-medium bg-white rounded shadow-md h-full flex flex-col"
+ h2 class="w-0 h-0 opacity-0" = "#{@location.name} card"
+
+ // Cover (simple blue cover for Smart Match)
+ div class="relative w-full h-52 bg-blue-medium"
+
+ // Bottom Part
+ div class="px-5 pb-6 flex-1 flex flex-col"
+ // Card head
+ section class="relative pt-4 pb-7 font-normal text-gray-4"
+ h3 class="absolute w-0 h-0 opacity-0" head
+ = render SmartMatchCard::Head::Component.new(location: @location)
+ // Donate/Volunteer buttons
+ section class="relative w-full flex-1 flex flex-col justify-center"
+ h3 class="sr-only" altruistic menu
+ - find_help_link = @location.is_a?(Location) && @location.to_key.present? ? location_path(@location) : (@location.website rescue "#")
+ = render "locations/donate_volunteer_buttons", location: @location, container_styles: "flex flex-col gap-4 w-full pt-5 pb-3 border-t border-gray-8 text-base", find_help_link: find_help_link
+ // Actions menu
+ section class="pt-6 pb-11 border-t border-gray-8 flex-shrink-0"
+ h3 class="w-0 h-0 opacity-0" actions menu
+ = render SmartMatchCard::ActionsMenu::Component.new(user: @user, location: @location)
+ // Causes list
+ - causes = (@location.organization.causes.uniq rescue [])
+ section class="pt-5 border-t border-gray-8 flex-shrink-0"
+ h3 class="mb-4 text-sm font-semibold uppercase"
+ | causes
+ = render CausesList::Component.new( \
+ causes: causes, \
+ icon_svg_options: {class: "w-1/2", aria_hidden: true}, \
+ list_options: { class: "flex flex-wrap gap-3"}, \
+ cause_options: { class: "group interactive-btn w-24 text-sm transition-colors hover:text-blue-medium font-normal" }, \
+ icon_wrapper_options: { class: "thick-icon w-14 h-14 transition-colors group-hover:bg-blue-medium", aria_hidden: true})
\ No newline at end of file
diff --git a/app/components/smart_match_card/component.rb b/app/components/smart_match_card/component.rb
new file mode 100644
index 000000000..bd2ec9e10
--- /dev/null
+++ b/app/components/smart_match_card/component.rb
@@ -0,0 +1,8 @@
+class SmartMatchCard::Component < ApplicationViewComponent
+ include LocationsHelper
+
+ def initialize(user:, location:)
+ @user = user
+ @location = location
+ end
+end
diff --git a/app/components/smart_match_card/head/component.html.slim b/app/components/smart_match_card/head/component.html.slim
new file mode 100644
index 000000000..428e3eebe
--- /dev/null
+++ b/app/components/smart_match_card/head/component.html.slim
@@ -0,0 +1,31 @@
+div class="flex gap-x-5"
+ - link_url = @location.is_a?(Location) && @location.to_key.present? ? location_path(@location) : (@location.website rescue "#")
+ = link_to link_url, class: "flex-shrink-0 self-center rounded", target: '_blank' do
+ - logo = (@location.organization.logo rescue nil)
+ - if logo.present?
+ - if logo.to_s.end_with?('.svg')
+ = inline_svg_tag "causes_categories/#{logo}", class: "w-20 h-20 object-contain"
+ - else
+ - logo_src = logo.to_s rescue ""
+ img src=logo_src class="w-20 h-20 object-contain" alt="logo"
+ - else
+ = inline_svg_tag "causes_categories/human_social_services.svg", class: "w-20 h-20 object-contain"
+ div class="flex flex-col"
+ // name and verified icon
+ div class="flex items-start mb-1.5"
+ h4 class="text-lg font-semibold leading-6 text-gray-2 break-words"
+ = link_to(@location.name, link_url, target: "_blank")
+ - if (@location.organization.verified? rescue false)
+ = render partial: "shared/popover", locals: { position: "right-0", copy: "Information verified by nonprofit.", wrapper_icon: "verified_nonprofit_check.svg" }
+ // maps and phone
+ - if (@location.formatted_address rescue nil).present?
+ - maps_link = (@location.link_to_google_maps rescue @location.website rescue "#")
+ = link_to(@location.formatted_address, maps_link, class: "pop-out w-full break-words", target: "_blank")
+ - if (@location.phone_number rescue nil)
+ a href="tel:#{@location.phone_number.number}" = @location.phone_number.number
+ // Designations
+ - begin
+ - if (@location.organization.designations rescue nil)
+ = render DesignationTag::Component.new(@location.organization)
+ - rescue
+ - # Skip designations if there's an error
\ No newline at end of file
diff --git a/app/components/smart_match_card/head/component.rb b/app/components/smart_match_card/head/component.rb
new file mode 100644
index 000000000..a96d3b3e2
--- /dev/null
+++ b/app/components/smart_match_card/head/component.rb
@@ -0,0 +1,5 @@
+class SmartMatchCard::Head::Component < ApplicationViewComponent
+ def initialize(location:)
+ @location = location
+ end
+end
diff --git a/app/components/smart_match_card/images_carousel/component.html.slim b/app/components/smart_match_card/images_carousel/component.html.slim
new file mode 100644
index 000000000..275e6f7c0
--- /dev/null
+++ b/app/components/smart_match_card/images_carousel/component.html.slim
@@ -0,0 +1,21 @@
+div class="relative" data-controller="carousel"
+ div class="overflow-hidden rounded-sm" data-carousel-target="container" class=@carousel_container_options[:class]
+ - @images.each_with_index do |image, index|
+ div class="w-full h-52 flex-shrink-0 #{index == 0 ? '' : 'hidden'}" data-carousel-target="slide" data-index=index
+ - if image.to_s.end_with?('.svg')
+ = inline_svg_tag "causes_categories/#{image}", class: "w-full h-full object-contain"
+ - else
+ img src=image.to_s alt="carousel image" class="w-full h-full object-cover"
+
+ - if @images.length > 1
+ // Navigation arrows
+ button type="button" class="absolute left-2 top-1/2 transform -translate-y-1/2 bg-white bg-opacity-80 rounded-full p-2 shadow-md hover:bg-opacity-100 transition-opacity" data-action="click->carousel#previous"
+ = inline_svg_tag "non_profit_cards/arrow_left.svg", class: "w-4 h-4"
+
+ button type="button" class="absolute right-2 top-1/2 transform -translate-y-1/2 bg-white bg-opacity-80 rounded-full p-2 shadow-md hover:bg-opacity-100 transition-opacity" data-action="click->carousel#next"
+ = inline_svg_tag "non_profit_cards/arrow_right.svg", class: "w-4 h-4"
+
+ // Dots indicator
+ div class="absolute bottom-2 left-1/2 transform -translate-x-1/2 flex space-x-1"
+ - @images.each_with_index do |_, index|
+ button type="button" class="w-2 h-2 rounded-full #{index == 0 ? 'bg-white' : 'bg-white bg-opacity-50'}" data-action="click->carousel#goToSlide" data-index=index
\ No newline at end of file
diff --git a/app/components/smart_match_card/images_carousel/component.rb b/app/components/smart_match_card/images_carousel/component.rb
new file mode 100644
index 000000000..0a26848d3
--- /dev/null
+++ b/app/components/smart_match_card/images_carousel/component.rb
@@ -0,0 +1,6 @@
+class SmartMatchCard::ImagesCarousel::Component < ApplicationViewComponent
+ def initialize(images:, carousel_container_options: {})
+ @images = images
+ @carousel_container_options = carousel_container_options
+ end
+end
diff --git a/app/controllers/smart_match_controller.rb b/app/controllers/smart_match_controller.rb
new file mode 100644
index 000000000..c87b06459
--- /dev/null
+++ b/app/controllers/smart_match_controller.rb
@@ -0,0 +1,829 @@
+# frozen_string_literal: true
+
+# Services and models are now in standard Rails autoloading paths
+
+class SmartMatchController < ApplicationController
+ skip_before_action :authenticate_user!
+ skip_after_action :verify_policy_scoped
+ skip_after_action :verify_authorized
+
+ def index
+ # Clear any existing session data when starting fresh
+ session.delete(:smart_match_progress)
+ session.delete(:smart_match_answers)
+ session.delete(:user_intent)
+
+ # Main Smart Match introduction page
+ render "smart_match/views/index"
+ end
+
+ def quiz
+ @current_step = params[:step]&.to_i || 1
+ @user_intent = session[:user_intent] || params[:intent] || "seeking_help"
+
+ Rails.logger.debug { "Current Step: #{@current_step}" }
+ Rails.logger.debug { "User Intent: #{@user_intent}" }
+
+ # If user is starting fresh (step 1, no answer, no intent param), clear any existing session data
+ if @current_step == 1 && params[:answer].blank? && params[:intent].blank?
+ session.delete(:smart_match_progress)
+ session.delete(:smart_match_answers)
+ session.delete(:user_intent)
+ end
+
+ # Check if user has already completed the quiz
+ # Only redirect to results if user is trying to access step 1 without an intent parameter
+ # This allows going back to step 1 when the intent is preserved
+ if session[:smart_match_answers]&.keys&.any? && @current_step == 1 && params[:answer].blank? && params[:intent].blank?
+ # User has answers but is trying to access step 1 again without intent - redirect to results
+ redirect_to smart_match_results_path and return
+ end
+
+ # Store user intent from first question
+ if @current_step == 1 && params[:answer].present?
+ session[:user_intent] = params[:answer]
+ @user_intent = params[:answer]
+ end
+
+ # Determine total steps based on user intent
+ @total_steps = get_total_steps(@user_intent)
+
+ # Store quiz progress in session
+ session[:smart_match_progress] ||= {}
+ session[:smart_match_answers] ||= {}
+
+ # Handle quiz navigation
+ if params[:answer].present?
+ Rails.logger.debug { "Processing answer: #{params[:answer]}" }
+
+ # Parse the answer (handle both single and multiple choice)
+ answer = params[:answer]
+ begin
+ # Try to parse as JSON first
+ parsed_answer = JSON.parse(answer)
+ answer = parsed_answer
+ rescue JSON::ParserError
+ # If JSON parsing fails, use the raw string (for step 1 answers)
+ Rails.logger.debug { "JSON parsing failed, using raw string: #{answer}" }
+ end
+
+ Rails.logger.debug { "Parsed answer: #{answer}" }
+ Rails.logger.debug { "Current step: #{@current_step}" }
+ Rails.logger.debug { "User intent: #{@user_intent}" }
+
+ session[:smart_match_answers][@current_step] = answer
+
+ # Clear any subsequent answers when modifying a previous answer
+ # This ensures data consistency when navigating back and changing answers
+ session[:smart_match_answers].keys.each do |step_key|
+ if step_key.to_f > @current_step.to_f
+ session[:smart_match_answers].delete(step_key)
+ end
+ end
+
+ next_step = get_next_step(@current_step, @user_intent)
+ Rails.logger.debug { "Next step calculated: #{next_step}" }
+
+ if next_step
+ redirect_url = smart_match_quiz_path(step: next_step, intent: @user_intent)
+ Rails.logger.debug { "Redirecting to: #{redirect_url}" }
+ redirect_to redirect_url and return
+ else
+ Rails.logger.debug { "Redirecting to results" }
+ redirect_to smart_match_results_path and return
+ end
+ end
+
+ render "smart_match/views/quiz/quiz"
+ end
+
+ def results
+ @answers = session[:smart_match_answers] || {}
+ @user_intent = session[:user_intent]
+
+ Rails.logger.info "Smart Match Results - User Intent: #{@user_intent}"
+ Rails.logger.info "Smart Match Results - Answers: #{@answers}"
+
+ # Check if we have the minimum required data
+ if @answers.empty? || @user_intent.blank?
+ Rails.logger.warn "Smart Match Results - Missing required data, redirecting to index"
+ redirect_to smart_match_index_path and return
+ end
+
+ # Generate recommendations based on answers
+ begin
+ Rails.logger.info "Smart Match Results - Starting recommendation generation..."
+ result_data = generate_recommendations(@answers, @user_intent)
+ Rails.logger.info "Smart Match Results - Generated result_data: #{result_data.class}"
+
+ # Handle both old array format and new hash format for backward compatibility
+ if result_data.is_a?(Array)
+ Rails.logger.warn "Smart Match Results - Received array format, converting to hash format"
+ @recommendations = result_data
+ @threshold_metrics = calculate_threshold_metrics(result_data)
+ else
+ @recommendations = result_data[:recommendations] || []
+ @threshold_metrics = result_data[:threshold_metrics] || {}
+ end
+
+ # Ensure we have valid data
+ @recommendations = [] unless @recommendations.is_a?(Array)
+ @threshold_metrics = {} unless @threshold_metrics.is_a?(Hash)
+
+ Rails.logger.info "Smart Match Results - Final recommendations count: #{@recommendations.length}"
+ Rails.logger.info "Smart Match Results - Threshold metrics: #{@threshold_metrics}"
+ Rails.logger.info "Smart Match Results - Recommendations data: #{@recommendations.inspect}" if @recommendations.any?
+ Rails.logger.info "Smart Match Results - First recommendation: #{@recommendations.first.inspect}" if @recommendations.any?
+
+ # Debug: Check if recommendations have the expected structure
+ if @recommendations.any?
+ first_rec = @recommendations.first
+ Rails.logger.info "Smart Match Results - First recommendation structure:"
+ Rails.logger.info " - Keys: #{first_rec.keys}"
+ Rails.logger.info " - Has location: #{first_rec.key?(:location)}"
+ Rails.logger.info " - Location class: #{first_rec[:location].class}" if first_rec[:location]
+ if first_rec[:location]
+ Rails.logger.info " - Location name: #{begin
+ first_rec[:location].name
+ rescue
+ "N/A"
+ end}"
+ end
+ end
+ rescue => e
+ Rails.logger.error "Smart Match Results - Error generating recommendations: #{e.message}"
+ Rails.logger.error e.backtrace.join("\n")
+
+ # Set default values on error
+ @recommendations = []
+ @threshold_metrics = {
+ show_warning: true,
+ warning_message: "We encountered an error while generating your recommendations. Please try again.",
+ average_score: 0.0,
+ max_score: 0.0
+ }
+ end
+
+ # Don't clear session data immediately - let users refresh the page
+ # Session data will be cleared when they start over or complete a new quiz
+ # session.delete(:smart_match_progress)
+ # session.delete(:smart_match_answers)
+ # session.delete(:user_intent)
+
+ render "smart_match/views/results/results"
+ end
+
+ def current_answers
+ # Return current answers from session for AJAX requests
+ respond_to do |format|
+ format.json do
+ render json: {
+ answers: session[:smart_match_answers] || {},
+ user_intent: session[:user_intent]
+ }
+ end
+ end
+ end
+
+ def feedback
+ nonprofit_id = params[:nonprofit_id]
+ feedback_type = params[:feedback_type]
+ session_id = session.id.to_s
+
+ # Validate feedback type
+ unless %w[like dislike].include?(feedback_type)
+ render json: {error: "Invalid feedback type"}, status: :bad_request
+ return
+ end
+
+ # Check if feedback already exists
+ if RecommendationFeedback.feedback_given?(session_id, nonprofit_id)
+ render json: {error: "Feedback already provided for this nonprofit"}, status: :unprocessable_entity
+ return
+ end
+
+ # Create feedback record
+ feedback = RecommendationFeedback.new(
+ nonprofit_id: nonprofit_id,
+ feedback_type: feedback_type,
+ session_id: session_id,
+ user: current_user, # Will be nil if user not logged in
+ user_answers: session[:smart_match_answers]&.to_json,
+ recommendation_data: params[:recommendation_data]&.to_json
+ )
+
+ if feedback.save
+ render json: {
+ success: true,
+ message: "Thank you for your feedback!",
+ feedback_type: feedback_type
+ }
+ else
+ render json: {error: feedback.errors.full_messages.join(", ")}, status: :unprocessable_entity
+ end
+ end
+
+ helper_method :get_previous_step, :needs_language_support?, :get_step_sequence, :needs_location_details?
+
+ # Generate recommendations using BGE matrix and methods with fallback
+ def generate_recommendations(answers, user_intent)
+ Rails.logger.info "Smart Match - Starting recommendation generation"
+ Rails.logger.info "Smart Match - Answers: #{answers}"
+ Rails.logger.info "Smart Match - User intent: #{user_intent}"
+
+ begin
+ # Try the comprehensive recommendation service first (BGE-based)
+ Rails.logger.info "Smart Match - Converting quiz answers to UserIntent..."
+ converter = QuizToUserIntentConverter.new(answers, user_intent)
+ user_intent_obj = converter.convert
+ Rails.logger.info "Smart Match - UserIntent: #{user_intent_obj}"
+ Rails.logger.info "Smart Match - UserIntent causes: #{user_intent_obj.causes_selected}"
+ Rails.logger.info "Smart Match - UserIntent prefs: #{user_intent_obj.prefs_selected}"
+
+ Rails.logger.info "Smart Match - Creating BGE-based comprehensive service instance..."
+ recommendation_service = ComprehensiveRecommendationService.new(user_intent_obj)
+ Rails.logger.info "Smart Match - BGE service instance created successfully"
+
+ Rails.logger.info "Smart Match - Calling BGE generate_recommendations..."
+ recommendations = recommendation_service.generate_recommendations(10)
+ Rails.logger.info "Smart Match - BGE service returned #{recommendations.length} recommendations"
+ Rails.logger.info "Smart Match - First recommendation: #{recommendations.first}" if recommendations.any?
+
+ # Convert to expected format and calculate threshold metrics
+ formatted_recommendations = recommendations.map do |rec|
+ # Create a mock Location object using OpenStruct
+ location_obj = OpenStruct.new(
+ id: rec[:id],
+ name: rec[:name],
+ organization: OpenStruct.new(
+ name: rec[:name],
+ website: rec[:url],
+ donation_link: nil,
+ volunteer_link: nil,
+ volunteer_availability?: false,
+ decorate: OpenStruct.new(
+ donation_link: nil,
+ volunteer_link: nil
+ )
+ ),
+ website: rec[:url],
+ formatted_address: rec[:city].present? ? "#{rec[:city]}, #{rec[:state]}" : rec[:state],
+ city: rec[:city],
+ state: rec[:state],
+ # Add missing properties that the template expects
+ donation_link: nil,
+ volunteer_link: nil,
+ volunteer_availability?: false
+ )
+
+ {
+ location: location_obj,
+ similarity_score: rec[:score] || rec[:final_score] || 0.0,
+ relevance_reason: rec[:relevance_reason] || "General match"
+ }
+ end
+
+ # Calculate threshold metrics
+ threshold_metrics = calculate_threshold_metrics(formatted_recommendations)
+
+ Rails.logger.info "Smart Match - Formatted recommendations: #{formatted_recommendations.length}"
+ Rails.logger.info "Smart Match - Threshold metrics: #{threshold_metrics}"
+ Rails.logger.info "Smart Match - First formatted recommendation: #{formatted_recommendations.first}" if formatted_recommendations.any?
+
+ # Return both recommendations and threshold info
+ {
+ recommendations: formatted_recommendations,
+ threshold_metrics: threshold_metrics
+ }
+ rescue => e
+ Rails.logger.error "Smart Match comprehensive service failed: #{e.message}"
+ Rails.logger.error e.backtrace.join("\n")
+
+ # Return empty results with warning
+ {
+ recommendations: [],
+ threshold_metrics: {
+ show_warning: true,
+ warning_message: "We're experiencing technical difficulties. Please try again or contact support.",
+ average_score: 0.0,
+ max_score: 0.0
+ }
+ }
+ end
+ end
+
+ private
+
+ def calculate_threshold_metrics(recommendations)
+ return {show_warning: false, average_score: 0.0, max_score: 0.0} if recommendations.empty?
+
+ # Filter out nil scores and ensure we have valid numeric scores
+ scores = recommendations.pluck(:similarity_score).compact.select { |score| score.is_a?(Numeric) }
+
+ if scores.empty?
+ return {
+ show_warning: true,
+ warning_level: "no_scores",
+ warning_message: "We couldn't calculate match scores for the recommendations.",
+ average_score: 0.0,
+ max_score: 0.0,
+ strong_match_threshold: 0.7,
+ moderate_match_threshold: 0.4,
+ weak_match_threshold: 0.2
+ }
+ end
+
+ average_score = scores.sum / scores.length
+ max_score = scores.max
+
+ # Define thresholds
+ strong_match_threshold = 0.7 # 70% - strong matches
+ moderate_match_threshold = 0.4 # 40% - moderate matches
+ weak_match_threshold = 0.2 # 20% - weak matches
+
+ # Determine warning level
+ if max_score >= strong_match_threshold
+ show_warning = false
+ warning_level = "none"
+ warning_message = nil
+ elsif max_score >= moderate_match_threshold
+ show_warning = true
+ warning_level = "moderate"
+ warning_message = "We found some relevant nonprofits, but they may not perfectly match your specific needs. These organizations could still be helpful for your situation."
+ elsif max_score >= weak_match_threshold
+ show_warning = true
+ warning_level = "weak"
+ warning_message = "We found limited matches for your specific needs. The organizations below may not be exactly what you're looking for, but they could still provide useful services or referrals."
+ else
+ show_warning = true
+ warning_level = "very_weak"
+ warning_message = "We couldn't find nonprofits that closely match your specific needs. The organizations below are general recommendations that might still be helpful, or you may want to contact them for referrals to more specialized services."
+ end
+
+ {
+ show_warning: show_warning,
+ warning_level: warning_level,
+ warning_message: warning_message,
+ average_score: average_score,
+ max_score: max_score,
+ strong_match_threshold: strong_match_threshold,
+ moderate_match_threshold: moderate_match_threshold,
+ weak_match_threshold: weak_match_threshold
+ }
+ end
+
+ def get_total_steps(user_intent)
+ case user_intent
+ when "seeking_help"
+ # Service Seeker path has 12 total steps (1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12)
+ 12
+ when "donating"
+ # Donor path has 11 total steps (1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11)
+ 11
+ when "volunteering"
+ # Volunteer path has 10 total steps (1, 2, 3, 4, 5*, 6, 7, 8, 9, 10)
+ base_steps = 10
+ if needs_location_details?
+ base_steps # Include location step
+ else
+ base_steps - 1 # Skip location step
+ end
+ else
+ 1 # Default to first question
+ end
+ end
+
+ def get_next_step(current_step, user_intent)
+ case user_intent
+ when "seeking_help"
+ get_service_seeker_next_step(current_step)
+ when "donating"
+ get_donor_next_step(current_step)
+ when "volunteering"
+ get_volunteer_next_step(current_step)
+ else
+ # Step 1 is the universal branch - no specific path yet
+ current_step + 1
+ end
+ end
+
+ def get_service_seeker_next_step(current_step)
+ case current_step
+ when 1
+ 2 # Who are you filling this out for?
+ when 2
+ 3 # What best describes you?
+ when 3
+ 4 # What type of help are you looking for?
+ when 4
+ 5 # What best describes your situation?
+ when 5
+ 6 # Which area are you located at?
+ when 6
+ 7 # How far can you travel?
+ when 7
+ 8 # Do you need any of the following?
+ when 8
+ 9 # Age range (language selection is handled within step 8)
+ when 9
+ 10 # Gender identity
+ when 10
+ 11 # Race or ethnicity
+ when 11
+ nil # End of quiz - redirect to results
+ when 12
+ nil # End of quiz
+ end
+ end
+
+ def get_previous_step(current_step, user_intent)
+ case user_intent
+ when "seeking_help"
+ get_service_seeker_previous_step(current_step)
+ when "donating"
+ get_donor_previous_step(current_step)
+ when "volunteering"
+ get_volunteer_previous_step(current_step)
+ else
+ [current_step - 1, 1].max
+ end
+ end
+
+ def get_service_seeker_previous_step(current_step)
+ case current_step
+ when 2
+ 1
+ when 3
+ 2
+ when 4
+ 3
+ when 5
+ 4
+ when 6
+ 5
+ when 7
+ 6
+ when 8
+ 7
+ when 9
+ 8
+ when 10
+ 9
+ when 11
+ 10
+ when 12
+ 11
+ else
+ [current_step - 1, 1].max
+ end
+ end
+
+ def get_donor_previous_step(current_step)
+ case current_step
+ when 2
+ 1
+ when 3
+ 2
+ when 4
+ 3
+ when 5
+ 4
+ when 6
+ 5
+ when 7
+ 6
+ when 8
+ 7
+ when 9
+ 8
+ when 10
+ 9
+ when 11
+ 10
+ else
+ [current_step - 1, 1].max
+ end
+ end
+
+ def get_volunteer_previous_step(current_step)
+ case current_step
+ when 2
+ 1
+ when 3
+ 2
+ when 4
+ 3
+ when 5
+ 4
+ when 6
+ # Check if user came from location step or skipped it
+ if needs_location_details?
+ 5
+ else
+ 4
+ end
+ when 7
+ 6
+ when 8
+ 7
+ when 9
+ 8
+ else
+ [current_step - 1, 1].max
+ end
+ end
+
+ def needs_language_support?
+ # Check if user selected "Spanish or another language available" in step 8
+ return false unless session[:smart_match_answers]
+ step_8_answers = session[:smart_match_answers][8]
+ return false unless step_8_answers
+
+ # Handle both array and string formats
+ if step_8_answers.is_a?(Array)
+ step_8_answers.include?("spanish_language")
+ else
+ step_8_answers == "spanish_language"
+ end
+ end
+
+ def get_step_sequence(user_intent)
+ # Return the sequence of steps based on user intent
+ case user_intent
+ when "seeking_help"
+ # Service Seeker path - 12 steps
+ [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12]
+ when "volunteering"
+ # Volunteer path - 10 steps
+ [1, 2, 3, 4, 5, 6, 7, 8, 9, 10]
+ when "donating"
+ # Donor path - 10 steps
+ [1, 2, 3, 4, 5, 6, 7, 8, 9, 10]
+ else
+ [1]
+ end
+ end
+
+ def needs_location_details?
+ # Check if user selected "Near me" or "Specific city or zip code" in step 5 (volunteer path)
+ return false unless session[:smart_match_answers]
+ step_5_answers = session[:smart_match_answers][5]
+ return false unless step_5_answers
+
+ # Step 5 is single choice
+ step_5_answers == "near_me" || step_5_answers == "specific_location"
+ end
+
+ def get_donor_next_step(current_step)
+ case current_step
+ when 1
+ 2 # Donor path starts at step 2
+ when 2
+ 3 # What causes are you passionate about?
+ when 3
+ 4 # How much would you like to donate?
+ when 4
+ 5 # Do you prefer one-time or recurring donations?
+ when 5
+ 6 # What type of impact are you looking for?
+ when 6
+ 7 # Do you want to support local or national organizations?
+ when 7
+ 8 # Do you prefer to donate to specific programs or general operations?
+ when 8
+ 9 # Do you want to receive updates about your donation?
+ when 9
+ 10 # Age range
+ when 10
+ nil # End of quiz - redirect to results (after race/ethnicity)
+ when 11
+ nil # End of quiz
+ end
+ end
+
+ def get_volunteer_next_step(current_step)
+ case current_step
+ when 1
+ 2 # What causes are close to your heart?
+ when 2
+ 3 # How would you like to help?
+ when 3
+ 4 # Volunteer preferences
+ when 4
+ 5 # Where do you want to focus your impact?
+ when 5
+ if needs_location_details?
+ end
+ 6
+ when 6
+ 7 # How much time do you have to give?
+ when 7
+ 8 # Age range
+ when 8
+ 9 # Gender identity
+ when 9
+ 10 # Race or ethnicity
+ when 10
+ nil # End of quiz - redirect to results
+ end
+ end
+
+ def generate_fallback_recommendations(answers, user_intent)
+ # Fallback to the original filtering logic
+ search = Search.new(location_params)
+ search.save
+
+ results = search.results.limit(20)
+
+ # Apply filters based on user intent and answers
+ case user_intent
+ when "seeking_help"
+ results = filter_for_service_seeker(results, answers)
+ when "donating"
+ results = filter_for_donor(results, answers)
+ when "volunteering"
+ results = filter_for_volunteer(results, answers)
+ end
+
+ # Convert to the same format as the new service
+ results.map do |location|
+ {
+ location: location,
+ similarity_score: 0.5, # Default fallback score
+ relevance_reason: "Based on your search criteria and location preferences"
+ }
+ end
+ end
+
+ def filter_for_service_seeker(results, answers)
+ # Filter based on service seeker answers
+ if answers[4].present? # Type of help needed
+ case answers[4]
+ when "food_groceries"
+ results = results.joins(:services).where(services: {name: ["Food Assistance", "Meal Programs", "Food Pantry"]})
+ when "housing_shelter"
+ results = results.joins(:services).where(services: {name: ["Housing Assistance", "Emergency Shelter", "Transitional Housing"]})
+ when "mental_health"
+ results = results.joins(:services).where(services: {name: ["Mental Health Services", "Counseling", "Therapy"]})
+ when "medical_healthcare"
+ results = results.joins(:services).where(services: {name: ["Medical Care", "Health Services", "Dental Care"]})
+ when "employment_training"
+ results = results.joins(:services).where(services: {name: ["Job Training", "Employment Services", "Career Counseling"]})
+ when "legal_help"
+ results = results.joins(:services).where(services: {name: ["Legal Services", "Legal Aid", "Legal Consultation"]})
+ when "financial_assistance"
+ results = results.joins(:services).where(services: {name: ["Financial Assistance", "Emergency Financial Aid", "Utility Assistance"]})
+ end
+ end
+
+ # Filter by location preference
+ if answers[6].present? # Location
+ case answers[6]
+ when "atlantic_city"
+ results = results.where(city: "Atlantic City")
+ when "los_angeles"
+ results = results.where(city: "Los Angeles")
+ when "nashville"
+ results = results.where(city: "Nashville")
+ end
+ end
+
+ # Filter by travel distance
+ if answers[7].present? # Travel distance
+ case answers[7]
+ when "walking_distance"
+ # Filter for locations within 5 miles
+ results = results.near([@current_location[:latitude], @current_location[:longitude]], 5)
+ when "public_transport"
+ # Filter for locations within 10 miles
+ results = results.near([@current_location[:latitude], @current_location[:longitude]], 10)
+ when "car_access"
+ # No distance filter for car access
+ end
+ end
+
+ # Filter by special requirements
+ if answers[8].present? && answers[8].is_a?(Array)
+ answers[8].each do |requirement|
+ case requirement
+ when "free_sliding_scale"
+ # Filter for organizations offering free or sliding scale services
+ results = results.joins(:organization).where(organizations: {offers_free_services: true})
+ when "no_id_required"
+ # Filter for organizations that don't require ID
+ results = results.joins(:organization).where(organizations: {requires_id: false})
+ when "spanish_language"
+ # Filter for organizations offering Spanish services
+ results = results.joins(:organization).where(organizations: {offers_spanish: true})
+ when "lgbtqia_affirming"
+ # Filter for LGBTQIA+ affirming organizations
+ results = results.joins(:organization).where(organizations: {lgbtqia_affirming: true})
+ when "wheelchair_accessible"
+ # Filter for wheelchair accessible locations
+ results = results.where(wheelchair_accessible: true)
+ when "women_bipoc_led"
+ # Filter for women or BIPOC-led organizations
+ results = results.joins(:organization).where(organizations: {women_or_bipoc_led: true})
+ end
+ end
+ end
+
+ results
+ end
+
+ def filter_for_donor(results, answers)
+ # To be implemented for donor filtering
+ results
+ end
+
+ def filter_for_volunteer(results, answers)
+ # Filter based on volunteer answers
+
+ # Filter by causes they care about
+ if answers[2].present? && answers[2].is_a?(Array)
+ answers[2].each do |cause|
+ case cause
+ when "food_groceries"
+ results = results.joins(:services).where(services: {name: ["Food Assistance", "Meal Programs", "Food Pantry"]})
+ when "housing_shelter"
+ results = results.joins(:services).where(services: {name: ["Housing Assistance", "Emergency Shelter", "Transitional Housing"]})
+ when "mental_health"
+ results = results.joins(:services).where(services: {name: ["Mental Health Services", "Counseling", "Therapy"]})
+ when "medical_healthcare"
+ results = results.joins(:services).where(services: {name: ["Medical Care", "Health Services", "Dental Care"]})
+ when "employment_training"
+ results = results.joins(:services).where(services: {name: ["Job Training", "Employment Services", "Career Counseling"]})
+ when "legal_help"
+ results = results.joins(:services).where(services: {name: ["Legal Services", "Legal Aid", "Legal Consultation"]})
+ when "financial_assistance"
+ results = results.joins(:services).where(services: {name: ["Financial Assistance", "Emergency Financial Aid", "Utility Assistance"]})
+ end
+ end
+ end
+
+ # Filter by location preference
+ if answers[4].present?
+ case answers[4]
+ when "near_me"
+ # Filter for locations near user
+ results = results.near([@current_location[:latitude], @current_location[:longitude]], 25)
+ when "specific_city_zip"
+ # Filter by specific city (handled in step 5)
+ if answers[5].present?
+ case answers[5]
+ when "atlantic_city"
+ results = results.where(city: "Atlantic City")
+ when "los_angeles"
+ results = results.where(city: "Los Angeles")
+ when "nashville"
+ results = results.where(city: "Nashville")
+ end
+ end
+ when "anywhere_virtual"
+ # No location filter for virtual opportunities
+ end
+ end
+
+ # Filter by in-person/remote preference
+ if answers[6].present?
+ case answers[6]
+ when "only_in_person"
+ # Filter for in-person opportunities only
+ results = results.where(remote_opportunities: false)
+ when "only_remote"
+ # Filter for remote opportunities only
+ results = results.where(remote_opportunities: true)
+ when "both"
+ # No filter - show both
+ end
+ end
+
+ # Filter by time commitment
+ if answers[7].present? && answers[7].is_a?(Array)
+ answers[7].each do |time_commitment|
+ case time_commitment
+ when "time_0"
+ # One-time events
+ results = results.joins(:organization).where(organizations: {offers_one_time_events: true})
+ when "time_1"
+ # Few hours a week
+ results = results.joins(:organization).where(organizations: {offers_weekly_opportunities: true})
+ when "time_2"
+ # Ongoing role
+ results = results.joins(:organization).where(organizations: {offers_ongoing_roles: true})
+ end
+ end
+ end
+
+ results
+ end
+
+ def location_params
+ {
+ city: @current_location[:city],
+ state: @current_location[:state],
+ lat: @current_location[:latitude],
+ lon: @current_location[:longitude]
+ }
+ end
+end
diff --git a/app/javascript/controllers/smart_match_controller.js b/app/javascript/controllers/smart_match_controller.js
new file mode 100644
index 000000000..dae2b1575
--- /dev/null
+++ b/app/javascript/controllers/smart_match_controller.js
@@ -0,0 +1,822 @@
+import { Controller } from "@hotwired/stimulus"
+
+export default class extends Controller {
+ static targets = ["choiceCard", "nextButton", "choiceCardsContainer", "moreOptionsBtn", "hiddenCard", "languageInput", "languageInputContainer", "genderDescriptionContainer", "genderDescriptionInput", "citySelectionContainer", "cityOption", "disclaimerCheckbox", "startButton", "disclaimerExpandable", "disclaimerToggle"]
+
+ connect() {
+ console.log('Smart Match Controller connected!')
+ this.selectedChoice = null
+ this.selectedMultipleChoices = []
+ this.updateCurrentState()
+ this.initializeCardStyles()
+ this.initializeDisclaimer()
+ this.initializePreviousAnswers()
+
+ // Check if we're on the results page and fix layout if needed
+ if (window.location.pathname.includes('/smart-match/results')) {
+ this.fixResultsPageLayout()
+ }
+ }
+
+ // Fix layout issues on results page
+ fixResultsPageLayout() {
+ console.log('Fixing results page layout...')
+
+ // Ensure proper grid layout
+ const grid = document.querySelector('.smart-match-results .grid')
+ if (grid) {
+ grid.style.display = 'grid'
+ grid.style.gridTemplateColumns = 'repeat(1, 1fr)'
+ grid.style.gap = '1.5rem'
+
+ // Responsive grid
+ if (window.innerWidth >= 768) {
+ grid.style.gridTemplateColumns = 'repeat(2, 1fr)'
+ }
+ if (window.innerWidth >= 1024) {
+ grid.style.gridTemplateColumns = 'repeat(3, 1fr)'
+ }
+ }
+
+ // Fix Match Quality Summary grid specifically
+ const qualityGrid = document.querySelector('.smart-match-results .bg-gray-50 .grid.grid-cols-4')
+ if (qualityGrid) {
+ console.log('Fixing Match Quality Summary grid...')
+ qualityGrid.style.display = 'grid'
+ qualityGrid.style.gridTemplateColumns = 'repeat(4, 1fr)'
+ qualityGrid.style.gridTemplateRows = '1fr'
+ qualityGrid.style.gridAutoFlow = 'row'
+ qualityGrid.style.gap = '1rem'
+
+ // Force all children to be in the first row
+ const children = qualityGrid.children
+ for (let i = 0; i < children.length; i++) {
+ children[i].style.gridRow = '1'
+ children[i].style.gridColumn = `${i + 1}`
+ }
+
+ console.log('Match Quality Summary grid fixed')
+ }
+
+ // Fix card positioning
+ const cards = document.querySelectorAll('.smart-match-results .bg-white.rounded-lg.shadow-md')
+ cards.forEach(card => {
+ card.style.position = 'relative'
+ card.style.display = 'flex'
+ card.style.flexDirection = 'column'
+ card.style.height = '100%'
+ card.style.overflow = 'hidden'
+ card.style.minHeight = '400px'
+ })
+
+ // Fix badge positioning
+ const badges = document.querySelectorAll('.smart-match-results .absolute.top-4.right-4')
+ badges.forEach(badge => {
+ badge.style.position = 'absolute'
+ badge.style.top = '1rem'
+ badge.style.right = '1rem'
+ badge.style.zIndex = '30'
+ })
+
+ // Fix text overflow
+ const textElements = document.querySelectorAll('.smart-match-results .break-words')
+ textElements.forEach(element => {
+ element.style.wordWrap = 'break-word'
+ element.style.overflowWrap = 'break-word'
+ element.style.hyphens = 'auto'
+ })
+
+ console.log('Results page layout fixed')
+ }
+
+ initializeDisclaimer() {
+ // Initialize disclaimer checkbox and start button state
+ if (this.hasDisclaimerCheckboxTarget && this.hasStartButtonTarget) {
+ this.toggleStartButton()
+ }
+ }
+
+ toggleStartButton() {
+ if (this.hasDisclaimerCheckboxTarget && this.hasStartButtonTarget) {
+ const checkbox = this.disclaimerCheckboxTarget
+ const startButton = this.startButtonTarget
+
+ if (checkbox.checked) {
+ startButton.classList.remove('opacity-50', 'cursor-not-allowed')
+ startButton.classList.add('cursor-pointer')
+ startButton.href = startButton.dataset.href || '/smart-match/quiz'
+ } else {
+ startButton.classList.add('opacity-50', 'cursor-not-allowed')
+ startButton.classList.remove('cursor-pointer')
+ startButton.href = '#'
+ }
+ }
+ }
+
+ checkDisclaimer(event) {
+ if (this.hasDisclaimerCheckboxTarget) {
+ const checkbox = this.disclaimerCheckboxTarget
+ if (!checkbox.checked) {
+ event.preventDefault()
+ alert('Please agree to the Terms of Service and disclaimer before proceeding.')
+ }
+ }
+ }
+
+ toggleDisclaimer() {
+ if (this.hasDisclaimerExpandableTarget && this.hasDisclaimerToggleTarget) {
+ const expandable = this.disclaimerExpandableTarget
+ const toggle = this.disclaimerToggleTarget
+
+ if (expandable.classList.contains('hidden')) {
+ expandable.classList.remove('hidden')
+ toggle.textContent = 'Hide full disclaimer'
+ } else {
+ expandable.classList.add('hidden')
+ toggle.textContent = 'Show full disclaimer'
+ }
+ }
+ }
+
+ updateCurrentState() {
+ this.currentStep = this.getCurrentStep()
+ this.userIntent = this.getUserIntent()
+ }
+
+ initializeCardStyles() {
+ // Apply initial styling to all cards based on current step and user intent
+ const style = this.getCardStyle()
+ console.log('initializeCardStyles - style:', style, 'cards found:', this.choiceCardTargets.length)
+ this.choiceCardTargets.forEach((card, index) => {
+ console.log(`Applying style to card ${index + 1}:`, card)
+ this.applyStyle(card, false, style)
+ })
+ }
+
+ // Helper functions for consistent styling
+ applyWhiteStyle(card, isSelected) {
+ console.log('applyWhiteStyle - isSelected:', isSelected)
+ if (isSelected) {
+ console.log('Applying selected white style')
+ card.style.borderWidth = '4px'
+ card.style.borderColor = '#1e40af'
+ card.style.backgroundColor = '#eff6ff'
+ } else {
+ console.log('Applying unselected white style')
+ card.style.borderWidth = '2px'
+ card.style.borderColor = '#dbeafe'
+ card.style.backgroundColor = 'white'
+ }
+ console.log('Final card styles:', {
+ borderWidth: card.style.borderWidth,
+ borderColor: card.style.borderColor,
+ backgroundColor: card.style.backgroundColor
+ })
+ }
+
+ applyBlueStyle(card, isSelected) {
+ if (isSelected) {
+ card.style.borderWidth = '4px'
+ card.style.borderColor = '#113c7b'
+ card.style.backgroundColor = '#2B5AA0'
+ // Keep icon and text white when selected
+ const icon = card.querySelector('svg')
+ const text = card.querySelector('p')
+ if (icon) icon.style.filter = 'brightness(0) invert(1)'
+ if (text) {
+ text.classList.remove('text-blue-dark')
+ text.classList.add('text-white')
+ }
+ } else {
+ card.style.borderWidth = '0px'
+ card.style.borderColor = 'transparent'
+ card.style.backgroundColor = '#3682D0'
+ // Reset icon and text colors to white
+ const icon = card.querySelector('svg')
+ const text = card.querySelector('p')
+ if (icon) icon.style.filter = 'brightness(0) invert(1)'
+ if (text) {
+ text.classList.remove('text-blue-dark')
+ text.classList.add('text-white')
+ }
+ }
+ }
+
+ applyPinkStyle(card, isSelected) {
+ if (isSelected) {
+ card.style.borderWidth = '0px'
+ card.style.borderColor = 'transparent'
+ card.style.backgroundColor = '#E67E7A'
+ // Make icon and text white when selected
+ const icon = card.querySelector('svg')
+ const text = card.querySelector('p')
+ if (icon) icon.style.filter = 'brightness(0) invert(1)'
+ if (text) {
+ text.classList.remove('text-blue-dark')
+ text.classList.add('text-white')
+ }
+ } else {
+ card.style.borderWidth = '0px'
+ card.style.borderColor = 'transparent'
+ card.style.backgroundColor = '#F2A29E'
+ // Reset icon and text colors to blue
+ const icon = card.querySelector('svg')
+ const text = card.querySelector('p')
+ if (icon) icon.style.filter = 'none'
+ if (text) {
+ text.classList.remove('text-white')
+ text.classList.add('text-blue-dark')
+ }
+ }
+ }
+
+ applySeafoamStyle(card, isSelected) {
+ console.log('applySeafoamStyle - isSelected:', isSelected)
+ if (isSelected) {
+ console.log('Applying selected seafoam style')
+ card.style.borderWidth = '4px'
+ card.style.borderColor = '#113c7b'
+ card.style.backgroundColor = '#9AE2E0'
+ } else {
+ console.log('Applying unselected seafoam style')
+ card.style.borderWidth = '0px'
+ card.style.borderColor = 'transparent'
+ card.style.backgroundColor = '#C7F0EF'
+ }
+ }
+
+ getCardStyle() {
+ // Get style from data attribute on the choice cards container
+ const choiceCardsContainer = document.querySelector('.choice-cards')
+ if (choiceCardsContainer && choiceCardsContainer.dataset.style) {
+ const style = choiceCardsContainer.dataset.style
+ console.log('Returning style from data attribute:', style)
+ return style
+ }
+
+ // Fallback to default white style if no data attribute is set
+ console.log('No style data attribute found, returning white style')
+ return 'white'
+ }
+
+ selectChoice(event) {
+ console.log('selectChoice called!')
+ this.updateCurrentState() // Update current state before determining style
+ const card = event.currentTarget
+ const choice = card.dataset.choice
+ const style = this.getCardStyle()
+
+ // Remove previous selection from all cards
+ this.choiceCardTargets.forEach(c => {
+ this.applyStyle(c, false, style)
+ c.classList.remove('selected')
+ })
+
+ // Select new choice
+ this.applyStyle(card, true, style)
+ card.classList.add('selected')
+
+ this.selectedChoice = choice
+
+ // Handle gender description field visibility for step 10 (service seeker), step 9 (donor), and step 9 (volunteer)
+ if (this.currentStep === 10 || (this.currentStep === 9 && this.getUserIntent() === 'donating') || (this.currentStep === 9 && this.getUserIntent() === 'volunteering')) {
+ this.toggleGenderDescription()
+ }
+
+ // Handle city selection visibility for step 6 (donor path) and step 5 (volunteer path)
+ if ((this.currentStep === 6 && this.getUserIntent() === 'donating') ||
+ (this.currentStep === 5 && this.getUserIntent() === 'volunteering')) {
+ this.toggleCitySelection()
+ }
+
+ this.enableNextButton()
+ }
+
+ applyStyle(card, isSelected, style) {
+ switch (style) {
+ case 'white':
+ this.applyWhiteStyle(card, isSelected)
+ break
+ case 'blue':
+ this.applyBlueStyle(card, isSelected)
+ break
+ case 'pink':
+ this.applyPinkStyle(card, isSelected)
+ break
+ case 'seafoam':
+ this.applySeafoamStyle(card, isSelected)
+ break
+ }
+ }
+
+ selectMultipleChoice(event) {
+ this.updateCurrentState() // Update current state before determining style
+ const card = event.currentTarget
+ const choice = card.dataset.choice
+ const style = this.getCardStyle()
+ console.log('selectMultipleChoice - choice:', choice, 'style:', style, 'currentStep:', this.getCurrentStep(), 'userIntent:', this.getUserIntent())
+
+ if (card.classList.contains('selected')) {
+ // Deselect
+ console.log('Deselecting card')
+ this.applyStyle(card, false, style)
+ card.classList.remove('selected')
+ this.selectedMultipleChoices = this.selectedMultipleChoices.filter(c => c !== choice)
+ } else {
+ // Select
+ console.log('Selecting card')
+ this.applyStyle(card, true, style)
+ card.classList.add('selected')
+ this.selectedMultipleChoices.push(choice)
+ }
+
+ // Handle language input field visibility for step 8 (donor) and step 8 (service seeker)
+ if (this.currentStep === 8 || (this.currentStep === 8 && this.getUserIntent() === 'seeking_help')) {
+ this.toggleLanguageInput()
+ }
+
+ this.enableNextButton()
+ }
+
+ selectLanguage(event) {
+ this.selectedChoice = event.target.value
+ this.enableNextButton()
+ }
+
+ updateLanguageChoice(event) {
+ this.selectedChoice = event.target.value
+ this.enableNextButton()
+ }
+
+ updateGenderDescription(event) {
+ this.enableNextButton()
+ }
+
+ enableNextButton() {
+ const nextButton = this.nextButtonTarget
+ if (nextButton) {
+ if (this.hasValidSelection()) {
+ nextButton.classList.remove('opacity-50', 'cursor-not-allowed')
+ nextButton.classList.add('cursor-pointer')
+ } else {
+ nextButton.classList.add('opacity-50', 'cursor-not-allowed')
+ nextButton.classList.remove('cursor-pointer')
+ }
+ }
+ }
+
+ hasValidSelection() {
+ // Check if current step requires single or multiple choice
+ const currentStep = this.getCurrentStep()
+ if (this.isMultipleChoiceStep()) {
+ if ((currentStep === 8 && this.selectedMultipleChoices.includes('spanish_language')) ||
+ (currentStep === 8 && this.getUserIntent() === 'seeking_help' && this.selectedMultipleChoices.includes('spanish_language'))) {
+ // For step 8 (donor) or step 7 (service seeker), if spanish_language is selected, also check if language input has value
+ const languageInput = this.languageInputTarget
+ return this.selectedMultipleChoices.length > 0 && languageInput && languageInput.value.trim() !== ''
+ }
+ return this.selectedMultipleChoices.length > 0
+ } else if (this.isLanguageStep()) {
+ // For language input step, check if there's text in the input
+ const languageInput = this.languageInputTarget
+ return languageInput && languageInput.value.trim() !== ''
+ } else if ((currentStep === 10 || (currentStep === 9 && this.getUserIntent() === 'donating') || (currentStep === 9 && this.getUserIntent() === 'volunteering')) && this.selectedChoice === 'other') {
+ // For step 10 (service seeker), step 9 (donor), or step 9 (volunteer), if "other" is selected, also check if gender description input has value
+ const genderDescriptionInput = this.genderDescriptionInputTarget
+ return this.selectedChoice !== null && this.selectedChoice !== '' && genderDescriptionInput && genderDescriptionInput.value.trim() !== ''
+ } else if (((currentStep === 6 && this.getUserIntent() === 'donating') || (currentStep === 5 && this.getUserIntent() === 'volunteering')) && (this.selectedChoice === 'near_me' || this.selectedChoice === 'specific_location')) {
+ // For step 6 (donor) or step 5 (volunteer), if location is selected, also check if city is selected
+ return this.selectedChoice !== null && this.selectedChoice !== '' && this.selectedCity !== null && this.selectedCity !== ''
+ } else {
+ return this.selectedChoice !== null && this.selectedChoice !== ''
+ }
+ }
+
+ isMultipleChoiceStep() {
+ const multipleChoiceSteps = [4, 7, 8] // Service Seeker steps that allow multiple selections
+ const volunteerMultipleChoiceSteps = [2, 3, 4] // Volunteer steps that allow multiple selections
+ const donorMultipleChoiceSteps = [2, 5, 7] // Donor steps that allow multiple selections
+
+ // Check based on user intent
+ const userIntent = this.getUserIntent()
+ const currentStep = this.getCurrentStep()
+ if (userIntent === 'volunteering') {
+ return volunteerMultipleChoiceSteps.includes(currentStep)
+ } else if (userIntent === 'donating') {
+ return donorMultipleChoiceSteps.includes(currentStep)
+ } else {
+ return multipleChoiceSteps.includes(currentStep)
+ }
+ }
+
+ isLanguageStep() {
+ return false // Language selection is now handled within step 8
+ }
+
+ nextStep(event) {
+ console.log('nextStep called!')
+ this.updateCurrentState() // Update current state before proceeding
+ console.log('hasValidSelection:', this.hasValidSelection())
+ console.log('selectedChoice:', this.selectedChoice)
+ console.log('currentStep:', this.currentStep)
+
+ // Check if this is the final step (completion step)
+ const isFinalStep = this.isFinalStep()
+ console.log('isFinalStep:', isFinalStep)
+
+ if (!this.hasValidSelection() && !isFinalStep) {
+ console.log('No valid selection and not final step, preventing navigation')
+ event.preventDefault()
+ return
+ }
+
+ // If this is the final step, navigate directly to results
+ if (isFinalStep) {
+ console.log('Final step detected, navigating to results')
+ window.location.href = '/smart-match/results'
+ return
+ }
+
+ // Prepare the answer data
+ let answerData
+ if (this.isMultipleChoiceStep()) {
+ if ((this.currentStep === 8 && this.selectedMultipleChoices.includes('spanish_language')) ||
+ (this.currentStep === 8 && this.getUserIntent() === 'seeking_help' && this.selectedMultipleChoices.includes('spanish_language'))) {
+ // For step 8 (donor) or step 7 (service seeker), include both the selected choices and the language input
+ const languageInput = this.languageInputTarget
+ const languageValue = languageInput ? languageInput.value.trim() : ''
+ answerData = {
+ choices: this.selectedMultipleChoices,
+ language: languageValue
+ }
+ } else {
+ answerData = this.selectedMultipleChoices
+ }
+ } else if (this.isLanguageStep()) {
+ // For language step, get the value from the input field
+ const languageInput = this.languageInputTarget
+ answerData = languageInput ? languageInput.value.trim() : ''
+ } else if ((this.currentStep === 10 || (this.currentStep === 9 && this.getUserIntent() === 'donating') || (this.currentStep === 9 && this.getUserIntent() === 'volunteering')) && this.selectedChoice === 'other') {
+ // For step 10 (service seeker), step 9 (donor), or step 9 (volunteer), if "other" is selected, include both the choice and the description
+ const genderDescriptionInput = this.genderDescriptionInputTarget
+ const descriptionValue = genderDescriptionInput ? genderDescriptionInput.value.trim() : ''
+ answerData = {
+ choice: this.selectedChoice,
+ description: descriptionValue
+ }
+ } else if (((this.currentStep === 6 && this.getUserIntent() === 'donating') || (this.currentStep === 5 && this.getUserIntent() === 'volunteering')) && (this.selectedChoice === 'near_me' || this.selectedChoice === 'specific_location')) {
+ // For step 6 (donor) or step 5 (volunteer), if location is selected, include both the choice and the city
+ answerData = {
+ choice: this.selectedChoice,
+ city: this.selectedCity
+ }
+ } else {
+ answerData = this.selectedChoice
+ }
+
+ console.log('answerData:', answerData)
+
+ // Submit the choice to the current step - the controller will handle navigation
+ let answerParam
+ if (this.currentStep === 1) {
+ // For step 1, send as simple string, not JSON
+ answerParam = encodeURIComponent(answerData)
+ } else {
+ // For other steps, send as JSON
+ answerParam = encodeURIComponent(JSON.stringify(answerData))
+ }
+
+ const url = `/smart-match/quiz?step=${this.currentStep}&answer=${answerParam}`
+ console.log('Submitting answer to current step:', this.currentStep)
+ console.log('Navigating to:', url)
+
+ // Simple navigation - let the controller handle the redirect
+ window.location.href = url
+ }
+
+ isFinalStep() {
+ const userIntent = this.getUserIntent()
+ const currentStep = this.getCurrentStep()
+
+ // Check if this is the final step for each user intent
+ if (userIntent === 'seeking_help' && currentStep === 12) {
+ return true
+ }
+ if (userIntent === 'donating' && currentStep === 10) {
+ return true
+ }
+ if (userIntent === 'volunteering' && currentStep === 10) {
+ return true
+ }
+
+ return false
+ }
+
+ getCurrentStep() {
+ const urlParams = new URLSearchParams(window.location.search)
+ return parseInt(urlParams.get('step')) || 1
+ }
+
+ getUserIntent() {
+ const urlParams = new URLSearchParams(window.location.search)
+ return urlParams.get('intent')
+ }
+
+ toggleLanguageInput() {
+ const languageInputContainer = this.languageInputContainerTarget
+ const isSpanishLanguageSelected = this.selectedMultipleChoices.includes('spanish_language')
+
+ if (isSpanishLanguageSelected) {
+ languageInputContainer.classList.remove('hidden')
+ } else {
+ languageInputContainer.classList.add('hidden')
+ }
+ }
+
+ toggleGenderDescription() {
+ const genderDescriptionContainer = this.genderDescriptionContainerTarget
+ const isOtherSelected = this.selectedChoice === 'other'
+
+ if (isOtherSelected) {
+ genderDescriptionContainer.classList.remove('hidden')
+ } else {
+ genderDescriptionContainer.classList.add('hidden')
+ }
+ }
+
+ toggleMoreOptions() {
+ const hiddenCards = this.hiddenCardTargets
+ const moreOptionsBtn = this.moreOptionsBtnTarget
+
+ // Check if hidden cards are currently visible
+ const isShowingMore = hiddenCards.length > 0 && !hiddenCards[0].classList.contains('hidden')
+
+ if (isShowingMore) {
+ // Hide the hidden cards
+ hiddenCards.forEach(card => {
+ card.classList.add('hidden')
+ })
+
+ // Change button text back
+ moreOptionsBtn.textContent = 'More Options'
+ } else {
+ // Show hidden cards
+ hiddenCards.forEach(card => {
+ card.classList.remove('hidden')
+ // Apply the correct styling to the newly revealed card
+ this.updateCurrentState()
+ const style = this.getCardStyle()
+ this.applyStyle(card, false, style)
+ })
+
+ // Change button text
+ moreOptionsBtn.textContent = 'Show Less'
+ }
+ }
+
+ toggleCitySelection() {
+ const citySelectionContainer = this.citySelectionContainerTarget
+ const isLocationSelected = this.selectedChoice === 'near_me' || this.selectedChoice === 'specific_location'
+
+ if (isLocationSelected) {
+ citySelectionContainer.classList.remove('hidden')
+ } else {
+ citySelectionContainer.classList.add('hidden')
+ }
+ }
+
+ selectCity(event) {
+ const cityOption = event.currentTarget
+ const city = cityOption.dataset.city
+
+ // Remove previous selection from all city options
+ this.cityOptionTargets.forEach(option => {
+ this.applyWhiteStyle(option, false)
+ option.classList.remove('selected')
+ })
+
+ // Select new city
+ this.applyWhiteStyle(cityOption, true)
+ cityOption.classList.add('selected')
+
+ this.selectedCity = city
+ this.enableNextButton()
+ }
+
+ initializePreviousAnswers() {
+ // Get the current step and user intent
+ const currentStep = this.getCurrentStep()
+ const userIntent = this.getUserIntent()
+
+ console.log('initializePreviousAnswers - currentStep:', currentStep, 'userIntent:', userIntent)
+
+ // Only initialize for steps after the first step
+ if (currentStep > 1 && userIntent) {
+ // Make an AJAX request to get the current answers from the session
+ fetch(`/smart-match/current-answers?step=${currentStep}&intent=${userIntent}`, {
+ method: 'GET',
+ headers: {
+ 'Accept': 'application/json',
+ 'X-Requested-With': 'XMLHttpRequest'
+ }
+ })
+ .then(response => response.json())
+ .then(data => {
+ console.log('Received answers data:', data)
+ if (data.answers && data.answers[currentStep]) {
+ const answer = data.answers[currentStep]
+ this.restorePreviousAnswer(answer, currentStep)
+ }
+ })
+ .catch(error => {
+ console.log('Could not load previous answers:', error)
+ })
+ }
+ }
+
+ restorePreviousAnswer(answer, step) {
+ console.log('Restoring previous answer for step', step, ':', answer)
+
+ if (Array.isArray(answer)) {
+ // Multiple choice answer
+ this.selectedMultipleChoices = answer
+ answer.forEach(choice => {
+ const card = this.element.querySelector(`[data-choice="${choice}"]`)
+ if (card) {
+ const style = this.getCardStyle()
+ this.applyStyle(card, true, style)
+ card.classList.add('selected')
+ }
+ })
+
+ // Handle special cases for multiple choice
+ if (step === 8 && answer.includes('spanish_language')) {
+ this.toggleLanguageInput()
+ }
+ } else {
+ // Single choice answer
+ this.selectedChoice = answer
+ const card = this.element.querySelector(`[data-choice="${answer}"]`)
+ if (card) {
+ const style = this.getCardStyle()
+ this.applyStyle(card, true, style)
+ card.classList.add('selected')
+ }
+
+ // Handle special cases for single choice
+ if (step === 10 || (step === 9 && this.getUserIntent() === 'donating') || (step === 9 && this.getUserIntent() === 'volunteering')) {
+ if (answer === 'other') {
+ this.toggleGenderDescription()
+ }
+ }
+
+ if ((step === 6 && this.getUserIntent() === 'donating') || (step === 5 && this.getUserIntent() === 'volunteering')) {
+ if (answer === 'near_me' || answer === 'specific_location') {
+ this.toggleCitySelection()
+ }
+ }
+ }
+
+ this.enableNextButton()
+ }
+
+ submitFeedback(event) {
+ event.preventDefault()
+
+ const button = event.currentTarget
+ const nonprofitId = button.dataset.nonprofitId
+ const feedbackType = button.dataset.feedbackType
+
+ // Disable all feedback buttons for this nonprofit to prevent double submission
+ const allFeedbackButtons = document.querySelectorAll(`[data-nonprofit-id="${nonprofitId}"]`)
+ allFeedbackButtons.forEach(btn => {
+ btn.disabled = true
+ btn.style.opacity = '0.5'
+ })
+
+ // Show loading state
+ button.innerHTML = `
+
+ Submitting...
+ `
+
+ // Prepare recommendation data for context
+ const card = button.closest('.bg-white.rounded-lg.shadow-md')
+ const recommendationData = {
+ nonprofit_name: card.querySelector('h3')?.textContent?.trim(),
+ match_score: card.querySelector('.bg-green-500, .bg-yellow-500, .bg-orange-500, .bg-red-500')?.textContent?.trim(),
+ relevance_reason: card.querySelector('.text-xs.text-gray-500')?.textContent?.trim()
+ }
+
+ // Submit feedback
+ fetch('/smart-match/feedback', {
+ method: 'POST',
+ headers: {
+ 'Content-Type': 'application/json',
+ 'X-CSRF-Token': document.querySelector('meta[name="csrf-token"]')?.getAttribute('content')
+ },
+ body: JSON.stringify({
+ nonprofit_id: nonprofitId,
+ feedback_type: feedbackType,
+ recommendation_data: recommendationData
+ })
+ })
+ .then(response => response.json())
+ .then(data => {
+ if (data.success) {
+ // Show success state
+ button.innerHTML = `
+
+ Thank you!
+ `
+
+ // Apply success styling
+ if (feedbackType === 'like') {
+ button.classList.remove('bg-gray-100', 'text-gray-700', 'hover:bg-green-100', 'hover:text-green-700')
+ button.classList.add('bg-green-100', 'text-green-700')
+ } else {
+ button.classList.remove('bg-gray-100', 'text-gray-700', 'hover:bg-red-100', 'hover:text-red-700')
+ button.classList.add('bg-red-100', 'text-red-700')
+ }
+
+ // Show success message
+ this.showFeedbackMessage('Thank you for your feedback!', 'success')
+ } else {
+ // Show error state
+ this.showFeedbackMessage(data.error || 'Failed to submit feedback', 'error')
+
+ // Re-enable buttons
+ allFeedbackButtons.forEach(btn => {
+ btn.disabled = false
+ btn.style.opacity = '1'
+ })
+
+ // Reset button content
+ this.resetFeedbackButton(button, feedbackType)
+ }
+ })
+ .catch(error => {
+ console.error('Feedback submission error:', error)
+ this.showFeedbackMessage('Failed to submit feedback. Please try again.', 'error')
+
+ // Re-enable buttons
+ allFeedbackButtons.forEach(btn => {
+ btn.disabled = false
+ btn.style.opacity = '1'
+ })
+
+ // Reset button content
+ this.resetFeedbackButton(button, feedbackType)
+ })
+ }
+
+ resetFeedbackButton(button, feedbackType) {
+ if (feedbackType === 'like') {
+ button.innerHTML = `
+
+ Like
+ `
+ } else {
+ button.innerHTML = `
+
+ Dislike
+ `
+ }
+ }
+
+ showFeedbackMessage(message, type) {
+ // Remove any existing message
+ const existingMessage = document.querySelector('.feedback-message')
+ if (existingMessage) {
+ existingMessage.remove()
+ }
+
+ // Create new message
+ const messageDiv = document.createElement('div')
+ messageDiv.className = `feedback-message fixed top-4 right-4 z-50 px-4 py-2 rounded-md shadow-lg transition-all duration-300 ${type === 'success' ? 'bg-green-500 text-white' : 'bg-red-500 text-white'
+ }`
+ messageDiv.textContent = message
+
+ // Add to page
+ document.body.appendChild(messageDiv)
+
+ // Remove after 3 seconds
+ setTimeout(() => {
+ messageDiv.style.opacity = '0'
+ setTimeout(() => {
+ if (messageDiv.parentNode) {
+ messageDiv.parentNode.removeChild(messageDiv)
+ }
+ }, 300)
+ }, 3000)
+ }
+}
\ No newline at end of file
diff --git a/app/models/recommendation_feedback.rb b/app/models/recommendation_feedback.rb
new file mode 100644
index 000000000..75eb8c66a
--- /dev/null
+++ b/app/models/recommendation_feedback.rb
@@ -0,0 +1,19 @@
+class RecommendationFeedback < ApplicationRecord
+ belongs_to :user, optional: true
+
+ validates :nonprofit_id, presence: true
+ validates :feedback_type, presence: true, inclusion: {in: %w[like dislike]}
+ validates :session_id, presence: true
+ validates :session_id, uniqueness: {scope: :nonprofit_id, message: "You've already provided feedback for this nonprofit"}
+
+ scope :likes, -> { where(feedback_type: "like") }
+ scope :dislikes, -> { where(feedback_type: "dislike") }
+
+ def self.feedback_given?(session_id, nonprofit_id)
+ exists?(session_id: session_id, nonprofit_id: nonprofit_id)
+ end
+
+ def self.get_feedback(session_id, nonprofit_id)
+ find_by(session_id: session_id, nonprofit_id: nonprofit_id)
+ end
+end
diff --git a/app/models/user_intent.rb b/app/models/user_intent.rb
new file mode 100644
index 000000000..8c0795132
--- /dev/null
+++ b/app/models/user_intent.rb
@@ -0,0 +1,51 @@
+# UserIntent represents the structured preferences from the quiz
+# This is a neutral struct that can be used by different recommendation algorithms
+class UserIntent
+ include ActiveModel::Model
+ include ActiveModel::Attributes
+
+ attribute :user_state, :string
+ attribute :user_city, :string
+ attribute :travel_bucket, :string
+ attribute :user_type, :string
+ attribute :causes_selected, array: true, default: -> { [] }
+ attribute :prefs_selected, array: true, default: -> { [] }
+ attribute :language_input, :string
+
+ validates :user_state, presence: true, inclusion: {in: %w[NJ CA TN]}
+ validates :user_city, presence: true
+ validates :travel_bucket, presence: true, inclusion: {in: %w[walk transit car]}
+ validates :user_type, presence: true, inclusion: {in: %w[seeker volunteer donor]}
+ validates :causes_selected, presence: true
+ validates :prefs_selected, presence: true
+
+ def initialize(attributes = {})
+ super
+ @causes_selected ||= []
+ @prefs_selected ||= []
+ end
+
+ def to_s
+ "UserIntent(#{user_type} in #{user_city}, #{user_state} - #{travel_bucket} travel, causes: #{causes_selected.join(", ")}, prefs: #{prefs_selected.join(", ")})"
+ end
+
+ def valid_state?
+ %w[NJ CA TN].include?(user_state)
+ end
+
+ def valid_travel_bucket?
+ %w[walk transit car].include?(travel_bucket)
+ end
+
+ def valid_user_type?
+ %w[seeker volunteer donor].include?(user_type)
+ end
+
+ def has_language_preference?
+ language_input.present?
+ end
+
+ def language_preference
+ language_input&.downcase
+ end
+end
diff --git a/app/services/comprehensive_recommendation_service.rb b/app/services/comprehensive_recommendation_service.rb
new file mode 100644
index 000000000..b65cfa7fa
--- /dev/null
+++ b/app/services/comprehensive_recommendation_service.rb
@@ -0,0 +1,838 @@
+# Comprehensive Recommendation Service
+# Implements the full workflow with BGE embeddings, deterministic filtering, and configurable scoring
+class ComprehensiveRecommendationService
+ include Math
+
+ def initialize(user_intent)
+ @user_intent = user_intent
+ @config = load_config
+ @city_centroids = load_city_centroids
+ @matrix_data = load_matrix_data
+ @chunk_embeddings = load_chunk_embeddings
+ end
+
+ def generate_recommendations(limit = 10)
+ Rails.logger.info "Comprehensive Recommendation Service - Starting for #{@user_intent}"
+
+ # Step 1: Basic validation (skip for OpenStruct)
+ return [] unless @user_intent.respond_to?(:causes_selected) && @user_intent.causes_selected.any?
+
+ # Step 2: Apply deterministic filters
+ candidates = apply_deterministic_filters
+ Rails.logger.info "Comprehensive Recommendation Service - Found #{candidates.length} candidates after filtering"
+
+ return [] if candidates.empty?
+
+ # Step 3: Build query text for BGE
+ query_text = build_query_text
+ Rails.logger.info "Comprehensive Recommendation Service - Query text: #{query_text}"
+
+ # Step 4: Generate query embedding
+ query_embedding = generate_query_embedding(query_text)
+ return [] unless query_embedding
+
+ # Step 5: Calculate scores for all candidates
+ scored_candidates = calculate_scores(candidates, query_embedding)
+ Rails.logger.info "Comprehensive Recommendation Service - Scored #{scored_candidates.length} candidates"
+
+ # Step 6: Sort and limit results
+ recommendations = scored_candidates
+ .sort_by { |c| -c[:final_score] }
+ .first(limit)
+ .map { |c| build_recommendation(c) }
+
+ Rails.logger.info "Comprehensive Recommendation Service - Generated #{recommendations.length} recommendations"
+ recommendations
+ end
+
+ private
+
+ def load_config
+ YAML.load_file(Rails.root.join("config/matching_rules.yml"))
+ end
+
+ def load_city_centroids
+ YAML.load_file(Rails.root.join("config/city_centroids.yml"))
+ end
+
+ def load_matrix_data
+ # Load enhanced BGE matrix (new comprehensive matrix with all 928 nonprofits)
+ enhanced_bge_matrix_path = Rails.root.join("app/views/smart_match/data/enhanced_bge_nonprofits_matrix.json")
+ if File.exist?(enhanced_bge_matrix_path)
+ @enhanced_matrix = JSON.parse(File.read(enhanced_bge_matrix_path))
+ Rails.logger.info "Comprehensive Recommendation Service - Loaded enhanced BGE matrix (#{@enhanced_matrix["nonprofits"].size} nonprofits)"
+ return @enhanced_matrix
+ end
+
+ # Fallback to old matrices if enhanced BGE matrix doesn't exist
+ Rails.logger.warn "Comprehensive Recommendation Service - Enhanced BGE matrix not found, falling back to old matrices"
+
+ # Load BGE matrix for embeddings
+ bge_matrix_path = Rails.root.join("app/views/smart_match/data/bge_nonprofits_matrix.json")
+ return nil unless File.exist?(bge_matrix_path)
+
+ @bge_matrix = JSON.parse(File.read(bge_matrix_path))
+
+ # Load enhanced matrix for location data
+ enhanced_matrix_path = Rails.root.join("app/views/smart_match/data/enhanced_nonprofits_matrix.json")
+ if File.exist?(enhanced_matrix_path)
+ @enhanced_matrix = JSON.parse(File.read(enhanced_matrix_path))
+
+ # Create a mapping from BGE nonprofit names to enhanced data
+ @enhanced_lookup = {}
+ @enhanced_matrix["nonprofits"].each do |np|
+ @enhanced_lookup[np["name"]] = np
+ end
+
+ Rails.logger.info "Comprehensive Recommendation Service - Loaded BGE matrix (#{@bge_matrix["nonprofits"].size} nonprofits) and enhanced matrix (#{@enhanced_matrix["nonprofits"].size} nonprofits)"
+ else
+ Rails.logger.warn "Comprehensive Recommendation Service - Enhanced matrix not found, using BGE matrix only"
+ end
+
+ @bge_matrix
+ end
+
+ def load_chunk_embeddings
+ # For now, we'll use the existing matrix structure
+ # In a full implementation, this would load from a separate chunk embeddings table
+ @matrix_data
+ end
+
+ def apply_deterministic_filters
+ # Use the enhanced BGE matrix as primary data source
+ if @enhanced_matrix
+ candidates = @enhanced_matrix["nonprofits"] || []
+ Rails.logger.info "Comprehensive Recommendation Service - Using enhanced BGE matrix with #{candidates.length} nonprofits"
+
+ # Step 1: State filter
+ candidates = candidates.select do |np|
+ np["state"] == @user_intent.user_state
+ end
+ Rails.logger.info "Comprehensive Recommendation Service - After state filter: #{candidates.length}"
+
+ # Step 2: Distance filter (only if coordinates are available)
+ has_coordinates = candidates.any? { |np| np["lat"] && np["lng"] }
+
+ if has_coordinates
+ user_coords = get_user_coordinates
+ return [] unless user_coords
+
+ radius_miles = @config["radius_miles_by_bucket"][@user_intent.travel_bucket]
+ candidates = filter_by_distance_enhanced(candidates, user_coords, radius_miles)
+ Rails.logger.info "Comprehensive Recommendation Service - After distance filter: #{candidates.length}"
+
+ # If no candidates, try progressive radius expansion
+ if candidates.empty?
+ candidates = expand_radius_progressively_enhanced(user_coords)
+ Rails.logger.info "Comprehensive Recommendation Service - After radius expansion: #{candidates.length}"
+ end
+ else
+ Rails.logger.info "Comprehensive Recommendation Service - No coordinates available, skipping distance filter"
+ end
+
+ return candidates
+ end
+
+ # Fallback to old method if enhanced matrix not available
+ Rails.logger.warn "Comprehensive Recommendation Service - Enhanced matrix not available, falling back to old method"
+ return [] unless @bge_matrix
+
+ candidates = @bge_matrix["nonprofits"] || []
+
+ # Use enhanced lookup to get location data
+ if @enhanced_lookup
+ # Step 1: State filter using enhanced data
+ candidates = candidates.select do |np|
+ enhanced_data = @enhanced_lookup[np["name"]]
+ enhanced_data && enhanced_data["state"] == @user_intent.user_state
+ end
+ Rails.logger.info "Comprehensive Recommendation Service - After state filter: #{candidates.length}"
+
+ # Step 2: Distance filter (only if coordinates are available in enhanced data)
+ has_coordinates = candidates.any? do |np|
+ enhanced_data = @enhanced_lookup[np["name"]]
+ enhanced_data && enhanced_data["lat"] && enhanced_data["lng"]
+ end
+
+ if has_coordinates
+ user_coords = get_user_coordinates
+ return [] unless user_coords
+
+ radius_miles = @config["radius_miles_by_bucket"][@user_intent.travel_bucket]
+ candidates = filter_by_distance_with_enhanced(candidates, user_coords, radius_miles)
+ Rails.logger.info "Comprehensive Recommendation Service - After distance filter: #{candidates.length}"
+
+ # If no candidates, try progressive radius expansion
+ if candidates.empty?
+ candidates = expand_radius_progressively_with_enhanced(user_coords)
+ Rails.logger.info "Comprehensive Recommendation Service - After radius expansion: #{candidates.length}"
+ end
+ else
+ Rails.logger.info "Comprehensive Recommendation Service - No coordinates available, skipping distance filter"
+ end
+ else
+ Rails.logger.info "Comprehensive Recommendation Service - No enhanced data available, using all candidates"
+ end
+
+ candidates
+ end
+
+ def get_user_coordinates
+ city = @user_intent.user_city
+ state = @user_intent.user_state
+
+ # Try main city centroids first
+ if @city_centroids["city_centroids"][city]&.[](state)
+ return @city_centroids["city_centroids"][city][state]
+ end
+
+ # Try additional cities
+ if @city_centroids["additional_cities"][city]&.[](state)
+ return @city_centroids["additional_cities"][city][state]
+ end
+
+ Rails.logger.warn "Comprehensive Recommendation Service - No coordinates found for #{city}, #{state}"
+ nil
+ end
+
+ def filter_by_distance(candidates, user_coords, radius_miles)
+ user_lat, user_lng = user_coords
+
+ candidates.select do |np|
+ next false unless np["lat"] && np["lng"]
+
+ distance = haversine_distance(user_lat, user_lng, np["lat"], np["lng"])
+ distance <= radius_miles
+ end
+ end
+
+ def filter_by_distance_enhanced(candidates, user_coords, radius_miles)
+ user_lat, user_lng = user_coords
+
+ candidates.select do |np|
+ next false unless np["lat"] && np["lng"]
+
+ distance = haversine_distance(user_lat, user_lng, np["lat"], np["lng"])
+ distance <= radius_miles
+ end
+ end
+
+ def filter_by_distance_with_enhanced(candidates, user_coords, radius_miles)
+ user_lat, user_lng = user_coords
+
+ candidates.select do |np|
+ enhanced_data = @enhanced_lookup[np["name"]]
+ next false unless enhanced_data && enhanced_data["lat"] && enhanced_data["lng"]
+
+ distance = haversine_distance(user_lat, user_lng, enhanced_data["lat"], enhanced_data["lng"])
+ distance <= radius_miles
+ end
+ end
+
+ def expand_radius_progressively(user_coords)
+ candidates = []
+ user_lat, user_lng = user_coords
+
+ # Progressive radius expansion: 5 → 10 → 25 → 50 miles
+ [5, 10, 25, 50].each do |radius|
+ candidates = @matrix_data["nonprofits"].select do |np|
+ np["state"] == @user_intent.user_state &&
+ np["lat"] && np["lng"] &&
+ haversine_distance(user_lat, user_lng, np["lat"], np["lng"]) <= radius
+ end
+
+ break if candidates.any?
+ end
+
+ candidates
+ end
+
+ def expand_radius_progressively_enhanced(user_coords)
+ candidates = []
+ user_lat, user_lng = user_coords
+
+ # Progressive radius expansion: 5 → 10 → 25 → 50 miles
+ [5, 10, 25, 50].each do |radius|
+ candidates = @enhanced_matrix["nonprofits"].select do |np|
+ np["state"] == @user_intent.user_state &&
+ np["lat"] && np["lng"] &&
+ haversine_distance(user_lat, user_lng, np["lat"], np["lng"]) <= radius
+ end
+
+ break if candidates.any?
+ end
+
+ candidates
+ end
+
+ def expand_radius_progressively_with_enhanced(user_coords)
+ candidates = []
+ user_lat, user_lng = user_coords
+
+ # Progressive radius expansion: 5 → 10 → 25 → 50 miles
+ [5, 10, 25, 50].each do |radius|
+ candidates = @bge_matrix["nonprofits"].select do |np|
+ enhanced_data = @enhanced_lookup[np["name"]]
+ enhanced_data &&
+ enhanced_data["state"] == @user_intent.user_state &&
+ enhanced_data["lat"] && enhanced_data["lng"] &&
+ haversine_distance(user_lat, user_lng, enhanced_data["lat"], enhanced_data["lng"]) <= radius
+ end
+
+ break if candidates.any?
+ end
+
+ candidates
+ end
+
+ def haversine_distance(lat1, lng1, lat2, lng2)
+ # Convert to radians
+ lat1_rad = lat1 * PI / 180
+ lng1_rad = lng1 * PI / 180
+ lat2_rad = lat2 * PI / 180
+ lng2_rad = lng2 * PI / 180
+
+ # Haversine formula
+ dlat = lat2_rad - lat1_rad
+ dlng = lng2_rad - lng1_rad
+ a = sin(dlat / 2)**2 + cos(lat1_rad) * cos(lat2_rad) * sin(dlng / 2)**2
+ c = 2 * asin(sqrt(a))
+
+ # Earth radius in miles
+ earth_radius = 3959
+ earth_radius * c
+ end
+
+ def build_query_text
+ parts = []
+
+ # Add cause synonyms
+ @user_intent.causes_selected.each do |cause|
+ if @config["causes"][cause]&.[]("synonyms")
+ parts << @config["causes"][cause]["synonyms"].join(" ")
+ end
+ end
+
+ # Add language preference
+ if @user_intent.has_language_preference?
+ parts << @user_intent.language_preference
+ end
+
+ # Add accessibility preferences
+ if @user_intent.prefs_selected.include?("wheelchair_access")
+ parts << "wheelchair accessible"
+ end
+
+ # Add caregiver support
+ if @user_intent.prefs_selected.include?("caregiver")
+ parts << "caregiver support"
+ end
+
+ # Add location context
+ parts << "#{@user_intent.user_city} #{@user_intent.user_state}"
+
+ query_text = parts.join("; ")
+
+ # Debug logging
+ Rails.logger.info "Comprehensive Recommendation Service - Query text: #{query_text}"
+ Rails.logger.info "Comprehensive Recommendation Service - User intent causes: #{@user_intent.causes_selected}"
+ Rails.logger.info "Comprehensive Recommendation Service - User location: #{@user_intent.user_city}, #{@user_intent.user_state}"
+
+ query_text
+ end
+
+ def generate_query_embedding(query_text)
+ script_path = Rails.root.join("app/views/smart_match/scripts/generate_user_embedding.py")
+
+ begin
+ # Use Open3 for better command execution
+ require "open3"
+
+ # Use array format to avoid shell escaping issues
+ cmd_array = ["conda", "run", "-n", "bge_env", "python", script_path.to_s, query_text, "BAAI/bge-large-en-v1.5"]
+
+ stdout, stderr, status = Open3.capture3(*cmd_array)
+
+ if status.success?
+ response = JSON.parse(stdout)
+ response["embedding"]
+ else
+ Rails.logger.error "Comprehensive Recommendation Service - Failed to generate query embedding: #{stderr}"
+ Rails.logger.error "Comprehensive Recommendation Service - Falling back to simple embedding"
+ # Return a simple fallback embedding (all zeros) to avoid complete failure
+ Array.new(1024, 0.0)
+ end
+ rescue => e
+ Rails.logger.error "Comprehensive Recommendation Service - Error generating query embedding: #{e.message}"
+ Rails.logger.error "Comprehensive Recommendation Service - Falling back to simple embedding"
+ # Return a simple fallback embedding (all zeros) to avoid complete failure
+ Array.new(1024, 0.0)
+ end
+ end
+
+ def calculate_scores(candidates, query_embedding)
+ candidates.map do |candidate|
+ # Calculate dense similarity (using existing embedding for now)
+ dense_similarity = calculate_dense_similarity(candidate, query_embedding)
+
+ # Calculate attribute bonus
+ attribute_bonus = calculate_attribute_bonus(candidate)
+
+ # Calculate distance score
+ distance_score = calculate_distance_score(candidate)
+
+ # Calculate final score
+ final_score = calculate_final_score(dense_similarity, attribute_bonus, distance_score)
+
+ {
+ candidate: candidate,
+ dense_similarity: dense_similarity,
+ attribute_bonus: attribute_bonus,
+ distance_score: distance_score,
+ final_score: final_score
+ }
+ end
+ end
+
+ def calculate_dense_similarity(candidate, query_embedding)
+ # Check if candidate has embedding (from BGE matrix)
+ unless candidate["embedding"]
+ # If no embedding, calculate similarity based on semantic content
+ return calculate_text_based_similarity(candidate, query_embedding)
+ end
+
+ # Check if we have a fallback embedding (all zeros)
+ if query_embedding.all? { |x| x == 0.0 }
+ Rails.logger.info "Comprehensive Recommendation Service - Using fallback similarity calculation"
+ return 0.5
+ end
+
+ # Enhanced BGE embedding similarity calculation
+ candidate_emb = candidate["embedding"]
+ return 0.5 unless candidate_emb.length == query_embedding.length
+
+ # Calculate cosine similarity
+ dot_product = candidate_emb.zip(query_embedding).sum { |a, b| a * b }
+ magnitude_a = sqrt(candidate_emb.sum { |x| x**2 })
+ magnitude_b = sqrt(query_embedding.sum { |x| x**2 })
+
+ return 0.5 if magnitude_a == 0 || magnitude_b == 0
+
+ raw_similarity = dot_product / (magnitude_a * magnitude_b)
+
+ # Debug logging for education-related organizations
+ if candidate["name"]&.downcase&.include?("education") || candidate["causes"]&.downcase&.include?("education")
+ Rails.logger.info "Comprehensive Recommendation Service - Education org similarity: #{candidate["name"]} - Raw: #{raw_similarity.round(3)}"
+ end
+
+ # Apply content-based boost for nonprofits with rich descriptions
+ content_boost = calculate_content_boost(candidate)
+ boosted_similarity = raw_similarity * (1.0 + content_boost)
+
+ # Check if normalization is enabled
+ behavior_config = @config["scoring_behavior"] || {}
+ enable_normalization = behavior_config["enable_normalization"] != false
+ enable_sigmoid = behavior_config["enable_sigmoid_transformation"] != false
+ min_sim = behavior_config["similarity_min"] || 0.1
+ max_sim = behavior_config["similarity_max"] || 0.95
+
+ if enable_normalization && enable_sigmoid
+ # Normalize similarity to prevent extreme values
+ # Apply sigmoid-like transformation to smooth out extreme values
+ # Use a less aggressive sigmoid to preserve higher scores
+ normalized_similarity = 1.0 / (1.0 + Math.exp(-3.0 * (boosted_similarity - 0.3)))
+
+ # Clamp to reasonable range to prevent 100% or 0% scores
+ final_similarity = normalized_similarity.clamp(min_sim, max_sim)
+
+ # Log significant transformations for monitoring
+ if (raw_similarity - final_similarity).abs > 0.1
+ Rails.logger.info "Comprehensive Recommendation Service - Similarity transformed: #{raw_similarity.round(3)} -> #{final_similarity.round(3)} (boost: #{content_boost.round(3)}) for #{candidate["name"]}"
+ end
+
+ final_similarity
+ else
+ # Return boosted similarity without normalization
+ [boosted_similarity, 1.0].min
+ end
+ end
+
+ def calculate_content_boost(candidate)
+ # Calculate a boost based on the richness of the nonprofit's content
+ # This rewards nonprofits with detailed descriptions, even if cause labels are missing
+ boost = 0.0
+
+ # Boost for detailed mission/vision/services
+ if candidate["mission_vision_services"]
+ content_length = candidate["mission_vision_services"].length
+ if content_length > 500
+ boost += 0.1 # 10% boost for very detailed descriptions
+ elsif content_length > 200
+ boost += 0.05 # 5% boost for moderately detailed descriptions
+ end
+ end
+
+ # Boost for multiple causes (indicates comprehensive services)
+ if candidate["causes"]
+ cause_count = candidate["causes"].split(",").length
+ if cause_count > 3
+ boost += 0.05 # 5% boost for NGOs with many causes
+ elsif cause_count > 1
+ boost += 0.02 # 2% boost for NGOs with multiple causes
+ end
+ end
+
+ # Boost for having complete information
+ if candidate["name"] && candidate["city"] && candidate["state"] && candidate["mission_vision_services"]
+ boost += 0.03 # 3% boost for complete profiles
+ end
+
+ # Cap the total boost at 20%
+ [boost, 0.2].min
+ end
+
+ def calculate_text_based_similarity(candidate, query_embedding)
+ # For nonprofits without BGE embeddings, calculate similarity based on semantic content
+
+ # Load CSV to quiz mapping
+ csv_to_quiz_mapping = @config["csv_to_quiz_mapping"] || {}
+
+ # Build comprehensive text representation of the candidate
+ candidate_text_parts = []
+
+ # Add organization name
+ candidate_text_parts << candidate["name"] if candidate["name"]
+
+ # Add causes (but with lower weight since we want to rely more on content)
+ if candidate["causes"]
+ candidate_causes_raw = candidate["causes"].split(",").map(&:strip)
+ candidate_causes = candidate_causes_raw.map do |cause|
+ csv_to_quiz_mapping[cause] || cause.downcase
+ end
+ candidate_text_parts << candidate_causes.join(" ")
+ end
+
+ # Add mission/vision/services (most important for semantic matching)
+ if candidate["mission_vision_services"]
+ candidate_text_parts << candidate["mission_vision_services"]
+ end
+
+ # Add location context
+ if candidate["city"] && candidate["state"]
+ candidate_text_parts << "#{candidate["city"]} #{candidate["state"]}"
+ end
+
+ candidate_text = candidate_text_parts.join(" ").downcase
+
+ # Build user query text (same as in build_query_text method)
+ user_query_parts = []
+
+ # Add cause synonyms
+ @user_intent.causes_selected.each do |cause|
+ if @config["causes"][cause]&.[]("synonyms")
+ user_query_parts << @config["causes"][cause]["synonyms"].join(" ")
+ end
+ end
+
+ # Add language preference
+ if @user_intent.has_language_preference?
+ user_query_parts << @user_intent.language_preference
+ end
+
+ # Add accessibility preferences
+ if @user_intent.prefs_selected.include?("wheelchair_access")
+ user_query_parts << "wheelchair accessible"
+ end
+
+ # Add caregiver support
+ if @user_intent.prefs_selected.include?("caregiver")
+ user_query_parts << "caregiver support"
+ end
+
+ # Add location context
+ user_query_parts << "#{@user_intent.user_city} #{@user_intent.user_state}"
+
+ user_query_text = user_query_parts.join(" ").downcase
+
+ # Calculate semantic similarity using keyword matching and content analysis
+ similarity_score = calculate_semantic_similarity(candidate_text, user_query_text)
+
+ # Apply normalization to prevent extreme values
+ behavior_config = @config["scoring_behavior"] || {}
+ enable_normalization = behavior_config["enable_normalization"] != false
+ enable_sigmoid = behavior_config["enable_sigmoid_transformation"] != false
+ min_sim = behavior_config["similarity_min"] || 0.1
+ max_sim = behavior_config["similarity_max"] || 0.95
+
+ if enable_normalization && enable_sigmoid
+ normalized_similarity = 1.0 / (1.0 + Math.exp(-3.0 * (similarity_score - 0.3)))
+ final_similarity = normalized_similarity.clamp(min_sim, max_sim)
+
+ Rails.logger.info "Comprehensive Recommendation Service - Text-based similarity: #{similarity_score.round(3)} -> #{final_similarity.round(3)} for #{candidate["name"]}"
+ final_similarity
+ else
+ [similarity_score, 1.0].min
+ end
+ end
+
+ def calculate_semantic_similarity(candidate_text, user_query_text)
+ # Enhanced semantic similarity calculation that relies more on content than exact matches
+ similarity = 0.0
+
+ # Split into words and create sets
+ candidate_words = candidate_text.split(/\s+/).to_set
+ user_words = user_query_text.split(/\s+/).to_set
+
+ # Calculate word overlap (Jaccard similarity)
+ intersection = candidate_words & user_words
+ union = candidate_words | user_words
+
+ if union.size > 0
+ word_similarity = intersection.size.to_f / union.size
+ similarity += word_similarity * 0.4 # 40% weight for word overlap
+ end
+
+ # Calculate phrase matching (for multi-word concepts)
+ user_phrases = extract_meaningful_phrases(user_query_text)
+ candidate_phrases = extract_meaningful_phrases(candidate_text)
+
+ phrase_matches = 0
+ total_phrases = user_phrases.size
+
+ user_phrases.each do |phrase|
+ if candidate_phrases.any? { |cp| cp.include?(phrase) || phrase.include?(cp) }
+ phrase_matches += 1
+ end
+ end
+
+ if total_phrases > 0
+ phrase_similarity = phrase_matches.to_f / total_phrases
+ similarity += phrase_similarity * 0.6 # 60% weight for phrase matching
+ end
+
+ similarity
+ end
+
+ def extract_meaningful_phrases(text)
+ # Extract meaningful phrases (2-4 word combinations) from text
+ words = text.split(/\s+/)
+ phrases = []
+
+ # Extract 2-4 word phrases
+ (2..4).each do |length|
+ (0..words.length - length).each do |start|
+ phrase = words[start, length].join(" ")
+ # Only include phrases that are meaningful (not just common words)
+ if phrase.length > 3 && !phrase.match?(/^(the|and|or|but|in|on|at|to|for|of|with|by)$/i)
+ phrases << phrase
+ end
+ end
+ end
+
+ phrases.uniq
+ end
+
+ def calculate_attribute_bonus(candidate)
+ bonus = 0.0
+
+ @user_intent.prefs_selected.each do |pref|
+ rule = @config["attributes"][@user_intent.user_type]&.[](pref)
+ next unless rule
+
+ if rule["match_input"] && @user_intent.has_language_preference?
+ # Language matching
+ candidate_languages = candidate["languages"] || []
+ if candidate_languages.include?(@user_intent.language_preference)
+ bonus += rule["weight"]
+ end
+ else
+ # Field matching
+ field_value = candidate[rule["field"]] || []
+ field_value = [field_value] unless field_value.is_a?(Array)
+
+ if (field_value & rule["any_of"]).any?
+ bonus += rule["weight"]
+ end
+ end
+ end
+
+ # Clamp to attribute cap
+ attribute_cap = @config["scoring_weights"]["attribute_cap"]
+ [bonus, attribute_cap].min
+ end
+
+ def calculate_distance_score(candidate)
+ user_coords = get_user_coordinates
+ return 0.5 unless user_coords
+
+ # Get coordinates from enhanced data if available
+ lat, lng = if @enhanced_lookup && @enhanced_lookup[candidate["name"]]
+ enhanced_data = @enhanced_lookup[candidate["name"]]
+ [enhanced_data["lat"], enhanced_data["lng"]]
+ else
+ [candidate["lat"], candidate["lng"]]
+ end
+
+ return 0.5 unless lat && lng
+
+ distance = haversine_distance(user_coords[0], user_coords[1], lat, lng)
+
+ # Map distance to score using buckets
+ buckets = @config["distance_buckets_miles"]
+ bucket_scores = [1.00, 0.95, 0.90, 0.80, 0.70]
+
+ buckets.each_with_index do |bucket, index|
+ return bucket_scores[index] if distance <= bucket
+ end
+
+ 0.70 # Default for distances > 50 miles
+ end
+
+ def calculate_final_score(dense_similarity, attribute_bonus, distance_score)
+ weights = @config["scoring_weights"]
+
+ raw_final_score = weights["dense_similarity"] * dense_similarity +
+ weights["attribute_bonus"] * attribute_bonus +
+ weights["distance_score"] * distance_score
+
+ # Check if normalization is enabled
+ behavior_config = @config["scoring_behavior"] || {}
+ enable_normalization = behavior_config["enable_normalization"] != false
+ enable_sigmoid = behavior_config["enable_sigmoid_transformation"] != false
+ min_score = behavior_config["min_score"] || 0.05
+ max_score = behavior_config["max_score"] || 0.95
+
+ if enable_normalization && enable_sigmoid
+ # Apply additional normalization to create better distribution
+ # Use a less aggressive sigmoid to preserve higher scores
+ normalized_score = 1.0 / (1.0 + Math.exp(-2.0 * (raw_final_score - 0.4)))
+
+ # Clamp to reasonable range to prevent extreme scores
+ final_score = normalized_score.clamp(min_score, max_score)
+
+ # Log significant transformations for monitoring
+ if (raw_final_score - final_score).abs > 0.1
+ Rails.logger.info "Comprehensive Recommendation Service - Final score transformed: #{raw_final_score.round(3)} -> #{final_score.round(3)} (dense: #{dense_similarity.round(3)}, attr: #{attribute_bonus.round(3)}, dist: #{distance_score.round(3)})"
+ end
+
+ final_score
+ else
+ # Return raw score without normalization
+ [raw_final_score, 1.0].min
+ end
+ end
+
+ def build_recommendation(scored_candidate)
+ candidate = scored_candidate[:candidate]
+
+ # Get location data from enhanced lookup if available
+ city, state = if @enhanced_lookup && @enhanced_lookup[candidate["name"]]
+ enhanced_data = @enhanced_lookup[candidate["name"]]
+ [enhanced_data["city"], enhanced_data["state"]]
+ else
+ [candidate["city"], candidate["state"]]
+ end
+
+ {
+ id: candidate["id"],
+ name: candidate["name"],
+ url: candidate["url"] || candidate["id"], # Use ID as URL if no URL field
+ city: city || "Unknown",
+ state: state || "Unknown",
+ score: scored_candidate[:final_score],
+ relevance_reason: generate_relevance_reason(scored_candidate),
+ metadata: {
+ dense_similarity: scored_candidate[:dense_similarity],
+ attribute_bonus: scored_candidate[:attribute_bonus],
+ distance_score: scored_candidate[:distance_score]
+ }
+ }
+ end
+
+ def generate_relevance_reason(scored_candidate)
+ candidate = scored_candidate[:candidate]
+
+ parts = []
+
+ # Add the actual causes this nonprofit serves (from CSV data)
+ if candidate["causes"].present?
+ # Parse the causes (they come as comma-separated string)
+ nonprofit_causes = candidate["causes"].split(",").map(&:strip)
+
+ # Format the causes nicely
+ parts << if nonprofit_causes.length == 1
+ "Serves: #{nonprofit_causes.first}"
+ elsif nonprofit_causes.length == 2
+ "Serves: #{nonprofit_causes.join(" and ")}"
+ else
+ "Serves: #{nonprofit_causes[0...-1].join(", ")}, and #{nonprofit_causes.last}"
+ end
+ end
+
+ # Add user's selected causes that match
+ user_causes = @user_intent.causes_selected.map(&:titleize)
+ if user_causes.any?
+ parts << "Matches your interest in #{user_causes.join(", ")}"
+ end
+
+ # Add location information
+ city, state = if @enhanced_lookup && @enhanced_lookup[candidate["name"]]
+ enhanced_data = @enhanced_lookup[candidate["name"]]
+ [enhanced_data["city"], enhanced_data["state"]]
+ else
+ [candidate["city"], candidate["state"]]
+ end
+
+ if city && state && city != "Unknown"
+ parts << "Located in #{city}, #{state}"
+ elsif state && state != "Unknown"
+ parts << "Located in #{state}"
+ end
+
+ # Add distance information if available
+ user_coords = get_user_coordinates
+ if user_coords
+ # Get coordinates from enhanced data if available
+ lat, lng = if @enhanced_lookup && @enhanced_lookup[candidate["name"]]
+ enhanced_data = @enhanced_lookup[candidate["name"]]
+ [enhanced_data["lat"], enhanced_data["lng"]]
+ else
+ [candidate["lat"], candidate["lng"]]
+ end
+
+ if lat && lng
+ distance = haversine_distance(user_coords[0], user_coords[1], lat, lng)
+ bucket = get_distance_bucket(distance)
+ parts << "within #{bucket} miles of you"
+ end
+ end
+
+ # Add language if applicable
+ if @user_intent.has_language_preference?
+ parts << "Offers services in #{@user_intent.language_preference.titleize}"
+ end
+
+ # Add accessibility if applicable
+ if @user_intent.prefs_selected.include?("wheelchair_access")
+ parts << "Wheelchair accessible"
+ end
+
+ # Add organizational identity if applicable
+ if @user_intent.prefs_selected.include?("women_bipoc_led")
+ parts << "Women/BIPOC-led organization"
+ end
+
+ parts.join(". ")
+ end
+
+ def get_distance_bucket(distance)
+ buckets = @config["distance_buckets_miles"]
+ bucket_labels = ["2", "5", "10", "25", "50"]
+
+ buckets.each_with_index do |bucket, index|
+ return bucket_labels[index] if distance <= bucket
+ end
+
+ "50+"
+ end
+end
diff --git a/app/services/quiz_to_user_intent_converter.rb b/app/services/quiz_to_user_intent_converter.rb
new file mode 100644
index 000000000..ccd690d69
--- /dev/null
+++ b/app/services/quiz_to_user_intent_converter.rb
@@ -0,0 +1,332 @@
+# Quiz to UserIntent Converter
+# Converts quiz answers to structured UserIntent for the recommendation system
+class QuizToUserIntentConverter
+ def initialize(quiz_answers, user_intent_type)
+ @quiz_answers = quiz_answers
+ @user_intent_type = user_intent_type
+ end
+
+ def convert
+ UserIntent.new(
+ user_state: extract_user_state,
+ user_city: extract_user_city,
+ travel_bucket: extract_travel_bucket,
+ user_type: map_user_type(@user_intent_type),
+ causes_selected: extract_causes,
+ prefs_selected: extract_preferences,
+ language_input: extract_language_preference
+ )
+ end
+
+ private
+
+ def map_user_type(user_intent_type)
+ case user_intent_type
+ when "seeking_help"
+ "seeker"
+ when "volunteering"
+ "volunteer"
+ when "donating"
+ "donor"
+ else
+ "seeker" # default
+ end
+ end
+
+ private
+
+ def extract_user_state
+ # Extract state from quiz answers
+ # For service seekers, city selection is in step 6
+ city_answer = @quiz_answers["6"] || @quiz_answers["city"] || @quiz_answers["location"] || @quiz_answers["user_state"]
+
+ # Map common state formats to our supported states
+ case city_answer&.downcase
+ when "atlantic city", "new jersey", "nj"
+ "NJ"
+ when "los angeles", "california", "ca"
+ "CA"
+ when "nashville", "tennessee", "tn"
+ "TN"
+ else
+ # Default to first supported state if not found
+ "NJ"
+ end
+ end
+
+ def extract_user_city
+ # Extract city from quiz answers
+ # For service seekers, city selection is in step 6
+ city_answer = @quiz_answers["6"] || @quiz_answers["city"] || @quiz_answers["location"] || @quiz_answers["user_city"]
+
+ # Map to supported cities or use as-is
+ case city_answer&.downcase
+ when "atlantic city"
+ "Atlantic City"
+ when "los angeles", "la"
+ "Los Angeles"
+ when "nashville"
+ "Nashville"
+ else
+ # Use the provided city or default
+ city_answer&.titleize || "Atlantic City"
+ end
+ end
+
+ def extract_travel_bucket
+ # Extract travel preference from quiz answers
+ # For service seekers, travel preference is in step 5
+ # For donors and volunteers, step 5 is not about travel
+ travel_answer = if @user_intent_type == "seeking_help"
+ @quiz_answers["5"] || @quiz_answers["travel"] || @quiz_answers["transportation"] || @quiz_answers["travel_preference"]
+ else
+ # For donors and volunteers, travel is not collected in step 5
+ @quiz_answers["travel"] || @quiz_answers["transportation"] || @quiz_answers["travel_preference"]
+ end
+
+ # Handle array input (convert to string)
+ if travel_answer.is_a?(Array)
+ travel_answer = travel_answer.first
+ end
+
+ case travel_answer&.downcase
+ when "walk", "walking", "foot", "near_me"
+ "walk"
+ when "transit", "public transportation", "bus", "train", "subway"
+ "transit"
+ when "car", "driving", "drive"
+ "car"
+ else
+ # Default to car if not specified
+ "car"
+ end
+ end
+
+ def extract_causes
+ # Extract causes from quiz answers
+ causes = []
+
+ # Load the mapping configuration
+ config = YAML.load_file(Rails.root.join("config/matching_rules.yml"))
+ quiz_mapping = config["quiz_mapping"] || {}
+
+ # Get the appropriate mapping for this user type
+ user_type_key = case @user_intent_type
+ when "seeking_help"
+ "service_seeker"
+ when "volunteering"
+ "volunteer"
+ when "donating"
+ "donor"
+ else
+ "service_seeker"
+ end
+
+ mapping = quiz_mapping[user_type_key] || {}
+
+ # For service seekers, causes are selected in step 4
+ if @user_intent_type == "seeking_help"
+ step_4_causes = @quiz_answers["4"]
+ if step_4_causes.is_a?(Array)
+ step_4_causes.each do |cause|
+ # Use the mapping configuration if available, otherwise fall back to direct mapping
+ mapped_cause = mapping[cause] || cause
+ causes << mapped_cause if mapped_cause
+ end
+ end
+ elsif @user_intent_type == "volunteering"
+ # For volunteers, causes are selected in step 2
+ step_2_causes = @quiz_answers["2"]
+ if step_2_causes.is_a?(Array)
+ step_2_causes.each do |cause|
+ mapped_cause = mapping[cause] || cause
+ causes << mapped_cause if mapped_cause
+ end
+ end
+ elsif @user_intent_type == "donating"
+ # For donors, causes are selected in step 2
+ step_2_causes = @quiz_answers["2"]
+ if step_2_causes.is_a?(Array)
+ step_2_causes.each do |cause|
+ mapped_cause = mapping[cause] || cause
+ causes << mapped_cause if mapped_cause
+ end
+ end
+ end
+
+ # Remove duplicates and return
+ causes.uniq
+ end
+
+ def extract_preferences
+ # Extract user preferences based on user type
+ preferences = []
+
+ case @user_intent_type
+ when "seeking_help"
+ preferences = extract_seeker_preferences
+ when "volunteering"
+ preferences = extract_volunteer_preferences
+ when "donating"
+ preferences = extract_donor_preferences
+ end
+
+ # Always add default preferences to ensure UserIntent is valid
+ case @user_intent_type
+ when "seeking_help"
+ preferences << "free_or_sliding" unless preferences.include?("free_or_sliding")
+ when "volunteering"
+ preferences << "family_friendly" unless preferences.include?("family_friendly")
+ when "donating"
+ preferences << "children_families" unless preferences.include?("children_families")
+ end
+
+ preferences
+ end
+
+ def extract_race_ethnicity
+ # Extract race/ethnicity from step 11 for service seekers
+ if @user_intent_type == "seeking_help"
+ race_answer = @quiz_answers["11"]
+ return race_answer if race_answer.present?
+ end
+ nil
+ end
+
+ def extract_seeker_preferences
+ prefs = []
+
+ # For service seekers, preferences are selected in step 3 (identity) and step 8 (additional preferences)
+ # Step 3: Identity preferences
+ step_3_identity = @quiz_answers["3"]
+ if step_3_identity.present?
+ case step_3_identity
+ when "student"
+ prefs << "student"
+ when "veteran_military"
+ prefs << "veteran"
+ when "caregiver"
+ prefs << "caregiver"
+ when "lgbtqia"
+ prefs << "lgbtqia"
+ when "disabilities"
+ prefs << "disability"
+ when "crisis_hardships"
+ prefs << "facing_crisis"
+ end
+ end
+
+ # Step 8: Additional preferences
+ step_8_prefs = @quiz_answers["8"]
+ if step_8_prefs.is_a?(Array)
+ step_8_prefs.each do |pref|
+ case pref
+ when "free_services"
+ prefs << "free_or_sliding"
+ when "no_id"
+ prefs << "no_id_required"
+ when "lgbtq_affirming"
+ prefs << "lgbtq_affirming"
+ when "wheelchair"
+ prefs << "wheelchair_access"
+ when "women_led"
+ prefs << "women_bipoc_led"
+ when "no_special_needs"
+ # If user selects "no_special_needs", don't add any special preferences
+ next
+ end
+ end
+ end
+
+ prefs
+ end
+
+ def extract_volunteer_preferences
+ prefs = []
+
+ @quiz_answers.each do |key, value|
+ next if value.blank?
+
+ case key.downcase
+ when "work_with_kids", "work_with_seniors"
+ prefs << "work_with_kids_seniors" if value == "yes" || value == true
+ when "veterans", "military_support"
+ prefs << "support_veterans" if value == "yes" || value == true
+ when "spanish", "spanish_opportunities"
+ prefs << "spanish_opps" if value == "yes" || value == true
+ when "grassroots", "bipoc_led"
+ prefs << "grassroots_bipoc_led" if value == "yes" || value == true
+ when "behind_scenes", "admin", "logistics"
+ prefs << "behind_the_scenes" if value == "yes" || value == true
+ when "accessible", "wheelchair"
+ prefs << "accessible_opps" if value == "yes" || value == true
+ when "family_friendly", "group_opportunities"
+ prefs << "family_friendly" if value == "yes" || value == true
+ end
+ end
+
+ prefs
+ end
+
+ def extract_donor_preferences
+ prefs = []
+
+ @quiz_answers.each do |key, value|
+ next if value.blank?
+
+ case key.downcase
+ when "seniors", "elderly"
+ prefs << "seniors" if value == "yes" || value == true
+ when "veterans", "military"
+ prefs << "veterans" if value == "yes" || value == true
+ when "spanish_speaking", "hispanic"
+ prefs << "spanish_speaking" if value == "yes" || value == true
+ when "bipoc", "people_of_color"
+ prefs << "bipoc" if value == "yes" || value == true
+ when "disabilities", "disability"
+ prefs << "disabilities" if value == "yes" || value == true
+ when "lgbtq", "lgbtqia"
+ prefs << "lgbtq" if value == "yes" || value == true
+ when "children", "families"
+ prefs << "children_families" if value == "yes" || value == true
+ end
+ end
+
+ prefs
+ end
+
+ def extract_language_preference
+ # Extract language preference from quiz answers
+ # For service seekers, language is selected in step 8 (special needs)
+ # For donors and volunteers, language is not collected
+ language_answer = if @user_intent_type == "seeking_help"
+ # For service seekers, check if spanish_language is selected in step 8
+ step_8_answers = @quiz_answers["8"]
+ if step_8_answers.is_a?(Array) && step_8_answers.include?("spanish_language")
+ "spanish"
+ end
+ else
+ # For donors and volunteers, language is not collected
+ @quiz_answers["language"] || @quiz_answers["preferred_language"] || @quiz_answers["language_preference"]
+ end
+
+ return nil if language_answer.blank?
+
+ # Handle array input (convert to string)
+ if language_answer.is_a?(Array)
+ language_answer = language_answer.first
+ end
+
+ return nil if language_answer.blank?
+
+ # Normalize language input
+ case language_answer.downcase
+ when "spanish", "espa\u00F1ol", "espanol"
+ "spanish"
+ when "english", "en"
+ "english"
+ else
+ language_answer.downcase
+ end
+ end
+end
diff --git a/app/views/smart_match/README.md b/app/views/smart_match/README.md
new file mode 100644
index 000000000..708f3106a
--- /dev/null
+++ b/app/views/smart_match/README.md
@@ -0,0 +1,697 @@
+# Smart Match Recommendation System
+
+A comprehensive nonprofit recommendation system that uses AI-powered semantic matching with BGE embeddings and deterministic filtering to connect users with relevant organizations based on their needs and preferences.
+
+## 📁 Complete Smart Match File Structure
+
+```
+giving-connection/ # Project root
+├── app/
+│ ├── controllers/
+│ │ └── smart_match_controller.rb # Main controller
+│ ├── services/ # Smart match services (standard Rails autoloading)
+│ │ ├── comprehensive_recommendation_service.rb # Main recommendation service
+│ │ └── quiz_to_user_intent_converter.rb # Quiz answer converter
+│ ├── models/ # Smart match models (standard Rails autoloading)
+│ │ └── user_intent.rb # User intent model
+│ ├── javascript/controllers/
+│ │ └── smart_match_controller.js # Frontend controller
+│ └── views/smart_match/ # Smart match module
+│ ├── README.md # This documentation
+│ ├── services/ # Legacy services (backup copies)
+│ │ ├── comprehensive_recommendation_service.rb # Backup copy
+│ │ └── quiz_to_user_intent_converter.rb # Backup copy
+│ ├── models/ # Legacy models (backup copies)
+│ │ └── user_intent.rb # Backup copy
+│ ├── assets/stylesheets/components/ # Smart match styles
+│ │ └── _smart_match.scss # Custom CSS
+│ ├── views/ # Main view templates
+│ │ ├── index.html.slim # Welcome/landing page
+│ │ ├── quiz/ # Quiz interface views
+│ │ │ └── quiz.html.erb # Main quiz interface
+│ │ └── results/ # Results views
+│ │ └── results.html.slim # Results display page
+│ ├── components/ # Reusable UI components
+│ │ ├── paths/ # Quiz path components
+│ │ │ ├── _service_seeker_path.html.slim
+│ │ │ ├── _volunteer_path.html.slim
+│ │ │ └── _donor_path.html.slim
+│ │ └── shared/ # Shared components (future use)
+│ ├── assets/ # Static assets
+│ │ ├── images/ # Smart match specific images
+│ │ └── styles/ # Smart match specific styles
+│ ├── scripts/ # Matrix generation and testing scripts
+│ │ ├── generate_enhanced_bge_matrix.py # Generate comprehensive BGE matrix
+│ │ ├── generate_user_embedding.py # Generate user answer embeddings
+│ │ ├── analyze_causes.py # Analyze cause data from CSV
+│ │ └── activate_env.sh # Activate Python environment
+│ └── data/ # Generated data files
+│ ├── enhanced_bge_nonprofits_matrix.json # Primary matrix (928 nonprofits)
+│ └── giving_connection_scraped_data.csv # Source data (928 nonprofits)
+├── config/
+│ ├── matching_rules.yml # Cause mappings, scoring weights, quiz configs
+│ ├── routes.rb # Smart match routing configuration
+│ └── city_centroids.yml # Geographic data for location matching
+├── spec/controllers/
+│ └── smart_match_controller_spec.rb # RSpec tests for smart match functionality
+└── lib/tasks/ # Development tools
+ ├── smart_match_new.rake # Current service testing tasks (working)
+ ├── smart_match_debug.rake # Debug tasks (may reference old services)
+ └── test_smart_match_improvements.rake # Legacy testing tasks (may reference old services)
+```
+
+## 🎯 System Overview
+
+The Smart Match system consists of three main user paths:
+
+1. **Service Seeker Path** - For users seeking help from nonprofits (36 cause options)
+2. **Volunteer Path** - For users wanting to volunteer their time (14 cause options)
+3. **Donor Path** - For users wanting to donate to causes (14 cause options)
+
+Each path has a customized questionnaire that collects relevant information to generate personalized recommendations using semantic similarity.
+
+## 🤖 AI-Powered Semantic Matching
+
+### How It Works
+
+1. **Nonprofit Embeddings**: All 928 nonprofits are converted to semantic embeddings using the `BAAI/bge-large-en-v1.5` model (1024 dimensions)
+2. **User Answer Processing**: User quiz answers are converted to natural language text representations
+3. **Semantic Matching**: User text is converted to embeddings and compared with nonprofit embeddings using cosine similarity
+4. **Deterministic Filtering**: Additional filtering based on location, causes, and user preferences
+5. **Recommendation Ranking**: Nonprofits are ranked by combined similarity and filtering scores
+
+### Matrix Generation
+
+The system uses BGE (BAAI/bge-large-en-v1.5) to generate embeddings for nonprofits based on:
+- Organization name
+- Mission and vision statements
+- Services offered
+- Causes supported (with comprehensive mapping)
+- Geographic location
+- Full address information
+
+### Prerequisites
+
+1. Create and activate the Python virtual environment:
+ ```bash
+ conda create -n bge_env python=3.11
+ conda activate bge_env
+ pip install sentence-transformers torch torchvision torchaudio
+ ```
+
+2. Ensure the CSV file `giving_connection_scraped_data.csv` is in the smart_match/data folder.
+
+### Generating the Matrix
+
+**Python Script:**
+```bash
+cd app/views/smart_match/scripts
+conda run -n bge_env python generate_enhanced_bge_matrix.py
+```
+
+**Expected Output:**
+```
+🚀 Starting Enhanced BGE Matrix Generation...
+📊 Loading CSV data: 928 nonprofits found
+🔧 Creating enhanced text representations...
+🤖 Loading BGE model: BAAI/bge-large-en-v1.5
+📈 Generating embeddings: 100% complete
+💾 Saving matrix: enhanced_bge_nonprofits_matrix.json
+✅ Matrix generation complete! (928 nonprofits, 1024 dimensions)
+```
+
+### Testing the Recommendation System
+
+**Rake Task:**
+```bash
+rails smart_match_new:test_service # Test comprehensive service
+rails smart_match_debug:debug_food_assistance # Debug specific scenarios
+```
+
+## 📊 Data Structure
+
+### Input CSV Format
+
+The CSV file contains these fields:
+- `url`: Organization URL (used as ID)
+- `name`: Organization name
+- `mission_vision_services`: Organization description and services
+- `causes`: Causes supported (comma-separated)
+- `city`: Geographic location
+- `state`: Geographic location
+- `address`: Full address
+
+### Output Matrix Format
+
+```json
+{
+ "model": "BAAI/bge-large-en-v1.5",
+ "dimension": 1024,
+ "nonprofits_count": 928,
+ "model_info": {
+ "name": "BGE-Large-EN",
+ "max_seq_length": 512,
+ "embedding_dimension": 1024
+ },
+ "nonprofits": [
+ {
+ "id": "https://example.org",
+ "name": "Example Nonprofit",
+ "causes": "Education, Youth Development",
+ "city": "Atlantic City",
+ "state": "NJ",
+ "lat": 39.3643,
+ "lng": -74.4229,
+ "embedding": [0.062, -0.015, 0.059, ...]
+ }
+ ],
+ "generated_at": "2024-01-01T12:00:00Z"
+}
+```
+
+## 🔧 Recommendation Service
+
+The `ComprehensiveRecommendationService` class handles:
+
+1. **User Intent Conversion**: Converts quiz answers to structured user intent
+2. **Deterministic Filtering**: Filters nonprofits by location and causes
+3. **BGE Embedding Generation**: Uses Python script to generate semantic embeddings
+4. **Similarity Calculation**: Computes cosine similarity with filtered nonprofits
+5. **Scoring & Ranking**: Combines similarity scores with deterministic filtering scores
+
+### Usage
+
+```ruby
+# In your controller
+converter = QuizToUserIntentConverter.new(user_answers, user_intent)
+user_intent_obj = converter.convert
+recommendation_service = ComprehensiveRecommendationService.new(user_intent_obj)
+recommendations = recommendation_service.generate_recommendations(10)
+
+# Returns array of hashes with:
+# - id: nonprofit URL
+# - name: nonprofit name
+# - score: 0.0-1.0 combined score
+# - relevance_reason: human-readable explanation with all causes served
+```
+
+## 🎯 Matchmaking Algorithm: Complete Breakdown
+
+### **🔄 The 6-Step Matchmaking Process**
+
+#### **Step 1: User Intent Validation**
+```ruby
+# From comprehensive_recommendation_service.rb
+def generate_recommendations(limit = 10)
+ # Step 1: Basic validation
+ return [] unless @user_intent.respond_to?(:causes_selected) && @user_intent.causes_selected.any?
+```
+
+**What it does:**
+- Validates that user intent has required fields (state, city, travel_bucket, user_type, causes)
+- Ensures data quality before proceeding
+
+#### **Step 2: Deterministic Filtering**
+```ruby
+# Step 2: Apply deterministic filters
+candidates = apply_deterministic_filters
+```
+
+**What it does:**
+1. **State Filter**: Only nonprofits in user's state (NJ, CA, TN)
+2. **Distance Filter**: Based on travel preference:
+ - Walk: 5 miles radius
+ - Transit: 10 miles radius
+ - Car: 50 miles radius
+3. **Progressive Radius Expansion**: If no results, expands radius gradually
+
+#### **Step 3: Query Text Building**
+```ruby
+# Step 3: Build query text for BGE
+query_text = build_query_text
+```
+
+**What it does:**
+- Converts user preferences to natural language text
+- Includes cause synonyms, language preferences, accessibility needs
+- Example: `"education learning school academic educational programs literacy training educational services learning support; spanish; wheelchair accessible; Atlantic City NJ"`
+
+#### **Step 4: Embedding Generation**
+```ruby
+# Step 4: Generate query embedding
+query_embedding = generate_query_embedding(query_text)
+```
+
+**What it does:**
+- Calls Python script to generate 1024-dimensional BGE embedding
+- Uses `BAAI/bge-large-en-v1.5` model for superior semantic understanding
+
+#### **Step 5: Multi-Factor Scoring**
+```ruby
+# Step 5: Calculate scores for all candidates
+scored_candidates = calculate_scores(candidates, query_embedding)
+```
+
+**What it does:**
+Calculates three scores for each nonprofit:
+
+1. **Dense Similarity (70% weight)**:
+ ```ruby
+ def calculate_dense_similarity(candidate, query_embedding)
+ # Cosine similarity between user query and nonprofit embedding
+ # Plus content boost for detailed descriptions
+ dot_product = candidate_emb.zip(query_embedding).sum { |a, b| a * b }
+ magnitude_a = sqrt(candidate_emb.sum { |x| x**2 })
+ magnitude_b = sqrt(query_embedding.sum { |x| x**2 })
+ similarity = dot_product / (magnitude_a * magnitude_b)
+
+ # Content boost for rich descriptions
+ if candidate["mission_vision_services"]&.length.to_i > 500
+ similarity += 0.10 # 10% boost for detailed descriptions
+ elsif candidate["mission_vision_services"]&.length.to_i > 200
+ similarity += 0.05 # 5% boost for moderate descriptions
+ end
+ ```
+
+2. **Attribute Bonus (20% weight)**:
+ ```ruby
+ def calculate_attribute_bonus(candidate)
+ bonus = 0.0
+ @user_intent.prefs_selected.each do |pref|
+ rule = @config["attributes"][@user_intent.user_type]&.[](pref)
+ if rule && (field_value & rule["any_of"]).any?
+ bonus += rule["weight"] # 0.04-0.08 per match
+ end
+ end
+ ```
+
+3. **Distance Score (10% weight)**:
+ ```ruby
+ def calculate_distance_score(candidate)
+ distance = haversine_distance(user_coords, nonprofit_coords)
+ # Map to score: 2mi=1.0, 5mi=0.95, 10mi=0.90, 25mi=0.80, 50mi=0.70
+ ```
+
+#### **Step 6: Final Ranking**
+```ruby
+# Step 6: Sort and limit results
+recommendations = scored_candidates
+ .sort_by { |c| -c[:final_score] }
+ .first(limit)
+ .map { |c| build_recommendation(c) }
+```
+
+### **🎯 Scoring Formula**
+
+```ruby
+final_score = (0.70 × dense_similarity) + (0.20 × attribute_bonus) + (0.10 × distance_score)
+```
+
+### **📊 Configuration-Driven Matching**
+
+The system uses `config/matching_rules.yml` for flexible configuration:
+
+#### **Cause Mapping:**
+```yaml
+education:
+ synonyms: ["education", "learning", "school", "academic", "educational programs", "literacy", "training", "educational services", "learning support"]
+
+# CSV to Quiz Mapping - Maps actual causes from CSV data to quiz causes
+csv_to_quiz_mapping:
+ "Advocacy": "advocacy"
+ "Human & Social Services": "human_services"
+ "Children & Family Services": "youth"
+ "Youth Development": "youth"
+ "Health": "healthcare"
+ "Education": "education"
+ "Arts & Culture": "arts_culture"
+ "Community & Economic Development": "community_development"
+ "Housing & Homelessness": "housing"
+ "Faith-Based": "faith_based"
+ "Disability Services": "disability"
+ "Hunger & Food Security": "food_assistance"
+ "Philanthropy": "human_services"
+ "Mental Health": "mental_health"
+ "Sports & Recreation": "sports_recreation"
+ "Clothing & Living Essentials": "clothing_essentials"
+ "Drug & Alcohol Treatment": "substance_abuse"
+ "Animals": "animal_welfare"
+ "Environment": "environment"
+ "Emergency & Safety": "crisis"
+ "LGBTQ+": "lgbtqia"
+ "Veteran & Military": "veterans"
+ "Immigrant & Refugee": "immigrant_refugee"
+ "Race & Ethnicity": "advocacy"
+ "Inmate & Formerly Incarcerated": "legal_help"
+ "Justice & Legal Services": "legal_help"
+ "Disaster Relief & Preparedness": "disaster_relief"
+ "Research & Public Policy": "advocacy"
+ "Media & Broadcasting": "arts_culture"
+ "Social Sciences": "education"
+ "Science & Technology": "education"
+```
+
+#### **Attribute Rules:**
+```yaml
+seeker:
+ lgbtqia:
+ field: "cause_tags"
+ any_of: ["lgbtq_services", "lgbtq_affirming"]
+ weight: 0.08
+ wheelchair_access:
+ field: "facilities"
+ any_of: ["wheelchair_accessible"]
+ weight: 0.07
+```
+
+### ** Real-World Example**
+
+**User Input:**
+- Location: Atlantic City, NJ
+- Travel: Walking (5 mile radius)
+- Cause: Education
+- Preferences: Spanish language, wheelchair accessible
+- User Type: Service seeker
+
+**Matchmaking Process:**
+
+1. **Filter**: 928 nonprofits → 196 nonprofits in NJ → 15 nonprofits within 5 miles of Atlantic City
+
+2. **Query Text**: `"education learning school academic educational programs literacy training educational services learning support; spanish; wheelchair accessible; Atlantic City NJ"`
+
+3. **Scoring Example**:
+ ```
+ Nonprofit A: Atlantic County Collaborative for Educational Equity
+ - Dense Similarity: 0.85 (high semantic match)
+ - Attribute Bonus: 0.15 (Spanish + wheelchair accessible)
+ - Distance Score: 0.95 (2 miles away)
+ - Final Score: (0.70×0.85) + (0.20×0.15) + (0.10×0.95) = 0.78
+
+ Nonprofit B: Animal Shelter
+ - Dense Similarity: 0.25 (low semantic match)
+ - Attribute Bonus: 0.07 (wheelchair accessible only)
+ - Distance Score: 0.90 (3 miles away)
+ - Final Score: (0.70×0.25) + (0.20×0.07) + (0.10×0.90) = 0.28
+ ```
+
+4. **Result**: Atlantic County Collaborative for Educational Equity ranked #1 with 78% match
+
+### ** Key Features**
+
+1. **Embedding-First Approach**: 70% weight on semantic similarity using BGE embeddings
+2. **Comprehensive Cause Mapping**: Maps all 35 unique causes from CSV to quiz categories
+3. **Multi-cause support**: Handles nonprofits with multiple causes (61.9% of nonprofits)
+4. **Configurable Weights**: Easy to adjust scoring without code changes
+5. **Progressive Filtering**: Starts strict, expands if needed
+6. **Fallback Mechanisms**: Text-based similarity for nonprofits without embeddings
+7. **Explainable Results**: Clear reasoning showing all causes each nonprofit serves
+
+## 🔄 Complete Workflow Files
+
+### **User Journey Files:**
+
+1. **Landing Page**: `app/views/smart_match/views/index.html.slim`
+2. **Quiz Interface**: `app/views/smart_match/views/quiz/quiz.html.erb`
+3. **Quiz Paths**:
+ - `app/views/smart_match/components/paths/_service_seeker_path.html.slim`
+ - `app/views/smart_match/components/paths/_donor_path.html.slim`
+ - `app/views/smart_match/components/paths/_volunteer_path.html.slim`
+4. **JavaScript Controller**: `app/javascript/controllers/smart_match_controller.js`
+5. **Rails Controller**: `app/controllers/smart_match_controller.rb`
+
+### **Processing Files:**
+
+6. **Quiz Converter**: `app/views/smart_match/services/quiz_to_user_intent_converter.rb`
+7. **User Intent Model**: `app/views/smart_match/models/user_intent.rb`
+8. **Main Service**: `app/views/smart_match/services/comprehensive_recommendation_service.rb`
+9. **Python Embedding**: `app/views/smart_match/scripts/generate_user_embedding.py`
+
+### **Configuration Files:**
+
+10. **Matching Rules**: `config/matching_rules.yml` - Cause mappings, scoring weights, and quiz configurations
+11. **Routes**: `config/routes.rb` - Smart match routing configuration
+12. **City Data**: `config/city_centroids.yml` - Geographic data for location matching
+
+### **Data Files:**
+
+13. **Enhanced BGE Matrix**: `app/views/smart_match/data/enhanced_bge_nonprofits_matrix.json` (28MB, 928 nonprofits)
+14. **Source Data**: `app/views/smart_match/data/giving_connection_scraped_data.csv` (1.9MB, 928 nonprofits)
+
+### **Results Files:**
+
+15. **Results Display**: `app/views/smart_match/views/results/results.html.slim`
+
+### **Styling Files:**
+
+16. **Smart Match Styles**: `app/views/smart_match/assets/stylesheets/components/_smart_match.scss` - Custom CSS for smart match components
+
+### **Testing Files:**
+
+17. **Controller Tests**: `spec/controllers/smart_match_controller_spec.rb` - RSpec tests for smart match functionality
+
+### **Development Tools:**
+
+18. **New Service Tasks**: `lib/tasks/smart_match_new.rake` - Current service testing tasks (working)
+19. **Debug Tasks**: `lib/tasks/smart_match_debug.rake` - Debug tasks (may reference old services)
+20. **Test Tasks**: `lib/tasks/test_smart_match_improvements.rake` - Legacy testing tasks (may reference old services)
+
+### **Data Flow:**
+
+```
+User Input → Quiz Interface → JavaScript → Rails Controller →
+Quiz Converter → UserIntent → Comprehensive Service →
+Python Script → BGE Embeddings → Similarity Calculation →
+Scoring & Ranking → Results Display
+```
+
+## 🔧 Development
+
+### Adding New Components
+
+1. **New Quiz Paths**: Add to `components/paths/`
+2. **New Services**: Add to `app/services/`
+3. **New Models**: Add to `app/models/`
+
+### Environment Setup
+
+```bash
+# Activate environment
+conda activate bge_env
+
+# Or use the convenience script
+./scripts/activate_env.sh
+```
+
+### Available Commands
+
+```bash
+# Matrix generation
+conda run -n bge_env python scripts/generate_enhanced_bge_matrix.py
+
+# System testing
+rails smart_match_new:test_service
+rails smart_match_new:test_csv_loading
+rails smart_match_new:compare_services
+
+# Cause analysis
+conda run -n bge_env python scripts/analyze_causes.py
+```
+
+**Note**: Some rake tasks may reference old services that have been removed. The working tasks are listed above.
+
+## 🚀 Performance
+
+- **Enhanced BGE Matrix Generation**: ~15 minutes for 928 nonprofits
+- **User Embedding**: ~0.2 seconds per user
+- **Recommendation Generation**: ~0.3 seconds for filtered ranking
+- **Memory Usage**: ~28MB for matrix storage
+- **Accuracy**: Excellent semantic matching with 53-61% scores for relevant organizations
+
+## 🐍 Environment Setup
+
+### **Prerequisites**
+
+Before setting up the Smart Match environment, ensure you have:
+
+1. **Conda** installed on your system
+2. **Git** for cloning the repository
+3. **Rails** application running
+4. **At least 5GB free disk space** (for models and dependencies)
+
+### **Step 1: Create Conda Environment**
+
+```bash
+# Navigate to project root
+cd /path/to/giving-connection
+
+# Create conda environment
+conda create -n bge_env python=3.11
+
+# Activate the environment
+conda activate bge_env
+
+# Verify activation (should show bge_env in prompt)
+conda info --envs
+```
+
+### **Step 2: Install Required Python Packages**
+
+```bash
+# Make sure environment is activated
+conda activate bge_env
+
+# Install core ML libraries
+pip install torch torchvision torchaudio
+
+# Install sentence transformers and utilities
+pip install sentence-transformers
+
+# Install data processing libraries
+pip install numpy pandas scikit-learn
+
+# Install additional utilities
+pip install requests tqdm
+```
+
+### **Step 3: Verify Installation**
+
+```bash
+# Test Python environment
+python -c "import torch; print(f'PyTorch version: {torch.__version__}')"
+python -c "import sentence_transformers; print('Sentence Transformers installed')"
+python -c "import numpy; print(f'NumPy version: {numpy.__version__}')"
+```
+
+### **Step 4: Test BGE Model Download**
+
+```bash
+# Navigate to scripts directory
+cd app/views/smart_match/scripts
+
+# Test model loading (this will download ~1.5GB model file)
+python -c "
+from sentence_transformers import SentenceTransformer
+model = SentenceTransformer('BAAI/bge-large-en-v1.5')
+print('BGE model loaded successfully!')
+print(f'Model dimension: {model.get_sentence_embedding_dimension()}')
+"
+```
+
+**Expected output:**
+```
+BGE model loaded successfully!
+Model dimension: 1024
+```
+
+### **Environment Troubleshooting**
+
+#### **Common Issues:**
+
+1. **"conda: command not found"**
+ ```bash
+ # Install conda first
+ # Download from: https://docs.conda.io/en/latest/miniconda.html
+ ```
+
+2. **"Module not found" errors**
+ ```bash
+ # Reinstall packages
+ conda activate bge_env
+ pip install --force-reinstall sentence-transformers torch
+ ```
+
+3. **Out of memory errors**
+ ```bash
+ # Reduce batch size in scripts
+ # Edit: batch_size=32 -> batch_size=16
+ ```
+
+4. **Model download fails**
+ ```bash
+ # Manual download
+ python -c "
+ from sentence_transformers import SentenceTransformer
+ import os
+ os.environ['HF_HOME'] = '/path/to/custom/cache'
+ model = SentenceTransformer('BAAI/bge-large-en-v1.5')
+ "
+ ```
+
+### **Environment Structure**
+
+```
+bge_env/
+├── bin/ # Python executables
+├── lib/ # Python libraries
+│ └── python3.11/
+│ └── site-packages/ # Installed packages
+├── include/ # Header files
+├── share/ # Shared data
+└── conda-meta/ # Conda metadata
+```
+
+### **Model Cache Location**
+
+The BGE model (~1.5GB) is cached in:
+- **macOS**: `~/.cache/torch/sentence_transformers/`
+- **Linux**: `~/.cache/torch/sentence_transformers/`
+- **Windows**: `C:\Users\