wordpress-theme-aksrt/src/AKSRT/Admin/Native/PayShipping.php

<?php
/**
 * @package AKSRT
 */

namespace AKSRT\Admin\Native;

defined('ABSPATH') || exit;

class PayShipping {

    public const CAPABILITY = 'manage_options';
    public const PAGE_SLUG  = 'aksrt_shipping';

    private static $instance = null;

    public static function get_instance(): self {
        if (null === self::$instance) {
            self::$instance = new self();
        }
        return self::$instance;
    }

    public function init(): void {
        if (!is_admin()) {
            return;
        }
        add_action('admin_post_aksrt_pay_update_shipping', [$this, 'handle_update_shipping']);
        add_action('admin_post_aksrt_pay_query_express', [$this, 'handle_query_express']);
        add_action('admin_post_aksrt_pay_create_shipping', [$this, 'handle_create_shipping']);
    }

    public function render_shipping_page(): void {
        $this->ensure_cap();
        $this->render_header(__('发货及物流', 'aksrt'));

        if (!class_exists('\AKSRT\Payment\Shipping')) {
            echo '<div class="notice notice-error"><p>' . esc_html__('物流模块未初始化。', 'aksrt') . '</p></div>';
            $this->render_footer();
            return;
        }

        $view     = isset($_GET['view']) ? sanitize_key((string) wp_unslash($_GET['view'])) : 'records';
        if (!in_array($view, ['records', 'pending'], true)) {
            $view = 'records';
        }
        $status   = isset($_GET['status']) ? sanitize_key((string) wp_unslash($_GET['status'])) : '';
        $search   = isset($_GET['s']) ? sanitize_text_field((string) wp_unslash($_GET['s'])) : '';
        $page_num = max(1, (int) ($_GET['paged'] ?? 1));
        $per_page = 20;
        $svc      = \AKSRT\Payment\Shipping::get_instance();
        $stats    = $svc->get_stats();
        $status_options = $this->shipping_status_options(true);

        $pending_total = 0;
        if (class_exists('\AKSRT\Payment\OrderRepository')) {
            $pending_total = (int) (\AKSRT\Payment\OrderRepository::get_instance()->get_pending_shipment_orders(['limit' => 1, 'search' => ''])['total'] ?? 0);
        }

        echo '<p>' . esc_html(sprintf(
            /* translators: 1: shipping records 2: pending shipment orders */
            __('物流记录 %1$d 条 · 待发货订单 %2$d', 'aksrt'),
            (int) ($stats['total'] ?? 0),
            $pending_total
        )) . '</p>';

        echo '<h2 class="nav-tab-wrapper" style="margin:12px 0 16px;">';
        printf(
            '<a href="%s" class="nav-tab%s">%s</a>',
            esc_url($this->page_url('aksrt_shipping', ['view' => 'pending'])),
            $view === 'pending' ? ' nav-tab-active' : '',
            esc_html(sprintf(__('待发货 (%d)', 'aksrt'), $pending_total))
        );
        printf(
            '<a href="%s" class="nav-tab%s">%s</a>',
            esc_url($this->page_url('aksrt_shipping', ['view' => 'records'])),
            $view === 'records' ? ' nav-tab-active' : '',
            esc_html__('物流记录', 'aksrt')
        );
        echo '</h2>';

        if ($view === 'pending') {
            $this->render_pending_shipment_board($search, $page_num, $per_page);
            $this->render_footer();
            return;
        }

        echo '<h2>' . esc_html__('新建发货', 'aksrt') . '</h2>';
        echo '<form method="post" action="' . esc_url(admin_url('admin-post.php')) . '" style="margin:8px 0 20px;display:flex;flex-wrap:wrap;gap:8px;align-items:end;">';
        echo '<input type="hidden" name="action" value="aksrt_pay_create_shipping" />';
        echo '<input type="hidden" name="redirect_page" value="shipping" />';
        wp_nonce_field('aksrt_pay_create_shipping');
        echo '<p><label>' . esc_html__('订单号', 'aksrt') . '<br><input type="text" name="order_number" value="' . esc_attr($search) . '" required class="regular-text" /></label></p>';
        echo '<p><label>' . esc_html__('承运商', 'aksrt') . '<br>';
        $this->render_carrier_field('');
        echo '</label></p>';
        echo '<p><label>' . esc_html__('运单号', 'aksrt') . '<br><input type="text" name="tracking_no" required /></label></p>';
        echo '<p><label>' . esc_html__('备注', 'aksrt') . '<br><input type="text" name="note" /></label></p>';
        submit_button(__('创建发货', 'aksrt'), 'primary', '', false);
        echo '</form>';

        echo '<form method="get" style="margin:12px 0;">';
        echo '<input type="hidden" name="page" value="aksrt_shipping" />';
        echo '<input type="hidden" name="view" value="records" />';
        echo '<select name="status">';
        foreach ($status_options as $key => $label) {
            printf('<option value="%s"%s>%s</option>', esc_attr($key), selected($status, $key, false), esc_html($label));
        }
        echo '</select> ';
        echo '<input type="search" name="s" value="' . esc_attr($search) . '" placeholder="' . esc_attr__('订单号 / 运单号', 'aksrt') . '" /> ';
        submit_button(__('筛选', 'aksrt'), 'secondary', '', false);
        echo '</form>';

        $args = [
            'status' => $status,
            'limit'  => $per_page,
            'offset' => ($page_num - 1) * $per_page,
        ];
        if ($search !== '') {
            if (preg_match('/^[A-Za-z0-9_-]+$/', $search)) {
                $args['order_number'] = $search;
            } else {
                $args['tracking_no'] = $search;
            }
        }
        $result = $svc->get_list($args);
        $items  = $result['items'] ?? [];
        $total  = (int) ($result['total'] ?? 0);
        $pages  = max(1, (int) ceil(max(1, $total) / $per_page));
        $row_status_options = $this->shipping_status_options(false);
        $show_express_id = isset($_GET['express_id']) ? (int) $_GET['express_id'] : 0;

        echo '<table class="wp-list-table widefat fixed striped"><thead><tr>';
        echo '<th>ID</th><th>' . esc_html__('订单号', 'aksrt') . '</th><th>' . esc_html__('承运商', 'aksrt') . '</th><th>' . esc_html__('运单号', 'aksrt') . '</th><th>' . esc_html__('状态', 'aksrt') . '</th><th>' . esc_html__('时间', 'aksrt') . '</th><th>' . esc_html__('操作', 'aksrt') . '</th>';
        echo '</tr></thead><tbody>';
        if (!$items) {
            echo '<tr><td colspan="7">' . esc_html__('暂无物流记录', 'aksrt') . '</td></tr>';
        }
        foreach ($items as $row) {
            $id = (int) ($row['id'] ?? 0);
            $st = (string) ($row['status'] ?? '');
            $order_number = (string) ($row['order_number'] ?? '');
            echo '<tr>';
            echo '<td>' . esc_html((string) $id) . '</td>';
            echo '<td><a href="' . esc_url($this->page_url('aksrt_orders', ['order' => $order_number])) . '"><code>' . esc_html($order_number) . '</code></a></td>';
            echo '<td>' . esc_html((string) ($row['carrier'] ?? '')) . '</td>';
            echo '<td>' . esc_html((string) ($row['tracking_no'] ?? '')) . '</td>';
            echo '<td>' . esc_html($row_status_options[$st] ?? $st) . '</td>';
            echo '<td>' . esc_html((string) ($row['created_at'] ?? '')) . '</td>';
            echo '<td style="display:flex;gap:6px;flex-wrap:wrap;align-items:center;">';
            echo '<form method="post" action="' . esc_url(admin_url('admin-post.php')) . '" style="display:flex;gap:4px;align-items:center;">';
            echo '<input type="hidden" name="action" value="aksrt_pay_update_shipping" />';
            echo '<input type="hidden" name="shipping_id" value="' . esc_attr((string) $id) . '" />';
            wp_nonce_field('aksrt_pay_update_shipping_' . $id);
            echo '<select name="new_status">';
            foreach ($row_status_options as $key => $label) {
                printf('<option value="%s"%s>%s</option>', esc_attr($key), selected($st, $key, false), esc_html($label));
            }
            echo '</select>';
            echo '<input type="text" name="note" placeholder="' . esc_attr__('备注', 'aksrt') . '" />';
            submit_button(__('更新', 'aksrt'), 'small', '', false);
            echo '</form>';
            echo '<form method="post" action="' . esc_url(admin_url('admin-post.php')) . '">';
            echo '<input type="hidden" name="action" value="aksrt_pay_query_express" />';
            echo '<input type="hidden" name="shipping_id" value="' . esc_attr((string) $id) . '" />';
            echo '<input type="hidden" name="force" value="1" />';
            wp_nonce_field('aksrt_pay_query_express_' . $id);
            submit_button(__('查物流', 'aksrt'), 'small', '', false);
            echo '</form>';
            echo '<a class="button button-small" href="' . esc_url($this->page_url('aksrt_shipping', ['view' => 'records', 'express_id' => $id, 's' => $order_number])) . '">' . esc_html__('轨迹', 'aksrt') . '</a>';
            echo '</td></tr>';
            if ($show_express_id === $id) {
                echo '<tr class="aksrt-express-row"><td colspan="7">';
                $this->render_express_timeline_panel($id);
                echo '</td></tr>';
            }
        }
        echo '</tbody></table>';
        $this->render_pagination($pages, $page_num);
        $this->render_footer();
    }

