Live Env Deployment

.env.example

@@ -3,7 +3,7 @@ APP_ENV=local
 APP_KEY=
 APP_DEBUG=true
 APP_TIMEZONE=UTC
-APP_URL=http://localhost
+APP_URL=http://aef.test
 
 APP_LOCALE=en
 APP_FALLBACK_LOCALE=en

app/Console/Commands/FillStudyCaseStatus.php

@@ -0,0 +1,53 @@
+<?php
+
+namespace App\Console\Commands;
+
+use App\Models\StudyCase;
+use App\Enums\StudyCaseStatus;
+use Illuminate\Console\Command;
+
+class FillStudyCaseStatus extends Command
+{
+    /**
+     * The name and signature of the console command.
+     *
+     * @var string
+     */
+    protected $signature = 'app:fill-study-case-status';
+
+    /**
+     * The console command description.
+     *
+     * @var string
+     */
+    protected $description = 'A one-time command program to fill study case status';
+
+    /**
+     * Execute the console command.
+     */
+    public function handle()
+    {
+        $this->info('start');
+
+        $studyCases = StudyCase::all();
+
+        foreach ($studyCases as $studyCase) {
+            if ($studyCase->reviewed) {
+                $studyCase->status = StudyCaseStatus::Reviewed;
+            } else if ($studyCase->ready_for_review) {
+                $studyCase->status = StudyCaseStatus::ReadyForReview;
+            } else {
+                // Question: for existing study cases not yet ready for review, should we consider them as Proposal or Development?
+                // Proposal means the study case creator does not ask for reviewer's approval
+                // Development means the creator has asked reviewer for approval, and the reviewer has approved this study case
+
+                $studyCase->status = StudyCaseStatus::Proposal;
+                // $studyCase->status = StudyCaseStatus::Development;
+            }
+
+            $studyCase->save();
+        }
+
+        $this->info('end');
+    }
+}

app/Enums/StudyCaseStatus.php

@@ -0,0 +1,64 @@
+<?php
+
+namespace App\Enums;
+
+use Filament\Support\Contracts\HasLabel;
+use Filament\Support\Contracts\HasDescription;
+use Filament\Support\Contracts\HasColor;
+
+enum StudyCaseStatus: string implements HasLabel, HasDescription, HasColor
+{
+    // define string values
+    case Proposal = 'proposal';
+    case Closed = 'closed';
+    case Development = 'development';
+    case ReadyForReview = 'ready_for_review';
+    case Reviewed = 'reviewed';
+
+    // define labels
+    public function getLabel(): ?string
+    {
+        return match ($this) {
+            self::Proposal => 'Proposal',
+            self::Closed => 'Closed',
+            self::Development => 'Development',
+            self::ReadyForReview => 'Ready for review',
+            self::Reviewed => 'Reviewed',
+        };
+    }
+
+    // define descritpions
+    public function getDescription(): ?string
+    {
+        // Proposal       : user created a new study case (assumes user will inform reviewer offline when the study case is ready for review)
+        // Closed         : reviewer reviewed and decided NOT to further develop
+        // Development    : reviewer reviewed and decided to further develop
+        // ReadyForReview : user has filled in all necessary details; user request reviewer to review
+        // Reviewed       : reviewer approved study case; study case is published on the website
+
+        return match ($this) {
+            self::Proposal => 'This has not finished being written yet.',
+            self::Closed => 'This has been reviewed by reviewer, and decided NOT to further develop',
+            self::Development => 'This has been reviewed by reviewer, and decided to further develop',
+            self::ReadyForReview => 'This is ready for a reviewer to review',
+            self::Reviewed => 'This has been approved by a reviewer. This has been published on the website',
+        };
+    }
+
+    // define badge colors
+    public function getColor(): string | array | null
+    {
+        // warning (yellow) : pending on reviewer to review
+        // danger (red)     : unsuccessful study case that decided not to further develop
+        // gray (gray)      : no action required from reviewer
+        // success (green)  : reviewer has reviewed and published
+
+        return match ($this) {
+            self::Proposal => 'warning',
+            self::Closed => 'danger',
+            self::Development => 'gray',
+            self::ReadyForReview => 'warning',
+            self::Reviewed => 'success',            
+        };
+    }
+}

app/Filament/Admin/Resources/ClaimResource.php

@@ -47,6 +47,7 @@ public static function getPages(): array
             'index' => Pages\ListClaims::route('/'),
             'create' => Pages\CreateClaim::route('/create'),
             'edit' => Pages\EditClaim::route('/{record}/edit'),
+            'view' => Pages\ViewClaim::route('/{record}'),
         ];
     }
 }

app/Filament/Admin/Resources/ClaimResource/Pages/EditClaim.php

@@ -25,10 +25,10 @@ public function getBreadcrumbs(): array
         $casesUrl = route('filament.admin.resources.study-cases.index');
         $breadcrumbs[$casesUrl] = 'Cases';
 
