feat: [bill,loan] 어음 V8 확장 필드 및 가지급금 상품권 카테고리 지원

- Bill 모델: V8 확장 필드 54개 추가 (증권종류, 할인, 배서, 추심, 개서, 부도 등) - Bill 상태: 수취/발행 어음·수표별 세분화된 상태 체계 - BillService: assignV8Fields/syncInstallments 헬퍼 추출, instrument_type/medium 필터 - BillInstallment: type/counterparty 필드 추가 - Loan 모델: holding/used/disposed 상태 + metadata(JSON) 필드 추가 - LoanService: 상품권 카테고리 지원 (summary 상태별 집계, store 기본상태 holding) - FormRequest: V8 확장 필드 검증 규칙 추가 - 마이그레이션: bills V8 필드 + loans metadata 컬럼 Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-05 20:45:54 +09:00
parent f41605ca73
commit 8c9f2fcfb5
13 changed files with 743 additions and 59 deletions
--- a/app/Models/Tenants/Bill.php
+++ b/app/Models/Tenants/Bill.php
@@ -31,6 +31,58 @@ class Bill extends Model
        'created_by',
        'updated_by',
        'deleted_by',
+        // V8 확장 필드
+        'instrument_type',
+        'medium',
+        'bill_category',
+        'electronic_bill_no',
+        'registration_org',
+        'drawee',
+        'acceptance_status',
+        'acceptance_date',
+        'acceptance_refusal_date',
+        'acceptance_refusal_reason',
+        'endorsement',
+        'endorsement_order',
+        'storage_place',
+        'issuer_bank',
+        'is_discounted',
+        'discount_date',
+        'discount_bank',
+        'discount_rate',
+        'discount_amount',
+        'endorsement_date',
+        'endorsee',
+        'endorsement_reason',
+        'collection_bank',
+        'collection_request_date',
+        'collection_fee',
+        'collection_complete_date',
+        'collection_result',
+        'collection_deposit_date',
+        'collection_deposit_amount',
+        'settlement_bank',
+        'payment_method',
+        'actual_payment_date',
+        'payment_place',
+        'payment_place_detail',
+        'renewal_date',
+        'renewal_new_bill_no',
+        'renewal_reason',
+        'recourse_date',
+        'recourse_amount',
+        'recourse_target',
+        'recourse_reason',
+        'buyback_date',
+        'buyback_amount',
+        'buyback_bank',
+        'dishonored_date',
+        'dishonored_reason',
+        'has_protest',
+        'protest_date',
+        'recourse_notice_date',
+        'recourse_notice_deadline',
+        'is_split',
    ];

    protected $casts = [
@@ -41,21 +93,57 @@ class Bill extends Model
        'bank_account_id' => 'integer',
        'installment_count' => 'integer',
        'is_electronic' => 'boolean',
+        // V8 확장 casts
+        'acceptance_date' => 'date',
+        'acceptance_refusal_date' => 'date',
+        'discount_date' => 'date',
+        'discount_rate' => 'decimal:2',
+        'discount_amount' => 'decimal:2',
+        'endorsement_date' => 'date',
+        'collection_request_date' => 'date',
+        'collection_fee' => 'decimal:2',
+        'collection_complete_date' => 'date',
+        'collection_deposit_date' => 'date',
+        'collection_deposit_amount' => 'decimal:2',
+        'actual_payment_date' => 'date',
+        'renewal_date' => 'date',
+        'recourse_date' => 'date',
+        'recourse_amount' => 'decimal:2',
+        'buyback_date' => 'date',
+        'buyback_amount' => 'decimal:2',
+        'dishonored_date' => 'date',
+        'protest_date' => 'date',
+        'recourse_notice_date' => 'date',
+        'recourse_notice_deadline' => 'date',
+        'is_discounted' => 'boolean',
+        'has_protest' => 'boolean',
+        'is_split' => 'boolean',
    ];

    /**
     * 배열/JSON 변환 시 날짜 형식 지정
     */
