Files
sam-api/app/Models/Permissions/Role.php
김보곤 1dd9057540 refactor: [authz] 역할/권한 API 품질 개선
- Validator::make를 FormRequest로 분리 (6개 생성)
- 하드코딩 한글 문자열을 i18n 키로 교체
- RoleMenuPermission 데드코드 제거
- Role 모델 SpatieRole 상속으로 일원화
- 권한 변경 후 캐시 무효화 추가 (AccessService::bumpVersion)
- 미문서화 8개 Swagger 엔드포인트 추가
- 역할/권한 라우트에 perm.map+permission 미들웨어 추가
2026-02-21 17:19:17 +09:00

82 lines
1.6 KiB
PHP

<?php
namespace App\Models\Permissions;
use App\Models\Commons\IdeHelperRole;
use App\Models\Members\User;
use App\Models\Members\UserRole;
use App\Models\Tenants\Tenant;
use App\Traits\Auditable;
use App\Traits\BelongsToTenant;
use Illuminate\Database\Eloquent\SoftDeletes;
use Spatie\Permission\Models\Role as SpatieRole;
/**
* @mixin IdeHelperRole
*/
class Role extends SpatieRole
{
use Auditable, BelongsToTenant, SoftDeletes;
protected $fillable = [
'tenant_id',
'name',
'guard_name',
'description',
'is_hidden',
'created_by',
'updated_by',
'deleted_by',
];
protected $casts = [
'is_hidden' => 'boolean',
'tenant_id' => 'integer',
];
/**
* 관계: 테넌트
*/
public function tenant()
{
return $this->belongsTo(Tenant::class);
}
/**
* 관계: 사용자 역할
*/
public function userRoles()
{
return $this->hasMany(UserRole::class);
}
/**
* 관계: 사용자 (user_roles 테이블 통해)
*/
public function users()
{
return $this->belongsToMany(
User::class,
'user_roles',
'role_id',
'user_id'
);
}
/**
* 스코프: 공개된 역할만
*/
public function scopeVisible($query)
{
return $query->where('is_hidden', false);
}
/**
* 스코프: 숨겨진 역할만
*/
public function scopeHidden($query)
{
return $query->where('is_hidden', true);
}
}