From eb8519a22d1ccd5313020bc6b957c5107d2c6a5a Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=EA=B9=80=EB=B3=B4=EA=B3=A4?= Date: Thu, 19 Mar 2026 22:05:30 +0900 Subject: [PATCH] =?UTF-8?q?docs:=20[changes]=20=EC=B9=B4=EB=93=9C=EA=B1=B0?= =?UTF-8?q?=EB=9E=98=20=ED=91=9C=EC=8B=9C=20=ED=8F=AC=EB=A7=B7=203?= =?UTF-8?q?=EA=B0=9C=20=ED=99=94=EB=A9=B4=20=ED=86=B5=EC=9D=BC=20=EB=B3=80?= =?UTF-8?q?=EA=B2=BD=EC=9D=B4=EB=A0=A5=20=EC=B6=94=EA=B0=80?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- INDEX.md | 1 + ...19_card_transaction_display_unification.md | 55 +++++++++++++++++++ 2 files changed, 56 insertions(+) create mode 100644 changes/20260319_card_transaction_display_unification.md diff --git a/INDEX.md b/INDEX.md index 50d5c78..d9da3b4 100644 --- a/INDEX.md +++ b/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개 화면 통일 (계정별원장·일반전표·카드사용내역) | --- diff --git a/changes/20260319_card_transaction_display_unification.md b/changes/20260319_card_transaction_display_unification.md new file mode 100644 index 0000000..f161f61 --- /dev/null +++ b/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 명세