Rename controller namespaces: drop V1 prefix, clarify roles

V1/Admin     -> Company       (company-scoped controllers)
V1/SuperAdmin -> Admin        (platform-wide admin controllers)
V1/Customer  -> CustomerPortal (customer-facing portal)
V1/Installation -> Setup      (installation wizard)
V1/PDF       -> Pdf           (consistent casing)
V1/Modules   -> Modules       (drop V1 prefix)
V1/Webhook   -> Webhook       (drop V1 prefix)

The V1 prefix served no purpose - API versioning is in the route prefix
(/api/v1/), not the controller namespace. "Admin" was misleading for
company-scoped controllers. "SuperAdmin" is now simply "Admin" for
platform administration.

app/Http/Controllers/Company/Payment/PaymentMethodsController.php

@@ -0,0 +1,99 @@
+<?php
+
+namespace App\Http\Controllers\Company\Payment;
+
+use App\Http\Controllers\Controller;
+use App\Http\Requests\PaymentMethodRequest;
+use App\Http\Resources\PaymentMethodResource;
+use App\Models\PaymentMethod;
+use Illuminate\Http\Request;
+use Illuminate\Http\Response;
+
+class PaymentMethodsController extends Controller
+{
+    /**
+     * Display a listing of the resource.
+     *
+     * @return Response
+     */
+    public function index(Request $request)
+    {
+        $this->authorize('viewAny', PaymentMethod::class);
+
+        $limit = $request->has('limit') ? $request->limit : 5;
+
+        $paymentMethods = PaymentMethod::applyFilters($request->all())
+            ->where('type', PaymentMethod::TYPE_GENERAL)
+            ->whereCompany()
+            ->latest()
+            ->paginateData($limit);
+
+        return PaymentMethodResource::collection($paymentMethods);
+    }
+
+    /**
+     * Store a newly created resource in storage.
+     *
+     * @param  Request  $request
+     * @return Response
+     */
+    public function store(PaymentMethodRequest $request)
+    {
+        $this->authorize('create', PaymentMethod::class);
+
+        $paymentMethod = PaymentMethod::createPaymentMethod($request);
+
+        return new PaymentMethodResource($paymentMethod);
+    }
+
+    /**
+     * Display the specified resource.
+     *
+     * @return Response
+     */
+    public function show(PaymentMethod $paymentMethod)
+    {
+        $this->authorize('view', $paymentMethod);
+
+        return new PaymentMethodResource($paymentMethod);
+    }
+
+    /**
+     * Update the specified resource in storage.
+     *
+     * @param  Request  $request
+     * @return Response
+     */
+    public function update(PaymentMethodRequest $request, PaymentMethod $paymentMethod)
+    {
+        $this->authorize('update', $paymentMethod);
+
+        $paymentMethod->update($request->getPaymentMethodPayload());
+
+        return new PaymentMethodResource($paymentMethod);
+    }
+
+    /**
+     * Remove the specified resource from storage.
+     *
+     * @return Response
+     */
+    public function destroy(PaymentMethod $paymentMethod)
+    {
+        $this->authorize('delete', $paymentMethod);
+
+        if ($paymentMethod->payments()->exists()) {
+            return respondJson('payments_attached', 'Payments Attached.');
+        }
+
+        if ($paymentMethod->expenses()->exists()) {
+            return respondJson('expenses_attached', 'Expenses Attached.');
+        }
+
+        $paymentMethod->delete();
+
+        return response()->json([
+            'success' => 'Payment method deleted successfully',
+        ]);
+    }
+}

app/Http/Controllers/Company/Payment/PaymentsController.php

@@ -0,0 +1,114 @@
+<?php
+
+namespace App\Http\Controllers\Company\Payment;
+
+use App\Http\Controllers\Controller;
+use App\Http\Requests\DeletePaymentsRequest;
+use App\Http\Requests\PaymentRequest;
+use App\Http\Requests\SendPaymentRequest;
+use App\Http\Resources\PaymentResource;
+use App\Models\Payment;
+use App\Services\PaymentService;
+use Illuminate\Http\Request;
+use Illuminate\Http\Response;
+use Illuminate\Mail\Markdown;
+
+class PaymentsController extends Controller
+{
+    public function __construct(
+        private readonly PaymentService $paymentService,
+    ) {}
+
+    /**
+     * Display a listing of the resource.
+     *
+     * @return Response
+     */
+    public function index(Request $request)
+    {
+        $this->authorize('viewAny', Payment::class);
+
+        $limit = $request->has('limit') ? $request->limit : 10;
+
+        $payments = Payment::whereCompany()
+            ->join('customers', 'customers.id', '=', 'payments.customer_id')
+            ->leftJoin('invoices', 'invoices.id', '=', 'payments.invoice_id')
+            ->leftJoin('payment_methods', 'payment_methods.id', '=', 'payments.payment_method_id')
+            ->applyFilters($request->all())
+            ->select('payments.*', 'customers.name', 'invoices.invoice_number', 'payment_methods.name as payment_mode')
+            ->latest()
+            ->paginateData($limit);
+
+        return PaymentResource::collection($payments)
+            ->additional(['meta' => [
+                'payment_total_count' => Payment::whereCompany()->count(),
+            ]]);
+    }
+
+    /**
+     * Store a newly created resource in storage.
+     *
+     * @param  Request  $request
+     * @return Response
+     */
+    public function store(PaymentRequest $request)
+    {
+        $this->authorize('create', Payment::class);
+
+        $payment = $this->paymentService->create($request);
+
+        return new PaymentResource($payment);
+    }
+
+    public function show(Request $request, Payment $payment)
+    {
+        $this->authorize('view', $payment);
+
+        return new PaymentResource($payment);
+    }
+
+    public function update(PaymentRequest $request, Payment $payment)
+    {
+        $this->authorize('update', $payment);
+
+        $payment = $this->paymentService->update($payment, $request);
+
+        return new PaymentResource($payment);
+    }
+
+    public function delete(DeletePaymentsRequest $request)
+    {
+        $this->authorize('delete multiple payments');
+
+        $ids = Payment::whereCompany()
+            ->whereIn('id', $request->ids)
+            ->pluck('id');
+
+        $this->paymentService->delete($ids);
+
+        return response()->json([
+            'success' => true,
+        ]);
+    }
+
+    public function send(SendPaymentRequest $request, Payment $payment)
+    {
+        $this->authorize('send payment', $payment);
+
+        $response = $this->paymentService->send($payment, $request->all());
+
+        return response()->json($response);
+    }
+
+    public function sendPreview(Request $request, Payment $payment)
+    {
+        $this->authorize('send payment', $payment);
+
+        $markdown = new Markdown(view(), config('mail.markdown'));
+
+        $data = $this->paymentService->sendPaymentData($payment, $request->all());
+        $data['url'] = $payment->paymentPdfUrl;
+
+        return $markdown->render('emails.send.payment', ['data' => $data]);
+    }
+}