AI store generator for ecommerce, Malaysia first. Laravel 13 + React + TypeScript.
Nelze vybrat více než 25 témat Téma musí začínat písmenem nebo číslem, může obsahovat pomlčky („-“) a může být dlouhé až 35 znaků.

Order.php 4.2KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126
  1. <?php
  2. namespace App\Models;
  3. use App\Enums\OrderStatus;
  4. use Carbon\CarbonInterface;
  5. use Database\Factories\OrderFactory;
  6. use Illuminate\Database\Eloquent\Collection;
  7. use Illuminate\Database\Eloquent\Factories\HasFactory;
  8. use Illuminate\Database\Eloquent\Model;
  9. use Illuminate\Database\Eloquent\Relations\BelongsTo;
  10. use Illuminate\Database\Eloquent\Relations\HasMany;
  11. /**
  12. * One purchase from a store. Money is saved in sen (1 ringgit = 100 sen).
  13. *
  14. * The items keep their own copy of each product's name and price, so an order
  15. * never changes when the merchant later edits or deletes a product.
  16. *
  17. * @property int $id
  18. * @property int $store_id
  19. * @property string $public_id
  20. * @property int $number
  21. * @property OrderStatus $status
  22. * @property string $customer_name
  23. * @property string $customer_email
  24. * @property string $customer_phone
  25. * @property array{line1: string, line2: string|null, city: string, postcode: string, state: string, country: string} $shipping_address
  26. * @property int $subtotal
  27. * @property string|null $discount_code
  28. * @property string|null $discount_name The automatic discount used, when there was no code
  29. * @property int $discount_total
  30. * @property int $shipping_total
  31. * @property int $total
  32. * @property string $currency
  33. * @property string|null $payment_provider
  34. * @property string|null $payment_checkout_id
  35. * @property string|null $payment_reference
  36. * @property CarbonInterface|null $paid_at
  37. * @property CarbonInterface|null $shipped_at
  38. * @property string|null $shipping_courier
  39. * @property string|null $tracking_number
  40. * @property CarbonInterface|null $created_at
  41. * @property CarbonInterface|null $updated_at
  42. * @property-read Store $store
  43. * @property-read Collection<int, OrderItem> $items
  44. */
  45. class Order extends Model
  46. {
  47. /** @use HasFactory<OrderFactory> */
  48. use HasFactory;
  49. /**
  50. * @return BelongsTo<Store, $this>
  51. */
  52. public function store(): BelongsTo
  53. {
  54. return $this->belongsTo(Store::class);
  55. }
  56. /**
  57. * @return HasMany<OrderItem, $this>
  58. */
  59. public function items(): HasMany
  60. {
  61. return $this->hasMany(OrderItem::class);
  62. }
  63. public function isPaid(): bool
  64. {
  65. return $this->status === OrderStatus::Paid;
  66. }
  67. /**
  68. * The order as shown to people. Money is in ringgit here.
  69. *
  70. * @return array<string, mixed>
  71. */
  72. public function toDisplay(): array
  73. {
  74. return [
  75. 'id' => $this->id,
  76. 'public_id' => $this->public_id,
  77. 'number' => $this->number,
  78. 'status' => $this->status->value,
  79. 'status_label' => $this->status->label(),
  80. 'customer_name' => $this->customer_name,
  81. 'customer_email' => $this->customer_email,
  82. 'customer_phone' => $this->customer_phone,
  83. 'shipping_address' => $this->shipping_address,
  84. 'subtotal' => $this->subtotal / 100,
  85. 'discount_code' => $this->discount_code,
  86. 'discount_name' => $this->discount_name,
  87. 'discount_total' => $this->discount_total / 100,
  88. 'shipping_total' => $this->shipping_total / 100,
  89. 'total' => $this->total / 100,
  90. 'paid_at' => $this->paid_at?->toIso8601String(),
  91. 'shipped_at' => $this->shipped_at?->toIso8601String(),
  92. 'shipping_courier' => $this->shipping_courier,
  93. 'tracking_number' => $this->tracking_number,
  94. 'created_at' => $this->created_at?->toIso8601String(),
  95. 'items' => $this->items->map(fn (OrderItem $item) => [
  96. 'id' => $item->id,
  97. 'name' => $item->name,
  98. 'unit_price' => $item->unit_price / 100,
  99. 'quantity' => $item->quantity,
  100. 'line_total' => $item->line_total / 100,
  101. // For a bundle, what to pack for each one: ["2 × Sambal Hijau (250g)", ...].
  102. 'contents' => array_map(fn (array $part) => $part['label'], $item->bundle_contents ?? []),
  103. ])->all(),
  104. ];
  105. }
  106. /**
  107. * @return array<string, string>
  108. */
  109. protected function casts(): array
  110. {
  111. return [
  112. 'status' => OrderStatus::class,
  113. 'shipping_address' => 'array',
  114. 'paid_at' => 'datetime',
  115. 'shipped_at' => 'datetime',
  116. ];
  117. }
  118. }