feat(phase-12/13/16): tests, exports, dashboard enhancements (in-progress)

- Phase 12: QueueJobsTest (4 tests) — invoice, low-stock, payroll, bulk-import
- Phase 13: MailNotificationsTest (6 tests) — render + dispatch assertions
- Phase 14: purchase-order PDF view added
- Phase 15: ProductsExport, ContactsExport (partial)
- Phase 16: DashboardController module_stats + activity_feed; Dashboard.tsx
  module overview cards and recent activity feed

Co-Authored-By: Claude <noreply@anthropic.com>

Author: claude

erp/app/Exports/ContactsExport.php

@@ -0,0 +1,33 @@
+<?php
+
+namespace App\Exports;
+
+use App\Modules\Finance\Models\Contact;
+use Maatwebsite\Excel\Concerns\FromQuery;
+use Maatwebsite\Excel\Concerns\WithHeadings;
+use Maatwebsite\Excel\Concerns\WithMapping;
+
+class ContactsExport implements FromQuery, WithHeadings, WithMapping
+{
+    public function __construct(private readonly int $tenantId) {}
+
+    public function query()
+    {
+        return Contact::where('tenant_id', $this->tenantId);
+    }
+
+    public function headings(): array
+    {
+        return ['ID', 'Name', 'Email', 'Type'];
+    }
+
+    public function map($contact): array
+    {
+        return [
+            $contact->id,
+            $contact->name,
+            $contact->email,
+            $contact->type,
+        ];
+    }
+}

erp/app/Exports/InvoicesExport.php

@@ -0,0 +1,34 @@
+<?php
+
+namespace App\Exports;
+
+use App\Modules\Finance\Models\Invoice;
+use Maatwebsite\Excel\Concerns\FromQuery;
+use Maatwebsite\Excel\Concerns\WithHeadings;
+use Maatwebsite\Excel\Concerns\WithMapping;
+
+class InvoicesExport implements FromQuery, WithHeadings, WithMapping
+{
+    public function __construct(private readonly int $tenantId) {}
+
+    public function query()
+    {
+        return Invoice::where('tenant_id', $this->tenantId)->with('items');
+    }
+
+    public function headings(): array
+    {
+        return ['ID', 'Number', 'Status', 'Issue Date', 'Total'];
+    }
+
+    public function map($invoice): array
+    {
+        return [
+            $invoice->id,
+            $invoice->number,
+            $invoice->status,
+            $invoice->issue_date?->toDateString(),
+            $invoice->total,
+        ];
+    }
+}

erp/app/Exports/ProductsExport.php

@@ -0,0 +1,35 @@
+<?php
+
+namespace App\Exports;
+
+use App\Modules\Inventory\Models\Product;
+use Maatwebsite\Excel\Concerns\FromQuery;
+use Maatwebsite\Excel\Concerns\WithHeadings;
+use Maatwebsite\Excel\Concerns\WithMapping;
+
+class ProductsExport implements FromQuery, WithHeadings, WithMapping
+{
+    public function __construct(private readonly int $tenantId) {}
+
+    public function query()
+    {
+        return Product::where('tenant_id', $this->tenantId);
+    }
+
+    public function headings(): array
+    {
+        return ['ID', 'SKU', 'Name', 'Cost Price', 'Sale Price', 'Type'];
+    }
+
+    public function map($product): array
+    {
+        return [
+            $product->id,
+            $product->sku,
+            $product->name,
+            $product->cost_price,
+            $product->sale_price,
+            $product->type ?? '',
+        ];
+    }
+}

erp/app/Http/Controllers/DashboardController.php

@@ -114,6 +114,31 @@ public function index(Request $request)
             ->where('due_date', '<', now()->startOfDay())
             ->count();
 
+        // Module stats — counts per module scoped to tenant
+        $moduleStats = [
+            'open_invoices'     => Invoice::where('tenant_id', $tenantId)->whereNotIn('status', ['paid', 'cancelled'])->count(),
+            'open_bills'        => Bill::where('tenant_id', $tenantId)->whereNotIn('status', ['paid', 'cancelled'])->count(),
+            'pending_pos'       => \App\Modules\Purchase\Models\Po::where('tenant_id', $tenantId)->where('status', 'draft')->count(),
+            'active_projects'   => \App\Modules\PM\Models\Project::where('tenant_id', $tenantId)->where('status', 'active')->count(),
+            'open_tickets'      => \App\Modules\Helpdesk\Models\HelpdeskTicket::where('tenant_id', $tenantId)->where('status', '!=', 'closed')->count(),
+            'pending_approvals' => \App\Modules\Approvals\Models\ApprovalRequest::where('tenant_id', $tenantId)->where('status', 'pending')->count(),
+            'active_employees'  => \App\Modules\HR\Models\Employee::where('tenant_id', $tenantId)->where('status', 'active')->count(),
+            'total_products'    => \App\Modules\Inventory\Models\Product::where('tenant_id', $tenantId)->count(),
+        ];
+
+        // Activity feed — last 10 records across key models
+        $feed = collect();
+        $feed = $feed->concat(
+            Invoice::where('tenant_id', $tenantId)->latest()->limit(3)->get()->map(fn ($i) => ['type' => 'invoice', 'label' => 'Invoice ' . $i->number, 'status' => $i->status, 'at' => $i->created_at])
+        );
+        $feed = $feed->concat(
+            \App\Modules\Purchase\Models\Po::where('tenant_id', $tenantId)->latest()->limit(3)->get()->map(fn ($p) => ['type' => 'po', 'label' => 'PO ' . $p->po_number, 'status' => $p->status, 'at' => $p->created_at])
+        );
+        $feed = $feed->concat(
+            \App\Modules\HR\Models\PayrollRun::where('tenant_id', $tenantId)->latest()->limit(2)->get()->map(fn ($r) => ['type' => 'payroll', 'label' => 'Payroll ' . $r->period_label, 'status' => $r->status, 'at' => $r->created_at])
+        );
+        $activityFeed = $feed->sortByDesc('at')->take(10)->values();
+
         return Inertia::render('Dashboard', [
             'breadcrumbs' => [
                 ['label' => 'Dashboard', 'href' => route('dashboard')],
@@ -125,9 +150,11 @@ public function index(Request $request)
                 'outstanding_ap'      => round($outstandingAp, 2),
                 'overdue_count'       => $overdueCount,
             ],
-            'monthly_chart'  => $months->values(),
-            'recent_invoices'=> $recentInvoices->values(),
-            'low_stock'      => $lowStock,
+            'monthly_chart'   => $months->values(),
+            'recent_invoices' => $recentInvoices->values(),
+            'low_stock'       => $lowStock,
+            'module_stats'    => $moduleStats,
+            'activity_feed'   => $activityFeed,
         ]);
     }
 }