Files
sam-manage/app/Models/Barobill/BankTransaction.php
김보곤 005020f5ec fix: [bank-transaction] uniqueKey에 적요(summary) 추가하여 동일 금액·시간 거래 구분
- BankTransaction 모델: getUniqueKeyAttribute, generateUniqueKey에 summary 추가
- EaccountController: API 응답 및 DB upsert 시 summary 포함 매칭
- JournalEntry, JournalEntryController: 레거시(5필드) 키 호환 처리
- BankTransactionOverride: 레거시 키 호환 조회
2026-02-23 16:02:36 +09:00

118 lines
3.1 KiB
PHP

<?php
namespace App\Models\Barobill;
use App\Models\Tenants\Tenant;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Relations\BelongsTo;
/**
* 바로빌 계좌 입출금 내역 모델
*
* 바로빌에서 조회한 입출금 내역에 계정과목을 추가하여 저장
*/
class BankTransaction extends Model
{
protected $table = 'barobill_bank_transactions';
protected $fillable = [
'tenant_id',
'bank_account_num',
'bank_code',
'bank_name',
'trans_date',
'trans_time',
'trans_dt',
'deposit',
'withdraw',
'balance',
'summary',
'cast',
'memo',
'trans_office',
'account_code',
'account_name',
'client_code',
'client_name',
'is_manual',
];
protected $casts = [
'is_manual' => 'boolean',
];
/**
* 테넌트 관계
*/
public function tenant(): BelongsTo
{
return $this->belongsTo(Tenant::class);
}
/**
* 거래 고유 키 생성 (매칭용)
* 숫자는 정수로 변환하여 형식 통일
*/
public function getUniqueKeyAttribute(): string
{
return implode('|', [
$this->bank_account_num,
$this->trans_dt,
(int) $this->deposit,
(int) $this->withdraw,
(int) $this->balance,
$this->summary ?? '',
]);
}
/**
* 바로빌 로그 데이터로부터 고유 키 생성 (정적 메서드)
*/
public static function generateUniqueKey(array $log): string
{
// trans_dt 생성: transDate + transTime
$transDt = ($log['transDate'] ?? '').($log['transTime'] ?? '');
return implode('|', [
$log['bankAccountNum'] ?? '',
$transDt,
$log['deposit'] ?? 0,
$log['withdraw'] ?? 0,
$log['balance'] ?? 0,
$log['summary'] ?? '',
]);
}
/**
* 캐시된 API 거래 내역 조회 (월별)
* is_manual=false인 거래만 조회 (API에서 자동 저장된 데이터)
*/
public static function getCachedByMonth(int $tenantId, string $accNum, string $startDate, string $endDate): \Illuminate\Database\Eloquent\Collection
{
return self::where('tenant_id', $tenantId)
->where('bank_account_num', $accNum)
->where('is_manual', false)
->whereBetween('trans_date', [$startDate, $endDate])
->orderBy('trans_date', 'desc')
->orderBy('trans_time', 'desc')
->get();
}
/**
* 테넌트별 거래 내역 조회 (기간별)
*/
public static function getByDateRange(int $tenantId, string $startDate, string $endDate, ?string $accountNum = null)
{
$query = self::where('tenant_id', $tenantId)
->whereBetween('trans_date', [$startDate, $endDate])
->orderBy('trans_date', 'desc')
->orderBy('trans_time', 'desc');
if ($accountNum) {
$query->where('bank_account_num', $accountNum);
}
return $query->get()->keyBy(fn ($item) => $item->unique_key);
}
}