feat: [품질관리] 백엔드 API 구현 - 품질관리서 + 실적신고

- 품질관리서(quality_documents) CRUD API 14개 엔드포인트 - 실적신고(performance_reports) 관리 API 6개 엔드포인트 - DB 마이그레이션 4개 테이블 (quality_documents, quality_document_orders, quality_document_locations, performance_reports) - 모델 4개 + 서비스 2개 + 컨트롤러 2개 + FormRequest 4개 - stats() ambiguous column 버그 수정 (JOIN 시 테이블 접두사 추가) - missing() status_code 컬럼명/값 수정 Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-05 20:29:39 +09:00
parent 0aa0a8592d
commit a6e29bc1f3
19 changed files with 1807 additions and 0 deletions
--- a/app/Models/Qualitys/PerformanceReport.php
+++ b/app/Models/Qualitys/PerformanceReport.php
@@ -0,0 +1,76 @@
+<?php
+
+namespace App\Models\Qualitys;
+
+use App\Models\Members\User;
+use App\Traits\Auditable;
+use App\Traits\BelongsToTenant;
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\SoftDeletes;
+
+class PerformanceReport extends Model
+{
+    use Auditable, BelongsToTenant, SoftDeletes;
+
+    protected $table = 'performance_reports';
+
+    const STATUS_UNCONFIRMED = 'unconfirmed';
+
+    const STATUS_CONFIRMED = 'confirmed';
+
+    const STATUS_REPORTED = 'reported';
+
+    protected $fillable = [
+        'tenant_id',
+        'quality_document_id',
+        'year',
+        'quarter',
+        'confirmation_status',
+        'confirmed_date',
+        'confirmed_by',
+        'memo',
+        'created_by',
+        'updated_by',
+        'deleted_by',
+    ];
+
+    protected $casts = [
+        'confirmed_date' => 'date',
+        'year' => 'integer',
+        'quarter' => 'integer',
+    ];
+
+    // ===== Relationships =====
+
+    public function qualityDocument()
+    {
+        return $this->belongsTo(QualityDocument::class);
+    }
+
+    public function confirmer()
+    {
+        return $this->belongsTo(User::class, 'confirmed_by');
+    }
+
+    public function creator()
+    {
+        return $this->belongsTo(User::class, 'created_by');
+    }
+
+    // ===== Status Helpers =====
+
+    public function isUnconfirmed(): bool
+    {
+        return $this->confirmation_status === self::STATUS_UNCONFIRMED;
+    }
+
+    public function isConfirmed(): bool
+    {
+        return $this->confirmation_status === self::STATUS_CONFIRMED;
+    }
+
+    public function isReported(): bool
+    {
+        return $this->confirmation_status === self::STATUS_REPORTED;
+    }
+}
--- a/app/Models/Qualitys/QualityDocument.php
+++ b/app/Models/Qualitys/QualityDocument.php
@@ -0,0 +1,131 @@
+<?php
+
+namespace App\Models\Qualitys;
+
+use App\Models\Members\User;
+use App\Models\Orders\Client;
+use App\Traits\Auditable;
+use App\Traits\BelongsToTenant;
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\SoftDeletes;
+
+class QualityDocument extends Model
+{
+    use Auditable, BelongsToTenant, SoftDeletes;
+
+    protected $table = 'quality_documents';
+
+    const STATUS_RECEIVED = 'received';
+
+    const STATUS_IN_PROGRESS = 'in_progress';
+
+    const STATUS_COMPLETED = 'completed';
+
+    protected $fillable = [
+        'tenant_id',
+        'quality_doc_number',
+        'site_name',
+        'status',
+        'client_id',
+        'inspector_id',
+        'received_date',
+        'options',
+        'created_by',
+        'updated_by',
+        'deleted_by',
+    ];
+
+    protected $casts = [
+        'options' => 'array',
+        'received_date' => 'date',
+    ];
+
+    // ===== Relationships =====
+
+    public function client()
+    {
+        return $this->belongsTo(Client::class, 'client_id');
+    }
+
+    public function inspector()
+    {
+        return $this->belongsTo(User::class, 'inspector_id');
+    }
+
+    public function creator()
+    {
+        return $this->belongsTo(User::class, 'created_by');
+    }
+
+    public function documentOrders()
+    {
+        return $this->hasMany(QualityDocumentOrder::class);
+    }
+
+    public function locations()
+    {
+        return $this->hasMany(QualityDocumentLocation::class);
+    }
+
+    public function performanceReport()
+    {
+        return $this->hasOne(PerformanceReport::class);
+    }
+
+    // ===== 채번 =====
+
+    public static function generateDocNumber(int $tenantId): string
+    {
+        $prefix = 'KD-QD';
+        $yearMonth = now()->format('Ym');
+
+        $lastNo = static::withoutGlobalScopes()
+            ->where('tenant_id', $tenantId)
+            ->where('quality_doc_number', 'like', "{$prefix}-{$yearMonth}-%")
+            ->orderByDesc('quality_doc_number')
+            ->value('quality_doc_number');
+
+        if ($lastNo) {
+            $seq = (int) substr($lastNo, -4) + 1;
+        } else {
+            $seq = 1;
+        }
+
+        return sprintf('%s-%s-%04d', $prefix, $yearMonth, $seq);
+    }
+
+    // ===== Status Helpers =====
+
+    public function isReceived(): bool
+    {
+        return $this->status === self::STATUS_RECEIVED;
+    }
+
+    public function isInProgress(): bool
+    {
+        return $this->status === self::STATUS_IN_PROGRESS;
+    }
+
+    public function isCompleted(): bool
+    {
+        return $this->status === self::STATUS_COMPLETED;
+    }
+
+    public static function mapStatusToFrontend(string $status): string
+    {
+        return match ($status) {
+            self::STATUS_RECEIVED => 'reception',
+            self::STATUS_IN_PROGRESS => 'in_progress',
+            self::STATUS_COMPLETED => 'completed',
+            default => $status,
+        };
+    }
+
+    public static function mapStatusFromFrontend(string $status): string
+    {
+        return match ($status) {
+            'reception' => self::STATUS_RECEIVED,
+            default => $status,
+        };
+    }
+}
--- a/app/Models/Qualitys/QualityDocumentLocation.php
+++ b/app/Models/Qualitys/QualityDocumentLocation.php
@@ -0,0 +1,57 @@
+<?php
+
+namespace App\Models\Qualitys;
+
+use App\Models\Documents\Document;
+use App\Models\Orders\OrderItem;
+use Illuminate\Database\Eloquent\Model;
+
+class QualityDocumentLocation extends Model
+{
+    protected $table = 'quality_document_locations';
+
+    const STATUS_PENDING = 'pending';
+
+    const STATUS_COMPLETED = 'completed';
+
+    protected $fillable = [
+        'quality_document_id',
+        'quality_document_order_id',
+        'order_item_id',
+        'post_width',
+        'post_height',
+        'change_reason',
+        'document_id',
+        'inspection_status',
+    ];
+
+    public function qualityDocument()
+    {
+        return $this->belongsTo(QualityDocument::class);
+    }
+
+    public function qualityDocumentOrder()
+    {
+        return $this->belongsTo(QualityDocumentOrder::class);
+    }
+
+    public function orderItem()
+    {
+        return $this->belongsTo(OrderItem::class);
+    }
+
+    public function document()
+    {
+        return $this->belongsTo(Document::class);
+    }
+
+    public function isPending(): bool
+    {
+        return $this->inspection_status === self::STATUS_PENDING;
+    }
+
+    public function isCompleted(): bool
+    {
+        return $this->inspection_status === self::STATUS_COMPLETED;
+    }
+}
--- a/app/Models/Qualitys/QualityDocumentOrder.php
+++ b/app/Models/Qualitys/QualityDocumentOrder.php
@@ -0,0 +1,31 @@
+<?php
+
+namespace App\Models\Qualitys;
+
+use App\Models\Orders\Order;
+use Illuminate\Database\Eloquent\Model;
+
+class QualityDocumentOrder extends Model
+{
+    protected $table = 'quality_document_orders';
+
+    protected $fillable = [
+        'quality_document_id',
+        'order_id',
+    ];
+
+    public function qualityDocument()
+    {
+        return $this->belongsTo(QualityDocument::class);
+    }
+
+    public function order()
+    {
+        return $this->belongsTo(Order::class);
+    }
+
+    public function locations()
+    {
+        return $this->hasMany(QualityDocumentLocation::class);
+    }
+}