docs: [changes] 카드거래 표시 포맷 3개 화면 통일 변경이력 추가

INDEX.md

@@ -287,6 +287,7 @@ DB 도메인별:
 | [20260319_barobill_card_auto_sync.md](changes/20260319_barobill_card_auto_sync.md) | 바로빌 카드 사용내역 자동 동기화 스케줄러 추가 (2시간마다, 서버 crontab 필요) |
 | [20260319_db_codebridge_migration_and_fixes.md](changes/20260319_db_codebridge_migration_and_fixes.md) | MNG 전용 테이블 codebridge DB 이관 + 손익계산서 매출액/월별 세부내역 수정 |
 | [20260319_attendance_leave_sync_fix.md](changes/20260319_attendance_leave_sync_fix.md) | 근태현황 승인된 휴가 누락 attendance 레코드 자동 보정 |
+| [20260319_card_transaction_display_unification.md](changes/20260319_card_transaction_display_unification.md) | 카드거래 표시 포맷 3개 화면 통일 (계정별원장·일반전표·카드사용내역) |
 
 ---
 

changes/20260319_card_transaction_display_unification.md

@@ -0,0 +1,55 @@
+# 카드거래 표시 포맷 3개 화면 통일
+
+**날짜:** 2026-03-19
+**작업자:** Claude Code
+
+## 변경 개요
+
+카드사용내역 → 일반전표입력 → 계정별원장 3개 화면에서 카드거래 정보 표시 구조가 불일치하던 문제를 해결했다.
+
+- **카드사용내역**: 상세 컬럼(카드번호, 공제구분, 가맹점, 공급가액/세액) 표시
+- **일반전표입력**: 적요 텍스트로 압축, 공급/세액 분리 없음
+- **계정별원장**: 카드 정보 아예 없음
+
+3개 화면에서 동일한 카드거래 구조를 유지하도록 개선했다.
+
+## 수정된 파일
+
+| 파일 | 변경 내용 |
+|------|----------|
+| `app/Http/Controllers/Finance/AccountLedgerController.php` | `source_type` COALESCE 변환, `source_key` 추가, `fetchCardTransactions()` 메서드 신규, `card_tx` 필드 추가 |
+| `resources/views/finance/account-ledger.blade.php` | 카드 배지/카드번호 하위텍스트, DetailModal 카드정보 카드, drillDown ecard_transaction 분기 |
+| `resources/views/finance/journal-entries.blade.php` | 적요에 카드사/카드번호/사업자번호, 출금에 공급가액/세액 분해 표시 |
+
+## 상세 변경 사항
+
+### 1. AccountLedgerController — 백엔드
+
+- `DB::raw("'journal' as source_type")` → `COALESCE(je.source_type, 'journal')` 변환하여 카드/은행 전표 구분
+- `je.source_key` 셀렉트 추가
+- `fetchCardTransactions()` private 메서드: `ecard_transaction`인 행의 `source_key`(복합키 `card_num|use_dt|approval_num|amount`)를 파싱하여 `barobill_card_transactions` 일괄 조회
+- 각 item에 `card_tx` 필드 추가 (카드번호, 카드사, 가맹점, 사업자번호, 공급가액, 세액)
+- `card_tx`가 있으면 거래처명/사업자번호를 가맹점 정보로 우선 표시
+
+### 2. account-ledger.blade.php — 계정별원장
+
+- 거래 행 적요 컬럼: 카드 아이콘 + 공제/불공제 배지 + 카드사·카드번호(끝4자리) 하위 텍스트
+- DetailModal: `card_tx` 존재 시 주황색 카드거래 정보 카드 (카드번호, 카드사, 가맹점, 사업자번호, 공급가액, 세액)
+- drillDown 함수: `ecard_transaction`, `bank_transaction`도 전표 상세 모달에서 조회 가능
+
+### 3. journal-entries.blade.php — 일반전표입력
+
+- 적요 컬럼: 기존 가맹점명 + 공제배지 아래에 카드사·카드번호(끝4자리) + 사업자번호 하위 행
+- 출금 컬럼: 합계 금액 아래에 `공급 N / 세액 N` 분해 표시
+
+## 테스트 체크리스트
+
+- [ ] 일반전표입력에서 카드거래 행에 카드번호, 공제배지, 공급가액/세액 분리 표시
+- [ ] 계정별원장에서 카드거래 분개 행에 카드 아이콘, 공제/불공제, 가맹점명 표시
+- [ ] 계정별원장 행 클릭 시 카드 정보 요약 카드가 모달에 표시
+- [ ] 은행거래/수동전표 행이 기존과 동일하게 표시 (회귀 없음)
+
+## 관련 문서
+
+- `dev/dev_plans/account-ledger-income-statement-plan.md` — 계정별원장 기획
+- `frontend/api-specs/barobill-api.md` — 바로빌 API 명세