    private function render_pending_shipment_board(string $search, int $page_num, int $per_page): void {
        if (!class_exists('\AKSRT\Payment\OrderRepository')) {
            echo '<div class="notice notice-error"><p>' . esc_html__('订单服务不可用。', 'aksrt') . '</p></div>';
            return;
        }

        echo '<form method="get" style="margin:12px 0;">';
        echo '<input type="hidden" name="page" value="aksrt_shipping" />';
        echo '<input type="hidden" name="view" value="pending" />';
        echo '<input type="search" name="s" value="' . esc_attr($search) . '" placeholder="' . esc_attr__('订单号 / 类型', 'aksrt') . '" /> ';
        submit_button(__('筛选', 'aksrt'), 'secondary', '', false);
        echo '</form>';

        $result = \AKSRT\Payment\OrderRepository::get_instance()->get_pending_shipment_orders([
            'search' => $search,
            'limit'  => $per_page,
            'offset' => ($page_num - 1) * $per_page,
        ]);
        $items = $result['items'] ?? [];
        $total = (int) ($result['total'] ?? 0);
        $pages = max(1, (int) ($result['max_pages'] ?? 1));
        $labels = class_exists('\AKSRT\Core\DomainModel')
            ? \AKSRT\Core\DomainModel::order_status_labels()
            : [];

        echo '<table class="wp-list-table widefat fixed striped"><thead><tr>';
        echo '<th>' . esc_html__('订单号', 'aksrt') . '</th>';
        echo '<th>' . esc_html__('用户', 'aksrt') . '</th>';
        echo '<th>' . esc_html__('类型', 'aksrt') . '</th>';
        echo '<th>' . esc_html__('金额', 'aksrt') . '</th>';
        echo '<th>' . esc_html__('状态', 'aksrt') . '</th>';
        echo '<th>' . esc_html__('支付时间', 'aksrt') . '</th>';
        echo '<th>' . esc_html__('立即发货', 'aksrt') . '</th>';
        echo '</tr></thead><tbody>';

        if (!$items) {
            echo '<tr><td colspan="7">' . esc_html__('暂无待发货订单', 'aksrt') . '</td></tr>';
        }

        foreach ($items as $row) {
            $order_number = (string) ($row['order_number'] ?? '');
            $user_id = (int) ($row['user_id'] ?? 0);
            $user = $user_id > 0 ? get_userdata($user_id) : null;
            $status_key = (string) ($row['status'] ?? '');
            echo '<tr>';
            echo '<td><a href="' . esc_url($this->page_url('aksrt_orders', ['order' => $order_number])) . '"><code>' . esc_html($order_number) . '</code></a></td>';
            echo '<td>' . ($user ? esc_html($user->display_name . ' (#' . $user_id . ')') : esc_html((string) $user_id)) . '</td>';
            echo '<td>' . esc_html((string) ($row['product_type'] ?? '')) . '</td>';
            echo '<td>' . esc_html(number_format((float) ($row['amount'] ?? 0), 2)) . ' ' . esc_html((string) ($row['currency'] ?? '')) . '</td>';
            echo '<td>' . esc_html($labels[$status_key] ?? $status_key) . '</td>';
            echo '<td>' . esc_html((string) ($row['paid_at'] ?? $row['created_at'] ?? '')) . '</td>';
            echo '<td>';
            echo '<form method="post" action="' . esc_url(admin_url('admin-post.php')) . '" style="display:flex;flex-wrap:wrap;gap:4px;align-items:center;">';
            echo '<input type="hidden" name="action" value="aksrt_pay_create_shipping" />';
            echo '<input type="hidden" name="order_number" value="' . esc_attr($order_number) . '" />';
            echo '<input type="hidden" name="redirect_page" value="pending" />';
            wp_nonce_field('aksrt_pay_create_shipping_' . $order_number);
            $this->render_carrier_field('');
            echo '<input type="text" name="tracking_no" required placeholder="' . esc_attr__('运单号', 'aksrt') . '" />';
            echo '<input type="text" name="note" placeholder="' . esc_attr__('备注', 'aksrt') . '" />';
            submit_button(__('发货', 'aksrt'), 'primary small', '', false);
            echo '</form>';
            echo '</td>';
            echo '</tr>';
        }
        echo '</tbody></table>';
        $this->render_pagination($pages, $page_num);
    }

