*/ protected $fillable = [ // 旧字段（兼容保留） 'hyname', 'hyname1', 'hytime', 'hygb', 'hyjb', 'i', // 新字段 'user_id', 'partner_id', 'ring_item_id', 'ring_purchase_id', 'status', 'proposed_at', 'expires_at', 'married_at', 'divorced_at', 'divorce_type', 'divorcer_id', 'divorce_requested_at', 'intimacy', 'level', 'online_minutes', 'flower_count', 'chat_count', 'admin_note', ]; /** * 字段类型转换。 * * @return array */ protected function casts(): array { return [ 'hytime' => 'datetime', 'proposed_at' => 'datetime', 'expires_at' => 'datetime', 'married_at' => 'datetime', 'divorced_at' => 'datetime', 'divorce_requested_at' => 'datetime', 'intimacy' => 'integer', 'level' => 'integer', 'online_minutes' => 'integer', 'flower_count' => 'integer', 'chat_count' => 'integer', ]; } // ──────────────────────────── 关联关系 ──────────────────────────── /** * 发起方用户。 */ public function user(): BelongsTo { return $this->belongsTo(User::class, 'user_id'); } /** * 被求婚方用户。 */ public function partner(): BelongsTo { return $this->belongsTo(User::class, 'partner_id'); } /** * 使用的戒指道具。 */ public function ringItem(): BelongsTo { return $this->belongsTo(ShopItem::class, 'ring_item_id'); } /** * 亲密度变更日志。 */ public function intimacyLogs(): HasMany { return $this->hasMany(MarriageIntimacyLog::class); } /** * 婚礼仪式记录。 */ public function ceremonies(): HasMany { return $this->hasMany(WeddingCeremony::class); } /** * 最新一场婚礼。 */ public function latestCeremony(): HasOne { return $this->hasOne(WeddingCeremony::class)->latestOfMany(); } // ──────────────────────────── 查询 Scope ────────────────────────── /** * 仅返回已婚记录。 */ public function scopeMarried(Builder $query): Builder { return $query->where('status', 'married'); } /** * 仅返回求婚中记录。 */ public function scopePending(Builder $query): Builder { return $query->where('status', 'pending'); } // ──────────────────────────── 业务方法 ──────────────────────────── /** * 判断指定用户是否为婚姻一方。 * * @param int $userId 用户 ID */ public function involves(int $userId): bool { return $this->user_id === $userId || $this->partner_id === $userId; } /** * 判断两人是否已婚（静态工厂方法）。 * * @param int $userA 用户A ID * @param int $userB 用户B ID */ public static function areMárried(int $userA, int $userB): bool { return static::query() ->where('status', 'married') ->where(function (Builder $q) use ($userA, $userB) { $q->where(fn ($q) => $q->where('user_id', $userA)->where('partner_id', $userB)) ->orWhere(fn ($q) => $q->where('user_id', $userB)->where('partner_id', $userA)); }) ->exists(); } /** * 获取用户当前有效婚姻（pending 或 married 状态）。 * * @param int $userId 用户 ID */ public static function currentFor(int $userId): ?static { return static::query() ->whereIn('status', ['pending', 'married']) ->where(function (Builder $q) use ($userId) { $q->where('user_id', $userId)->orWhere('partner_id', $userId); }) ->first(); } }