feat(billing): renewals, coupons, VAT numbering, billing cycles and invoice payment tracking

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

app/Http/Controllers/Api/Service/CouponPreviewController.php

@@ -0,0 +1,44 @@
+<?php
+
+namespace App\Http\Controllers\Api\Service;
+
+use App\Http\Controllers\Controller;
+use App\Http\Requests\Api\Order\CouponPreviewRequest;
+use App\Models\Product;
+use App\Services\Api\Order\OrderService;
+use App\Services\Coupon\CouponService;
+use Illuminate\Http\JsonResponse;
+
+class CouponPreviewController extends Controller
+{
+    public function __invoke(CouponPreviewRequest $request, OrderService $orders, CouponService $coupons): JsonResponse
+    {
+        $data = $request->validated();
+        $data['product_id'] = Product::where('uuid', $data['product_id'])->value('id');
+
+        try {
+            $quote = $orders->quote($data);
+        } catch (\InvalidArgumentException $e) {
+            return response()->json(['success' => false, 'message' => $e->getMessage()], 400);
+        }
+
+        $applied = $coupons->preview(
+            $data['coupon_code'],
+            $request->user(),
+            $quote['product'],
+            $data['billing_cycle'],
+            $quote['sub_total'],
+        );
+
+        return response()->json([
+            'success' => true,
+            'data' => [
+                'code' => $applied['coupon']->code,
+                'name' => $applied['coupon']->name,
+                'sub_total' => $quote['sub_total'],
+                'discount' => $applied['discount'],
+                'total' => $quote['sub_total'] - $applied['discount'],
+            ],
+        ]);
+    }
+}

app/Http/Controllers/Api/Service/OrderControllerRefactor.php

@@ -11,6 +11,8 @@ use App\Http\Requests\Api\Order\StoreOrderRequest;
 use App\Http\Resources\Api\Service\Order\InvoiceDetailResource;
 use App\Http\Resources\Api\Service\Order\InvoiceSummaryResource;
 use App\Http\Resources\Api\Service\Order\OrderDetailResource;
+use Illuminate\Support\Facades\Storage;
+use App\Models\InvoiceAttachment;
 use App\Http\Resources\Api\Service\Order\OrderItemResource;
 use App\Http\Resources\Api\Service\Order\OrderSummaryResource;
 use App\Http\Resources\Api\Service\Order\ServiceSummaryResource;
@@ -193,8 +195,9 @@ class OrderControllerRefactor extends Controller
     public function getClientInvoiceDetailByOrderNum(Request $request, string $orderNumber): JsonResponse
     {
         $order = $this->orderQueryService->findCustomerInvoiceByOrderNum((int) $request->user()->id, $orderNumber);
+        $invoice = $order ? $this->orderQueryService->pickOrderInvoice($order, $request->query('invoice')) : null;
 
-        if (!$order?->invoice) {
+        if (!$invoice) {
             return response()->json(['success' => false, 'message' => 'Hóa đơn không tồn tại.'], 404);
         }
 
@@ -202,7 +205,7 @@ class OrderControllerRefactor extends Controller
 
         return response()->json([
             'success' => true,
-            'data' => new InvoiceDetailResource($order->invoice->setRelation('order', $order)),
+            'data' => new InvoiceDetailResource($invoice->setRelation('order', $order)),
         ]);
     }
 
@@ -292,12 +295,14 @@ class OrderControllerRefactor extends Controller
     ): Response {
         $order = $this->orderQueryService->findCustomerInvoiceByOrderNum((int) $request->user()->id, $orderNum);
 
-        if (!$order?->invoice) {
+        $invoice = $order ? $this->orderQueryService->pickOrderInvoice($order, $request->query('invoice')) : null;
+
+        if (!$invoice) {
             abort(404, 'Hóa đơn không tồn tại.');
         }
 
-        $pdf = $pdfService->generate($order->invoice);
-        $filename = $pdfService->generateFileName($order->invoice);
+        $pdf = $pdfService->generate($invoice);
+        $filename = $pdfService->generateFileName($invoice);
 
         return response($pdf, 200, [
             'Content-Type' => 'application/pdf',
@@ -305,6 +310,21 @@ class OrderControllerRefactor extends Controller
         ]);
     }
 
+    public function downloadOrderContract(Request $request, string $orderNum, int $attachmentId)
+    {
+        $order = $this->orderQueryService->findCustomerInvoiceByOrderNum((int) $request->user()->id, $orderNum);
+
+        $attachment = $order?->invoices
+            ->flatMap->attachments
+            ->first(fn ($file) => $file->id === $attachmentId && $file->type === InvoiceAttachment::TYPE_CONTRACT);
+
+        if (!$attachment) {
+            abort(404, 'Hợp đồng không tồn tại.');
+        }
+
+        return Storage::disk($attachment->disk)->response($attachment->path, $attachment->filename);
+    }
+
     public function getClientServices(Request $request): JsonResponse
     {
         $services = $this->orderQueryService->getCustomerServices((int) $request->user()->id);

app/Http/Controllers/Api/Service/VmRebuildController.php

@@ -19,6 +19,7 @@ use Illuminate\Support\Facades\DB;
 use Illuminate\Support\Facades\Log;
 use Illuminate\Validation\ValidationException;
 use Throwable;
+use App\Support\VatNumbering;
 
 class VmRebuildController extends Controller
 {
@@ -315,6 +316,8 @@ class VmRebuildController extends Controller
                     InvoiceItem::create($line + ['invoice_id' => $invoice->id]);
                 }
 
+                VatNumbering::settle($invoice);
+
                 return $invoice;
             });
         } catch (Throwable $e) {