From 623dbe5e4490b93c4a51decd7151ad4c37e08203 Mon Sep 17 00:00:00 2001
From: nelson <memoryman51@hotmail.com>
Date: Fri, 7 Feb 2025 12:51:00 -0800
Subject: [PATCH] chore: add documentation to rake commands

---
 lib/tasks/data.rake | 41 +++++++++++++++++++++++++++--------------
 1 file changed, 27 insertions(+), 14 deletions(-)

diff --git a/lib/tasks/data.rake b/lib/tasks/data.rake
index d2f45024..49091359 100644
--- a/lib/tasks/data.rake
+++ b/lib/tasks/data.rake
@@ -1,6 +1,15 @@
 require "csv"
 
 namespace(:data) do
+  # locally
+  # bundle exec rake data:load_survey_responses
+
+  # on heroku staging environment
+  # heroku run:detached -a mciea-beta bundle exec rake data:load_survey_responses
+
+  # on heroku production environment
+  # heroku run:detached -a mciea-dashboard bundle exec rake data:load_survey_responses
+
   desc("load survey responses")
   task(load_survey_responses: :environment) do
     survey_item_response_count = SurveyItemResponse.count
@@ -17,6 +26,17 @@ namespace(:data) do
     Rails.cache.clear
   end
 
+  # Usage:
+  # SFTP_PATH=/data/survey_responses/clean/2022_23 bundle exec rake data:load_survey_responses_from_path
+  # You can also swap the order of the commands and environment variables
+  # bundle exec rake data:load_survey_responses_from_path  SFTP_PATH=/ecp/data/survey_responses/clean/2024_25
+
+  # on heroku staging environment
+  # heroku run:detached -a mciea-beta SFTP_PATH=/ecp/data/survey_responses/clean/2024_25 bundle exec rake data:load_survey_responses_from_path
+
+  # on heroku production environment
+  # heroku run:detached -a mciea-dashboard SFTP_PATH=/ecp/data/survey_responses/clean/2024_25 bundle exec rake data:load_survey_responses_from_path
+
   desc("load survey responses from a specific directory")
   task(load_survey_responses_from_path: :environment) do
     survey_item_response_count = SurveyItemResponse.count
@@ -33,21 +53,14 @@ namespace(:data) do
     Rails.cache.clear
   end
 
-  desc("reset response rate values")
-  task(reset_response_rates: :environment) do
-    puts("Resetting response rates")
-    ResponseRateLoader.reset
-    Rails.cache.clear
-    puts("=====================> Completed loading #{ResponseRate.count} survey responses")
-  end
+  # locally
+  # $ bundle exec rake data:load_admin_data
 
-  desc("reset race score calculations")
-  task(reset_race_scores: :environment) do
-    puts("Resetting race scores")
-    RaceScoreLoader.reset(fast_processing: false)
-    Rails.cache.clear
-    puts("=====================> Completed loading #{RaceScore.count} survey responses")
-  end
+  # on heroku staging environment
+  # $ heroku run:detached -a mciea-beta bundle exec rake data:load_admin_data
+
+  # on heroku production environment
+  # $ heroku run:detached -a mciea-dashboard bundle exec rake data:load_admin_data
 
   desc("load admin_data")
   task(load_admin_data: :environment) do