+    /**
+     * 날짜 cast 필드 목록 (toArray에서 Y-m-d 형식 변환용)
+     */
+    private const DATE_FIELDS = [
+        'issue_date', 'maturity_date',
+        'acceptance_date', 'acceptance_refusal_date',
+        'discount_date', 'endorsement_date',
+        'collection_request_date', 'collection_complete_date', 'collection_deposit_date',
+        'actual_payment_date',
+        'renewal_date', 'recourse_date', 'buyback_date',
+        'dishonored_date', 'protest_date', 'recourse_notice_date', 'recourse_notice_deadline',
+    ];
+
    public function toArray(): array
    {
        $array = parent::toArray();

-        // 날짜 필드를 Y-m-d 형식으로 변환
-        if (isset($array['issue_date']) && $this->issue_date) {
-            $array['issue_date'] = $this->issue_date->format('Y-m-d');
-        }
-        if (isset($array['maturity_date']) && $this->maturity_date) {
-            $array['maturity_date'] = $this->maturity_date->format('Y-m-d');
+        foreach (self::DATE_FIELDS as $field) {
+            if (isset($array[$field]) && $this->{$field}) {
+                $array[$field] = $this->{$field}->format('Y-m-d');
+            }
        }

        return $array;
@@ -69,14 +157,42 @@ public function toArray(): array
        'issued' => '발행',
    ];

+    /**
+     * 증권종류
+     */
+    public const INSTRUMENT_TYPES = [
+        'promissory' => '약속어음',
+        'exchange' => '환어음',
+        'cashierCheck' => '자기앞수표',
+        'currentCheck' => '당좌수표',
+    ];
+
    /**
     * 수취 어음 상태 목록
     */
    public const RECEIVED_STATUSES = [
        'stored' => '보관중',
+        'endorsed' => '배서양도',
+        'discounted' => '할인',
+        'collectionRequest' => '추심의뢰',
+        'collectionComplete' => '추심완료',
+        'maturityDeposit' => '만기입금',
+        'paymentComplete' => '결제완료',
+        'dishonored' => '부도',
+        'renewed' => '개서',
+        'buyback' => '환매',
+        // 하위호환
        'maturityAlert' => '만기입금(7일전)',
        'maturityResult' => '만기결과',
-        'paymentComplete' => '결제완료',
+    ];
+
+    /**
+     * 수취 수표 상태 목록
+     */
+    public const RECEIVED_CHECK_STATUSES = [
+        'stored' => '보관중',
+        'endorsed' => '배서양도',
+        'deposited' => '입금',
        'dishonored' => '부도',
    ];

@@ -85,10 +201,25 @@ public function toArray(): array
     */
    public const ISSUED_STATUSES = [
        'stored' => '보관중',
+        'issued' => '지급대기',
+        'maturityPayment' => '만기결제',
+        'paymentComplete' => '결제완료',
+        'dishonored' => '부도',
+        'renewed' => '개서',
+        // 하위호환
        'maturityAlert' => '만기입금(7일전)',
        'collectionRequest' => '추심의뢰',
        'collectionComplete' => '추심완료',
        'suing' => '추소중',
+    ];
+
+    /**
+     * 발행 수표 상태 목록
+     */
+    public const ISSUED_CHECK_STATUSES = [
+        'stored' => '보관중',
+        'issued' => '지급대기',
+        'cashed' => '현금화',
        'dishonored' => '부도',
    ];

@@ -149,11 +280,25 @@ public function getBillTypeLabelAttribute(): string
     */
    public function getStatusLabelAttribute(): string
    {
+        $isCheck = in_array($this->instrument_type, ['cashierCheck', 'currentCheck']);
+
        if ($this->bill_type === 'received') {
-            return self::RECEIVED_STATUSES[$this->status] ?? $this->status;
+            $statuses = $isCheck ? self::RECEIVED_CHECK_STATUSES : self::RECEIVED_STATUSES;
+
+            return $statuses[$this->status] ?? self::RECEIVED_STATUSES[$this->status] ?? $this->status;
        }

-        return self::ISSUED_STATUSES[$this->status] ?? $this->status;
+        $statuses = $isCheck ? self::ISSUED_CHECK_STATUSES : self::ISSUED_STATUSES;
+
+        return $statuses[$this->status] ?? self::ISSUED_STATUSES[$this->status] ?? $this->status;
+    }
+
+    /**
+     * 증권종류 라벨
+     */
+    public function getInstrumentTypeLabelAttribute(): string
+    {
+        return self::INSTRUMENT_TYPES[$this->instrument_type] ?? $this->instrument_type ?? '약속어음';
    }

    /**
--- a/app/Models/Tenants/BillInstallment.php
+++ b/app/Models/Tenants/BillInstallment.php
@@ -12,8 +12,10 @@ class BillInstallment extends Model

    protected $fillable = [
        'bill_id',
+        'type',
        'installment_date',
        'amount',
+        'counterparty',
        'note',
        'created_by',
    ];
--- a/app/Models/Tenants/Loan.php
+++ b/app/Models/Tenants/Loan.php
@@ -28,6 +28,12 @@ class Loan extends Model

    public const STATUS_PARTIAL = 'partial';         // 부분정산

+    public const STATUS_HOLDING = 'holding';         // 보유 (상품권)
+
+    public const STATUS_USED = 'used';               // 사용 (상품권)
+
+    public const STATUS_DISPOSED = 'disposed';       // 폐기 (상품권)
+
    /**
     * 상태 목록
     */
@@ -35,6 +41,9 @@ class Loan extends Model
        self::STATUS_OUTSTANDING,
        self::STATUS_SETTLED,
        self::STATUS_PARTIAL,
+        self::STATUS_HOLDING,
+        self::STATUS_USED,
+        self::STATUS_DISPOSED,
    ];

    /**
@@ -104,6 +113,7 @@ class Loan extends Model
        'settlement_amount',
        'status',
        'category',
+        'metadata',
        'withdrawal_id',
        'created_by',
        'updated_by',
@@ -115,6 +125,7 @@ class Loan extends Model
        'settlement_date' => 'date',
        'amount' => 'decimal:2',
        'settlement_amount' => 'decimal:2',
+        'metadata' => 'array',
    ];

    // =========================================================================
@@ -166,6 +177,9 @@ public function getStatusLabelAttribute(): string
            self::STATUS_OUTSTANDING => '미정산',
            self::STATUS_SETTLED => '정산완료',
            self::STATUS_PARTIAL => '부분정산',
+            self::STATUS_HOLDING => '보유',
+            self::STATUS_USED => '사용',
+            self::STATUS_DISPOSED => '폐기',
            default => $this->status,
        };
    }
@@ -209,15 +223,21 @@ public function getElapsedDaysAttribute(): int
     */
    public function isEditable(): bool
    {
-        return $this->status === self::STATUS_OUTSTANDING;
+        return in_array($this->status, [
+            self::STATUS_OUTSTANDING,
+            self::STATUS_HOLDING,
+        ]);
    }

    /**
-     * 삭제 가능 여부 (미정산 상태만)
+     * 삭제 가능 여부 (미정산/보유 상태만)
     */
    public function isDeletable(): bool
    {
-        return $this->status === self::STATUS_OUTSTANDING;
+        return in_array($this->status, [
+            self::STATUS_OUTSTANDING,
+            self::STATUS_HOLDING,
+        ]);
    }

    /**