Adds Student Research Applications Charts

app/Helpers/Semester.php

@@ -129,4 +129,82 @@ public static function date(string $name, bool $start_of_season = true)
 
         return Carbon::parse($month_and_day . ' ' . $parsed['year']->year);
     }
+
+    /**
+     * Returns a comparator function to sort semesters chronologically.
+     * 
+     * Use with usort() or Laravel collection sort methods.
+     * Sorts semesters in 'Season YYYY' format (e.g., "Spring 2023", "Fall 2024").
+     * 
+     * @return \Closure(string, string): int Comparator function returning -1, 0, or 1
+     */
+    public static function sortCollectionWithSemestersKeyChronologically() {
+        return function ($a, $b) {
+            // Extract the year and season from both semesters
+            list($seasonA, $yearA) = explode(' ', $a);
+            list($seasonB, $yearB) = explode(' ', $b);
+
+            // Define a mapping of seasons to values for sorting
+            $seasonOrder = [
+                'Spring' => 1,
+                'Summer' => 2,
+                'Fall' => 3,
+                'Winter' => 4,
+            ];
+
+            // First, compare the years
+            if ($yearA != $yearB) {
+                return $yearA <=> $yearB;
+            }
+
+            // If the years are the same, compare the seasons using the seasonOrder
+            return $seasonOrder[$seasonA] <=> $seasonOrder[$seasonB];
+        };
+    }
+
+    /**
+     * Sort chronologically an array of semesters in the 'Semester YY' format 
+     * @param array $semesters
+     * @return bool
+     */
+    public static function sortSemestersChronologically(array &$semesters): bool
+    {
+        return usort($semesters, function (string $a, string $b): int {
+            // Extract year and season
+            preg_match('/(Spring|Summer|Fall) (\d+)/', $a, $matchesA);
+            preg_match('/(Spring|Summer|Fall) (\d+)/', $b, $matchesB);
+
+            // Handle invalid formats
+            if (empty($matchesA) || empty($matchesB)) {
+                return 0; // Consider them equal if invalid
+            }
+
+            // Map seasons to an order
+            $seasonOrder = ['Spring' => 1, 'Summer' => 2, 'Fall' => 3];
+
+            // Compare by year first
+            if ($matchesA[2] !== $matchesB[2]) {
+                return (int) $matchesA[2] <=> (int) $matchesB[2];
+            }
+
+            // If years are the same, compare by season
+            return $seasonOrder[$matchesA[1]] <=> $seasonOrder[$matchesB[1]];
+        });
+    }
+
+    /**
+     * Given a list of semesters, removes the ones that are in the future
+     */
+    public static function removeFutureSemesters($semesters)
+    {
+        $current_semester = static::current();
+        $current_semester_index = array_search($current_semester, $semesters);
+
+        if ($current_semester_index !== false) {
+            return array_slice($semesters, 0, $current_semester_index + 1);
+        }
+
+        return $semesters;
+
+    }
 }

app/Http/Controllers/InsightsController.php

@@ -0,0 +1,37 @@
+<?php
+
+namespace App\Http\Controllers;
+
+use App\Helpers\Semester;
+use App\Insights\StudentApplications\StudentDataInsight;
+use App\StudentData;
+use Illuminate\Contracts\View\View as ViewContract;
+use Illuminate\View\View;
+use Illuminate\Http\Request;
+
+class InsightsController extends Controller
+{
+    /**
+     * Controller constructor. Middleware can be defined here.
+     */
+    public function __construct()
+    {
+        $this->middleware('auth');
+
+        $this->middleware('can:viewAdminIndex,App\LogEntry')->only('index');
+    }
+
+    /**
+     * Display a listing of the resource.
+     */
+    public function index(Request $request): View|ViewContract
+    {
+
+        $schools_options = StudentDataInsight::getLabels('school')->toArray();
+        $semesters_options = StudentDataInsight::getLabels('semester')->toArray();
+        $semesters_selected = Semester::removeFutureSemesters($semesters_options);
+        $title = StudentDataInsight::convertParameterstoTitle($semesters_options, $schools_options);
+
+        return view('insights.index', compact('schools_options', 'semesters_options', 'semesters_selected', 'title'));
+    }
+}

app/Http/Livewire/Insights/AcceptedAndFollowUpAppsPercentageChart.php

