Настройка истории операций кэшбэка в личном кабинете 1С-Битрикс

Настройка истории операций кэшбэка в личном кабинете 1С-Битрикс

Пользователь не понимает, откуда взялся его текущий баланс. Начислили 250 рублей — за какой заказ? Списали 100 — когда и при какой покупке? Без прозрачной истории операций программа лояльности вызывает недоверие. При этом «показать таблицу из базы» — недостаточно: нужна правильная пагинация, фильтрация по типу операции и корректная обработка часовых поясов.

Таблица транзакций

История операций хранится в local_cashback_transactions. Структура, достаточная для отображения всего необходимого:

CREATE TABLE local_cashback_transactions (
    ID          BIGINT AUTO_INCREMENT PRIMARY KEY,
    USER_ID     INT NOT NULL,
    TYPE        ENUM('accrual','debit','reserve','release','expire','manual') NOT NULL,
    AMOUNT      DECIMAL(10,2) NOT NULL,
    ORDER_ID    INT,
    PAYMENT_ID  INT,
    DESCRIPTION VARCHAR(500),
    CREATED_AT  DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
    EXPIRES_AT  DATETIME,
    INDEX idx_user_date (USER_ID, CREATED_AT DESC)
);

Индекс по (USER_ID, CREATED_AT DESC) — обязателен. Без него выборка истории за последние 6 месяцев у активного пользователя с тысячами транзакций будет полным сканом таблицы.

Компонент истории

Создаём компонент /local/components/local/cashback.history/. Структура:

class.php        — логика выборки
templates/.default/template.php  — шаблон
lang/ru/         — языковые файлы

class.php — наследуем от CBitrixComponent:

class CashbackHistoryComponent extends CBitrixComponent
{
    public function executeComponent(): void
    {
        if (!$this->getUser()->isAuthorized()) {
            ShowError('Доступ запрещён');
            return;
        }

        $userId    = (int)$this->getUser()->GetID();
        $pageNum   = max(1, (int)($_GET['page'] ?? 1));
        $pageSize  = (int)($this->arParams['PAGE_SIZE'] ?? 20);
        $typeFilter = $_GET['type'] ?? '';

        $filter = ['USER_ID' => $userId];
        if (in_array($typeFilter, ['accrual', 'debit', 'expire'])) {
            $filter['TYPE'] = $typeFilter;
        }

        $totalCount = CashbackTransactionTable::getCount($filter);

        $transactions = CashbackTransactionTable::getList([
            'filter' => $filter,
            'order'  => ['CREATED_AT' => 'DESC'],
            'limit'  => $pageSize,
            'offset' => ($pageNum - 1) * $pageSize,
            'select' => ['ID', 'TYPE', 'AMOUNT', 'ORDER_ID', 'DESCRIPTION', 'CREATED_AT', 'EXPIRES_AT'],
        ])->fetchAll();

        // Подгружаем номера заказов одним запросом
        $orderIds = array_filter(array_column($transactions, 'ORDER_ID'));
        $orderNumbers = [];
        if ($orderIds) {
            $res = \Bitrix\Sale\Internals\OrderTable::getList([
                'filter' => ['ID' => $orderIds],
                'select' => ['ID', 'ACCOUNT_NUMBER'],
            ]);
            while ($row = $res->fetch()) {
                $orderNumbers[$row['ID']] = $row['ACCOUNT_NUMBER'];
            }
        }

        $this->arResult = [
            'BALANCE'       => CashbackBalanceTable::getBalance($userId),
            'TRANSACTIONS'  => $transactions,
            'ORDER_NUMBERS' => $orderNumbers,
            'TOTAL_COUNT'   => $totalCount,
            'PAGE_NUM'      => $pageNum,
            'PAGE_SIZE'     => $pageSize,
            'TYPE_FILTER'   => $typeFilter,
        ];

        $this->includeComponentTemplate();
    }
}

Отображение и пагинация

Ключевой момент с пагинацией: стандартный CDBResult с NavStart/NavNext подходит для старых компонентов. Для D7-компонента — собственный расчёт $totalPages и генерация URL.

// template.php
$totalPages = (int)ceil($arResult['TOTAL_COUNT'] / $arResult['PAGE_SIZE']);

$typeLabels = [
    'accrual' => 'Начисление',
    'debit'   => 'Списание',
    'reserve' => 'Резерв',
    'release' => 'Возврат резерва',
    'expire'  => 'Сгорание',
    'manual'  => 'Ручная корректировка',
];

$amountSign = [
    'accrual' => '+',
    'debit'   => '−',
    'reserve' => '−',
    'release' => '+',
    'expire'  => '−',
    'manual'  => '',
];

Часовой пояс: даты из базы — UTC. Конвертация в часовой пояс пользователя:

$userTz = new \DateTimeZone(\CTimeZone::GetOffset() ? 'UTC' : date_default_timezone_get());
$dt = new \DateTime($transaction['CREATED_AT'], new \DateTimeZone('UTC'));
$dt->setTimezone($userTz);
echo $dt->format('d.m.Y H:i');

Либо через стандартный \Bitrix\Main\Type\DateTime::createFromTimestamp() — он учитывает настройки часового пояса сайта.

Связь с заказами

Транзакции типа accrual и debit должны давать ссылку на заказ. Ссылку строим через ACCOUNT_NUMBER, а не через ID — это публичный номер заказа в личном кабинете:

/personal/order/detail/{ACCOUNT_NUMBER}/

Если заказ удалён — ссылку не показываем, только номер с пометкой «(заказ удалён)».

Срок действия кэшбэка

Если бизнес-логика предполагает сгорание кэшбэка (например, через 12 месяцев неактивности), поле EXPIRES_AT отображается для транзакций типа accrual. Cron раз в сутки находит кэшбэк с истёкшим сроком и создаёт транзакцию типа expire:

// Cron: местная полночь
$expired = CashbackTransactionTable::getList([
    'filter' => [
        'TYPE'       => 'accrual',
        '<EXPIRES_AT' => new \Bitrix\Main\Type\DateTime(),
        'EXPIRED'    => false,
    ],
]);

Состав работ

• Таблица транзакций с индексами
• Компонент /local/components/local/cashback.history/ с пагинацией и фильтрацией
• Конвертация часовых поясов, связь с заказами
• Механизм сгорания кэшбэка (если требуется)
• Размещение компонента в шаблоне личного кабинета

Сроки: 1–1.5 недели для компонента и шаблона. 2–3 недели с учётом механизма сгорания и административного интерфейса ручных корректировок.