    public function handle_update_shipping(): void {
        if (!current_user_can(self::CAPABILITY)) {
            wp_die(esc_html__('权限不足', 'aksrt'));
        }
        $id         = isset($_POST['shipping_id']) ? (int) $_POST['shipping_id'] : 0;
        $new_status = isset($_POST['new_status']) ? sanitize_key((string) wp_unslash($_POST['new_status'])) : '';
        $note       = isset($_POST['note']) ? sanitize_textarea_field((string) wp_unslash($_POST['note'])) : '';
        check_admin_referer('aksrt_pay_update_shipping_' . $id);

        $ok = false;
        if ($id > 0 && $new_status !== '' && class_exists('\AKSRT\Payment\Shipping')) {
            $ok = \AKSRT\Payment\Shipping::get_instance()->update_status($id, $new_status, $note, get_current_user_id());
        }

        $redirect_order = isset($_POST['redirect_order']) ? sanitize_text_field((string) wp_unslash($_POST['redirect_order'])) : '';
        if ($redirect_order !== '') {
            wp_safe_redirect($this->page_url('aksrt_orders', [
                'order'         => $redirect_order,
                'aksrt_pay_msg' => $ok ? 'shipping_updated' : 'shipping_failed',
            ]));
            exit;
        }

        wp_safe_redirect($this->page_url('aksrt_shipping', [
            'view'          => 'records',
            'aksrt_pay_msg' => $ok ? 'shipping_updated' : 'shipping_failed',
        ]));
        exit;
    }