@@ -0,0 +1,55 @@
+<?php
+
+namespace App\Http\Livewire\Insights;
+
+use App\Helpers\Semester;
+use App\Insights\StudentApplications\StudentDataInsight;
+use Livewire\Component;
+
+class AcceptedAndFollowUpAppsPercentageChart extends Component
+{
+
+    public array $labels;
+    public array $data;
+    public array $selected_semesters;
+    public array $selected_schools;
+    public $weeks_before_semester_start;
+    public $weeks_before_semester_end;
+    public array $filing_statuses_category_1;
+    public array $filing_statuses_category_2;
+    protected $listeners = ['refreshData5', 'refreshChart5'];
+
+    public function mount() 
+    {
+        $this->weeks_before_semester_start = 4;
+        $this->weeks_before_semester_end = 4;
+        $this->filing_statuses_category_1 = ['accepted', 'follow up'];
+        $this->filing_statuses_category_2= ['not interested', 'maybe later'];
+        $this->data = $this->dataset;
+        $this->labels = ['Accepted & Follow Up', 'Other'];
+    }
+
+    public function refreshChart5($data, $labels) {}
+
+    public function refreshData5($selected_semesters, $selected_schools, $weeks_before_semester_start, $weeks_before_semester_end)
+    {
+        $this->weeks_before_semester_start = $weeks_before_semester_start;
+        $this->weeks_before_semester_end = $weeks_before_semester_end;
+        $this->selected_semesters = $selected_semesters;
+        $this->selected_schools = $selected_schools;
+
+        $this->data = $this->dataset;
+        $this->emit('refreshChart5', $this->data, $this->labels);
+    }
+
+    public function getDatasetProperty()
+    {
+        $report = new StudentDataInsight();
+        return $report->appCountForTwoCategoriesOfFilingStatus($this->selected_semesters, $this->selected_schools, $this->filing_statuses_category_1, $this->filing_statuses_category_2, $this->weeks_before_semester_start, $this->weeks_before_semester_end);
+    }
+
+    public function render()
+    {
+        return view('livewire.charts.accepted-and-follow-up-apps-percentage-chart');
+    }
+}

app/Http/Livewire/Insights/InsightsFilter.php

@@ -0,0 +1,39 @@
+<?php
+
+namespace App\Http\Livewire\Insights;
+
+use App\Helpers\Semester;
+use App\Insights\StudentApplications\StudentDataInsight;
+use Livewire\Component;
+
+class InsightsFilter extends Component
+{
+
+    public $semester_options = [];
+    public $semesters_selected = [];
+    public $school_options = [];
+    public $charts_loaded;
+    public $title;
+    public $current_semester;
+    protected $listeners = ['applyFilters'];
+
+    public function mount()
+    {
+        $this->charts_loaded = true;
+        $this->current_semester = Semester::current();
+    }
+
+    public function applyFilters($selected_semesters, $selected_schools, $weeks_before_semester_start, $weeks_before_semester_end) {
+        $this->charts_loaded = false;
+        $this->title = StudentDataInsight::convertParameterstoTitle($selected_semesters, $selected_schools);
+        $this->emitTo('accepted-and-follow-up-apps-percentage-chart', 'refreshData5', $selected_semesters, $selected_schools, $weeks_before_semester_start, $weeks_before_semester_end);
+        $this->emitTo('student-apps-viewed-not-viewed-chart', 'refreshData4', $selected_semesters, $selected_schools, $weeks_before_semester_start, $weeks_before_semester_end);
+        $this->emitTo('students-app-count-chart', 'refreshData2', $selected_semesters, $selected_schools, $weeks_before_semester_start, $weeks_before_semester_end);
+        $this->emitTo('students-app-filing-status-chart', 'refreshData1', $selected_semesters, $selected_schools, $weeks_before_semester_start, $weeks_before_semester_end);
+    }
+
+    public function render()
+    {
+        return view('livewire.charts.insights-filter');
+    }
+}

app/Http/Livewire/Insights/StudentAppsViewedNotViewedChart.php

