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