ladill-care/app/Http/Controllers/Care/Concerns/ScopesToAccount.php

<?php

namespace App\Http\Controllers\Care\Concerns;

use App\Models\Member;
use App\Models\Organization;
use App\Services\Care\CarePermissions;
use App\Services\Care\OrganizationResolver;
use Illuminate\Database\Eloquent\Builder;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Http\Request;

trait ScopesToAccount
{
    /**
     * Tenant data owner — always the organization owner_ref.
     * Staff members must read/write the employer's records, not their own public_id.
     */
    protected function ownerRef(Request $request): string
    {
        return (string) $this->organization($request)->owner_ref;
    }

    /** Acting user (audit / created_by), distinct from the tenant owner. */
    protected function actorRef(Request $request): string
    {
        return (string) $request->user()->public_id;
    }

    protected function organization(Request $request): Organization
    {
        $organization = $request->attributes->get('care.organization')
            ?? app(OrganizationResolver::class)->resolveForUser($request->user());

        abort_unless($organization, 404);

        return $organization;
    }

    protected function member(Request $request): ?Member
    {
        return $request->attributes->get('care.member')
            ?? app(OrganizationResolver::class)->memberFor($request->user(), $this->organization($request));
    }

    protected function authorizeAbility(Request $request, string $ability): void
    {
        abort_unless(
            app(CarePermissions::class)->can($this->member($request), $ability),
            403,
        );
    }

    protected function authorizeOwner(Request $request, Model $model): void
    {
        abort_unless($model->getAttribute('owner_ref') === $this->ownerRef($request), 404);
    }

    protected function scopeToBranch(Request $request, Builder $query, string $column = 'branch_id'): Builder
    {
        $branchId = app(OrganizationResolver::class)->branchScope($this->member($request));

        if ($branchId !== null) {
            $query->where($column, $branchId);
        }

        return $query;
    }
}