terrylee
8977e7eb0f
- 機台系統設定：取物單模式(pickup_sheet)下新增「領藥單」開關 pharmacy_pickup_enabled，B014 下發 FunctionSet.PharmacyPickup - 權限：銷售管理→領藥單 menu.sales.pharmacy-pickup（角色/帳號可勾選授權，租戶模板預設關） - 資料模型：orders 加 order_type/pricing_slip_no/created_by（領藥單序號=flow_id）、pickup_codes.slot_no 可空 - 後台：PharmacyPickupController + PharmacyPickupService（以商品為單位建單、庫存不預扣）+ 建單/列表/列印頁(QR內嵌,不顯姓名) - B660：領藥單回多貨道 items[]（保留 slot_no 向後相容）+ 模式 gate + 標記已領 - 出貨回報：finalizePharmacyDispense（獨立於銷售/發票/閉環）+ flow_id 終態冪等 + 庫存只扣一次 - 修正 PickupCode::isValid() 對 null expires_at 的 NPE、status 補入 fillable Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
273 lines
8.0 KiB
PHP
273 lines
8.0 KiB
PHP
<?php
|
||
|
||
namespace App\Models\Transaction;
|
||
|
||
use Illuminate\Database\Eloquent\Factories\HasFactory;
|
||
use Illuminate\Database\Eloquent\Model;
|
||
use Illuminate\Database\Eloquent\SoftDeletes;
|
||
use App\Traits\TenantScoped;
|
||
use App\Models\Machine\Machine;
|
||
use App\Models\Member\Member;
|
||
|
||
class Order extends Model
|
||
{
|
||
use HasFactory, SoftDeletes, TenantScoped;
|
||
|
||
// 訂單類型 (order_type)
|
||
public const TYPE_SALE = 'sale'; // 一般銷售
|
||
public const TYPE_PHARMACY_PICKUP = 'pharmacy_pickup'; // 領藥單
|
||
|
||
// 支付狀態
|
||
public const PAYMENT_STATUS_FAILED = 0;
|
||
public const PAYMENT_STATUS_SUCCESS = 1;
|
||
|
||
// 出貨狀態
|
||
public const DELIVERY_STATUS_FAILED = 0;
|
||
public const DELIVERY_STATUS_SUCCESS = 1;
|
||
public const DELIVERY_STATUS_PARTIAL = 2;
|
||
|
||
// 交易生命週期狀態（status 欄位，字串）。
|
||
// pending：進入付款、等待結果；completed：付款成功（出貨另看 delivery_status）；
|
||
// failed：付款失敗/逾時；abandoned：感應前取消（由排程把逾時 pending 標記）。
|
||
// ⚠ 終態 = [completed, failed, abandoned]，一律冪等不可覆蓋（保護線上 main 機台行為不變）。
|
||
public const STATUS_PENDING = 'pending';
|
||
public const STATUS_COMPLETED = 'completed';
|
||
public const STATUS_FAILED = 'failed';
|
||
public const STATUS_ABANDONED = 'abandoned';
|
||
// 領藥單專用：已開立、等待病人到機台領取（非 pending，不被逾時清掃；非終態，可被出貨 finalize 更新）。
|
||
public const STATUS_AWAITING_PICKUP = 'awaiting_pickup';
|
||
|
||
/** 終態清單：到了這些狀態就不再變更（冪等）。 */
|
||
public const TERMINAL_STATUSES = [
|
||
self::STATUS_COMPLETED,
|
||
self::STATUS_FAILED,
|
||
self::STATUS_ABANDONED,
|
||
];
|
||
|
||
protected $fillable = [
|
||
'company_id',
|
||
'flow_id',
|
||
'order_no',
|
||
'order_type',
|
||
'pricing_slip_no',
|
||
'created_by',
|
||
'machine_id',
|
||
'member_id',
|
||
'payment_type',
|
||
'total_amount',
|
||
'discount_amount',
|
||
'pay_amount',
|
||
'change_amount',
|
||
'points_used',
|
||
'original_amount',
|
||
'payment_status',
|
||
'payment_request',
|
||
'payment_response',
|
||
'payment_at',
|
||
'member_barcode',
|
||
'code_id',
|
||
'welcome_gift_id',
|
||
'invoice_info',
|
||
'machine_time',
|
||
'status',
|
||
'metadata',
|
||
'delivery_status',
|
||
'remark',
|
||
];
|
||
|
||
protected $casts = [
|
||
'total_amount' => 'decimal:2',
|
||
'discount_amount' => 'decimal:2',
|
||
'pay_amount' => 'decimal:2',
|
||
'change_amount' => 'decimal:2',
|
||
'original_amount' => 'decimal:2',
|
||
'payment_at' => 'datetime',
|
||
'machine_time' => 'datetime',
|
||
'metadata' => 'array',
|
||
'payment_type' => 'integer',
|
||
'delivery_status' => 'integer',
|
||
];
|
||
|
||
/**
|
||
* 取得所有支付類型的對照標籤
|
||
*/
|
||
public static function getPaymentTypeLabels(): array
|
||
{
|
||
return [
|
||
1 => __('Credit Card'),
|
||
2 => __('E-Ticket (EasyCard/iPass)'),
|
||
3 => __('QR Code Payment - E.SUN'), // 掃碼支付-玉山
|
||
4 => __('Bill Acceptor'),
|
||
5 => __('Pass Code'), // 使用者要求由「通關密碼」改為「通行碼」
|
||
6 => __('Pickup Code'),
|
||
7 => __('Welcome Gift'),
|
||
8 => __('Questionnaire'),
|
||
9 => __('Coin Acceptor'),
|
||
10 => __('Mobile Pay'), // NFC 手機感應（行動支付，信用卡軌道，依使用者按鈕分類）
|
||
11 => __('QR Code Payment - TayPay'), // 掃碼支付-TayPay
|
||
21 => __('Offline + 1'),
|
||
22 => __('Offline + 2'),
|
||
23 => __('Offline + 3'),
|
||
24 => __('Offline + 4'),
|
||
25 => __('Offline + 9'),
|
||
30 => __('LINE Pay'),
|
||
31 => __('JKO Pay'),
|
||
32 => __('Easy Wallet'),
|
||
33 => __('Pi Pay'),
|
||
34 => __('PlusPay'),
|
||
40 => __('Member Verify Pickup'),
|
||
41 => __('Staff Card'),
|
||
42 => __('Pickup Voucher'),
|
||
50 => __('Offline + LINE Pay'),
|
||
51 => __('Offline + JKO Pay'),
|
||
52 => __('Offline + Easy Wallet'),
|
||
53 => __('Offline + Pi Pay'),
|
||
54 => __('Offline + PlusPay'),
|
||
60 => __('Points/Voucher'),
|
||
61 => __('Member + 1'),
|
||
62 => __('Member + 2'),
|
||
63 => __('Member + 3'),
|
||
64 => __('Member + 4'),
|
||
65 => __('Member + 5'),
|
||
66 => __('Member + 6'),
|
||
67 => __('Member + 7'),
|
||
68 => __('Member + 8'),
|
||
69 => __('Member + 9'),
|
||
70 => __('LINE Pay (Official)'), // LINE Pay 官方直連（非 TapPay 底下的 30）
|
||
90 => __('Member + LINE Pay'),
|
||
91 => __('Member + JKO Pay'),
|
||
92 => __('Member + Easy Wallet'),
|
||
93 => __('Member + Pi Pay'),
|
||
94 => __('Member + PlusPay'),
|
||
];
|
||
}
|
||
|
||
/**
|
||
* 取得目前的支付類型標籤 (Accessor)
|
||
*/
|
||
public function getPaymentTypeLabelAttribute(): string
|
||
{
|
||
return self::getPaymentTypeLabels()[$this->payment_type] ?? __('Unknown');
|
||
}
|
||
|
||
public function getMaskedPickupRecipientAttribute(): ?string
|
||
{
|
||
if (empty($this->member_barcode)) {
|
||
return null;
|
||
}
|
||
|
||
return self::maskPickupRecipientName($this->member_barcode);
|
||
}
|
||
|
||
public static function maskPickupRecipientName(string $value): string
|
||
{
|
||
$value = trim($value);
|
||
|
||
if ($value === '') {
|
||
return $value;
|
||
}
|
||
|
||
if (preg_match('/^([^\s（(]+)(.*)$/us', $value, $matches) !== 1) {
|
||
return self::maskName($value);
|
||
}
|
||
|
||
return self::maskName($matches[1]) . ($matches[2] ?? '');
|
||
}
|
||
|
||
private static function maskName(string $name): string
|
||
{
|
||
$length = mb_strlen($name);
|
||
|
||
if ($length <= 1) {
|
||
return $name;
|
||
}
|
||
|
||
if ($length === 2) {
|
||
return mb_substr($name, 0, 1) . 'O';
|
||
}
|
||
|
||
return mb_substr($name, 0, 1)
|
||
. str_repeat('O', $length - 2)
|
||
. mb_substr($name, -1);
|
||
}
|
||
|
||
/** 一般銷售訂單 */
|
||
public function scopeSales($query)
|
||
{
|
||
return $query->where('order_type', self::TYPE_SALE);
|
||
}
|
||
|
||
/** 領藥單 */
|
||
public function scopePharmacyPickup($query)
|
||
{
|
||
return $query->where('order_type', self::TYPE_PHARMACY_PICKUP);
|
||
}
|
||
|
||
public function machine()
|
||
{
|
||
return $this->belongsTo(Machine::class);
|
||
}
|
||
|
||
/** 建單者 (領藥單藥師) */
|
||
public function creator()
|
||
{
|
||
return $this->belongsTo(\App\Models\System\User::class, 'created_by');
|
||
}
|
||
|
||
public function member()
|
||
{
|
||
return $this->belongsTo(Member::class);
|
||
}
|
||
|
||
public function items()
|
||
{
|
||
return $this->hasMany(OrderItem::class);
|
||
}
|
||
|
||
public function invoice()
|
||
{
|
||
return $this->hasOne(Invoice::class);
|
||
}
|
||
|
||
public function dispenseRecords()
|
||
{
|
||
return $this->hasMany(DispenseRecord::class);
|
||
}
|
||
|
||
/** 領藥單對應的領藥碼（一單一碼） */
|
||
public function pickupCode()
|
||
{
|
||
return $this->hasOne(PickupCode::class);
|
||
}
|
||
|
||
public function staffCardLog()
|
||
{
|
||
return $this->hasOne(\App\Models\StaffCardLog::class);
|
||
}
|
||
|
||
public function welcomeGift()
|
||
{
|
||
return $this->belongsTo(WelcomeGift::class);
|
||
}
|
||
|
||
/**
|
||
* 取得所有出貨狀態的對照標籤
|
||
*/
|
||
public static function getDeliveryStatusLabels(): array
|
||
{
|
||
return [
|
||
self::DELIVERY_STATUS_FAILED => __('Dispense Failed'),
|
||
self::DELIVERY_STATUS_SUCCESS => __('Dispense Success'),
|
||
self::DELIVERY_STATUS_PARTIAL => __('Partial Dispense Success'),
|
||
];
|
||
}
|
||
|
||
/**
|
||
* 取得目前出貨狀態標籤 (Accessor)
|
||
*/
|
||
public function getDeliveryStatusLabelAttribute(): string
|
||
{
|
||
return self::getDeliveryStatusLabels()[$this->delivery_status] ?? __('Unknown');
|
||
}
|
||
}
|