*/ protected $fillable = [ 'user_id', 'name', 'email', 'phone', 'password', 'must_change_password', 'options', 'profile_photo_path', 'role', 'is_active', 'is_super_admin', 'parent_id', 'approval_status', 'approved_by', 'approved_at', 'rejection_reason', ]; /** * The attributes that should be hidden for serialization. * * @var list */ protected $hidden = [ 'password', 'remember_token', 'two_factor_secret', 'two_factor_recovery_codes', 'two_factor_confirmed_at', 'deleted_at', ]; /** * Get the attributes that should be cast. * * @return array */ protected function casts(): array { return [ 'email_verified_at' => 'datetime', 'last_login_at' => 'datetime', 'password' => 'hashed', 'options' => 'array', 'is_active' => 'boolean', 'is_super_admin' => 'boolean', 'must_change_password' => 'boolean', 'approved_at' => 'datetime', ]; } /** * 상위 관리자 (영업파트너 계층 구조) */ public function parent(): \Illuminate\Database\Eloquent\Relations\BelongsTo { return $this->belongsTo(User::class, 'parent_id'); } /** * 하위 관리자 목록 */ public function children(): HasMany { return $this->hasMany(User::class, 'parent_id'); } /** * 승인자 */ public function approver(): \Illuminate\Database\Eloquent\Relations\BelongsTo { return $this->belongsTo(User::class, 'approved_by'); } /** * 영업파트너 정보 */ public function salesPartner(): HasOne { return $this->hasOne(\App\Models\Sales\SalesPartner::class, 'user_id'); } /** * 단체(corporate) 파트너 여부 확인 */ public function isGroupPartner(): bool { return $this->salesPartner && $this->salesPartner->isGroup(); } /** * 영업파트너 첨부 서류 */ public function salesDocuments(): HasMany { return $this->hasMany(\App\Models\Sales\SalesManagerDocument::class, 'user_id'); } /** * 승인 대기 상태인지 확인 */ public function isPendingApproval(): bool { return $this->approval_status === 'pending'; } /** * 승인됨 상태인지 확인 */ public function isApproved(): bool { return $this->approval_status === 'approved'; } /** * 반려됨 상태인지 확인 */ public function isRejected(): bool { return $this->approval_status === 'rejected'; } /** * 승인 상태 라벨 */ public function getApprovalStatusLabelAttribute(): string { return match ($this->approval_status) { 'pending' => '승인대기', 'approved' => '승인완료', 'rejected' => '반려', default => $this->approval_status, }; } /** * 승인 상태별 색상 클래스 */ public function getApprovalStatusColorAttribute(): string { return match ($this->approval_status) { 'pending' => 'bg-yellow-100 text-yellow-800', 'approved' => 'bg-green-100 text-green-800', 'rejected' => 'bg-red-100 text-red-800', default => 'bg-gray-100 text-gray-800', }; } /** * 관계: 테넌트들 (Many-to-Many via user_tenants) */ public function tenants(): BelongsToMany { return $this->belongsToMany(\App\Models\Tenants\Tenant::class, 'user_tenants') ->withTimestamps() ->withPivot(['is_active', 'is_default', 'joined_at', 'left_at']); } /** * 현재 선택된 테넌트 (세션 기반) */ public function currentTenant() { $tenantId = session('selected_tenant_id'); if (! $tenantId) { return $this->tenants()->where('is_default', true)->first() ?? $this->tenants()->first(); } return $this->tenants()->find($tenantId); } /** * 관계: 사용자-역할 (user_roles 테이블, 테넌트별) */ public function userRoles(): HasMany { return $this->hasMany(UserRole::class); } /** * 관계: 사용자-부서 (department_user 테이블, 테넌트별) */ public function departmentUsers(): HasMany { return $this->hasMany(DepartmentUser::class); } /** * 특정 테넌트의 역할 목록 조회 */ public function getRolesForTenant(int $tenantId) { return $this->userRoles() ->where('tenant_id', $tenantId) ->with('role') ->get() ->pluck('role'); } /** * 특정 테넌트의 부서 목록 조회 */ public function getDepartmentsForTenant(int $tenantId) { return $this->departmentUsers() ->where('tenant_id', $tenantId) ->with('department') ->get() ->pluck('department'); } /** * 관계: 삭제한 사용자 */ public function deletedByUser(): \Illuminate\Database\Eloquent\Relations\BelongsTo { return $this->belongsTo(User::class, 'deleted_by'); } /** * 사용자가 본사(HQ) 테넌트에 소속되어 있는지 확인 */ public function belongsToHQ(): bool { return $this->tenants() ->where('tenant_type', 'HQ') ->exists(); } /** * 본사(HQ) 테넌트 조회 */ public function getHQTenant(): ?\App\Models\Tenants\Tenant { return $this->tenants() ->where('tenant_type', 'HQ') ->first(); } /** * 슈퍼관리자 여부 확인 */ public function isSuperAdmin(): bool { return (bool) $this->is_super_admin; } /** * MNG 관리자 패널 접근 가능 여부 * - 본사(HQ) 테넌트 소속이어야 함 */ public function canAccessMng(): bool { return $this->belongsToHQ() && $this->is_active; } /** * 특정 역할 보유 여부 확인 * * @param string|array $roles 역할명 또는 역할명 배열 */ public function hasRole(string|array $roles): bool { // 슈퍼관리자는 모든 역할 보유 if ($this->is_super_admin) { return true; } $roles = is_array($roles) ? $roles : [$roles]; // 현재 테넌트 기준 역할 확인 $currentTenant = $this->currentTenant(); if (! $currentTenant) { return false; } $userRoles = $this->getRolesForTenant($currentTenant->id); foreach ($roles as $roleName) { if ($userRoles->contains('name', $roleName)) { return true; } } return false; } /** * 관리자 역할 보유 여부 (admin 또는 super-admin) */ public function isAdmin(): bool { return $this->is_super_admin || $this->hasRole(['admin', 'super-admin']); } }