gbanyan
2faefb5872
- Add identity_type field (patient/parent) to distinguish 病友/家長 - Add guardian_member_id for parent-child relationships - Add guardian() and dependents() relationships - Add isPatient(), isParent() helper methods - Add identity_type_label accessor Data updated: - 47 members set as patient, 4 as parent - 25 members with approved disability, 26 without - 張序 linked to guardian 張誠駿 - Payment amounts corrected based on 2024 accounting records Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
420 lines
12 KiB
PHP
420 lines
12 KiB
PHP
<?php
|
|
|
|
namespace App\Models;
|
|
|
|
use Illuminate\Database\Eloquent\Factories\HasFactory;
|
|
use Illuminate\Database\Eloquent\Model;
|
|
use Illuminate\Support\Facades\Crypt;
|
|
|
|
class Member extends Model
|
|
{
|
|
use HasFactory;
|
|
|
|
// Membership status constants
|
|
const STATUS_PENDING = 'pending';
|
|
const STATUS_ACTIVE = 'active';
|
|
const STATUS_EXPIRED = 'expired';
|
|
const STATUS_SUSPENDED = 'suspended';
|
|
|
|
// Membership type constants (per charter Article 7)
|
|
const TYPE_INDIVIDUAL = 'individual'; // 個人會員
|
|
const TYPE_SPONSOR = 'sponsor'; // 贊助會員
|
|
const TYPE_HONORARY_ACADEMIC = 'honorary_academic'; // 榮譽學術會員
|
|
|
|
// Legacy types for backward compatibility
|
|
const TYPE_REGULAR = 'individual'; // Alias for individual
|
|
const TYPE_HONORARY = 'honorary_academic'; // Alias for honorary_academic
|
|
|
|
// Disability certificate status constants
|
|
const DISABILITY_STATUS_PENDING = 'pending';
|
|
const DISABILITY_STATUS_APPROVED = 'approved';
|
|
const DISABILITY_STATUS_REJECTED = 'rejected';
|
|
|
|
// Identity type constants (病友/家長)
|
|
const IDENTITY_PATIENT = 'patient'; // 病友
|
|
const IDENTITY_PARENT = 'parent'; // 家長/父母
|
|
|
|
protected $fillable = [
|
|
'user_id',
|
|
'full_name',
|
|
'email',
|
|
'phone',
|
|
'address_line_1',
|
|
'address_line_2',
|
|
'city',
|
|
'postal_code',
|
|
'emergency_contact_name',
|
|
'emergency_contact_phone',
|
|
'national_id_encrypted',
|
|
'national_id_hash',
|
|
'membership_started_at',
|
|
'membership_expires_at',
|
|
'membership_status',
|
|
'membership_type',
|
|
'identity_type',
|
|
'guardian_member_id',
|
|
'disability_certificate_path',
|
|
'disability_certificate_status',
|
|
'disability_verified_by',
|
|
'disability_verified_at',
|
|
'disability_rejection_reason',
|
|
];
|
|
|
|
protected $casts = [
|
|
'membership_started_at' => 'date',
|
|
'membership_expires_at' => 'date',
|
|
'disability_verified_at' => 'datetime',
|
|
];
|
|
|
|
protected $appends = ['national_id'];
|
|
|
|
public function user()
|
|
{
|
|
return $this->belongsTo(User::class);
|
|
}
|
|
|
|
public function payments()
|
|
{
|
|
return $this->hasMany(MembershipPayment::class);
|
|
}
|
|
|
|
/**
|
|
* 監護人（父母）
|
|
*/
|
|
public function guardian()
|
|
{
|
|
return $this->belongsTo(Member::class, 'guardian_member_id');
|
|
}
|
|
|
|
/**
|
|
* 被監護人（子女）
|
|
*/
|
|
public function dependents()
|
|
{
|
|
return $this->hasMany(Member::class, 'guardian_member_id');
|
|
}
|
|
|
|
/**
|
|
* 是否為病友
|
|
*/
|
|
public function isPatient(): bool
|
|
{
|
|
return $this->identity_type === self::IDENTITY_PATIENT;
|
|
}
|
|
|
|
/**
|
|
* 是否為家長/父母
|
|
*/
|
|
public function isParent(): bool
|
|
{
|
|
return $this->identity_type === self::IDENTITY_PARENT;
|
|
}
|
|
|
|
/**
|
|
* 取得身份類型標籤
|
|
*/
|
|
public function getIdentityTypeLabelAttribute(): string
|
|
{
|
|
return match ($this->identity_type) {
|
|
self::IDENTITY_PATIENT => '病友',
|
|
self::IDENTITY_PARENT => '家長/父母',
|
|
default => '未設定',
|
|
};
|
|
}
|
|
|
|
/**
|
|
* 關聯的收入記錄
|
|
*/
|
|
public function incomes()
|
|
{
|
|
return $this->hasMany(Income::class);
|
|
}
|
|
|
|
/**
|
|
* 取得會員的會費收入記錄
|
|
*/
|
|
public function getMembershipFeeIncomes()
|
|
{
|
|
return $this->incomes()
|
|
->whereIn('income_type', [
|
|
Income::TYPE_MEMBERSHIP_FEE,
|
|
Income::TYPE_ENTRANCE_FEE
|
|
])
|
|
->get();
|
|
}
|
|
|
|
/**
|
|
* 取得會員的總收入金額
|
|
*/
|
|
public function getTotalIncomeAttribute(): float
|
|
{
|
|
return $this->incomes()
|
|
->where('status', Income::STATUS_CONFIRMED)
|
|
->sum('amount');
|
|
}
|
|
|
|
/**
|
|
* Get the decrypted national ID
|
|
*/
|
|
public function getNationalIdAttribute(): ?string
|
|
{
|
|
if (empty($this->national_id_encrypted)) {
|
|
return null;
|
|
}
|
|
|
|
try {
|
|
return Crypt::decryptString($this->national_id_encrypted);
|
|
} catch (\Exception $e) {
|
|
\Log::error('Failed to decrypt national_id', [
|
|
'member_id' => $this->id,
|
|
'error' => $e->getMessage(),
|
|
]);
|
|
return null;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Set the national ID (encrypt and hash)
|
|
*/
|
|
public function setNationalIdAttribute(?string $value): void
|
|
{
|
|
if (empty($value)) {
|
|
$this->attributes['national_id_encrypted'] = null;
|
|
$this->attributes['national_id_hash'] = null;
|
|
return;
|
|
}
|
|
|
|
$this->attributes['national_id_encrypted'] = Crypt::encryptString($value);
|
|
$this->attributes['national_id_hash'] = hash('sha256', $value);
|
|
}
|
|
|
|
/**
|
|
* Check if membership status is pending (not yet paid/verified)
|
|
*/
|
|
public function isPending(): bool
|
|
{
|
|
return $this->membership_status === self::STATUS_PENDING;
|
|
}
|
|
|
|
/**
|
|
* Check if membership is active (paid & activated)
|
|
*/
|
|
public function isActive(): bool
|
|
{
|
|
return $this->membership_status === self::STATUS_ACTIVE;
|
|
}
|
|
|
|
/**
|
|
* Check if membership is expired
|
|
*/
|
|
public function isExpired(): bool
|
|
{
|
|
return $this->membership_status === self::STATUS_EXPIRED;
|
|
}
|
|
|
|
/**
|
|
* Check if membership is suspended
|
|
*/
|
|
public function isSuspended(): bool
|
|
{
|
|
return $this->membership_status === self::STATUS_SUSPENDED;
|
|
}
|
|
|
|
/**
|
|
* Check if member has paid membership (active status with valid dates)
|
|
*/
|
|
public function hasPaidMembership(): bool
|
|
{
|
|
return $this->isActive()
|
|
&& $this->membership_started_at
|
|
&& $this->membership_expires_at
|
|
&& $this->membership_expires_at->isFuture();
|
|
}
|
|
|
|
/**
|
|
* Get the membership status badge class for display
|
|
*/
|
|
public function getMembershipStatusBadgeAttribute(): string
|
|
{
|
|
$label = $this->membership_status_label;
|
|
|
|
$class = match($this->membership_status) {
|
|
self::STATUS_PENDING => 'bg-yellow-100 text-yellow-800 dark:bg-yellow-900 dark:text-yellow-200',
|
|
self::STATUS_ACTIVE => 'bg-green-100 text-green-800 dark:bg-green-900 dark:text-green-200',
|
|
self::STATUS_EXPIRED => 'bg-gray-100 text-gray-800 dark:bg-gray-900 dark:text-gray-200',
|
|
self::STATUS_SUSPENDED => 'bg-red-100 text-red-800 dark:bg-red-900 dark:text-red-200',
|
|
default => 'bg-gray-100 text-gray-800 dark:bg-gray-900 dark:text-gray-200',
|
|
};
|
|
|
|
return trim("{$label} {$class}");
|
|
}
|
|
|
|
/**
|
|
* Get the membership status label in Chinese
|
|
*/
|
|
public function getMembershipStatusLabelAttribute(): string
|
|
{
|
|
return match($this->membership_status) {
|
|
self::STATUS_PENDING => '待繳費',
|
|
self::STATUS_ACTIVE => '已啟用',
|
|
self::STATUS_EXPIRED => '已過期',
|
|
self::STATUS_SUSPENDED => '已暫停',
|
|
default => $this->membership_status,
|
|
};
|
|
}
|
|
|
|
/**
|
|
* Get the membership type label in Chinese
|
|
*/
|
|
public function getMembershipTypeLabelAttribute(): string
|
|
{
|
|
return match($this->membership_type) {
|
|
'individual', 'regular' => '個人會員',
|
|
'sponsor' => '贊助會員',
|
|
'honorary_academic', 'honorary' => '榮譽學術會員',
|
|
// Legacy types
|
|
'lifetime' => '終身會員',
|
|
'student' => '學生會員',
|
|
default => $this->membership_type,
|
|
};
|
|
}
|
|
|
|
/**
|
|
* Get pending payment (if any)
|
|
*/
|
|
public function getPendingPayment()
|
|
{
|
|
return $this->payments()
|
|
->where('status', MembershipPayment::STATUS_PENDING)
|
|
->orWhere('status', MembershipPayment::STATUS_APPROVED_CASHIER)
|
|
->orWhere('status', MembershipPayment::STATUS_APPROVED_ACCOUNTANT)
|
|
->latest()
|
|
->first();
|
|
}
|
|
|
|
/**
|
|
* Check if member can submit payment
|
|
*/
|
|
public function canSubmitPayment(): bool
|
|
{
|
|
// Can submit if pending status and no pending payment
|
|
return $this->isPending() && !$this->getPendingPayment();
|
|
}
|
|
|
|
// ========== 身心障礙相關 ==========
|
|
|
|
/**
|
|
* 身心障礙手冊審核人
|
|
*/
|
|
public function disabilityVerifiedBy()
|
|
{
|
|
return $this->belongsTo(User::class, 'disability_verified_by');
|
|
}
|
|
|
|
/**
|
|
* 是否有上傳身心障礙手冊
|
|
*/
|
|
public function hasDisabilityCertificate(): bool
|
|
{
|
|
return !empty($this->disability_certificate_path);
|
|
}
|
|
|
|
/**
|
|
* 身心障礙手冊是否待審核
|
|
*/
|
|
public function isDisabilityPending(): bool
|
|
{
|
|
return $this->disability_certificate_status === self::DISABILITY_STATUS_PENDING;
|
|
}
|
|
|
|
/**
|
|
* 身心障礙手冊是否已通過審核
|
|
*/
|
|
public function hasApprovedDisability(): bool
|
|
{
|
|
return $this->disability_certificate_status === self::DISABILITY_STATUS_APPROVED;
|
|
}
|
|
|
|
/**
|
|
* 身心障礙手冊是否被駁回
|
|
*/
|
|
public function isDisabilityRejected(): bool
|
|
{
|
|
return $this->disability_certificate_status === self::DISABILITY_STATUS_REJECTED;
|
|
}
|
|
|
|
/**
|
|
* 取得身心障礙狀態標籤
|
|
*/
|
|
public function getDisabilityStatusLabelAttribute(): string
|
|
{
|
|
if (!$this->hasDisabilityCertificate()) {
|
|
return '未上傳';
|
|
}
|
|
|
|
return match ($this->disability_certificate_status) {
|
|
self::DISABILITY_STATUS_PENDING => '審核中',
|
|
self::DISABILITY_STATUS_APPROVED => '已通過',
|
|
self::DISABILITY_STATUS_REJECTED => '已駁回',
|
|
default => '未知',
|
|
};
|
|
}
|
|
|
|
/**
|
|
* 取得身心障礙狀態的 Badge 樣式
|
|
*/
|
|
public function getDisabilityStatusBadgeAttribute(): string
|
|
{
|
|
if (!$this->hasDisabilityCertificate()) {
|
|
return 'bg-gray-100 text-gray-800 dark:bg-gray-900 dark:text-gray-200';
|
|
}
|
|
|
|
return match ($this->disability_certificate_status) {
|
|
self::DISABILITY_STATUS_PENDING => 'bg-yellow-100 text-yellow-800 dark:bg-yellow-900 dark:text-yellow-200',
|
|
self::DISABILITY_STATUS_APPROVED => 'bg-green-100 text-green-800 dark:bg-green-900 dark:text-green-200',
|
|
self::DISABILITY_STATUS_REJECTED => 'bg-red-100 text-red-800 dark:bg-red-900 dark:text-red-200',
|
|
default => 'bg-gray-100 text-gray-800 dark:bg-gray-900 dark:text-gray-200',
|
|
};
|
|
}
|
|
|
|
/**
|
|
* 審核通過身心障礙手冊
|
|
*/
|
|
public function approveDisabilityCertificate(User $verifier): void
|
|
{
|
|
$this->update([
|
|
'disability_certificate_status' => self::DISABILITY_STATUS_APPROVED,
|
|
'disability_verified_by' => $verifier->id,
|
|
'disability_verified_at' => now(),
|
|
'disability_rejection_reason' => null,
|
|
]);
|
|
}
|
|
|
|
/**
|
|
* 駁回身心障礙手冊
|
|
*/
|
|
public function rejectDisabilityCertificate(User $verifier, string $reason): void
|
|
{
|
|
$this->update([
|
|
'disability_certificate_status' => self::DISABILITY_STATUS_REJECTED,
|
|
'disability_verified_by' => $verifier->id,
|
|
'disability_verified_at' => now(),
|
|
'disability_rejection_reason' => $reason,
|
|
]);
|
|
}
|
|
|
|
/**
|
|
* 判斷下一次應繳哪種會費
|
|
*/
|
|
public function getNextFeeType(): string
|
|
{
|
|
// 新會員（從未啟用過）= 入會會費
|
|
if ($this->membership_started_at === null) {
|
|
return MembershipPayment::FEE_TYPE_ENTRANCE;
|
|
}
|
|
|
|
// 已有會籍 = 常年會費
|
|
return MembershipPayment::FEE_TYPE_ANNUAL;
|
|
}
|
|
}
|