Skip to content

Commit ba020a4

Browse files
claudeclaude
committed
feat(hr): Phase 104 — Employee Document Management
https://claude.ai/code/session_01RdUGwo74JXChRCF88Yu27d
1 parent 0d9f25f commit ba020a4

10 files changed

Lines changed: 376 additions & 0 deletions

File tree

‎erp/app/Modules/HR/Http/Controllers/EmployeeDocumentController.php‎

Lines changed: 80 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,80 @@
1+
<?php
2+
3+
namespace App\Modules\HR\Http\Controllers;
4+
5+
use App\Http\Controllers\Controller;
6+
use App\Modules\HR\Models\Employee;
7+
use App\Modules\HR\Models\EmployeeDocument;
8+
use Illuminate\Http\RedirectResponse;
9+
use Illuminate\Http\Request;
10+
use Inertia\Inertia;
11+
use Inertia\Response;
12+
13+
class EmployeeDocumentController extends Controller
14+
{
15+
public function index(Request $request): Response
16+
{
17+
$this->authorize('viewAny', EmployeeDocument::class);
18+
19+
$documents = EmployeeDocument::with('employee')
20+
->when($request->employee_id, fn ($q) => $q->where('employee_id', $request->employee_id))
21+
->when($request->document_type, fn ($q) => $q->where('document_type', $request->document_type))
22+
->latest()
23+
->paginate(20)
24+
->withQueryString();
25+
26+
return Inertia::render('HR/EmployeeDocuments/Index', [
27+
'documents' => $documents,
28+
'filters' => $request->only(['employee_id', 'document_type']),
29+
]);
30+
}
31+
32+
public function store(Request $request): RedirectResponse
33+
{
34+
$this->authorize('create', EmployeeDocument::class);
35+
36+
$validated = $request->validate([
37+
'employee_id' => 'required|exists:employees,id',
38+
'document_type' => 'required|string|max:50',
39+
'document_name' => 'required|string|max:255',
40+
'document_number' => 'nullable|string|max:100',
41+
'file_url' => 'nullable|string|max:500',
42+
'issued_date' => 'nullable|date',
43+
'expiry_date' => 'nullable|date',
44+
'notes' => 'nullable|string',
45+
]);
46+
47+
EmployeeDocument::create([
48+
'tenant_id' => auth()->user()->tenant_id,
49+
...$validated,
50+
]);
51+
52+
return back()->with('success', 'Document added.');
53+
}
54+
55+
public function show(EmployeeDocument $employeeDocument): Response
56+
{
57+
$this->authorize('view', $employeeDocument);
58+
$employeeDocument->load(['employee', 'verifiedBy']);
59+
60+
return Inertia::render('HR/EmployeeDocuments/Show', [
61+
'document' => $employeeDocument,
62+
]);
63+
}
64+
65+
public function verify(EmployeeDocument $employeeDocument): RedirectResponse
66+
{
67+
$this->authorize('update', $employeeDocument);
68+
$employeeDocument->verify(auth()->id());
69+
70+
return back()->with('success', 'Document verified.');
71+
}
72+
73+
public function destroy(EmployeeDocument $employeeDocument): RedirectResponse
74+
{
75+
$this->authorize('delete', $employeeDocument);
76+
$employeeDocument->delete();
77+
78+
return back()->with('success', 'Document deleted.');
79+
}
80+
}

‎erp/app/Modules/HR/Models/EmployeeDocument.php‎

Lines changed: 57 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,57 @@
1+
<?php
2+
3+
namespace App\Modules\HR\Models;
4+
5+
use App\Models\User;
6+
use App\Modules\Core\Traits\BelongsToTenant;
7+
use Illuminate\Database\Eloquent\Model;
8+
use Illuminate\Database\Eloquent\Relations\BelongsTo;
9+
use Illuminate\Database\Eloquent\SoftDeletes;
10+
11+
class EmployeeDocument extends Model
12+
{
13+
use BelongsToTenant, SoftDeletes;
14+
15+
protected $fillable = [
16+
'tenant_id', 'employee_id', 'document_type', 'document_name',
17+
'document_number', 'file_url', 'issued_date', 'expiry_date',
18+
'is_verified', 'verified_by', 'verified_at', 'notes',
19+
];
20+
21+
protected $casts = [
22+
'issued_date' => 'date',
23+
'expiry_date' => 'date',
24+
'is_verified' => 'boolean',
25+
'verified_at' => 'datetime',
26+
];
27+
28+
public function employee(): BelongsTo
29+
{
30+
return $this->belongsTo(Employee::class);
31+
}
32+
33+
public function verifiedBy(): BelongsTo
34+
{
35+
return $this->belongsTo(User::class, 'verified_by');
36+
}
37+
38+
public function verify(int $userId): void
39+
{
40+
$this->is_verified = true;
41+
$this->verified_by = $userId;
42+
$this->verified_at = now();
43+
$this->save();
44+
}
45+
46+
public function getIsExpiredAttribute(): bool
47+
{
48+
return $this->expiry_date !== null && $this->expiry_date->isPast();
49+
}
50+
51+
public function getIsExpiringSoonAttribute(): bool
52+
{
53+
return $this->expiry_date !== null
54+
&& ! $this->expiry_date->isPast()
55+
&& $this->expiry_date->diffInDays(now()) <= 30;
56+
}
57+
}