-        $studyCaseEditUrl = route('filament.admin.resources.study-cases.edit', ['record' => $studyCase->id]);
+        $studyCaseEditUrl = route('filament.admin.resources.study-cases.manage-case-study-claims', ['record' => $studyCase->id]);
         $breadcrumbs[$studyCaseEditUrl] = $studyCase->title;
 
-        $claimsUrl = $studyCaseEditUrl . '?tab=-tab-1-tab&activeRelationManager=0';
+        $claimsUrl = $studyCaseEditUrl;
         $breadcrumbs[$claimsUrl] = 'Claims';
 
         $breadcrumbs[] = 'Edit';
@@ -51,7 +51,7 @@ protected function getRedirectUrl(): string
 
         $ownerRecordId = $params['ownerRecord'];
 
-        $redirectUrl = $appUrl . '/admin/study-cases/' . $ownerRecordId . '/edit?tab=-tab-1-tab&activeRelationManager=0';
+        $redirectUrl = $appUrl . '/admin/study-cases/' . $ownerRecordId . '/manage-case-study-claims';
 
         return $redirectUrl;
     }

app/Filament/Admin/Resources/ClaimResource/Pages/ViewClaim.php

@@ -0,0 +1,11 @@
+<?php
+
+namespace App\Filament\Admin\Resources\ClaimResource\Pages;
+
+use App\Filament\Admin\Resources\ClaimResource;
+use Filament\Resources\Pages\ViewRecord;
+
+class ViewClaim extends ViewRecord
+{
+    protected static string $resource = ClaimResource::class;
+}

app/Filament/Admin/Resources/StudyCaseResource.php

@@ -7,24 +7,61 @@
 use Filament\Forms\Form;
 use App\Models\StudyCase;
 use Filament\Tables\Table;
+use App\Enums\StudyCaseStatus;
 use Filament\Resources\Resource;
+use Filament\Resources\Pages\Page;
 use Filament\Forms\Components\Tabs;
+use Filament\Tables\Filters\Filter;
 use Filament\Forms\Components\TextInput;
+use Filament\Resources\Pages\ViewRecord;
+use Filament\Pages\SubNavigationPosition;
 use Filament\Tables\Filters\SelectFilter;
 use Illuminate\Database\Eloquent\Builder;
 use Filament\Tables\Filters\TernaryFilter;
 use Illuminate\Database\Eloquent\SoftDeletingScope;
+use App\Filament\App\Resources\StudyCaseResource\Pages;
+use App\Filament\Admin\Resources\StudyCaseResource\RelationManagers;
 use App\Filament\App\Resources\StudyCaseResource as AppPanelStudyCaseResource;
+use App\Filament\Admin\Resources\StudyCaseResource\Pages\ListStudyCases as AdminPanelListStudyCases;
 use App\Filament\App\Resources\StudyCaseResource\RelationManagers\ClaimsRelationManager as AppPanelClaimsRelationManager;
