SamProject/sam-manage
6
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat:일반전표입력 기능 구현 (컨트롤러, 모델, 뷰, 라우트, 메뉴시더)

Browse Source 
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
김보곤
2026-02-06 15:23:43 +09:00
parent ce08d0110a
commit f277ec8475
6 changed files with 1371 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

355
app/Http/Controllers/Finance/JournalEntryController.php Normal file
View File

@@ -0,0 +1,355 @@
<?php
namespace App\Http\Controllers\Finance;
use App\Http\Controllers\Controller;
use App\Models\Finance\JournalEntry;
use App\Models\Finance\JournalEntryLine;
use App\Models\Finance\TradingPartner;
use App\Models\Barobill\AccountCode;
use Illuminate\Http\JsonResponse;
use Illuminate\Http\Request;
use Illuminate\Support\Facades\DB;
class JournalEntryController extends Controller
{
/**
* 전표 목록 조회
*/
public function index(Request $request): JsonResponse
{
$tenantId = session('selected_tenant_id', 1);
$query = JournalEntry::forTenant($tenantId)
->with('lines')
->orderByDesc('entry_date')
->orderByDesc('entry_no');
if ($request->filled('start_date')) {
$query->where('entry_date', '>=', $request->start_date);
}
if ($request->filled('end_date')) {
$query->where('entry_date', '<=', $request->end_date);
}
if ($request->filled('status') && $request->status !== 'all') {
$query->where('status', $request->status);
}
if ($request->filled('search')) {
$search = $request->search;
$query->where(function ($q) use ($search) {
$q->where('entry_no', 'like', "%{$search}%")
->orWhere('description', 'like', "%{$search}%");
});
}
$entries = $query->get();
$data = $entries->map(function ($entry) {
return [
'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,
'created_by_name' => $entry->created_by_name,
'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,
];
}),
];
});
$stats = [
'totalCount' => $entries->count(),
'totalDebit' => $entries->sum('total_debit'),
'totalCredit' => $entries->sum('total_credit'),
'draftCount' => $entries->where('status', 'draft')->count(),
'confirmedCount' => $entries->where('status', 'confirmed')->count(),
];
return response()->json([
'success' => true,
'data' => $data,
'stats' => $stats,
]);
}
/**
* 전표 상세 조회
*/
public function show(int $id): JsonResponse
{
$tenantId = session('selected_tenant_id', 1);
$entry = JournalEntry::forTenant($tenantId)
->with('lines')
->findOrFail($id);
return response()->json([
'success' => true,
'data' => [
'id' => $entry->id,
'entry_no' => $entry->entry_no,
'entry_date' => $entry->entry_date->format('Y-m-d'),
'entry_type' => $entry->entry_type,
'description' => $entry->description,
'total_debit' => $entry->total_debit,
'total_credit' => $entry->total_credit,
'status' => $entry->status,
'created_by_name' => $entry->created_by_name,
'attachment_note' => $entry->attachment_note,
'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,
];
}),
],
]);
}
/**
* 전표 저장
*/
public function store(Request $request): JsonResponse
{
$request->validate([
'entry_date' => 'required|date',
'description' => 'nullable|string|max:500',
'attachment_note' => 'nullable|string',
'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);
}
$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',
'created_by_name' => auth()->user()?->name ?? '시스템',
'attachment_note' => $request->attachment_note,
]);
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],
]);
}
/**
* 전표 수정
*/
public function update(Request $request, int $id): JsonResponse
{
$request->validate([
'entry_date' => 'required|date',
'description' => 'nullable|string|max:500',
'attachment_note' => 'nullable|string',
'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);
}
DB::transaction(function () use ($tenantId, $id, $request, $lines, $totalDebit, $totalCredit) {
$entry = JournalEntry::forTenant($tenantId)->findOrFail($id);
$entry->update([
'entry_date' => $request->entry_date,
'description' => $request->description,
'total_debit' => $totalDebit,
'total_credit' => $totalCredit,
'attachment_note' => $request->attachment_note,
]);
// 기존 lines 삭제 후 재생성
$entry->lines()->delete();
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 response()->json([
'success' => true,
'message' => '전표가 수정되었습니다.',
]);
}
/**
* 전표 삭제 (soft delete)
*/
public function destroy(int $id): JsonResponse
{
$tenantId = session('selected_tenant_id', 1);
$entry = JournalEntry::forTenant($tenantId)->findOrFail($id);
$entry->delete();
return response()->json([
'success' => true,
'message' => '전표가 삭제되었습니다.',
]);
}
/**
* 다음 전표번호 미리보기
*/
public function nextEntryNo(Request $request): JsonResponse
{
$tenantId = session('selected_tenant_id', 1);
$date = $request->get('date', date('Y-m-d'));
$entryNo = JournalEntry::generateEntryNo($tenantId, $date);
return response()->json([
'success' => true,
'entry_no' => $entryNo,
]);
}
/**
* 계정과목 목록
*/
public function accountCodes(): JsonResponse
{
$codes = AccountCode::getActive();
return response()->json([
'success' => true,
'data' => $codes->map(function ($code) {
return [
'code' => $code->code,
'name' => $code->name,
'category' => $code->category,
];
}),
]);
}
/**
* 거래처 목록
*/
public function tradingPartners(Request $request): JsonResponse
{
$tenantId = session('selected_tenant_id', 1);
$query = TradingPartner::forTenant($tenantId)->active();
if ($request->filled('search')) {
$search = $request->search;
$query->where(function ($q) use ($search) {
$q->where('name', 'like', "%{$search}%")
->orWhere('biz_no', 'like', "%{$search}%");
});
}
$partners = $query->orderBy('name')->limit(50)->get();
return response()->json([
'success' => true,
'data' => $partners->map(function ($p) {
return [
'id' => $p->id,
'name' => $p->name,
'biz_no' => $p->biz_no,
'type' => $p->type,
];
}),
]);
}
}