工单行内新增 handling_log 列,用户申请、用户撤销与后台每次改状态都落一条
「状态 + 备注 + 来源 + 时间」,按时间正序存放、上限 50 条(对齐
MetaAssetService::MAX_RECORDS)。set_status 因此变成读-改-写,补上
GET_LOCK/RELEASE_LOCK 包裹,并在锁内重读工单快照——锁外取快照仍会被并发
追加覆盖。
三处界面由「只显示最后一条」改为回放整条处理链路:
- 后台订单明细「售后记录」按工单渲染头部(状态/金额/申请时间)+ 原因 +
完整处理记录
- 售后面板手风琴「处理备注」单独占整行并置于「申请说明」上方,删掉已无
意义的「审核时间」
- 前台售后详细弹窗与订单详情弹窗的售后记录改为时间线:左列绳结状态条
(节点 + 状态 + 时间),右列处理备注;样式只在 modal-runtime.css 定义
一份,两个弹窗共用
清理随之失效的死代码:工单的 admin_note / reviewed_at / completed_at,以及
全仓库无写入方的 gateway_request_id / gateway_refund_id / gateway_result;
连带删掉 gatewayResultText()、uninstall 里从未存在过的 aksrt_after_sale
表项,并把两处后台页面重复的状态标签数组收成 after_sale_status_labels()、
重复的 .aksrt-as-log 样式收成 after_sale_log_css()。
顺带修复 88669f69 重构退款流水线时误删 refund_amount()、却仍在 create()
里调用的问题——此前任何用户提交售后都会直接 fatal。
验证:tests/widget-system/ 462 项、tests/admin/ 76 项通过;新增
after-sale-log-harness.php 驱动真实 AfterSaleService,覆盖首条日志、空备注
也留痕、撤销记录、50 条上限与畸形行规范化;两个后台页面经 dev harness
渲染校验「处理备注」宽行位于「申请说明」之前;未做浏览器视觉验收。
225 lines
10 KiB
PHP
225 lines
10 KiB
PHP
<?php
|
|
/**
|
|
* After-sale handling-log harness.
|
|
*
|
|
* Drives the REAL AfterSaleService against an in-memory $wpdb stand-in so the
|
|
* handling-log contract is covered end to end: every state submission appends one
|
|
* 「status + note + source + created_at」 entry, the log stays chronological, it is
|
|
* capped, and malformed rows normalize instead of fataling.
|
|
*
|
|
* Usage: php after-sale-log-harness.php -> prints a JSON result object.
|
|
*/
|
|
|
|
namespace {
|
|
define('ARRAY_A', 'ARRAY_A');
|
|
|
|
final class WP_Error {
|
|
public function __construct(private string $code, private string $message, private array $data = []) {}
|
|
public function get_error_code(): string { return $this->code; }
|
|
public function get_error_message(): string { return $this->message; }
|
|
public function get_error_data(): array { return $this->data; }
|
|
}
|
|
|
|
define('ABSPATH', __DIR__ . '/');
|
|
|
|
// ---------- WP function stubs ----------
|
|
function __($s, $d = null) { return (string) $s; }
|
|
function esc_html($s) { return htmlspecialchars((string) $s, ENT_QUOTES); }
|
|
function esc_url_raw($s) { return (string) $s; }
|
|
function sanitize_key($s) { return preg_replace('/[^a-z0-9_\-]/', '', strtolower((string) $s)) ?? ''; }
|
|
function sanitize_text_field($s) { return trim(strip_tags((string) $s)); }
|
|
function sanitize_textarea_field($s) { return trim(strip_tags((string) $s)); }
|
|
function wp_json_encode($v, $f = 0) { return (string) json_encode($v, $f); }
|
|
function current_user_can($c) { return true; }
|
|
|
|
// Monotonic clock: every append must land on a strictly later timestamp so the
|
|
// chronological ordering assertion is meaningful.
|
|
$GLOBALS['aksrt_log_now'] = strtotime('2026-10-01 10:00:00');
|
|
function current_time($type = 'mysql', $gmt = false) {
|
|
$GLOBALS['aksrt_log_now'] += 1;
|
|
return gmdate('Y-m-d H:i:s', $GLOBALS['aksrt_log_now']);
|
|
}
|
|
|
|
// ---------- In-memory $wpdb ----------
|
|
final class FakeWpdb {
|
|
public string $prefix = 'wp_';
|
|
/** @var array<int,array<string,mixed>> keyed by after-sale id */
|
|
public array $rows = [];
|
|
public int $insert_id = 0;
|
|
private int $next_id = 100;
|
|
|
|
public function prepare(string $sql, ...$args) {
|
|
if (count($args) === 1 && is_array($args[0])) $args = $args[0];
|
|
$i = 0;
|
|
return preg_replace_callback('/%[sd]/', static function ($m) use (&$i, $args): string {
|
|
if ($i >= count($args)) return $m[0];
|
|
$value = $args[$i++];
|
|
return $m[0][1] === 'd' ? (string) (int) $value : "'" . str_replace("'", "''", (string) $value) . "'";
|
|
}, $sql) ?? $sql;
|
|
}
|
|
|
|
public function get_var(string $sql) {
|
|
if (preg_match("/GET_LOCK\('/", $sql)) return 1;
|
|
if (preg_match("/RELEASE_LOCK\('/", $sql)) return 1;
|
|
if (str_starts_with($sql, 'SELECT COUNT(*)')) return count($this->rows);
|
|
throw new RuntimeException('unsupported get_var: ' . $sql);
|
|
}
|
|
|
|
public function get_row(string $sql, $output = null) {
|
|
if (preg_match("/WHERE id = (\d+)$/", $sql, $m)) return $this->rows[(int) $m[1]] ?? null;
|
|
if (preg_match("/WHERE order_number = '([^']*)'/", $sql, $m)) {
|
|
$statuses = preg_match("/status IN \(([^)]*)\)/", $sql, $s) ? explode(',', str_replace("'", '', $s[1])) : null;
|
|
$found = null;
|
|
foreach ($this->rows as $row) {
|
|
if ((string) ($row['order_number'] ?? '') !== $m[1]) continue;
|
|
if ($statuses !== null && !in_array((string) ($row['status'] ?? ''), array_map('trim', $statuses), true)) continue;
|
|
if ($found === null || (int) $row['id'] > (int) $found['id']) $found = $row;
|
|
}
|
|
return $found;
|
|
}
|
|
throw new RuntimeException('unsupported get_row: ' . $sql);
|
|
}
|
|
|
|
public function get_results(string $sql, $output = null) {
|
|
if (preg_match("/WHERE order_number = '([^']*)'/", $sql, $m)) {
|
|
$rows = array_values(array_filter($this->rows, static fn($row): bool => (string) ($row['order_number'] ?? '') === $m[1]));
|
|
usort($rows, static fn($a, $b): int => (int) $b['id'] <=> (int) $a['id']);
|
|
return $rows;
|
|
}
|
|
throw new RuntimeException('unsupported get_results: ' . $sql);
|
|
}
|
|
|
|
public function insert(string $table, array $data, array $formats = []) {
|
|
$id = $this->next_id++;
|
|
$this->rows[$id] = $data + ['id' => $id];
|
|
$this->insert_id = $id;
|
|
return 1;
|
|
}
|
|
|
|
public function update(string $table, array $data, array $where, array $formats = [], array $where_formats = []) {
|
|
$id = (int) ($where['id'] ?? 0);
|
|
if (!isset($this->rows[$id])) return false;
|
|
$this->rows[$id] = array_merge($this->rows[$id], $data);
|
|
return 1;
|
|
}
|
|
}
|
|
|
|
// ---------- Domain stubs the service collaborates with ----------
|
|
require __DIR__ . '/../../src/Ledger/AssetType.php';
|
|
require __DIR__ . '/../../src/Ledger/AssetAmount.php';
|
|
}
|
|
|
|
namespace AKSRT\Core {
|
|
final class DBMigrator {
|
|
public static function table(string $name): string { return 'wp_aksrt_' . $name; }
|
|
}
|
|
}
|
|
|
|
namespace AKSRT\Payment {
|
|
final class Order {
|
|
public const STATUS_PAID = 'paid';
|
|
}
|
|
|
|
final class OrderRepository {
|
|
private static $i;
|
|
/** @var array<string,array<string,mixed>> keyed by order number */
|
|
public static array $orders = [];
|
|
public static function get_instance(): self { return self::$i ?: self::$i = new self(); }
|
|
public function get_user_order(int $user_id, string $order_number): ?array {
|
|
return self::$orders[$order_number] ?? null;
|
|
}
|
|
}
|
|
|
|
require __DIR__ . '/../../src/Payment/AfterSaleService.php';
|
|
}
|
|
|
|
namespace {
|
|
$GLOBALS['aksrt_wpdb'] = new FakeWpdb();
|
|
// The service reaches for the real global $wpdb, so the stand-in has to live there.
|
|
$GLOBALS['wpdb'] = $GLOBALS['aksrt_wpdb'];
|
|
|
|
/** @return list<string> */
|
|
function run(): array {
|
|
$wpdb = $GLOBALS['aksrt_wpdb'];
|
|
$service = \AKSRT\Payment\AfterSaleService::get_instance();
|
|
$order = ['order_number' => '20261001100000000001', 'user_id' => 7, 'status' => 'paid', 'currency' => 'CNY', 'amount' => '12.50'];
|
|
\AKSRT\Payment\OrderRepository::$orders = [$order['order_number'] => $order];
|
|
|
|
// 1) create() seeds the log with the user's own submission.
|
|
$wpdb->rows = [];
|
|
$created = $service->create(7, $order['order_number'], '商品与描述不符');
|
|
if ($created instanceof \WP_Error) return ['error' => 'create failed: ' . $created->get_error_message()];
|
|
$log = $created['handling_log'];
|
|
$results = [];
|
|
$results[] = ['name' => 'create_seeds_single_user_entry', 'ok' => count($log) === 1
|
|
&& $log[0]['status'] === 'pending'
|
|
&& $log[0]['source'] === 'user'
|
|
&& $log[0]['note'] === ''
|
|
&& $log[0]['created_at'] === $created['created_at'],
|
|
'detail' => $log];
|
|
|
|
// 2) Every admin submission appends, even with an empty note; order is chronological.
|
|
$service->set_status((int) $created['id'], 'processing', '已联系仓库核实');
|
|
$service->set_status((int) $created['id'], 'completed', '已原路退款');
|
|
$service->set_status((int) $created['id'], 'rejected', '');
|
|
$log = $service->get((int) $created['id'])['handling_log'];
|
|
$results[] = ['name' => 'status_changes_append_even_without_note', 'ok' => count($log) === 4
|
|
&& $log[1] === ['status' => 'processing', 'note' => '已联系仓库核实', 'source' => 'admin', 'created_at' => $log[1]['created_at']]
|
|
&& $log[2]['status'] === 'completed' && $log[2]['note'] === '已原路退款'
|
|
&& $log[3]['status'] === 'rejected' && $log[3]['note'] === ''
|
|
&& $log[0]['created_at'] < $log[1]['created_at']
|
|
&& $log[1]['created_at'] < $log[2]['created_at']
|
|
&& $log[2]['created_at'] < $log[3]['created_at'],
|
|
'detail' => $log];
|
|
|
|
// 3) A user-side cancel is logged as a user entry.
|
|
$wpdb->rows = [];
|
|
$second = $service->create(7, $order['order_number'], '拍错了');
|
|
$service->cancel_for_user(7, $order['order_number']);
|
|
$log = $service->get((int) $second['id'])['handling_log'];
|
|
$last = end($log);
|
|
$results[] = ['name' => 'cancel_appends_user_entry', 'ok' => count($log) === 2
|
|
&& $last['status'] === 'cancelled' && $last['source'] === 'user' && $last['note'] === '',
|
|
'detail' => $log];
|
|
|
|
// 4) The log is capped, keeping the most recent entries.
|
|
$wpdb->rows = [];
|
|
$seeded = [];
|
|
for ($i = 1; $i <= 50; $i++) {
|
|
$seeded[] = ['status' => 'processing', 'note' => 'seed-' . $i, 'source' => 'admin', 'created_at' => sprintf('2026-10-01 10:%02d:00', $i)];
|
|
}
|
|
$wpdb->rows[900] = ['id' => 900, 'order_number' => $order['order_number'], 'user_id' => 7, 'status' => 'processing', 'handling_log' => wp_json_encode($seeded), 'created_at' => '2026-10-01 10:01:00'];
|
|
$service->set_status(900, 'completed', '第五十条');
|
|
$log = $service->get(900)['handling_log'];
|
|
$results[] = ['name' => 'log_is_capped_at_50', 'ok' => count($log) === 50
|
|
&& $log[0]['note'] === 'seed-2'
|
|
&& end($log)['note'] === '第五十条',
|
|
'detail' => ['count' => count($log), 'first' => $log[0]['note'], 'last' => end($log)['note']]];
|
|
|
|
// 5) Malformed rows normalize instead of fataling.
|
|
$wpdb->rows[901] = ['id' => 901, 'order_number' => $order['order_number'], 'user_id' => 7, 'status' => 'processing',
|
|
'handling_log' => wp_json_encode([
|
|
['status' => 'pending', 'note' => 'ok', 'source' => 'user', 'created_at' => '2026-10-01 10:00:00'],
|
|
['status' => '', 'note' => 'no status', 'source' => 'admin', 'created_at' => '2026-10-01 10:05:00'],
|
|
['note' => 'not an array value', 'source' => 'admin', 'created_at' => '2026-10-01 10:06:00'],
|
|
'garbage',
|
|
['status' => 'completed', 'source' => 'mystery', 'created_at' => '2026-10-01 10:07:00'],
|
|
])];
|
|
$wpdb->rows[902] = ['id' => 902, 'order_number' => $order['order_number'], 'user_id' => 7, 'status' => 'pending', 'handling_log' => 'not-json'];
|
|
$normalized = $service->get(901)['handling_log'];
|
|
$broken = $service->get(902)['handling_log'];
|
|
$results[] = ['name' => 'normalize_drops_malformed_entries', 'ok' => count($normalized) === 2
|
|
&& $normalized[0]['status'] === 'pending'
|
|
&& $normalized[1] === ['status' => 'completed', 'note' => '', 'source' => 'admin', 'created_at' => '2026-10-01 10:07:00']
|
|
&& $broken === [],
|
|
'detail' => ['normalized' => $normalized, 'broken_json' => $broken]];
|
|
|
|
return $results;
|
|
}
|
|
|
|
$results = run();
|
|
$failed = array_values(array_filter($results, static fn($r): bool => empty($r['ok'])));
|
|
echo json_encode(['passed' => count($results) - count($failed), 'failed' => count($failed), 'results' => $results], JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT) . "\n";
|
|
exit($failed ? 1 : 0);
|
|
}
|