feat(sales): fresh sales implementation

2026-09-01 21:00:58 +00:00 · 2026-08-21 01:26:48 +02:00
parent e5dc314b68
commit 5269344458
53 changed files with 5736 additions and 0 deletions
@@ -0,0 +1,104 @@
+<?php
+
+namespace App\Domains\Sales\Http\Controllers\CustomerPortal;
+
+use App\Domains\Accounts\Models\CompanySetting;
+use App\Domains\Contacts\Models\Customer;
+use App\Domains\Sales\Http\Resources\CustomerPortal\InvoiceResource;
+use App\Domains\Sales\Mail\InvoiceViewedMail;
+use App\Domains\Sales\Models\Invoice;
+use App\Platform\Http\Controller;
+use App\Platform\Mail\Models\EmailLog;
+use Illuminate\Http\Request;
+use Illuminate\Support\Facades\Mail;
+
+class InvoicePdfController extends Controller
+{
+    /**
+     * Answer an emailed link: the rendered document when the caller asks for
+     * the file, otherwise the portal shell that frames it. Either way the
+     * visit counts as the customer having read the bill.
+     */
+    public function getPdf(EmailLog $emailLog, Request $request)
+    {
+        $invoice = $this->documentBehind($emailLog);
+
+        $this->recordReading($invoice);
+
+        if ($request->has('pdf')) {
+            return $invoice->getGeneratedPDFOrStream('invoice');
+        }
+
+        $issuer = $invoice->company_id;
+
+        return view('app')->with([
+            'customer_logo' => get_company_setting('customer_portal_logo', $issuer),
+            'current_theme' => get_company_setting('customer_portal_theme', $issuer),
+        ]);
+    }
+
+    /**
+     * Serve the same document as JSON for the viewer shell, in the trimmed
+     * portal shape.
+     */
+    public function getInvoice(EmailLog $emailLog)
+    {
+        return InvoiceResource::make($this->documentBehind($emailLog));
+    }
+
+    /**
+     * Trade an email-log token for the document it was issued for.
+     *
+     * Holding the token is the whole credential, so the guard is narrow. The
+     * log must point at a billing document (a token minted for some other
+     * kind of mail must not disclose one, however the ids line up), and the
+     * link must still be inside the company's expiry window.
+     */
+    private function documentBehind(EmailLog $emailLog): Invoice
+    {
+        $document = $emailLog->mailable;
+
+        if (! $document instanceof Invoice) {
+            abort(404);
+        }
+
+        if ($emailLog->isExpired()) {
+            abort(403, 'Link Expired.');
+        }
+
+        return $document;
+    }
+
+    /**
+     * Promote a document that is still awaiting a reader, and tell the issuer
+     * about it when they asked to be told.
+     */
+    private function recordReading(Invoice $invoice): void
+    {
+        $unread = [Invoice::STATUS_SENT, Invoice::STATUS_DRAFT];
+
+        if (! in_array($invoice->status, $unread)) {
+            return;
+        }
+
+        $invoice->update([
+            'status' => Invoice::STATUS_VIEWED,
+            'viewed' => true,
+        ]);
+
+        $wanted = CompanySetting::getSetting('notify_invoice_viewed', $invoice->company_id);
+
+        if ($wanted != 'YES') {
+            return;
+        }
+
+        $payload = [
+            'invoice' => Invoice::findOrFail($invoice->id)->toArray(),
+            'user' => Customer::find($invoice->customer_id)->toArray(),
+        ];
+
+        $mailbox = CompanySetting::getSetting('notification_email', $invoice->company_id);
+
+        Mail::to($mailbox)->send(new InvoiceViewedMail($payload));
+    }
+}