diff --git a/resources/views/livewire/admin/clients/individual/index.blade.php b/resources/views/livewire/admin/clients/individual/index.blade.php
index 0327560..1b2370d 100644
--- a/resources/views/livewire/admin/clients/individual/index.blade.php
+++ b/resources/views/livewire/admin/clients/individual/index.blade.php
@@ -57,9 +57,14 @@ new class extends Component {
{{ __('clients.individual_clients') }}
{{ __('clients.clients') }}
-
diff --git a/resources/views/livewire/admin/users/export-users.blade.php b/resources/views/livewire/admin/users/export-users.blade.php
new file mode 100644
index 0000000..dae400d
--- /dev/null
+++ b/resources/views/livewire/admin/users/export-users.blade.php
@@ -0,0 +1,253 @@
+getFilteredUsers()->count();
+
+ if ($count === 0) {
+ $this->dispatch('notify', type: 'info', message: __('export.no_users_match'));
+
+ return null;
+ }
+
+ $locale = auth()->user()->preferred_language ?? 'ar';
+
+ return response()->streamDownload(function () use ($locale) {
+ // UTF-8 BOM for Excel Arabic support
+ echo "\xEF\xBB\xBF";
+
+ $csv = Writer::createFromString();
+
+ // Headers based on admin language
+ $csv->insertOne([
+ __('export.name', [], $locale),
+ __('export.email', [], $locale),
+ __('export.phone', [], $locale),
+ __('export.user_type', [], $locale),
+ __('export.id_number', [], $locale),
+ __('export.status', [], $locale),
+ __('export.created_at', [], $locale),
+ ]);
+
+ $this->getFilteredUsers()->cursor()->each(function ($user) use ($csv, $locale) {
+ $csv->insertOne([
+ $user->user_type === UserType::Company ? $user->company_name : $user->full_name,
+ $user->email,
+ $user->phone,
+ __('export.type_'.$user->user_type->value, [], $locale),
+ $user->user_type === UserType::Company ? $user->company_cert_number : $user->national_id,
+ __('export.status_'.$user->status->value, [], $locale),
+ $user->created_at->format($locale === 'ar' ? 'd/m/Y' : 'm/d/Y'),
+ ]);
+ });
+
+ echo $csv->toString();
+ }, 'users-export-'.now()->format('Y-m-d').'.csv', [
+ 'Content-Type' => 'text/csv; charset=UTF-8',
+ ]);
+ }
+
+ public function exportPdf(): ?StreamedResponse
+ {
+ $users = $this->getFilteredUsers()->get();
+
+ if ($users->isEmpty()) {
+ $this->dispatch('notify', type: 'info', message: __('export.no_users_match'));
+
+ return null;
+ }
+
+ if ($users->count() > 500) {
+ $this->dispatch('notify', type: 'warning', message: __('export.large_export_warning'));
+ }
+
+ $locale = auth()->user()->preferred_language ?? 'ar';
+
+ $pdf = Pdf::loadView('pdf.users-export', [
+ 'users' => $users,
+ 'locale' => $locale,
+ 'generatedAt' => now(),
+ 'filters' => $this->getActiveFilters(),
+ 'totalCount' => $users->count(),
+ ]);
+
+ $pdf->setOption('isHtml5ParserEnabled', true);
+ $pdf->setOption('defaultFont', 'DejaVu Sans');
+
+ return response()->streamDownload(
+ fn () => print($pdf->output()),
+ 'users-export-'.now()->format('Y-m-d').'.pdf'
+ );
+ }
+
+ public function clearFilters(): void
+ {
+ $this->userType = 'all';
+ $this->status = 'all';
+ $this->dateFrom = '';
+ $this->dateTo = '';
+ }
+
+ public function with(): array
+ {
+ return [
+ 'userTypes' => [
+ 'all' => __('export.all_types'),
+ 'individual' => __('export.type_individual'),
+ 'company' => __('export.type_company'),
+ ],
+ 'statuses' => [
+ 'all' => __('export.all_statuses'),
+ 'active' => __('export.status_active'),
+ 'deactivated' => __('export.status_deactivated'),
+ ],
+ 'previewCount' => $this->getFilteredUsers()->count(),
+ ];
+ }
+
+ private function getFilteredUsers()
+ {
+ return User::query()
+ ->when($this->userType !== 'all', fn ($q) => $q->where('user_type', $this->userType))
+ ->when($this->status !== 'all', fn ($q) => $q->where('status', $this->status))
+ ->when($this->dateFrom, fn ($q) => $q->whereDate('created_at', '>=', $this->dateFrom))
+ ->when($this->dateTo, fn ($q) => $q->whereDate('created_at', '<=', $this->dateTo))
+ ->whereIn('user_type', [UserType::Individual, UserType::Company])
+ ->orderBy('created_at', 'desc');
+ }
+
+ private function getActiveFilters(): array
+ {
+ $filters = [];
+
+ if ($this->userType !== 'all') {
+ $filters['user_type'] = __('export.type_'.$this->userType);
+ }
+
+ if ($this->status !== 'all') {
+ $filters['status'] = __('export.status_'.$this->status);
+ }
+
+ if ($this->dateFrom) {
+ $filters['date_from'] = $this->dateFrom;
+ }
+
+ if ($this->dateTo) {
+ $filters['date_to'] = $this->dateTo;
+ }
+
+ return $filters;
+ }
+}; ?>
+
+
+
+
+ {{ __('export.export_users') }}
+ {{ __('export.export_users_description') }}
+
+
+
+
+
{{ __('export.filters_applied') }}
+
+
+
+
+ @foreach ($userTypes as $value => $label)
+ {{ $label }}
+ @endforeach
+
+
+
+
+
+ @foreach ($statuses as $value => $label)
+ {{ $label }}
+ @endforeach
+
+
+
+
+
+
+
+
+
+
+
+
+ @if ($userType !== 'all' || $status !== 'all' || $dateFrom || $dateTo)
+
+
+ {{ __('export.clear_filters') }}
+
+
+ @endif
+
+
+
+
+
+
+ {{ __('export.total_records') }}: {{ $previewCount }}
+
+
+
+
+
+ {{ __('export.export_csv') }}
+ {{ __('export.exporting') }}
+
+
+
+ {{ __('export.export_pdf') }}
+ {{ __('export.exporting') }}
+
+
+
+
+ @if ($previewCount === 0)
+
+
+ {{ __('export.no_users_match') }}
+
+ @endif
+
+
diff --git a/resources/views/livewire/admin/widgets/quick-actions.blade.php b/resources/views/livewire/admin/widgets/quick-actions.blade.php
index acef3d3..f16cff3 100644
--- a/resources/views/livewire/admin/widgets/quick-actions.blade.php
+++ b/resources/views/livewire/admin/widgets/quick-actions.blade.php
@@ -60,6 +60,9 @@ new class extends Component
{{ __('widgets.create_post') }}
+
+ {{ __('widgets.export_users') }}
+
{{ __('widgets.block_time_slot') }}
diff --git a/resources/views/pdf/users-export.blade.php b/resources/views/pdf/users-export.blade.php
new file mode 100644
index 0000000..a89c43d
--- /dev/null
+++ b/resources/views/pdf/users-export.blade.php
@@ -0,0 +1,267 @@
+
+
+
+
+
+
{{ __('export.users_export_title', [], $locale) }}
+
+
+
+
+
+
+
+
+ @if(count($filters) > 0)
+
+
{{ __('export.filters_applied', [], $locale) }}:
+ @foreach($filters as $key => $value)
+
+ @if($key === 'user_type')
+ {{ __('export.user_type', [], $locale) }}: {{ $value }}
+ @elseif($key === 'status')
+ {{ __('export.status', [], $locale) }}: {{ $value }}
+ @elseif($key === 'date_from')
+ {{ __('export.date_from', [], $locale) }}: {{ $value }}
+ @elseif($key === 'date_to')
+ {{ __('export.date_to', [], $locale) }}: {{ $value }}
+ @endif
+
+ @endforeach
+
+ {{ __('export.total_records', [], $locale) }}: {{ $totalCount }}
+
+
+ @if($users->count() > 0)
+
+
+
+ | {{ __('export.name', [], $locale) }} |
+ {{ __('export.email', [], $locale) }} |
+ {{ __('export.phone', [], $locale) }} |
+ {{ __('export.user_type', [], $locale) }} |
+ {{ __('export.id_number', [], $locale) }} |
+ {{ __('export.status', [], $locale) }} |
+ {{ __('export.created_at', [], $locale) }} |
+
+
+
+ @foreach($users as $user)
+
+ | {{ $user->user_type->value === 'company' ? $user->company_name : $user->full_name }} |
+ {{ $user->email }} |
+ {{ $user->phone }} |
+ {{ __('export.type_' . $user->user_type->value, [], $locale) }} |
+ {{ $user->user_type->value === 'company' ? $user->company_cert_number : $user->national_id }} |
+
+ {{ __('export.status_' . $user->status->value, [], $locale) }}
+ |
+ {{ $user->created_at->format($locale === 'ar' ? 'd/m/Y' : 'm/d/Y') }} |
+
+ @endforeach
+
+
+ @else
+
+ {{ __('export.no_users_match', [], $locale) }}
+
+ @endif
+
+
+
diff --git a/routes/web.php b/routes/web.php
index 7771515..5b66e1e 100644
--- a/routes/web.php
+++ b/routes/web.php
@@ -97,6 +97,10 @@ Route::middleware(['auth', 'active'])->group(function () {
Volt::route('/create', 'admin.posts.create')->name('create');
Volt::route('/{post}/edit', 'admin.posts.edit')->name('edit');
});
+
+ // User Export
+ Volt::route('/users/export', 'admin.users.export-users')
+ ->name('admin.users.export');
});
// Client routes
diff --git a/tests/Feature/Admin/UserExportTest.php b/tests/Feature/Admin/UserExportTest.php
new file mode 100644
index 0000000..af8c4c2
--- /dev/null
+++ b/tests/Feature/Admin/UserExportTest.php
@@ -0,0 +1,268 @@
+admin = User::factory()->admin()->create();
+});
+
+// ===========================================
+// Access Tests
+// ===========================================
+
+test('admin can access user export page', function () {
+ $this->actingAs($this->admin)
+ ->get(route('admin.users.export'))
+ ->assertOk();
+});
+
+test('non-admin cannot access export page', function () {
+ $client = User::factory()->individual()->create();
+
+ $this->actingAs($client)
+ ->get(route('admin.users.export'))
+ ->assertForbidden();
+});
+
+test('unauthenticated user cannot access export page', function () {
+ $this->get(route('admin.users.export'))
+ ->assertRedirect(route('login'));
+});
+
+// ===========================================
+// CSV Export Tests
+// ===========================================
+
+test('admin can export all users as CSV', function () {
+ User::factory()->count(5)->individual()->create();
+ User::factory()->count(3)->company()->create();
+
+ $this->actingAs($this->admin);
+
+ Volt::test('admin.users.export-users')
+ ->set('userType', 'all')
+ ->call('exportCsv')
+ ->assertFileDownloaded('users-export-'.now()->format('Y-m-d').'.csv');
+});
+
+test('admin can export filtered users by individual type', function () {
+ User::factory()->count(5)->individual()->create();
+ User::factory()->count(3)->company()->create();
+
+ $this->actingAs($this->admin);
+
+ Volt::test('admin.users.export-users')
+ ->set('userType', 'individual')
+ ->call('exportCsv')
+ ->assertFileDownloaded();
+});
+
+test('admin can export filtered users by company type', function () {
+ User::factory()->count(5)->individual()->create();
+ User::factory()->count(3)->company()->create();
+
+ $this->actingAs($this->admin);
+
+ Volt::test('admin.users.export-users')
+ ->set('userType', 'company')
+ ->call('exportCsv')
+ ->assertFileDownloaded();
+});
+
+test('admin can export users filtered by active status', function () {
+ User::factory()->count(3)->individual()->create();
+ User::factory()->count(2)->individual()->deactivated()->create();
+
+ $this->actingAs($this->admin);
+
+ Volt::test('admin.users.export-users')
+ ->set('status', 'active')
+ ->call('exportCsv')
+ ->assertFileDownloaded();
+});
+
+test('admin can export users filtered by deactivated status', function () {
+ User::factory()->count(3)->individual()->create();
+ User::factory()->count(2)->individual()->deactivated()->create();
+
+ $this->actingAs($this->admin);
+
+ Volt::test('admin.users.export-users')
+ ->set('status', 'deactivated')
+ ->call('exportCsv')
+ ->assertFileDownloaded();
+});
+
+test('admin can export users filtered by date range', function () {
+ User::factory()->individual()->create(['created_at' => now()->subDays(10)]);
+ User::factory()->individual()->create(['created_at' => now()->subDays(5)]);
+ User::factory()->individual()->create(['created_at' => now()]);
+
+ $this->actingAs($this->admin);
+
+ Volt::test('admin.users.export-users')
+ ->set('dateFrom', now()->subDays(7)->format('Y-m-d'))
+ ->set('dateTo', now()->format('Y-m-d'))
+ ->call('exportCsv')
+ ->assertFileDownloaded();
+});
+
+test('admin can export with combined filters', function () {
+ User::factory()->individual()->create(['created_at' => now()->subDays(5)]);
+ User::factory()->individual()->deactivated()->create(['created_at' => now()->subDays(5)]);
+ User::factory()->company()->create(['created_at' => now()->subDays(5)]);
+
+ $this->actingAs($this->admin);
+
+ Volt::test('admin.users.export-users')
+ ->set('userType', 'individual')
+ ->set('status', 'active')
+ ->set('dateFrom', now()->subDays(7)->format('Y-m-d'))
+ ->set('dateTo', now()->format('Y-m-d'))
+ ->call('exportCsv')
+ ->assertFileDownloaded();
+});
+
+// ===========================================
+// PDF Export Tests
+// ===========================================
+
+test('admin can export users as PDF', function () {
+ User::factory()->count(5)->individual()->create();
+
+ $this->actingAs($this->admin);
+
+ Volt::test('admin.users.export-users')
+ ->call('exportPdf')
+ ->assertFileDownloaded('users-export-'.now()->format('Y-m-d').'.pdf');
+});
+
+test('admin can export PDF with filters', function () {
+ User::factory()->count(3)->individual()->create();
+ User::factory()->count(2)->company()->create();
+
+ $this->actingAs($this->admin);
+
+ Volt::test('admin.users.export-users')
+ ->set('userType', 'individual')
+ ->call('exportPdf')
+ ->assertFileDownloaded();
+});
+
+// ===========================================
+// Empty Dataset Tests
+// ===========================================
+
+test('CSV export dispatches notification when no users match filters', function () {
+ $this->actingAs($this->admin);
+
+ Volt::test('admin.users.export-users')
+ ->set('userType', 'individual')
+ ->set('status', 'active')
+ ->call('exportCsv')
+ ->assertDispatched('notify');
+});
+
+test('PDF export dispatches notification when no users match filters', function () {
+ $this->actingAs($this->admin);
+
+ Volt::test('admin.users.export-users')
+ ->set('userType', 'individual')
+ ->set('status', 'active')
+ ->call('exportPdf')
+ ->assertDispatched('notify');
+});
+
+test('preview count shows zero when no users match filters', function () {
+ $this->actingAs($this->admin);
+
+ Volt::test('admin.users.export-users')
+ ->set('userType', 'individual')
+ ->set('status', 'active')
+ ->assertSee('0');
+});
+
+// ===========================================
+// Filter Tests
+// ===========================================
+
+test('preview count updates when filters change', function () {
+ User::factory()->count(3)->individual()->create();
+ User::factory()->count(2)->company()->create();
+
+ $this->actingAs($this->admin);
+
+ // All users (excluding admin) - should show 5
+ Volt::test('admin.users.export-users')
+ ->set('userType', 'all')
+ ->assertSeeHtml('
5');
+
+ // Filter to individual only - should show 3
+ Volt::test('admin.users.export-users')
+ ->set('userType', 'individual')
+ ->assertSeeHtml('
3');
+
+ // Filter to company only - should show 2
+ Volt::test('admin.users.export-users')
+ ->set('userType', 'company')
+ ->assertSeeHtml('
2');
+});
+
+test('clear filters resets all filter values', function () {
+ $this->actingAs($this->admin);
+
+ $component = Volt::test('admin.users.export-users')
+ ->set('userType', 'individual')
+ ->set('status', 'active')
+ ->set('dateFrom', '2024-01-01')
+ ->set('dateTo', '2024-12-31')
+ ->call('clearFilters');
+
+ expect($component->get('userType'))->toBe('all');
+ expect($component->get('status'))->toBe('all');
+ expect($component->get('dateFrom'))->toBe('');
+ expect($component->get('dateTo'))->toBe('');
+});
+
+// ===========================================
+// Admin Exclusion Tests
+// ===========================================
+
+test('export excludes admin users', function () {
+ User::factory()->count(3)->individual()->create();
+ User::factory()->admin()->create(); // Create another admin
+
+ $this->actingAs($this->admin);
+
+ // Should only count the 3 individual clients, not the 2 admins
+ Volt::test('admin.users.export-users')
+ ->assertSeeHtml('
3');
+});
+
+// ===========================================
+// Language Tests
+// ===========================================
+
+test('export uses admin preferred language for headers', function () {
+ $adminArabic = User::factory()->admin()->create(['preferred_language' => 'ar']);
+ User::factory()->individual()->create();
+
+ $this->actingAs($adminArabic);
+
+ // Test that export works - content verification would require more complex testing
+ Volt::test('admin.users.export-users')
+ ->call('exportCsv')
+ ->assertFileDownloaded();
+});
+
+test('export uses English when admin prefers English', function () {
+ $adminEnglish = User::factory()->admin()->create(['preferred_language' => 'en']);
+ User::factory()->individual()->create();
+
+ $this->actingAs($adminEnglish);
+
+ Volt::test('admin.users.export-users')
+ ->call('exportCsv')
+ ->assertFileDownloaded();
+});