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

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

app/Http/Resources/Api/Service/Order/OrderDetailResource.php

@@ -4,6 +4,8 @@ namespace App\Http\Resources\Api\Service\Order;
 
 use App\Enums\Invoice\InvoiceStatus;
 use App\Enums\Order\OrderStatus;
+use App\Models\InvoiceAttachment;
+use App\Services\InvoicePaymentService;
 use Illuminate\Http\Request;
 use Illuminate\Http\Resources\Json\JsonResource;
 
@@ -11,6 +13,8 @@ class OrderDetailResource extends JsonResource
 {
     use ResolvesPaymentMethod;
 
+    private const INVOICE_TYPE_LABELS = [1 => 'Đơn mới', 2 => 'Gia hạn', 3 => 'Nâng cấp'];
+
     public function toArray(Request $request): array
     {
         return [
@@ -37,6 +41,39 @@ class OrderDetailResource extends JsonResource
                 'paid_at' => $this->invoice->paid_at?->toISOString(),
                 'payment_method' => $this->resolvePaymentMethod($this->invoice),
             ]),
+            'invoices' => $this->whenLoaded('invoices', fn () => $this->invoices
+                ->sortByDesc('id')
+                ->values()
+                ->map(fn ($invoice) => [
+                    'id' => $invoice->id,
+                    'invoice_number' => $invoice->invoice_number,
+                    'invoice_type' => (int) $invoice->invoice_type,
+                    'type_text' => self::INVOICE_TYPE_LABELS[(int) $invoice->invoice_type] ?? 'Hóa đơn',
+                    'status' => (int) $invoice->status,
+                    'status_text' => InvoiceStatus::tryFrom((int) $invoice->status)?->label() ?? '-',
+                    'total' => (float) $invoice->total,
+                    'amount_paid' => (float) $invoice->amount_paid,
+                    'due_date' => $invoice->due_date?->toISOString(),
+                    'paid_at' => $invoice->paid_at?->toISOString(),
+                    'billing_period_start' => $invoice->billing_period_start,
+                    'billing_period_end' => $invoice->billing_period_end,
+                    'payable' => in_array((int) $invoice->status, InvoicePaymentService::PAYABLE_STATUSES, true),
+                    'payment_url' => $invoice->setRelation('order', $this->resource)->clientPath(),
+                ])),
+            'contracts' => $this->whenLoaded('invoices', fn () => $this->invoices
+                ->flatMap(fn ($invoice) => $invoice->relationLoaded('attachments')
+                    ? $invoice->attachments
+                        ->where('type', InvoiceAttachment::TYPE_CONTRACT)
+                        ->map(fn ($attachment) => [
+                            'id' => $attachment->id,
+                            'filename' => $attachment->filename,
+                            'mime_type' => $attachment->mime_type,
+                            'size' => (int) $attachment->size,
+                            'invoice_number' => $invoice->invoice_number,
+                            'uploaded_at' => $attachment->created_at?->toISOString(),
+                        ])
+                    : collect())
+                ->values()),
             'items' => $this->whenLoaded('orderItems') ? OrderItemResource::collection($this->orderItems) : [],
         ];
     }