feat: expense_accounts 테이블 및 모델 생성 (복리후생비/접대비용)

2026-01-21 10:39:17 +09:00
parent ebc1794b56
commit b6de7fc722
3 changed files with 218 additions and 1 deletions
--- a/LOGICAL_RELATIONSHIPS.md
+++ b/LOGICAL_RELATIONSHIPS.md
@@ -1,6 +1,6 @@
 # 논리적 데이터베이스 관계 문서

-> **자동 생성**: 2026-01-20 20:15:39
+> **자동 생성**: 2026-01-21 10:38:32
 > **소스**: Eloquent 모델 관계 분석

 ## 📊 모델별 관계 현황
@@ -26,6 +26,15 @@ ### bad_debt_memos
 - **badDebt()**: belongsTo → `bad_debts`
 - **creator()**: belongsTo → `users`

+### biddings
+**모델**: `App\Models\Bidding\Bidding`
+
+- **quote()**: belongsTo → `quotes`
+- **client()**: belongsTo → `clients`
+- **bidder()**: belongsTo → `users`
+- **creator()**: belongsTo → `users`
+- **updater()**: belongsTo → `users`
+
 ### boards
 **모델**: `App\Models\Boards\Board`

@@ -128,6 +137,38 @@ ### contracts

 - **contractManager()**: belongsTo → `users`
 - **constructionPm()**: belongsTo → `users`
+- **creator()**: belongsTo → `users`
+- **updater()**: belongsTo → `users`
+- **handoverReport()**: hasOne → `handover_reports`
+
+### handover_reports
+**모델**: `App\Models\Construction\HandoverReport`
+
+- **contract()**: belongsTo → `contracts`
+- **contractManager()**: belongsTo → `users`
+- **constructionPm()**: belongsTo → `users`
+- **creator()**: belongsTo → `users`
+- **updater()**: belongsTo → `users`
+- **managers()**: hasMany → `handover_report_managers`
+- **items()**: hasMany → `handover_report_items`
+
+### handover_report_items
+**모델**: `App\Models\Construction\HandoverReportItem`
+
+- **handoverReport()**: belongsTo → `handover_reports`
+- **creator()**: belongsTo → `users`
+- **updater()**: belongsTo → `users`
+
+### handover_report_managers
+**모델**: `App\Models\Construction\HandoverReportManager`
+
+- **handoverReport()**: belongsTo → `handover_reports`
+- **creator()**: belongsTo → `users`
+- **updater()**: belongsTo → `users`
+
+### structure_reviews
+**모델**: `App\Models\Construction\StructureReview`
+
 - **creator()**: belongsTo → `users`
 - **updater()**: belongsTo → `users`

@@ -224,6 +265,7 @@ ### item_receipts
 **모델**: `App\Models\Items\ItemReceipt`

 - **item()**: belongsTo → `items`
+- **creator()**: belongsTo → `users`

 ### login_tokens
 **모델**: `App\Models\LoginToken`
@@ -332,10 +374,14 @@ ### orders
 **모델**: `App\Models\Orders\Order`

 - **quote()**: belongsTo → `quotes`
+- **client()**: belongsTo → `clients`
+- **writer()**: belongsTo → `users`
 - **item()**: belongsTo → `items`
 - **items()**: hasMany → `order_items`
 - **histories()**: hasMany → `order_histories`
 - **versions()**: hasMany → `order_versions`
+- **workOrders()**: hasMany → `work_orders`
+- **shipments()**: hasMany → `shipments`

 ### order_historys
 **모델**: `App\Models\Orders\OrderHistory`
@@ -414,6 +460,7 @@ ### work_orders
 **모델**: `App\Models\Production\WorkOrder`

 - **salesOrder()**: belongsTo → `orders`
+- **process()**: belongsTo → `processes`
 - **assignee()**: belongsTo → `users`
 - **team()**: belongsTo → `departments`
 - **creator()**: belongsTo → `users`
@@ -422,6 +469,7 @@ ### work_orders
 - **primaryAssignee()**: hasMany → `work_order_assignees`
 - **items()**: hasMany → `work_order_items`
 - **issues()**: hasMany → `work_order_issues`
+- **shipments()**: hasMany → `shipments`
 - **bendingDetail()**: hasOne → `work_order_bending_details`

 ### work_order_assignees
@@ -509,6 +557,8 @@ ### inspections
 **모델**: `App\Models\Qualitys\Inspection`

 - **item()**: belongsTo → `items`
+- **inspector()**: belongsTo → `users`
+- **creator()**: belongsTo → `users`

 ### lots
 **모델**: `App\Models\Qualitys\Lot`
@@ -527,11 +577,13 @@ ### quotes
 - **client()**: belongsTo → `clients`
 - **item()**: belongsTo → `items`
 - **order()**: belongsTo → `orders`
+- **siteBriefing()**: belongsTo → `site_briefings`
 - **finalizer()**: belongsTo → `users`
 - **creator()**: belongsTo → `users`
 - **updater()**: belongsTo → `users`
 - **items()**: hasMany → `quote_items`
 - **revisions()**: hasMany → `quote_revisions`
+- **orders()**: hasMany → `orders`

 ### quote_formulas
 **모델**: `App\Models\Quote\QuoteFormula`
@@ -774,6 +826,8 @@ ### setting_field_defs
 ### shipments
 **모델**: `App\Models\Tenants\Shipment`

+- **order()**: belongsTo → `orders`
+- **workOrder()**: belongsTo → `work_orders`
 - **creator()**: belongsTo → `users`
 - **updater()**: belongsTo → `users`
 - **items()**: hasMany → `shipment_items`