    public function handle_query_express(): void {
        if (!current_user_can(self::CAPABILITY)) {
            wp_die(esc_html__('权限不足', 'aksrt'));
        }
        $id = isset($_POST['shipping_id']) ? (int) $_POST['shipping_id'] : 0;
        $force = !empty($_POST['force']);
        check_admin_referer('aksrt_pay_query_express_' . $id);

        $ok = false;
        $order_number = '';
        if ($id > 0 && class_exists('\AKSRT\Payment\Shipping')) {
            $svc = \AKSRT\Payment\Shipping::get_instance();
            $record = $svc->get($id);
            $order_number = is_array($record) ? (string) ($record['order_number'] ?? '') : '';
            $result = $svc->query_express($id, $force);
            $ok = !empty($result['success']);
        }

        wp_safe_redirect($this->page_url('aksrt_shipping', [
            'view'          => 'records',
            'express_id'    => $id,
            's'             => $order_number,
            'aksrt_pay_msg' => $ok ? 'express_ok' : 'express_failed',
        ]));
        exit;
    }

    public function handle_create_shipping(): void {
        if (!current_user_can(self::CAPABILITY)) {
            wp_die(esc_html__('权限不足', 'aksrt'));
        }
        $order_number = isset($_POST['order_number']) ? sanitize_text_field((string) wp_unslash($_POST['order_number'])) : '';
        $redirect_page = isset($_POST['redirect_page']) ? sanitize_key((string) wp_unslash($_POST['redirect_page'])) : 'order';
        $nonce_action = $redirect_page === 'shipping' ? 'aksrt_pay_create_shipping' : ('aksrt_pay_create_shipping_' . $order_number);
        check_admin_referer($nonce_action);

        $ok = false;
        if ($order_number !== '' && class_exists('\AKSRT\Payment\Shipping')) {
            if (class_exists('\AKSRT\Payment\OrderRepository')) {
                $order = \AKSRT\Payment\OrderRepository::get_instance()->get($order_number);
                if (!$order) {
                    $this->redirect_shipping_create_result(false, $order_number, $redirect_page);
                }
            }
            $id = \AKSRT\Payment\Shipping::get_instance()->create([
                'order_number' => $order_number,
                'carrier'      => sanitize_text_field((string) wp_unslash($_POST['carrier'] ?? '')),
                'tracking_no'  => sanitize_text_field((string) wp_unslash($_POST['tracking_no'] ?? '')),
                'note'         => sanitize_textarea_field((string) wp_unslash($_POST['note'] ?? '')),
                'operator_id'  => get_current_user_id(),
            ]);
            $ok = $id > 0;
        }

        $this->redirect_shipping_create_result($ok, $order_number, $redirect_page);
    }

