Initial commit

2025-11-20 23:21:05 +08:00
commit 13bc6db529
378 changed files with 54527 additions and 0 deletions
--- a/app/Models/CashierLedgerEntry.php
+++ b/app/Models/CashierLedgerEntry.php
@@ -0,0 +1,132 @@
+<?php
+
+namespace App\Models;
+
+use Illuminate\Database\Eloquent\Factories\HasFactory;
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+
+class CashierLedgerEntry extends Model
+{
+    use HasFactory;
+
+    protected $fillable = [
+        'finance_document_id',
+        'entry_date',
+        'entry_type',
+        'payment_method',
+        'bank_account',
+        'amount',
+        'balance_before',
+        'balance_after',
+        'receipt_number',
+        'transaction_reference',
+        'recorded_by_cashier_id',
+        'recorded_at',
+        'notes',
+    ];
+
+    protected $casts = [
+        'entry_date' => 'date',
+        'amount' => 'decimal:2',
+        'balance_before' => 'decimal:2',
+        'balance_after' => 'decimal:2',
+        'recorded_at' => 'datetime',
+    ];
+
+    /**
+     * 類型常數
+     */
+    const ENTRY_TYPE_RECEIPT = 'receipt';
+    const ENTRY_TYPE_PAYMENT = 'payment';
+
+    const PAYMENT_METHOD_BANK_TRANSFER = 'bank_transfer';
+    const PAYMENT_METHOD_CHECK = 'check';
+    const PAYMENT_METHOD_CASH = 'cash';
+
+    /**
+     * 關聯到財務申請單
+     */
+    public function financeDocument(): BelongsTo
+    {
+        return $this->belongsTo(FinanceDocument::class);
+    }
+
+    /**
+     * 記錄的出納人員
+     */
+    public function recordedByCashier(): BelongsTo
+    {
+        return $this->belongsTo(User::class, 'recorded_by_cashier_id');
+    }
+
+    /**
+     * 計算交易後餘額
+     */
+    public function calculateBalanceAfter(float $currentBalance): float
+    {
+        if ($this->entry_type === self::ENTRY_TYPE_RECEIPT) {
+            return $currentBalance + $this->amount;
+        } else {
+            return $currentBalance - $this->amount;
+        }
+    }
+
+    /**
+     * 取得最新餘額（從最後一筆記錄）
+     */
+    public static function getLatestBalance(string $bankAccount = null): float
+    {
+        $query = self::orderBy('entry_date', 'desc')
+            ->orderBy('id', 'desc');
+
+        if ($bankAccount) {
+            $query->where('bank_account', $bankAccount);
+        }
+
+        $latest = $query->first();
+
+        return $latest ? $latest->balance_after : 0.00;
+    }
+
+    /**
+     * 取得類型文字
+     */
+    public function getEntryTypeText(): string
+    {
+        return match ($this->entry_type) {
+            self::ENTRY_TYPE_RECEIPT => '收入',
+            self::ENTRY_TYPE_PAYMENT => '支出',
+            default => '未知',
+        };
+    }
+
+    /**
+     * 取得付款方式文字
+     */
+    public function getPaymentMethodText(): string
+    {
+        return match ($this->payment_method) {
+            self::PAYMENT_METHOD_BANK_TRANSFER => '銀行轉帳',
+            self::PAYMENT_METHOD_CHECK => '支票',
+            self::PAYMENT_METHOD_CASH => '現金',
+            default => '未知',
+        };
+    }
+
+    /**
+     * 是否為收入記錄
+     */
+    public function isReceipt(): bool
+    {
+        return $this->entry_type === self::ENTRY_TYPE_RECEIPT;
+    }
+
+    /**
+     * 是否為支出記錄
+     */
+    public function isPayment(): bool
+    {
+        return $this->entry_type === self::ENTRY_TYPE_PAYMENT;
+    }
+}