@@ -791,6 +845,15 @@ ### sites
 - **updater()**: belongsTo → `users`
 - **client()**: belongsTo → `clients`

+### site_briefings
+**모델**: `App\Models\Tenants\SiteBriefing`
+
+- **partner()**: belongsTo → `clients`
+- **site()**: belongsTo → `sites`
+- **creator()**: belongsTo → `users`
+- **updater()**: belongsTo → `users`
+- **quotes()**: hasMany → `quotes`
+
 ### stocks
 **모델**: `App\Models\Tenants\Stock`

--- a/app/Models/Tenants/ExpenseAccount.php
+++ b/app/Models/Tenants/ExpenseAccount.php
@@ -0,0 +1,93 @@
+<?php
+
+namespace App\Models\Tenants;
+
+use App\Models\Orders\Client;
+use App\Traits\BelongsToTenant;
+use App\Traits\ModelTrait;
+use Illuminate\Database\Eloquent\Factories\HasFactory;
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+use Illuminate\Database\Eloquent\SoftDeletes;
+
+/**
+ * 비용 계정 모델
+ *
+ * CEO 대시보드용 비용 데이터 (복리후생비, 접대비 등)
+ */
+class ExpenseAccount extends Model
+{
+    use BelongsToTenant, HasFactory, ModelTrait, SoftDeletes;
+
+    protected $table = 'expense_accounts';
+
+    protected $fillable = [
+        'tenant_id',
+        'account_type',
+        'sub_type',
+        'expense_date',
+        'amount',
+        'description',
+        'receipt_no',
+        'vendor_id',
+        'vendor_name',
+        'payment_method',
+        'card_no',
+        'created_by',
+        'updated_by',
+        'deleted_by',
+    ];
+
+    protected $casts = [
+        'expense_date' => 'date',
+        'amount' => 'decimal:2',
+    ];
+
+    // 계정 유형 상수
+    public const TYPE_WELFARE = 'welfare';
+    public const TYPE_ENTERTAINMENT = 'entertainment';
+    public const TYPE_TRAVEL = 'travel';
+    public const TYPE_OFFICE = 'office';
+
+    // 세부 유형 상수 (복리후생)
+    public const SUB_TYPE_MEAL = 'meal';
+    public const SUB_TYPE_HEALTH = 'health';
+    public const SUB_TYPE_EDUCATION = 'education';
+
+    // 결제 수단 상수
+    public const PAYMENT_CARD = 'card';
+    public const PAYMENT_CASH = 'cash';
+    public const PAYMENT_TRANSFER = 'transfer';
+
+    /**
+     * 거래처 관계
+     */
+    public function vendor(): BelongsTo
+    {
+        return $this->belongsTo(Client::class, 'vendor_id');
+    }
+
+    /**
+     * 복리후생비 스코프
+     */
+    public function scopeWelfare($query)
+    {
+        return $query->where('account_type', self::TYPE_WELFARE);
+    }
+
+    /**
+     * 접대비 스코프
+     */
+    public function scopeEntertainment($query)
+    {
+        return $query->where('account_type', self::TYPE_ENTERTAINMENT);
+    }
+
+    /**
+     * 기간 필터 스코프
+     */
+    public function scopeInPeriod($query, string $startDate, string $endDate)
+    {
+        return $query->whereBetween('expense_date', [$startDate, $endDate]);
+    }
+}
--- a/database/migrations/2026_01_21_103734_create_expense_accounts_table.php
+++ b/database/migrations/2026_01_21_103734_create_expense_accounts_table.php
@@ -0,0 +1,61 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    /**
+     * Run the migrations.
+     */
+    public function up(): void
+    {
+        Schema::create('expense_accounts', function (Blueprint $table) {
+            $table->id();
+            $table->unsignedBigInteger('tenant_id')->comment('테넌트 ID');
+
+            // 비용 유형
+            $table->string('account_type', 50)->comment('계정 유형: welfare, entertainment, etc.');
+            $table->string('sub_type', 50)->nullable()->comment('세부 유형: meal, gift, etc.');
+
+            // 비용 정보
+            $table->date('expense_date')->comment('지출일');
+            $table->decimal('amount', 15, 2)->default(0)->comment('금액');
+            $table->string('description', 500)->nullable()->comment('비용 내역');
+            $table->string('receipt_no', 100)->nullable()->comment('증빙번호');
+
+            // 거래처 정보 (접대비 등에서 사용)
+            $table->unsignedBigInteger('vendor_id')->nullable()->comment('거래처 ID');
+            $table->string('vendor_name', 200)->nullable()->comment('거래처명 (직접 입력)');
+
+            // 카드/결제 정보
+            $table->string('payment_method', 50)->nullable()->comment('결제수단: card, cash, transfer');
+            $table->string('card_no', 50)->nullable()->comment('카드 마지막 4자리');
+
+            // 감사 컬럼
+            $table->unsignedBigInteger('created_by')->nullable()->comment('등록자');
+            $table->unsignedBigInteger('updated_by')->nullable()->comment('수정자');
+            $table->unsignedBigInteger('deleted_by')->nullable()->comment('삭제자');
+
+            $table->timestamps();
+            $table->softDeletes();
+
+            // 인덱스
+            $table->index(['tenant_id', 'account_type', 'expense_date']);
+            $table->index(['tenant_id', 'expense_date']);
+
+            // 외래키
+            $table->foreign('tenant_id')->references('id')->on('tenants')->onDelete('cascade');
+            $table->foreign('vendor_id')->references('id')->on('clients')->onDelete('set null');
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        Schema::dropIfExists('expense_accounts');
+    }
+};