*/ protected $fillable = [ 'username', 'password', 'email', 'sex', 'sign', 'user_level', 'inviter_id', 'room_id', 'first_ip', 'previous_ip', 'last_ip', 'usersf', 'vip_level_id', 'hy_time', 'question', 'answer', 'has_received_new_gift', 'in_time', // 进房时间(用于勤务日志 login_at 基准) 'out_time', // 离房时间 ]; /** * The attributes that should be hidden for serialization. * * @var array */ protected $hidden = [ 'password', 'remember_token', 'temppass', 'ppass', 'userpassword', ]; /** * Get the attributes that should be cast. * * @return array */ protected function casts(): array { return [ 'email_verified_at' => 'datetime', 'password' => 'hashed', 'log_time' => 'datetime', 'in_time' => 'datetime', 'out_time' => 'datetime', 'hy_time' => 'datetime', 'xr_time' => 'datetime', 'yx_time' => 'datetime', 'sj' => 'datetime', 'q3_time' => 'datetime', 'has_received_new_gift' => 'boolean', ]; } /** * 头像文件名访问器 * * 原 ASP 系统的头像文件名存储在 usersf 字段中(如 "75.gif"), * 同时也支持用户自定义上传的头像,保存在 Laravel Storage 的 public 磁盘下。 * 此 accessor 将 headface 属性映射到 usersf 字段,如果包含 storage/ 则当作独立路径,自动转换旧版后缀小写。 */ protected function headface(): Attribute { return Attribute::make( get: function () { $val = $this->usersf ?: '1.gif'; if (str_starts_with($val, 'storage/')) { return $val; } // 仅对非 storage 下的旧头像做小写处理,兼容旧库数据 return strtolower($val); }, set: function ($value) { if (str_starts_with($value, 'storage/')) { return tap($value, fn () => $this->attributes['usersf'] = $value); } return tap(strtolower($value), fn () => $this->attributes['usersf'] = strtolower($value)); } ); } /** * 获取带前缀的完整头像 URL * 避免前端多处硬编码 '/images/headface/' */ protected function headfaceUrl(): Attribute { return Attribute::make( get: function () { $hf = $this->headface; if (str_starts_with((string) $hf, 'storage/')) { return '/'.$hf; } return '/images/headface/'.$hf; } ); } /** * 如果当前头像是自定义上传的图片,则从本地存储中删除此文件 */ public function deleteCustomAvatar(): void { $hf = (string) $this->usersf; if (str_starts_with($hf, 'storage/')) { $path = substr($hf, 8); // 去除 'storage/' 前缀 \Illuminate\Support\Facades\Storage::disk('public')->delete($path); } } /** * 关联:用户所属的 VIP 会员等级 */ public function vipLevel(): BelongsTo { return $this->belongsTo(VipLevel::class, 'vip_level_id'); } /** * 判断用户是否为有效 VIP(有等级且未过期) */ public function isVip(): bool { if (! $this->vip_level_id) { return false; } // hy_time 为 null 表示永久会员 if (! $this->hy_time) { return true; } return $this->hy_time->isFuture(); } /** * 获取 VIP 会员名称(无效则返回空字符串) */ public function vipName(): string { if (! $this->isVip()) { return ''; } return $this->vipLevel?->name ?? ''; } /** * 获取 VIP 会员图标(无效则返回空字符串) */ public function vipIcon(): string { if (! $this->isVip()) { return ''; } return $this->vipLevel?->icon ?? ''; } // ── 职务相关关联 ────────────────────────────────────────────────────── /** * 全部猎务履历(包括历史记录) */ public function positions(): HasMany { return $this->hasMany(UserPosition::class)->with(['position.department'])->orderByDesc('appointed_at'); } /** * 当前在职职务记录(HasOne,最多一条) */ public function activePosition(): HasOne { return $this->hasOne(UserPosition::class)->where('is_active', true)->with(['position.department']); } /** * 该用户在职期间的权限操作日志 */ public function authorityLogs(): HasMany { return $this->hasMany(PositionAuthorityLog::class)->orderByDesc('created_at'); } /** * 判断用户是否有当前在职职务 */ public function hasActivePosition(): bool { return $this->activePosition()->exists(); } /** * 关联:邀请当前用户的人 */ public function inviter(): BelongsTo { return $this->belongsTo(self::class, 'inviter_id'); } /** * 关联:当前用户邀请的所有人 */ public function invitees(): HasMany { return $this->hasMany(self::class, 'inviter_id'); } }