bao/portal-api
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

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

Browse Source 
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
This commit is contained in:
baodev0
2026-10-19 16:37:56 +07:00
co-authored by Claude Sonnet 5.5
parent ea9a53f742
commit 25f23d541e
134 changed files with 4926 additions and 185 deletions
Download Patch File Download Diff File Expand all files Collapse all files
app/Http/Resources/Api/Service/Order/InvoiceDetailResource.php
+27 -1
View File
@@ -3,6 +3,7 @@
namespace App\Http\Resources\Api\Service\Order;
use App\Enums\Invoice\InvoiceStatus;
use App\Enums\Order\OrderStatus;
use App\Models\InvoiceAttachment;
use Illuminate\Http\Request;
use Illuminate\Http\Resources\Json\JsonResource;
@@ -20,7 +21,10 @@ class InvoiceDetailResource extends JsonResource
'status_text' => InvoiceStatus::tryFrom((int) $this->status)?->label() ?? '-',
'sub_total' => (float) $this->sub_total,
'discount_amount' => (float) ($this->discount_amount ?? 0),
'coupon_code' => $this->coupon_code,
'tax' => (float) $this->tax,
'lookup_code' => $this->lookup_code,
'vat_number' => $this->vat_number,
'total' => (float) $this->total,
// Công nợ: đã thu / còn thiếu. Dịch vụ chỉ kích hoạt khi outstanding = 0.
'amount_paid' => (float) $this->amount_paid,
@@ -37,7 +41,10 @@ class InvoiceDetailResource extends JsonResource
]),
'order' => $this->whenLoaded('order', fn () => [
'order_num' => $this->order->order_num,
'status' => (int) $this->order->status,
'status_text' => OrderStatus::tryFrom((int) $this->order->status)?->label() ?? '-',
'total' => (float) $this->order->total,
'created_at' => $this->order->created_at?->toISOString(),
]),
'items' => $this->whenLoaded('order', fn () => $this->order->orderItems->map(fn ($item) => [
'product_name' => $item->product?->name,
@@ -47,8 +54,9 @@ class InvoiceDetailResource extends JsonResource
'months' => $item->months,
'os_id' => $item->os_id,
])->values()->all()),
'service' => $this->whenLoaded('order', fn () => $this->resolveService()),
'attachments' => $this->whenLoaded('attachments', fn () => $this->attachments
->where('type', '!=', InvoiceAttachment::TYPE_DEPLOYMENT)
->whereNotIn('type', [InvoiceAttachment::TYPE_DEPLOYMENT, InvoiceAttachment::TYPE_CONTRACT])
->values()
->map(fn ($a) => [
'filename' => $a->filename,
@@ -62,6 +70,24 @@ class InvoiceDetailResource extends JsonResource
];
}
private function resolveService(): ?array
{
$items = $this->order->orderItems;
$item = $this->service_id
? $items->first(fn ($i) => (int) $i->service?->id === (int) $this->service_id)
: null;
$item ??= $items->first();
return $item ? [
'product_id' => $item->product_id,
'name' => $item->product?->name,
'billing_cycle' => $item->billing_cycle,
'months' => $item->months,
'server_name' => $item->server_name,
'product_type' => $item->product?->product_type,
] : null;
}
private function resolveVmware(\App\Models\ModuleVmware $vm): array
{
return [
app/Http/Resources/Api/Service/Order/OrderDetailResource.php
+37
View File
@@ -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) : [],
];
}