- AttendanceController, AttendanceService 추가 - EmployeeController, EmployeeService 추가 - Attendance 모델 및 마이그레이션 추가 - TenantUserProfile에 employee_status 컬럼 추가 - DepartmentService 트리 조회 기능 개선 - Swagger 문서 추가 (AttendanceApi, EmployeeApi) - API 라우트 등록
73 lines
2.9 KiB
PHP
73 lines
2.9 KiB
PHP
<?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('attendances', function (Blueprint $table) {
|
|
$table->id();
|
|
|
|
// 인덱싱 필요 필드 (컬럼)
|
|
$table->unsignedBigInteger('tenant_id')->comment('테넌트 ID');
|
|
$table->unsignedBigInteger('user_id')->comment('사용자 ID');
|
|
$table->date('base_date')->comment('기준일');
|
|
$table->enum('status', [
|
|
'onTime', // 정시 출근
|
|
'late', // 지각
|
|
'absent', // 결근
|
|
'vacation', // 휴가
|
|
'businessTrip', // 출장
|
|
'fieldWork', // 외근
|
|
'overtime', // 야근
|
|
'remote', // 재택
|
|
])->default('onTime')->comment('근태 상태');
|
|
|
|
// 확장 가능한 상세 정보 (JSON)
|
|
// {
|
|
// "check_in": "09:00:00",
|
|
// "check_out": "18:00:00",
|
|
// "break_time": "01:00",
|
|
// "overtime_hours": "02:00",
|
|
// "reason": { "type": "vacationRequest", "label": "연차", "document_id": "DOC-001" },
|
|
// "gps_data": { "check_in_location": {...}, "check_out_location": {...}, "is_auto_checked": true },
|
|
// "external_work": { "type": "dispatch", "location": "협력사 A", "company": "ABC Corp" },
|
|
// "multiple_entries": [{ "in": "09:00", "out": "12:00" }, { "in": "13:00", "out": "18:00" }]
|
|
// }
|
|
$table->json('json_details')->nullable()->comment('출퇴근 상세 정보 (JSON)');
|
|
|
|
// 감사 로그
|
|
$table->unsignedBigInteger('created_by')->nullable()->comment('생성자 ID');
|
|
$table->unsignedBigInteger('updated_by')->nullable()->comment('수정자 ID');
|
|
$table->unsignedBigInteger('deleted_by')->nullable()->comment('삭제자 ID');
|
|
$table->timestamps();
|
|
$table->softDeletes();
|
|
|
|
// 외래 키
|
|
$table->foreign('tenant_id')->references('id')->on('tenants')->onDelete('cascade');
|
|
$table->foreign('user_id')->references('id')->on('users')->onDelete('cascade');
|
|
|
|
// 유니크 제약: 같은 테넌트/사용자/날짜에 하나의 근태 레코드만 허용
|
|
$table->unique(['tenant_id', 'user_id', 'base_date'], 'uq_attendance_user_date');
|
|
|
|
// 인덱스
|
|
$table->index(['tenant_id', 'base_date', 'status'], 'idx_attendance_tenant_date_status');
|
|
$table->index(['tenant_id', 'user_id'], 'idx_attendance_tenant_user');
|
|
});
|
|
}
|
|
|
|
/**
|
|
* Reverse the migrations.
|
|
*/
|
|
public function down(): void
|
|
{
|
|
Schema::dropIfExists('attendances');
|
|
}
|
|
};
|