feat: G-2 작업실적 관리 API 구현
- WorkResult 모델 생성 (Production 네임스페이스)
- WorkResultService 서비스 구현 (CRUD + 통계 + 토글)
- WorkResultController 컨트롤러 생성 (8개 엔드포인트)
- FormRequest 검증 클래스 (Store/Update)
- Swagger 문서 작성 (WorkResultApi.php)
- 라우트 추가 (/api/v1/work-results)
- i18n 메시지 추가 (work_result 키)
API Endpoints:
- GET /work-results - 목록 조회 (페이징, 필터링)
- GET /work-results/stats - 통계 조회
- GET /work-results/{id} - 상세 조회
- POST /work-results - 등록
- PUT /work-results/{id} - 수정
- DELETE /work-results/{id} - 삭제
- PATCH /work-results/{id}/inspection - 검사 상태 토글
- PATCH /work-results/{id}/packaging - 포장 상태 토글
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
242
app/Models/Production/WorkResult.php
Normal file
242
app/Models/Production/WorkResult.php
Normal file
@@ -0,0 +1,242 @@
|
||||
<?php
|
||||
|
||||
namespace App\Models\Production;
|
||||
|
||||
use App\Models\Members\User;
|
||||
use App\Traits\BelongsToTenant;
|
||||
use App\Traits\ModelTrait;
|
||||
use Illuminate\Database\Eloquent\Model;
|
||||
use Illuminate\Database\Eloquent\Relations\BelongsTo;
|
||||
use Illuminate\Database\Eloquent\SoftDeletes;
|
||||
|
||||
/**
|
||||
* 작업실적 모델
|
||||
*
|
||||
* 생산 작업의 실적을 기록하고 추적하는 엔티티
|
||||
*/
|
||||
class WorkResult extends Model
|
||||
{
|
||||
use BelongsToTenant, ModelTrait, SoftDeletes;
|
||||
|
||||
protected $table = 'work_results';
|
||||
|
||||
protected $fillable = [
|
||||
'tenant_id',
|
||||
'work_order_id',
|
||||
'work_order_item_id',
|
||||
'lot_no',
|
||||
'work_date',
|
||||
'process_type',
|
||||
'product_name',
|
||||
'specification',
|
||||
'production_qty',
|
||||
'good_qty',
|
||||
'defect_qty',
|
||||
'defect_rate',
|
||||
'is_inspected',
|
||||
'is_packaged',
|
||||
'worker_id',
|
||||
'memo',
|
||||
'created_by',
|
||||
'updated_by',
|
||||
];
|
||||
|
||||
protected $casts = [
|
||||
'work_date' => 'date',
|
||||
'production_qty' => 'integer',
|
||||
'good_qty' => 'integer',
|
||||
'defect_qty' => 'integer',
|
||||
'defect_rate' => 'decimal:2',
|
||||
'is_inspected' => 'boolean',
|
||||
'is_packaged' => 'boolean',
|
||||
];
|
||||
|
||||
protected $hidden = [
|
||||
'deleted_at',
|
||||
];
|
||||
|
||||
// ──────────────────────────────────────────────────────────────
|
||||
// 상수
|
||||
// ──────────────────────────────────────────────────────────────
|
||||
|
||||
/**
|
||||
* 공정 유형 (WorkOrder와 동일)
|
||||
*/
|
||||
public const PROCESS_SCREEN = 'screen';
|
||||
|
||||
public const PROCESS_SLAT = 'slat';
|
||||
|
||||
public const PROCESS_BENDING = 'bending';
|
||||
|
||||
public const PROCESS_TYPES = [
|
||||
self::PROCESS_SCREEN,
|
||||
self::PROCESS_SLAT,
|
||||
self::PROCESS_BENDING,
|
||||
];
|
||||
|
||||
// ──────────────────────────────────────────────────────────────
|
||||
// 관계
|
||||
// ──────────────────────────────────────────────────────────────
|
||||
|
||||
/**
|
||||
* 작업지시
|
||||
*/
|
||||
public function workOrder(): BelongsTo
|
||||
{
|
||||
return $this->belongsTo(WorkOrder::class);
|
||||
}
|
||||
|
||||
/**
|
||||
* 작업지시 품목
|
||||
*/
|
||||
public function workOrderItem(): BelongsTo
|
||||
{
|
||||
return $this->belongsTo(WorkOrderItem::class);
|
||||
}
|
||||
|
||||
/**
|
||||
* 작업자
|
||||
*/
|
||||
public function worker(): BelongsTo
|
||||
{
|
||||
return $this->belongsTo(User::class, 'worker_id');
|
||||
}
|
||||
|
||||
/**
|
||||
* 생성자
|
||||
*/
|
||||
public function creator(): BelongsTo
|
||||
{
|
||||
return $this->belongsTo(User::class, 'created_by');
|
||||
}
|
||||
|
||||
/**
|
||||
* 수정자
|
||||
*/
|
||||
public function updater(): BelongsTo
|
||||
{
|
||||
return $this->belongsTo(User::class, 'updated_by');
|
||||
}
|
||||
|
||||
// ──────────────────────────────────────────────────────────────
|
||||
// 스코프
|
||||
// ──────────────────────────────────────────────────────────────
|
||||
|
||||
/**
|
||||
* 공정유형별 필터
|
||||
*/
|
||||
public function scopeProcessType($query, string $type)
|
||||
{
|
||||
return $query->where('process_type', $type);
|
||||
}
|
||||
|
||||
/**
|
||||
* 작업일 범위 필터
|
||||
*/
|
||||
public function scopeWorkDateBetween($query, $from, $to)
|
||||
{
|
||||
return $query->whereBetween('work_date', [$from, $to]);
|
||||
}
|
||||
|
||||
/**
|
||||
* 작업지시별 필터
|
||||
*/
|
||||
public function scopeWorkOrder($query, int $workOrderId)
|
||||
{
|
||||
return $query->where('work_order_id', $workOrderId);
|
||||
}
|
||||
|
||||
/**
|
||||
* 작업자별 필터
|
||||
*/
|
||||
public function scopeWorker($query, int $workerId)
|
||||
{
|
||||
return $query->where('worker_id', $workerId);
|
||||
}
|
||||
|
||||
/**
|
||||
* 검사 완료 필터
|
||||
*/
|
||||
public function scopeInspected($query)
|
||||
{
|
||||
return $query->where('is_inspected', true);
|
||||
}
|
||||
|
||||
/**
|
||||
* 포장 완료 필터
|
||||
*/
|
||||
public function scopePackaged($query)
|
||||
{
|
||||
return $query->where('is_packaged', true);
|
||||
}
|
||||
|
||||
/**
|
||||
* 불량 있음
|
||||
*/
|
||||
public function scopeHasDefects($query)
|
||||
{
|
||||
return $query->where('defect_qty', '>', 0);
|
||||
}
|
||||
|
||||
// ──────────────────────────────────────────────────────────────
|
||||
// 헬퍼 메서드
|
||||
// ──────────────────────────────────────────────────────────────
|
||||
|
||||
/**
|
||||
* 불량률 계산
|
||||
*/
|
||||
public function calculateDefectRate(): float
|
||||
{
|
||||
if ($this->production_qty <= 0) {
|
||||
return 0;
|
||||
}
|
||||
|
||||
return round(($this->defect_qty / $this->production_qty) * 100, 2);
|
||||
}
|
||||
|
||||
/**
|
||||
* 불량률 업데이트
|
||||
*/
|
||||
public function updateDefectRate(): void
|
||||
{
|
||||
$this->defect_rate = $this->calculateDefectRate();
|
||||
}
|
||||
|
||||
/**
|
||||
* 양품수량 자동 계산 및 설정
|
||||
*/
|
||||
public function calculateGoodQty(): int
|
||||
{
|
||||
return max(0, $this->production_qty - $this->defect_qty);
|
||||
}
|
||||
|
||||
/**
|
||||
* 불량이 있는지 확인
|
||||
*/
|
||||
public function hasDefects(): bool
|
||||
{
|
||||
return $this->defect_qty > 0;
|
||||
}
|
||||
|
||||
/**
|
||||
* 검사 및 포장 모두 완료인지 확인
|
||||
*/
|
||||
public function isFullyProcessed(): bool
|
||||
{
|
||||
return $this->is_inspected && $this->is_packaged;
|
||||
}
|
||||
|
||||
// ──────────────────────────────────────────────────────────────
|
||||
// 부팅
|
||||
// ──────────────────────────────────────────────────────────────
|
||||
|
||||
protected static function boot()
|
||||
{
|
||||
parent::boot();
|
||||
|
||||
// 저장 전 불량률 자동 계산
|
||||
static::saving(function (WorkResult $model) {
|
||||
$model->updateDefectRate();
|
||||
});
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user