‎erp/app/Modules/HR/Policies/EmployeeDocumentPolicy.php‎

Lines changed: 33 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,33 @@
1+
<?php
2+
3+
namespace App\Modules\HR\Policies;
4+
5+
use App\Models\User;
6+
7+
class EmployeeDocumentPolicy
8+
{
9+
public function viewAny(User $user): bool
10+
{
11+
return $user->hasPermissionTo('hr.view');
12+
}
13+
14+
public function view(User $user, $model): bool
15+
{
16+
return $user->hasPermissionTo('hr.view');
17+
}
18+
19+
public function create(User $user): bool
20+
{
21+
return $user->hasPermissionTo('hr.create');
22+
}
23+
24+
public function update(User $user, $model): bool
25+
{
26+
return $user->hasPermissionTo('hr.create');
27+
}
28+
29+
public function delete(User $user, $model): bool
30+
{
31+
return $user->hasPermissionTo('hr.delete');
32+
}
33+
}

‎erp/app/Modules/HR/Providers/HRServiceProvider.php‎

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -59,6 +59,8 @@
5959
use App\Modules\HR\Models\WorkScheduleShift;
6060
use App\Modules\HR\Models\EmployeeSchedule;
6161
use App\Modules\HR\Policies\WorkSchedulePolicy;
62+
use App\Modules\HR\Models\EmployeeDocument;
63+
use App\Modules\HR\Policies\EmployeeDocumentPolicy;
6264
use Illuminate\Support\Facades\Gate;
6365
use Illuminate\Support\ServiceProvider;
6466

@@ -107,5 +109,6 @@ public function boot(): void
107109
Gate::policy(WorkSchedule::class, WorkSchedulePolicy::class);
108110
Gate::policy(WorkScheduleShift::class, WorkSchedulePolicy::class);
109111
Gate::policy(EmployeeSchedule::class, WorkSchedulePolicy::class);
112+
Gate::policy(EmployeeDocument::class, EmployeeDocumentPolicy::class);
110113
}
111114
}

‎erp/app/Modules/HR/routes/hr.php‎

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -204,3 +204,10 @@
204204
Route::post('work-schedules/{workSchedule}/shifts', [WorkScheduleController::class, 'addShift'])->name('work-schedules.shifts.store');
205205
Route::resource('employee-schedules', EmployeeScheduleController::class)->only(['index', 'store', 'destroy']);
206206
});
207+
208+
// Employee Documents
209+
use App\Modules\HR\Http\Controllers\EmployeeDocumentController;
210+
Route::middleware(['web', 'auth', 'verified'])->prefix('hr')->name('hr.')->group(function () {
211+
Route::post('employee-documents/{employeeDocument}/verify', [EmployeeDocumentController::class, 'verify'])->name('employee-documents.verify');
212+
Route::resource('employee-documents', EmployeeDocumentController::class)->only(['index', 'store', 'show', 'destroy']);
213+
});

‎erp/database/migrations/2026_08_03_100001_create_employee_documents_table.php‎

Lines changed: 34 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,34 @@
1+
<?php
2+
3+
use Illuminate\Database\Migrations\Migration;
4+
use Illuminate\Database\Schema\Blueprint;
5+
use Illuminate\Support\Facades\Schema;
6+
7+
return new class extends Migration
8+
{
9+
public function up(): void
10+
{
11+
Schema::create('employee_documents', function (Blueprint $table) {
12+
$table->id();
13+
$table->unsignedBigInteger('tenant_id');
14+
$table->unsignedBigInteger('employee_id');
15+
$table->string('document_type'); // contract, id, passport, permit, certificate, other
16+
$table->string('document_name');
17+
$table->string('document_number')->nullable();
18+
$table->string('file_url')->nullable();
19+
$table->date('issued_date')->nullable();
20+
$table->date('expiry_date')->nullable();
21+
$table->boolean('is_verified')->default(false);
22+
$table->unsignedBigInteger('verified_by')->nullable();
23+
$table->timestamp('verified_at')->nullable();
24+
$table->text('notes')->nullable();
25+
$table->timestamps();
26+
$table->softDeletes();
27+
});
28+
}
29+
30+
public function down(): void
31+
{
32+
Schema::dropIfExists('employee_documents');
33+
}
34+
};

‎erp/resources/js/Pages/HR/EmployeeDocuments/Index.tsx‎

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
1+
import React from 'react';
2+
3+
export default function EmployeeDocumentsIndex() {
4+
return <div>Employee Documents</div>;
5+
}

‎erp/resources/js/Pages/HR/EmployeeDocuments/Show.tsx‎

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
1+
import React from 'react';
2+
3+
export default function EmployeeDocumentShow() {
4+
return <div>Employee Document</div>;
5+
}

‎erp/resources/js/types/hr.ts‎

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -691,3 +691,18 @@ export interface PerformanceReviewPhase96 {
691691
employee?: Employee;
692692
ratings?: ReviewRating[];
693693
}
694+
695+
export interface EmployeeDocument {
696+
id: number;
697+
employee_id: number;
698+
document_type: string;
699+
document_name: string;
700+
document_number: string | null;
701+
file_url: string | null;
702+
issued_date: string | null;
703+
expiry_date: string | null;
704+
is_verified: boolean;
705+
is_expired: boolean;
706+
is_expiring_soon: boolean;
707+
employee?: Employee;
708+
}

0 commit comments

Comments
 (0)