-use App\Filament\Admin\Resources\StudyCaseResource\Pages;
-use App\Filament\Admin\Resources\StudyCaseResource\RelationManagers;
 
 class StudyCaseResource extends Resource
 {
     protected static ?string $model = StudyCase::class;
     protected static ?string $navigationIcon = 'heroicon-o-rectangle-stack';
     protected static ?int $navigationSort = 1;
 
+    protected static SubNavigationPosition $subNavigationPosition = SubNavigationPosition::Top;
+
+    public static function getRecordSubNavigation(Page $page): array
+    {
+        // hardcode to check page's route name to determine if it is the "view page" for Claims nad Evidence
+        if ($page instanceof ViewRecord || 
+            $page->getRoutename() == 'filament.app.resources.study-cases.view-case-study-claims' ||
+            $page->getRoutename() == 'filament.admin.resources.study-cases.view-case-study-claims') {
+
+            $navigation = [
+                Pages\ViewBasicInformation::class,
+                Pages\ViewCaseDetails::class,
+                Pages\ViewCaseStudyClaims::class,
+                Pages\ViewCommunicationProducts::class,
+                Pages\ViewPhotos::class,
+                Pages\ViewConfirmation::class,
+            ];
+        } else {
+            $navigation = [
+                Pages\EditBasicInformation::class,
+                Pages\EditCaseDetails::class,
+                Pages\ManageCaseStudyClaims::class,
+                Pages\EditCommunicationProducts::class,
+                Pages\EditPhotos::class,
+                Pages\EditConfirmation::class,
+            ];
+        }
+
+        return $page->generateNavigationItems($navigation);
+    }
+
     // define translatable string in function
     public static function getModelLabel(): string
     {
@@ -63,27 +100,47 @@ public static function table(Table $table): Table
                     ->sortable()
                     ->searchable()
                     ->wrapHeader(),
-                Tables\Columns\IconColumn::make('ready_for_review')
-                    ->label(t('Ready for review'))
-                    ->boolean()
-                    ->sortable()
-                    ->wrapHeader(),
-                Tables\Columns\IconColumn::make('reviewed')
-                    ->label(t('Reviewed'))
-                    ->boolean()
+                Tables\Columns\TextColumn::make('status')
+                    ->label(t('Status'))
+                    ->badge()
                     ->sortable(),
+
             ])
             ->filters([
-                TernaryFilter::make('ready_for_review')->label(t('Ready for review')),
-                TernaryFilter::make('reviewed')->label(t('Reviewed')),
+                // apply this filter by default to exclude study case with status "closed"
+                //
+                // To show study cases with "closed" status, user needs to:
+                // 1. untick the checkbox of this filter
+                // 2. select "Closed" in "status" filter
+                Filter::make('hide_closed_cases')
+                    ->label('Hide closed cases')
+                    ->default()
+                    ->query(fn (Builder $query): Builder => $query->where('status', '!=', 'closed')),
+
+                // this filter works properly to show study cases for a selected status
+                SelectFilter::make('status')
+                    ->options(StudyCaseStatus::class),
             ])
             ->actions([
-                Tables\Actions\EditAction::make(),
+                // view action only available when case can no longer be edited
+                Tables\Actions\ViewAction::make()
+                    ->url(fn($record) => static::getUrl('view-basic-information', ['record' => $record]))
+                    ->hidden(function ($record) {
+                        return $record->status != StudyCaseStatus::Reviewed;
+                    }),
+
+                // study case can be edited only if reviewer has not reviewed it yet
+                Tables\Actions\EditAction::make()
+                    ->url(fn($record) => static::getUrl('edit-basic-information', ['record' => $record]))
+                    ->hidden(function ($record) {
+                        return $record->status == StudyCaseStatus::Reviewed;
+                    }),
+
                 Tables\Actions\Action::make('preview_catalogue')
-                                ->label(t('Preview'))
-                                ->icon('heroicon-o-book-open')
-                                ->url(fn (StudyCase $record): string => '/cases/' . $record->id)
-                                ->openUrlInNewTab()
+                    ->label(t('Preview'))
+                    ->icon('heroicon-o-book-open')
+                    ->url(fn(StudyCase $record): string => '/cases/' . $record->id)
+                    ->openUrlInNewTab()
             ])
             ->defaultSort('order')
             ->reorderable('order')
@@ -97,23 +154,30 @@ public static function table(Table $table): Table
     // re-use app panel Study case relation manager for claims
     public static function getRelations(): array
     {
-        return [
-            AppPanelClaimsRelationManager::class,
-        ];
+        return [];
     }
 
     public static function getPages(): array
     {
         return [
-            'index' => Pages\ListStudyCases::route('/'),
+            // use admin panel ListStudyCases, so that it will use table() function of this class
+            'index' => AdminPanelListStudyCases::route('/'),
 
-            // disable route for creating a new study case
-            // reviewer should not be able to create new study case.
-            // study case should be created by leading organisation member.
+            'edit-basic-information' => Pages\EditBasicInformation::route('/{record}/edit-basic-information'),
+            'edit-case-details' => Pages\EditCaseDetails::route('/{record}/edit-case-details'),
+            'manage-case-study-claims' => Pages\ManageCaseStudyClaims::route('/{record}/manage-case-study-claims'),
+            'edit-communication-products' => Pages\EditCommunicationProducts::route('/{record}/edit-communication-products'),
+            'edit-photos' => Pages\EditPhotos::route('/{record}/edit-photos'),
+            'edit-confirmation' => Pages\EditConfirmation::route('/{record}/edit-confirmation'),
 
-            // 'create' => Pages\CreateStudyCase::route('/create'),
-
-            'edit' => Pages\EditStudyCase::route('/{record}/edit'),
+            'view' => Pages\ViewBasicInformation::route('/{record}'),
+            'view-basic-information' => Pages\ViewBasicInformation::route('/{record}/view-basic-information'),
+            'view-case-details' => Pages\ViewCaseDetails::route('/{record}/view-case-details'),
+            'view-case-study-claims' => Pages\ViewCaseStudyClaims::route('/{record}/view-case-study-claims'),
+            'view-communication-products' => Pages\ViewCommunicationProducts::route('/{record}/view-communication-products'),
+            'view-photos' => Pages\ViewPhotos::route('/{record}/view-photos'),
+            'view-confirmation' => Pages\ViewConfirmation::route('/{record}/view-confirmation'),          
         ];
     }
+
 }

app/Filament/App/Pages/Register.php

@@ -17,6 +17,7 @@
 use Filament\Http\Responses\Auth\Contracts\RegistrationResponse;
 use DanHarrin\LivewireRateLimiting\Exceptions\TooManyRequestsException;
 
+// this class contains business logic for creating a new user account via email invitation
 class Register extends BaseRegister
 {
     #[Url]