feat:일반전표입력 페이지 전면 개편 - 계좌입출금 기반 분개 시스템

- 3탭 구조로 전면 재작성 (은행거래분개, 수동전표, 전표목록) - JournalEntryController에 bankTransactions, storeFromBank, bankJournals, deleteBankJournal API 추가 - JournalEntry 모델에 source_type, source_key fillable 및 헬퍼 메서드 추가 - 은행거래 목록에서 분개 모달로 복식부기 전표 생성 - 입금/출금에 따라 보통예금(103) 자동 세팅 - 분개 완료/미분개 상태 표시 및 필터링 - 기존 수동전표, 전표목록 기능 그대로 유지 Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-10 17:58:33 +09:00
parent 510b25ff1d
commit 34788e854c
4 changed files with 1465 additions and 461 deletions
--- a/app/Http/Controllers/Finance/JournalEntryController.php
+++ b/app/Http/Controllers/Finance/JournalEntryController.php
@@ -3,6 +3,7 @@
 namespace App\Http\Controllers\Finance;

 use App\Http\Controllers\Controller;
+use App\Http\Controllers\Barobill\EaccountController;
 use App\Models\Finance\JournalEntry;
 use App\Models\Finance\JournalEntryLine;
 use App\Models\Finance\TradingPartner;
@@ -10,6 +11,7 @@
 use Illuminate\Http\JsonResponse;
 use Illuminate\Http\Request;
 use Illuminate\Support\Facades\DB;
+use Illuminate\Support\Facades\Log;

 class JournalEntryController extends Controller
 {
@@ -359,4 +361,237 @@ public function tradingPartners(Request $request): JsonResponse
            }),
        ]);
    }