@@ -0,0 +1,50 @@
+<?php
+
+namespace App\Http\Livewire\Insights;
+
+use App\Helpers\Semester;
+use App\Insights\StudentApplications\StudentDataInsight;
+use Livewire\Component;
+
+class StudentAppsViewedNotViewedChart extends Component
+{
+
+    public array $labels;
+    public array $data;
+    public array $selected_semesters;
+    public array $selected_schools;
+    public $selected_filing_statuses;
+    protected $listeners = ['refreshData4', 'refreshChart4'];
+
+    public function mount()
+    {
+        $data = $this->dataset;
+        $this->data = $data['datasets'];
+        $this->labels = $data['labels'];    
+    }
+
+    public function refreshChart4($data, $labels) {}
+
+    public function refreshData4($selected_semesters, $selected_schools) {
+        $this->selected_semesters = $selected_semesters;
+        $this->selected_schools = $selected_schools;
+
+        $data = $this->dataset;
+
+        $this->data = $data['datasets'];
+        $this->labels = $data['labels'];
+
+        $this->emit('refreshChart4', $this->data, $this->labels);
+    }
+
+    public function getDatasetProperty()
+    {
+        $report = new StudentDataInsight();
+        return $report->appCountViewedAndNotViewed($this->selected_semesters, $this->selected_schools);
+    }
+
+    public function render()
+    {
+        return view('livewire.charts.student-apps-viewed-not-viewed-chart');
+    }
+}

app/Http/Livewire/Insights/StudentsAppCountChart.php

@@ -0,0 +1,49 @@
+<?php
+
+namespace App\Http\Livewire\Insights;
+
+use App\Insights\StudentApplications\StudentDataInsight;
+use Livewire\Component;
+
+class StudentsAppCountChart extends Component
+{
+
+    public array $labels;
+    public array $data;
+    public $selected_semesters = [];
+    public $selected_schools = [];
+    protected $listeners = ['refreshData2', 'refreshChart2'];
+
+    public function mount()
+    {
+        $data = $this->dataset;
+        $this->data = $data['datasets'];
+        $this->labels = $data['labels'];
+    }
+
+    public function refreshChart2($data, $labels) {}
+
+    public function refreshData2($selected_semesters, $selected_schools) {
+
+        $this->selected_semesters = $selected_semesters;
+        $this->selected_schools = $selected_schools;
+
+        $data = $this->dataset;
+
+        $this->data = $data['datasets'];
+        $this->labels = $data['labels'];
+
+        $this->emit('refreshChart2', $this->data, $this->labels);
+    }
+
+    public function getDatasetProperty()
+    {
+        $report = new StudentDataInsight();
+        return $report->appCountBySemestersAndSchools($this->selected_semesters, $this->selected_schools);
+    }
+
+    public function render()
+    {
+        return view('livewire.charts.students-app-count-chart');
+    }
+}

app/Http/Livewire/Insights/StudentsAppFilingStatusChart.php

@@ -0,0 +1,58 @@
+<?php
+
+namespace App\Http\Livewire\Insights;
+
+use App\Insights\StudentApplications\StudentDataInsight;
+use Livewire\Component;
+
+class StudentsAppFilingStatusChart extends Component
+{
+
+    public array $labels;
+    public array $data;
+    public $selected_semesters = [];
+    public $selected_schools = [];
+    public $weeks_before_semester_start;
+    public $weeks_before_semester_end;
+    public $selected_filing_statuses;
+    protected $listeners = ['refreshData1', 'refreshChart1'];
+
+    public function mount()
+    {
+        $this->weeks_before_semester_start = 4;
+        $this->weeks_before_semester_end = 4;
+        $this->selected_filing_statuses = ["accepted", "maybe later", "not interested", "new", "follow up"];
+
+        $data = $this->dataset;
+        $this->data = $data['datasets'];
+        $this->labels = $data['labels'];
+    }
+
+    public function refreshChart1($data, $labels) {}
+
+    public function refreshData1($selected_semesters, $selected_schools, $weeks_before_semester_start, $weeks_before_semester_end) {
+
+        $this->weeks_before_semester_start = $weeks_before_semester_start;
+        $this->weeks_before_semester_end = $weeks_before_semester_end;
+        $this->selected_semesters = $selected_semesters;
+        $this->selected_schools = $selected_schools;
+
+        $data = $this->dataset;
+
+        $this->data = $data['datasets'];
+        $this->labels = $data['labels'];
+
+        $this->emit('refreshChart1', $this->data, $this->labels);
+    }
+
+    public function getDatasetProperty()
+    {
+        $report = new StudentDataInsight();
+        return $report->appCountBySemestersAndSchoolsWithFilingStatus($this->selected_semesters, $this->selected_schools, $this->selected_filing_statuses, $this->weeks_before_semester_start, $this->weeks_before_semester_end);
+    }
+
+    public function render()
+    {
+        return view('livewire.charts.students-app-filing-status-chart');
+    }
+}