feat: add mediator role (#571)

Co-authored-by: Lupu Gheorghe <gheorghelupu17@gmail.com>

Author: andreiio

.gitignore

@@ -37,3 +37,6 @@ GEMINI.md
 AGENTS.md
 boost.json
 /.github/copilot-instructions.md
+/.claude
+/.cursor
+/.junie

app/Concerns/BelongsToMediator.php

@@ -0,0 +1,36 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Concerns;
+
+use App\Models\User;
+use Illuminate\Database\Eloquent\Builder;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+
+trait BelongsToMediator
+{
+    public function initializeBelongsToMediator(): void
+    {
+        $this->fillable[] = 'mediator_id';
+    }
+
+    public static function bootBelongsToMediator(): void
+    {
+        static::creating(function (self $model): void {
+            if (auth()->user()?->isMediator()) {
+                $model->mediator_id = auth()->id();
+            }
+        });
+    }
+
+    public function mediator(): BelongsTo
+    {
+        return $this->belongsTo(User::class, 'mediator_id')->onlyMediators();
+    }
+
+    public function scopeForMediator(Builder $query, User $user): Builder
+    {
+        return $query->where("{$query->getModel()->getTable()}.mediator_id", $user->id);
+    }
+}

app/Concerns/BelongsToNurse.php

@@ -17,12 +17,10 @@ public function initializeBelongsToNurse(): void
 
     public static function bootBelongsToNurse(): void
     {
-        static::addGlobalScope('forCurrentUser', function (Builder $builder) {
-            if (! auth()->check()) {
-                return;
+        static::creating(function (self $model): void {
+            if (auth()->user()?->isNurse()) {
+                $model->nurse_id = auth()->id();
             }
-
-            $builder->forUser(auth()->user());
         });
     }
 
@@ -31,18 +29,8 @@ public function nurse(): BelongsTo
         return $this->belongsTo(User::class)->onlyNurses();
     }
 
-    public function scopeForUser(Builder $query, User $user): Builder
+    public function scopeForNurse(Builder $query, User $user): Builder
     {
-        if ($user->isNurse()) {
-            $table = $query->getModel()->getTable();
-
-            return $query->where("{$table}.nurse_id", $user->id);
-        }
-
-        if ($user->isCoordinator()) {
-            return $query->whereRelation('nurse', 'activity_county_id', $user->county_id);
-        }
-
-        return $query;
+        return $query->where("{$query->getModel()->getTable()}.nurse_id", $user->id);
     }
 }

app/Concerns/BelongsToNurseOrMediator.php

@@ -0,0 +1,44 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Concerns;
+
+use App\Models\User;
+use Illuminate\Database\Eloquent\Builder;
+
+trait BelongsToNurseOrMediator
+{
+    use BelongsToNurse;
+    use BelongsToMediator;
+
+    public static function bootBelongsToNurseOrMediator(): void
+    {
+        static::addGlobalScope('forCurrentUser', function (Builder $builder) {
+            if (! auth()->check()) {
+                return;
+            }
+
+            $builder->forUser(auth()->user());
+        });
+    }
+
+    public function scopeForUser(Builder $query, User $user): Builder
+    {
+        return match (true) {
+            $user->isNurse() => $query->forNurse($user),
+            $user->isMediator() => $query->forMediator($user),
+            $user->isCoordinator() => $query->forCoordinator($user),
+            $user->isAdmin() => $query,
+        };
+    }
+
+    public function scopeForCoordinator(Builder $query, User $user): Builder
+    {
+        return $query->where(
+            fn (Builder $query): Builder => $query
+                ->whereRelation('nurse', 'activity_county_id', $user->county_id)
+                ->orWhereRelation('mediator', 'activity_county_id', $user->county_id)
+        );
+    }
+}

app/Concerns/BelongsToNurseThroughBeneficiary.php

@@ -26,14 +26,37 @@ public static function bootBelongsToNurseThroughBeneficiary(): void
 
     public function scopeForUser(Builder $query, User $user): Builder
     {
-        if ($user->isNurse()) {
-            return $query->whereRelation('beneficiary', 'nurse_id', $user->id);
-        }
+        return match (true) {
+            $user->isNurse() => $query->forNurse($user),
+            $user->isMediator() => $query->forMediator($user),
+            $user->isCoordinator() => $query->forCoordinator($user),
+            $user->isAdmin() => $query,
+        };
+    }
 
-        if ($user->isCoordinator()) {
-            return $query->whereRelation('beneficiary.nurse', 'activity_county_id', $user->county_id);
-        }
+    public function scopeForNurse(Builder $query, User $user): Builder
+    {
+        return $query->whereRelation('beneficiary', 'nurse_id', $user->id);
+    }
 
-        return $query;
+    public function scopeForMediator(Builder $query, User $user): Builder
+    {
+        return $query->where(
+            fn (Builder $query): Builder => $query
+                ->whereRelation('beneficiary', 'mediator_id', $user->id)
+                ->when(
+                    $this->isFillable('mediator_has_access'),
+                    fn (Builder $query): Builder => $query->where('mediator_has_access', true)
+                )
+        );
+    }
+
+    public function scopeForCoordinator(Builder $query, User $user): Builder
+    {
+        return $query->where(
+            fn (Builder $query): Builder => $query
+                ->whereRelation('beneficiary.nurse', 'activity_county_id', $user->county_id)
+                ->orWhereRelation('beneficiary.mediator', 'activity_county_id', $user->county_id)
+        );
     }
 }

app/Concerns/BelongsToUser.php

@@ -0,0 +1,60 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Concerns;
+
+use App\Models\User;
+use Illuminate\Database\Eloquent\Builder;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+
+trait BelongsToUser
+{
+    public function initializeBelongsToUser(): void
+    {
+        $this->fillable[] = 'user_id';
+    }
+
+    public static function bootBelongsToUser(): void
+    {
+        static::addGlobalScope('forCurrentUser', function (Builder $builder) {
+            if (! auth()->check()) {
+                return;
+            }
+
+            $builder->forUser(auth()->user());
+        });
+
+        static::creating(function (self $model): void {
+            if (blank($model->user_id)) {
+                $model->user_id = auth()?->id();
+            }
+        });
+    }
+
+    public function user(): BelongsTo
+    {
+        return $this->belongsTo(User::class);
+    }
+
+    public function restrictScopeToCurrentUser(): bool
+    {
+        return false;
+    }
+
+    public function scopeForUser(Builder $query, User $user): Builder
+    {
+        if (
+            $this->restrictScopeToCurrentUser() ||
+            $user->isNurseOrMediator()
+        ) {
+            return $query->where('user_id', $user->id);
+        }
+
+        if ($user->isCoordinator()) {
+            return $query->whereRelation('user', 'activity_county_id', $user->county_id);
+        }
+
+        return $query;
+    }
+}

app/Concerns/HasActivityAreas.php

@@ -32,6 +32,11 @@ public function scopeActivatesInCounty(Builder $query, int $county_id): Builder
         return $query->where('activity_county_id', $county_id);
     }
 
