mirror of
https://github.com/crmeb/CRMEB.git
synced 2026-10-29 05:50:50 +00:00
287 lines
10 KiB
PHP
287 lines
10 KiB
PHP
<?php
|
||
declare(strict_types=1);
|
||
|
||
namespace modules\product\virtual\handler;
|
||
|
||
use crmeb\trade\order\type\BaseOrderTypeAdapter;
|
||
use crmeb\trade\order\type\Button;
|
||
use crmeb\trade\order\type\OrderFlowNode;
|
||
use modules\product\virtual\model\VirtualOrderModel;
|
||
|
||
/**
|
||
* 网盘商品订单流转定义
|
||
*
|
||
* 网盘商品：无需物流，支付后自动发货即完成
|
||
* 状态流程：pending_payment → completed（直达终态，无中间环节）
|
||
* 任意节点可触发：canceled（取消）/ refunded（退款）
|
||
*
|
||
* ═══════════════ 完整状态流转图 ═══════════════
|
||
*
|
||
* pending_payment 待支付 ──────→ 中台 pending_payment
|
||
* │ 支付成功 → Event → Listener → Flow::advance('completed')
|
||
* ▼
|
||
* completed 已完成 ──────→ 中台 completed
|
||
*
|
||
* 任意节点可触发：
|
||
* → canceled 已取消 ────→ 中台 canceled
|
||
* → after_sale 售后中 ────→ 中台 after_sale
|
||
* → refunded 已退款 ────→ 中台 refunded
|
||
*/
|
||
class VirtualOrderAdapter extends BaseOrderTypeAdapter
|
||
{
|
||
// ======================== 扩展状态常量 ========================
|
||
|
||
/** 待支付 — 订单刚创建 */
|
||
public const EXT_STATUS_PENDING_PAYMENT = 'pending_payment';
|
||
/** 已完成 — 支付后即完成（网盘商品无物流环节） */
|
||
public const EXT_STATUS_COMPLETED = 'completed';
|
||
/** 已取消 — 订单已取消 */
|
||
public const EXT_STATUS_CANCELED = 'canceled';
|
||
/** 已退款 — 订单已退款 */
|
||
public const EXT_STATUS_REFUNDED = 'refunded';
|
||
|
||
// ======================== 1. 身份标识 ========================
|
||
|
||
public static function getSourceType(): string
|
||
{
|
||
return 'virtual_order';
|
||
}
|
||
|
||
public static function getOrderCategory(): string
|
||
{
|
||
return 'goods';
|
||
}
|
||
|
||
public static function getOrderCategoryLabel(): string
|
||
{
|
||
return '商品订单';
|
||
}
|
||
|
||
public static function getModelClass(): string
|
||
{
|
||
return VirtualOrderModel::class;
|
||
}
|
||
|
||
// ======================== 2. 状态树（唯一数据源） ========================
|
||
|
||
protected function defineStatusTree(): array
|
||
{
|
||
return [
|
||
// ───── 待支付 ─────
|
||
OrderFlowNode::make(self::EXT_STATUS_PENDING_PAYMENT)
|
||
->centerStatus(self::STATUS_PENDING_PAYMENT)
|
||
->label('待支付')
|
||
->adminButtons([
|
||
Button::make('取消订单', 'cancelOrder'),
|
||
])
|
||
->userButtons([
|
||
Button::make('取消订单', 'cancelOrder'),
|
||
Button::primary('去支付', 'payOrder'),
|
||
]),
|
||
|
||
// ───── 已完成（终态） ─────
|
||
OrderFlowNode::make(self::EXT_STATUS_COMPLETED)
|
||
->centerStatus(self::STATUS_COMPLETED)
|
||
->label('已完成')
|
||
->adminButtons([])
|
||
->userButtons([
|
||
Button::make('申请售后', 'applyAfterSale'),
|
||
Button::primary('再次购买', 'repurchase'),
|
||
]),
|
||
|
||
// ───── 已取消（终态） ─────
|
||
OrderFlowNode::make(self::EXT_STATUS_CANCELED)
|
||
->centerStatus(self::STATUS_CANCELED)
|
||
->label('已取消')
|
||
->adminButtons([])
|
||
->userButtons([
|
||
Button::make('删除订单', 'deleteOrder'),
|
||
Button::primary('再次购买', 'repurchase'),
|
||
]),
|
||
|
||
// ───── 售后中（由 resolveStatusCode 直接处理） ─────
|
||
OrderFlowNode::make(self::STATUS_AFTER_SALE)
|
||
->centerStatus(self::STATUS_AFTER_SALE)
|
||
->label('退换/售后')
|
||
->adminButtons([
|
||
Button::primary('处理售后', 'handleAfterSale'),
|
||
])
|
||
->userButtons([
|
||
Button::primary('查看售后', 'viewAfterSale'),
|
||
]),
|
||
|
||
// ───── 已退款（终态） ─────
|
||
OrderFlowNode::make(self::STATUS_REFUNDED)
|
||
->centerStatus(self::STATUS_REFUNDED)
|
||
->label('已退款')
|
||
->adminButtons([])
|
||
->userButtons([
|
||
Button::make('删除订单', 'deleteOrder'),
|
||
]),
|
||
];
|
||
}
|
||
|
||
// ======================== 3. 状态推导 ========================
|
||
|
||
/**
|
||
* 推导统一状态码
|
||
* 优先级：取消 > 退款完成 > 售后中 > 未支付 > 已支付→已完成
|
||
*/
|
||
public function resolveStatusCode(array $sourceOrder): string
|
||
{
|
||
if (($sourceOrder['is_cancel'] ?? 0) == 1) {
|
||
return self::STATUS_CANCELED;
|
||
}
|
||
$refundStatus = (int)($sourceOrder['refund_status'] ?? 0);
|
||
if ($refundStatus === 2) {
|
||
return self::STATUS_REFUNDED;
|
||
}
|
||
if ($refundStatus === 1) {
|
||
return self::STATUS_AFTER_SALE;
|
||
}
|
||
// 扩展表不一定携带 paid 字段，网盘商品 status=completed 即视为已支付
|
||
$isPaid = (bool)($sourceOrder['paid'] ?? 0)
|
||
|| ($sourceOrder['status'] ?? '') === self::EXT_STATUS_COMPLETED;
|
||
if (!$isPaid) {
|
||
return self::STATUS_PENDING_PAYMENT;
|
||
}
|
||
return self::STATUS_COMPLETED;
|
||
}
|
||
|
||
/**
|
||
* 推导支付状态
|
||
*/
|
||
public function resolvePayStatus(array $sourceOrder): int
|
||
{
|
||
$refundStatus = (int)($sourceOrder['refund_status'] ?? 0);
|
||
if ($refundStatus === 2) {
|
||
$refundPrice = (float)($sourceOrder['refund_price'] ?? 0);
|
||
$payPrice = (float)($sourceOrder['pay_price'] ?? 0);
|
||
return $refundPrice >= $payPrice ? self::PAY_FULL_REFUND : self::PAY_PARTIAL_REFUND;
|
||
}
|
||
$isPaid = (bool)($sourceOrder['paid'] ?? 0)
|
||
|| ($sourceOrder['status'] ?? '') === self::EXT_STATUS_COMPLETED;
|
||
return $isPaid ? self::PAY_PAID : self::PAY_UNPAID;
|
||
}
|
||
|
||
/**
|
||
* 推导退款状态
|
||
*/
|
||
public function resolveRefundStatus(array $sourceOrder): int
|
||
{
|
||
return (int)($sourceOrder['refund_status'] ?? 0);
|
||
}
|
||
|
||
/**
|
||
* 推导业务状态
|
||
* 网盘商品无中间业务状态，已支付即已完成
|
||
*/
|
||
public function resolveBusinessStatus(array $sourceOrder): ?array
|
||
{
|
||
if (($sourceOrder['is_cancel'] ?? 0) == 1 || ($sourceOrder['refund_status'] ?? 0) >= 2) {
|
||
return null;
|
||
}
|
||
if (($sourceOrder['paid'] ?? 0) == 0) {
|
||
return null;
|
||
}
|
||
return null; // 无中间业务状态
|
||
}
|
||
|
||
// ======================== 4. 进度条 ========================
|
||
|
||
/**
|
||
* 网盘商品订单生命周期进度条
|
||
* 节点：提交订单 → 支付成功 → 订单完成（网盘商品无物流）
|
||
*/
|
||
public function getProgress(array $detail): array
|
||
{
|
||
$statusCode = $detail['status_code'] ?? '';
|
||
$isCancel = $statusCode === self::STATUS_CANCELED;
|
||
$isRefunded = $statusCode === self::STATUS_REFUNDED;
|
||
$isAfterSale = $statusCode === self::STATUS_AFTER_SALE;
|
||
$isCompleted = $statusCode === self::STATUS_COMPLETED;
|
||
$isPendingPayment = $statusCode === self::STATUS_PENDING_PAYMENT;
|
||
|
||
$nodes = [
|
||
['title' => '提交订单', 'key' => 'submit', 'time_field' => 'add_time'],
|
||
['title' => '支付成功', 'key' => 'pay', 'time_field' => 'pay_time'],
|
||
['title' => '订单完成', 'key' => 'complete', 'time_field' => ''],
|
||
];
|
||
|
||
foreach ($nodes as $i => &$node) {
|
||
$time = $node['time_field'] ? (int)($detail[$node['time_field']] ?? 0) : 0;
|
||
$node['time'] = $time ? date('Y-m-d H:i:s', $time) : '';
|
||
$node['completed'] = $time > 0;
|
||
$node['active'] = false;
|
||
}
|
||
unset($node);
|
||
|
||
// 已完成节点由状态码决定，不能仅凭 pay_time 判断
|
||
$nodes[2]['completed'] = $isCompleted;
|
||
if ($isCompleted) {
|
||
$nodes[2]['time'] = $detail['pay_time'] ? date('Y-m-d H:i:s', (int)$detail['pay_time']) : '';
|
||
}
|
||
|
||
// 待支付状态：支付/完成节点不应显示已完成，避免脏数据误导
|
||
if ($isPendingPayment) {
|
||
$nodes[1]['completed'] = false;
|
||
$nodes[1]['time'] = '';
|
||
$nodes[2]['completed'] = false;
|
||
$nodes[2]['time'] = '';
|
||
}
|
||
|
||
$current = -1;
|
||
if ($isCancel) {
|
||
$current = 0;
|
||
} elseif ($isRefunded || $isAfterSale) {
|
||
$current = 1;
|
||
} elseif ($isCompleted) {
|
||
$current = 2;
|
||
} elseif ($isPendingPayment) {
|
||
// 待支付状态以状态码为准，不依赖时间字段
|
||
$current = 0;
|
||
} elseif ((int)($detail['pay_time'] ?? 0) > 0) {
|
||
// 有支付时间但非完成态，停留在支付成功节点
|
||
$current = 1;
|
||
} elseif ((int)($detail['add_time'] ?? 0) > 0) {
|
||
$current = 0;
|
||
}
|
||
|
||
if ($current < 0) {
|
||
$current = 0;
|
||
foreach ($nodes as $i => $node) {
|
||
if ($node['completed']) {
|
||
$current = $i;
|
||
}
|
||
}
|
||
}
|
||
|
||
if (isset($nodes[$current])) {
|
||
$nodes[$current]['active'] = true;
|
||
}
|
||
|
||
return [
|
||
'current' => $current,
|
||
'status' => $statusCode,
|
||
'nodes' => $nodes,
|
||
];
|
||
}
|
||
|
||
// ======================== 5. 按钮逻辑 ========================
|
||
|
||
public function getStatusButtons(string $statusCode, array $detail = []): array
|
||
{
|
||
// 网盘商品理论上不存在 processing 状态，但过渡期内部分旧数据/脏数据可能残留
|
||
// 将 processing 状态按 completed 处理，保证用户端能看到操作按钮
|
||
if ($statusCode === self::STATUS_PROCESSING) {
|
||
$statusCode = self::STATUS_COMPLETED;
|
||
}
|
||
|
||
$node = $this->centerStatusMap[$statusCode][0] ?? null;
|
||
if ($node) {
|
||
return $node['user_buttons'] ?? [];
|
||
}
|
||
return $this->extStatusMap[$statusCode]['user_buttons'] ?? [];
|
||
}
|
||
}
|