    private function redirect_shipping_create_result(bool $ok, string $order_number, string $redirect_page): void {
        $msg = $ok ? 'shipping_created' : 'shipping_create_failed';
        if ($redirect_page === 'shipping') {
            wp_safe_redirect($this->page_url('aksrt_shipping', [
                'view'          => 'records',
                'aksrt_pay_msg' => $msg,
                's'             => $order_number,
            ]));
            exit;
        }
        if ($redirect_page === 'pending') {
            wp_safe_redirect($this->page_url('aksrt_shipping', [
                'view'          => 'pending',
                'aksrt_pay_msg' => $msg,
            ]));
            exit;
        }
        wp_safe_redirect($this->page_url('aksrt_orders', [
            'order'         => $order_number,
            'aksrt_pay_msg' => $msg,
        ]));
        exit;
    }


    public function shipping_status_options_public(bool $include_all = false): array {
        return $this->shipping_status_options($include_all);
    }

    private function shipping_status_options(bool $include_all = false): array {
        $options = [];
        if ($include_all) {
            $options[''] = __('全部状态', 'aksrt');
        }
        if (class_exists('\AKSRT\Payment\Shipping')) {
            foreach (\AKSRT\Payment\Shipping::get_status_options() as $item) {
                $value = (string) ($item['value'] ?? '');
                if ($value === '') {
                    continue;
                }
                $options[$value] = (string) ($item['label'] ?? $value);
            }
        }
        if (count($options) === (int) $include_all) {
            $options = array_merge($options, [
                'shipped'    => __('已发货', 'aksrt'),
                'in_transit' => __('运输中', 'aksrt'),
                'delivered'  => __('已签收', 'aksrt'),
                'returned'   => __('已退回', 'aksrt'),
            ]);
        }
        return $options;
    }
    public function render_carrier_field_public(string $selected = ''): void {
        $this->render_carrier_field($selected);
    }