+
+    // ================================================================
+    // 은행거래 기반 분개 API
+    // ================================================================
+
+    /**
+     * 은행거래 목록 조회 (EaccountController 재사용 + 분개상태 병합)
+     */
+    public function bankTransactions(Request $request): JsonResponse
+    {
+        try {
+            $tenantId = session('selected_tenant_id', 1);
+
+            // EaccountController의 transactions 메서드 호출하여 은행거래 조회
+            $eaccountController = app(EaccountController::class);
+            $transResponse = $eaccountController->transactions($request);
+            $transData = json_decode($transResponse->getContent(), true);
+
+            if (!($transData['success'] ?? false)) {
+                return response()->json($transData);
+            }
+
+            $logs = $transData['data']['logs'] ?? [];
+
+            // 각 거래의 uniqueKey 수집
+            $uniqueKeys = array_column($logs, 'uniqueKey');
+
+            // 분개 완료된 source_key 조회
+            $journaledKeys = JournalEntry::getJournaledSourceKeys($tenantId, 'bank_transaction', $uniqueKeys);
+            $journaledKeysMap = array_flip($journaledKeys);
+
+            // 분개된 전표 ID도 조회
+            $journalMap = [];
+            if (!empty($journaledKeys)) {
+                $journals = JournalEntry::where('tenant_id', $tenantId)
+                    ->where('source_type', 'bank_transaction')
+                    ->whereIn('source_key', $journaledKeys)
+                    ->select('id', 'source_key', 'entry_no')
+                    ->get();
+                foreach ($journals as $j) {
+                    $journalMap[$j->source_key] = ['id' => $j->id, 'entry_no' => $j->entry_no];
+                }
+            }
+
+            // 각 거래에 분개 상태 추가
+            foreach ($logs as &$log) {
+                $key = $log['uniqueKey'] ?? '';
+                $log['hasJournal'] = isset($journaledKeysMap[$key]);
+                $log['journalId'] = $journalMap[$key]['id'] ?? null;
+                $log['journalEntryNo'] = $journalMap[$key]['entry_no'] ?? null;
+            }
+            unset($log);
+
+            // 분개 통계
+            $journaledCount = count($journaledKeys);
+            $totalCount = count($logs);
+
+            $transData['data']['logs'] = $logs;
+            $transData['data']['journalStats'] = [
+                'journaledCount' => $journaledCount,
+                'unjournaledCount' => $totalCount - $journaledCount,
+            ];
+
+            return response()->json($transData);
+        } catch (\Throwable $e) {
+            Log::error('은행거래 목록 조회 오류: ' . $e->getMessage());
+            return response()->json([
+                'success' => false,
+                'message' => '은행거래 목록 조회 실패: ' . $e->getMessage(),
+            ], 500);
+        }
+    }
+
+    /**
+     * 은행거래 기반 전표 생성
+     */
+    public function storeFromBank(Request $request): JsonResponse
+    {
+        $request->validate([
+            'source_key' => 'required|string|max:255',
+            'entry_date' => 'required|date',
+            'description' => 'nullable|string|max:500',
+            'lines' => 'required|array|min:2',
+            'lines.*.dc_type' => 'required|in:debit,credit',
+            'lines.*.account_code' => 'required|string|max:10',
+            'lines.*.account_name' => 'required|string|max:100',
+            'lines.*.trading_partner_id' => 'nullable|integer',
+            'lines.*.trading_partner_name' => 'nullable|string|max:100',
+            'lines.*.debit_amount' => 'required|integer|min:0',
+            'lines.*.credit_amount' => 'required|integer|min:0',
+            'lines.*.description' => 'nullable|string|max:300',
+        ]);
+
+        $tenantId = session('selected_tenant_id', 1);
+        $lines = $request->lines;
+
+        $totalDebit = collect($lines)->sum('debit_amount');
+        $totalCredit = collect($lines)->sum('credit_amount');
+
+        if ($totalDebit !== $totalCredit || $totalDebit === 0) {
+            return response()->json([
+                'success' => false,
+                'message' => '차변합계와 대변합계가 일치해야 하며 0보다 커야 합니다.',
+            ], 422);
+        }
+
+        // 중복 분개 체크
+        $existing = JournalEntry::getJournalBySourceKey($tenantId, 'bank_transaction', $request->source_key);
+        if ($existing) {
+            return response()->json([
+                'success' => false,
+                'message' => '이미 분개가 완료된 거래입니다. (전표번호: ' . $existing->entry_no . ')',
+            ], 422);
+        }
+
+        try {
+            $entry = DB::transaction(function () use ($tenantId, $request, $lines, $totalDebit, $totalCredit) {
+                $entryNo = JournalEntry::generateEntryNo($tenantId, $request->entry_date);
+
+                $entry = JournalEntry::create([
+                    'tenant_id' => $tenantId,
+                    'entry_no' => $entryNo,
+                    'entry_date' => $request->entry_date,
+                    'description' => $request->description,
+                    'total_debit' => $totalDebit,
+                    'total_credit' => $totalCredit,
+                    'status' => 'draft',
+                    'source_type' => 'bank_transaction',
+                    'source_key' => $request->source_key,
+                    'created_by_name' => auth()->user()?->name ?? '시스템',
+                ]);
+
+                foreach ($lines as $i => $line) {
+                    JournalEntryLine::create([
+                        'tenant_id' => $tenantId,
+                        'journal_entry_id' => $entry->id,
+                        'line_no' => $i + 1,
+                        'dc_type' => $line['dc_type'],
+                        'account_code' => $line['account_code'],
+                        'account_name' => $line['account_name'],
+                        'trading_partner_id' => $line['trading_partner_id'] ?? null,
+                        'trading_partner_name' => $line['trading_partner_name'] ?? null,
+                        'debit_amount' => $line['debit_amount'],
+                        'credit_amount' => $line['credit_amount'],
+                        'description' => $line['description'] ?? null,
+                    ]);
+                }
+
+                return $entry;
+            });
+
+            return response()->json([
+                'success' => true,
+                'message' => '분개가 저장되었습니다.',
+                'data' => ['id' => $entry->id, 'entry_no' => $entry->entry_no],
+            ]);
+        } catch (\Throwable $e) {
+            Log::error('은행거래 분개 저장 오류: ' . $e->getMessage());
+            return response()->json([
+                'success' => false,
+                'message' => '분개 저장 실패: ' . $e->getMessage(),
+            ], 500);
+        }
+    }
+
+    /**
+     * 특정 은행거래의 기존 분개 조회
+     */
+    public function bankJournals(Request $request): JsonResponse
+    {
+        $tenantId = session('selected_tenant_id', 1);
+        $sourceKey = $request->get('source_key');
+
+        if (!$sourceKey) {
+            return response()->json(['success' => false, 'message' => 'source_key가 필요합니다.'], 422);
+        }
+
+        $entry = JournalEntry::forTenant($tenantId)
+            ->where('source_type', 'bank_transaction')
+            ->where('source_key', $sourceKey)
+            ->with('lines')
+            ->first();
+
+        if (!$entry) {
+            return response()->json(['success' => true, 'data' => null]);
+        }
+
+        return response()->json([
+            'success' => true,
+            'data' => [
+                'id' => $entry->id,
+                'entry_no' => $entry->entry_no,
+                'entry_date' => $entry->entry_date->format('Y-m-d'),
+                'description' => $entry->description,
+                'total_debit' => $entry->total_debit,
+                'total_credit' => $entry->total_credit,
+                'status' => $entry->status,
+                'lines' => $entry->lines->map(function ($line) {
+                    return [
+                        'id' => $line->id,
+                        'line_no' => $line->line_no,
+                        'dc_type' => $line->dc_type,
+                        'account_code' => $line->account_code,
+                        'account_name' => $line->account_name,
+                        'trading_partner_id' => $line->trading_partner_id,
+                        'trading_partner_name' => $line->trading_partner_name,
+                        'debit_amount' => $line->debit_amount,
+                        'credit_amount' => $line->credit_amount,
+                        'description' => $line->description,
+                    ];
+                }),
+            ],
+        ]);
+    }
+
+    /**
+     * 은행거래 분개 삭제 (soft delete)
+     */
+    public function deleteBankJournal(int $id): JsonResponse
+    {
+        $tenantId = session('selected_tenant_id', 1);
+
+        $entry = JournalEntry::forTenant($tenantId)
+            ->where('source_type', 'bank_transaction')
+            ->findOrFail($id);
+
+        $entry->delete();
+
+        return response()->json([
+            'success' => true,
+            'message' => '분개가 삭제되었습니다.',
+        ]);
+    }
 }
