feat: [품질관리] 품질관리서/실적신고/검사 API

- QualityDocument CRUD + 수주 연결 + 개소별 데이터 저장
- PerformanceReport 실적신고 확인/메모 API
- Inspection 검사 설정 + product_code 전파 수정
- 수주선택 API에 client_name 필드 추가
- 절곡 검사 프로파일 분리 (S1/S2/S3)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

app/Models/Qualitys/Inspection.php

@@ -4,6 +4,7 @@
 
 use App\Models\Items\Item;
 use App\Models\Members\User;
+use App\Models\Production\WorkOrder;
 use App\Traits\Auditable;
 use App\Traits\BelongsToTenant;
 use Illuminate\Database\Eloquent\Casts\Attribute;
@@ -23,6 +24,7 @@
  * @property string|null $inspection_date 검사일
  * @property int|null $item_id 품목 ID
  * @property string $lot_no LOT번호
+ * @property int|null $work_order_id 작업지시 ID (PQC/FQC용)
  * @property int|null $inspector_id 검사자 ID
  * @property array|null $meta 메타정보 (process_name, quantity, unit 등)
  * @property array|null $items 검사항목 배열
@@ -47,6 +49,7 @@ class Inspection extends Model
         'inspection_date',
         'item_id',
         'lot_no',
+        'work_order_id',
         'inspector_id',
         'meta',
         'items',
@@ -92,6 +95,14 @@ class Inspection extends Model
 
     // ===== Relationships =====
 
+    /**
+     * 작업지시 (PQC/FQC용)
+     */
+    public function workOrder()
+    {
+        return $this->belongsTo(WorkOrder::class);
+    }
+
     /**
      * 품목
      */

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;
+    }
+}

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,
+        };
+    }
+}

app/Models/Qualitys/QualityDocumentLocation.php

@@ -0,0 +1,62 @@
+<?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',
+        'inspection_data',
+        'document_id',
+        'inspection_status',
+    ];
+
+    protected $casts = [
+        'inspection_data' => 'array',
+    ];
+
+    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;
+    }
+}

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);
+    }
+}