    private function render_carrier_field(string $selected = ''): void {
        $options = [];
        if (class_exists('\AKSRT\Payment\Shipping')) {
            foreach (\AKSRT\Payment\Shipping::get_carrier_options() as $item) {
                $value = (string) ($item['value'] ?? '');
                $label = (string) ($item['label'] ?? $value);
                if ($value !== '') {
                    $options[$value] = $label;
                }
            }
        }
        if ($options) {
            echo '<select name="carrier" required>';
            foreach ($options as $value => $label) {
                printf(
                    '<option value="%s"%s>%s</option>',
                    esc_attr($value),
                    selected($selected, $value, false),
                    esc_html($label)
                );
            }
            echo '</select>';
            return;
        }
        echo '<input type="text" name="carrier" value="' . esc_attr($selected) . '" required placeholder="SF/YTO/..." />';
    }
    private function render_express_timeline_panel(int $shipping_id): void {
        if ($shipping_id <= 0 || !class_exists('\AKSRT\Payment\Shipping')) {
            echo '<p>' . esc_html__('无法加载物流轨迹。', 'aksrt') . '</p>';
            return;
        }
        $svc = \AKSRT\Payment\Shipping::get_instance();
        // Prefer cached data; do not force remote query on pure view.
        $timeline = $svc->build_express_timeline($shipping_id);
        $record = $svc->get($shipping_id);
        echo '<div style="padding:10px 12px;background:#f6f7f7;border:1px solid #dcdcde;">';
        echo '<p style="margin:0 0 8px;"><strong>' . esc_html__('物流轨迹', 'aksrt') . '</strong> · ';
        echo esc_html((string) ($record['carrier'] ?? '')) . ' / ' . esc_html((string) ($record['tracking_no'] ?? ''));
        echo '</p>';
        if (!$timeline) {
            echo '<p style="margin:0;">' . esc_html__('暂无轨迹，可点击「查物流」拉取快递 API。', 'aksrt') . '</p>';
            echo '</div>';
            return;
        }
        echo '<ol style="margin:0;padding-left:18px;">';
        // newest first for operators
        $timeline = array_reverse($timeline);
        foreach ($timeline as $item) {
            $time = (string) ($item['time'] ?? '');
            $label = (string) ($item['label'] ?? '');
            echo '<li style="margin:0 0 6px;"><code>' . esc_html($time) . '</code> ' . esc_html($label) . '</li>';
        }
        echo '</ol></div>';
    }


    private function ensure_cap(): void {
        if (!current_user_can(self::CAPABILITY)) {
            wp_die(esc_html__('您没有权限访问此页面。', 'aksrt'));
        }
    }

    private function render_header(string $title): void {
        echo '<div class="wrap">';
        echo '<h1>' . esc_html($title) . '</h1>';
        $this->render_flash();
    }

    private function render_footer(): void {
        echo '</div>';
    }

    private function render_flash(): void {
        if (empty($_GET['aksrt_pay_msg'])) {
            return;
        }
        $code = sanitize_key((string) wp_unslash($_GET['aksrt_pay_msg']));
        $map  = [
            'shipping_updated'       => __('物流状态已更新。', 'aksrt'),
            'shipping_failed'        => __('物流状态更新失败。', 'aksrt'),
            'shipping_created'       => __('发货记录已创建。', 'aksrt'),
            'shipping_create_failed' => __('发货记录创建失败。', 'aksrt'),
            'express_ok'             => __('物流轨迹已更新。', 'aksrt'),
            'express_failed'         => __('物流轨迹查询失败。', 'aksrt'),
        ];
        if (!isset($map[$code])) {
            return;
        }
        $class = str_contains($code, 'failed') ? 'notice-error' : 'notice-success';
        echo '<div class="notice ' . esc_attr($class) . ' is-dismissible"><p>' . esc_html($map[$code]) . '</p></div>';
    }

    private function page_url(string $slug, array $args = []): string {
        return add_query_arg(array_merge(['page' => $slug], $args), admin_url('admin.php'));
    }

    private function render_pagination(int $pages, int $page_num): void {
        if ($pages <= 1) {
            return;
        }
        echo '<div class="tablenav"><div class="tablenav-pages">';
        echo paginate_links([
            'base'      => add_query_arg('paged', '%#%'),
            'format'    => '',
            'prev_text' => '&laquo;',
            'next_text' => '&raquo;',
            'total'     => $pages,
            'current'   => $page_num,
        ]);
        echo '</div></div>';
    }
}