--- a/app/Models/Finance/JournalEntry.php
+++ b/app/Models/Finance/JournalEntry.php
@@ -21,6 +21,8 @@ class JournalEntry extends Model
        'total_debit',
        'total_credit',
        'status',
+        'source_type',
+        'source_key',
        'created_by_name',
        'attachment_note',
    ];
@@ -41,6 +43,33 @@ public function scopeForTenant($query, $tenantId)
        return $query->where('tenant_id', $tenantId);
    }

+    /**
+     * 분개 완료된 source_key 일괄 조회
+     */
+    public static function getJournaledSourceKeys(int $tenantId, string $sourceType, array $sourceKeys): array
+    {
+        if (empty($sourceKeys)) {
+            return [];
+        }
+
+        return static::where('tenant_id', $tenantId)
+            ->where('source_type', $sourceType)
+            ->whereIn('source_key', $sourceKeys)
+            ->pluck('source_key')
+            ->toArray();
+    }
+
+    /**
+     * source_key로 분개 전표 조회 (ID 포함)
+     */
+    public static function getJournalBySourceKey(int $tenantId, string $sourceType, string $sourceKey)
+    {
+        return static::where('tenant_id', $tenantId)
+            ->where('source_type', $sourceType)
+            ->where('source_key', $sourceKey)
+            ->first();
+    }
+
    /**
     * 전표번호 자동채번: JE-YYYYMMDD-NNN
     */
--- a/resources/views/finance/journal-entries.blade.php
+++ b/resources/views/finance/journal-entries.blade.php
--- a/routes/web.php
+++ b/routes/web.php
@@ -842,6 +842,13 @@
        Route::get('/next-entry-no', [\App\Http\Controllers\Finance\JournalEntryController::class, 'nextEntryNo'])->name('next-entry-no');
        Route::get('/account-codes', [\App\Http\Controllers\Finance\JournalEntryController::class, 'accountCodes'])->name('account-codes');
        Route::get('/trading-partners', [\App\Http\Controllers\Finance\JournalEntryController::class, 'tradingPartners'])->name('trading-partners');
+
+        // 은행거래 기반 분개
+        Route::get('/bank-transactions', [\App\Http\Controllers\Finance\JournalEntryController::class, 'bankTransactions'])->name('bank-transactions');
+        Route::post('/store-from-bank', [\App\Http\Controllers\Finance\JournalEntryController::class, 'storeFromBank'])->name('store-from-bank');
+        Route::get('/bank-journals', [\App\Http\Controllers\Finance\JournalEntryController::class, 'bankJournals'])->name('bank-journals');
+        Route::delete('/bank-journal/{id}', [\App\Http\Controllers\Finance\JournalEntryController::class, 'deleteBankJournal'])->name('delete-bank-journal');
+
        Route::get('/{id}', [\App\Http\Controllers\Finance\JournalEntryController::class, 'show'])->name('show');
        Route::post('/store', [\App\Http\Controllers\Finance\JournalEntryController::class, 'store'])->name('store');
        Route::put('/{id}', [\App\Http\Controllers\Finance\JournalEntryController::class, 'update'])->name('update');