+    public function scopeActivatesInCurrentUserCounty(Builder $query): Builder
+    {
+        return $query->where('activity_county_id', auth()->user()->activity_county_id ?? auth()->user()->county_id);
+    }
+
     public function scopeWithActivityAreas(Builder $query): Builder
     {
         return $query->with('activityCounty', 'activityCities');

app/Concerns/Users/HasRole.php

@@ -31,6 +31,16 @@ public function isNurse(): bool
         return $this->role->is(Role::NURSE);
     }
 
+    public function isMediator(): bool
+    {
+        return $this->role->is(Role::MEDIATOR);
+    }
+
+    public function isNurseOrMediator(): bool
+    {
+        return $this->isNurse() || $this->isMediator();
+    }
+
     public function scopeOnlyAdmins(Builder $query): Builder
     {
         return $query->where('role', Role::ADMIN);
@@ -45,4 +55,14 @@ public function scopeOnlyNurses(Builder $query): Builder
     {
         return $query->where('role', Role::NURSE);
     }
+
+    public function scopeOnlyMediators(Builder $query): Builder
+    {
+        return $query->where('role', Role::MEDIATOR);
+    }
+
+    public function scopeOnlyNursesAndMediators(Builder $query): Builder
+    {
+        return $query->whereIn('role', [Role::NURSE, Role::MEDIATOR]);
+    }
 }

app/Contracts/Enums/CanBeFiltered.php

@@ -4,10 +4,9 @@
 
 namespace App\Contracts\Enums;
 
-use App\Enums\Report\Type;
 use BackedEnum;
 
 interface CanBeFiltered extends BackedEnum
 {
-    public function isVisible(?Type $type = null): bool;
+    public function isVisible(): bool;
 }

app/Contracts/UserScopable.php

@@ -0,0 +1,13 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Contracts;
+
+use App\Models\User;
+use Illuminate\Database\Eloquent\Builder;
+
+interface UserScopable
+{
+    public function scopeForUser(Builder $query, User $user): Builder;
+}