[ADVAPP-1933]: Introduce a new setting on alerts that will be used to make alerts visible to students in the student portal (#1913)

* [ADVAPP-1933]: Add check box / Update Model / Migration / Feature

* Update code formatting and copyright headers

* [ADVAPP-1933]: Add a default false on Visable to students

* [ADVAPP-1933]: Swap for toggle

---------

Co-authored-by: Karl Murray <karl.murray@canyongbs.com>

Author: krlmrr

app-modules/alert/src/Models/Alert.php

@@ -79,10 +79,12 @@ class Alert extends BaseModel implements Auditable, CanTriggerAutoSubscription,
         'severity',
         'suggested_intervention',
         'status_id',
+        'is_visible_for_students',
     ];
 
     protected $casts = [
         'severity' => AlertSeverity::class,
+        'is_visible_for_students' => 'boolean',
     ];
 
     public function processCustomHistories(string $event, Collection $old, Collection $new, Collection $pending): void

app-modules/student-data-model/database/migrations/2025_09_24_153231_add_is_visible_for_students_to_alerts_table.php

@@ -0,0 +1,66 @@
+<?php
+
+/*
+<COPYRIGHT>
+
+    Copyright © 2016-2025, Canyon GBS LLC. All rights reserved.
+
+    Advising App™ is licensed under the Elastic License 2.0. For more details,
+    see https://github.com/canyongbs/advisingapp/blob/main/LICENSE.
+
+    Notice:
+
+    - You may not provide the software to third parties as a hosted or managed
+      service, where the service provides users with access to any substantial set of
+      the features or functionality of the software.
+    - You may not move, change, disable, or circumvent the license key functionality
+      in the software, and you may not remove or obscure any functionality in the
+      software that is protected by the license key.
+    - You may not alter, remove, or obscure any licensing, copyright, or other notices
+      of the licensor in the software. Any use of the licensor’s trademarks is subject
+      to applicable law.
+    - Canyon GBS LLC respects the intellectual property rights of others and expects the
+      same in return. Canyon GBS™ and Advising App™ are registered trademarks of
+      Canyon GBS LLC, and we are committed to enforcing and protecting our trademarks
+      vigorously.
+    - The software solution, including services, infrastructure, and code, is offered as a
+      Software as a Service (SaaS) by Canyon GBS LLC.
+    - Use of this software implies agreement to the license terms and conditions as stated
+      in the Elastic License 2.0.
+
+    For more information or inquiries please visit our website at
+    https://www.canyongbs.com or contact us via email at legal@canyongbs.com.
+
+</COPYRIGHT>
+*/
+
+use App\Features\AlertVisibleToStudentsFeature;
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Support\Facades\DB;
+use Tpetry\PostgresqlEnhanced\Schema\Blueprint;
+use Tpetry\PostgresqlEnhanced\Support\Facades\Schema;
+
+return new class () extends Migration {
+    public function up(): void
+    {
+        DB::transaction(function () {
+            Schema::table('alerts', function (Blueprint $table) {
+                $table->boolean('is_visible_for_students')
+                    ->default(false);
+            });
+
+            AlertVisibleToStudentsFeature::activate();
+        });
+    }
+
+    public function down(): void
+    {
+        DB::transaction(function () {
+            AlertVisibleToStudentsFeature::purge();
+
+            Schema::table('alerts', function (Blueprint $table) {
+                $table->dropColumn('is_visible_for_students');
+            });
+        });
+    }
+};

app-modules/student-data-model/src/Filament/Resources/EducatableResource/Pages/Concerns/CanManageEducatableAlerts.php

@@ -38,9 +38,11 @@
 
 use AdvisingApp\Alert\Enums\AlertSeverity;
 use AdvisingApp\Alert\Enums\SystemAlertStatusClassification;
+use App\Features\AlertVisibleToStudentsFeature;
 use App\Filament\Tables\Columns\IdColumn;
 use Filament\Forms\Components\Select;
 use Filament\Forms\Components\Textarea;
+use Filament\Forms\Components\Toggle;
 use Filament\Forms\Form;
 use Filament\Infolists\Components\TextEntry;
 use Filament\Infolists\Infolist;
@@ -101,6 +103,9 @@ public function form(Form $form): Form
                     ->relationship('status', 'name', fn (Builder $query) => $query->orderBy('order'))
                     ->default(fn () => SystemAlertStatusClassification::default()?->getKey())
                     ->required(),
+                Toggle::make('is_visible_for_students')
+                    ->label('Make visible to students')
+                    ->visible(AlertVisibleToStudentsFeature::active()),
             ]);
     }
 

app/Features/AlertVisibleToStudentsFeature.php

@@ -0,0 +1,47 @@
+<?php
+
+/*
+<COPYRIGHT>
+
+    Copyright © 2016-2025, Canyon GBS LLC. All rights reserved.
+
+    Advising App™ is licensed under the Elastic License 2.0. For more details,
+    see https://github.com/canyongbs/advisingapp/blob/main/LICENSE.
+
+    Notice:
+
+    - You may not provide the software to third parties as a hosted or managed
+      service, where the service provides users with access to any substantial set of
+      the features or functionality of the software.
+    - You may not move, change, disable, or circumvent the license key functionality
+      in the software, and you may not remove or obscure any functionality in the
+      software that is protected by the license key.
+    - You may not alter, remove, or obscure any licensing, copyright, or other notices
+      of the licensor in the software. Any use of the licensor’s trademarks is subject
+      to applicable law.
+    - Canyon GBS LLC respects the intellectual property rights of others and expects the
+      same in return. Canyon GBS™ and Advising App™ are registered trademarks of
+      Canyon GBS LLC, and we are committed to enforcing and protecting our trademarks
+      vigorously.
+    - The software solution, including services, infrastructure, and code, is offered as a
+      Software as a Service (SaaS) by Canyon GBS LLC.
+    - Use of this software implies agreement to the license terms and conditions as stated
+      in the Elastic License 2.0.
+
+    For more information or inquiries please visit our website at
+    https://www.canyongbs.com or contact us via email at legal@canyongbs.com.
+
+</COPYRIGHT>
+*/
+
+namespace App\Features;
+
+use App\Support\AbstractFeatureFlag;
+
+class AlertVisibleToStudentsFeature extends AbstractFeatureFlag
+{
+    public function resolve(mixed $scope): mixed
+    {
+        return false;
+    }
+}