Доделать настройку приёма платежей на сайте на вордпресс

Техническое задание (ТЗ)<strong>Цель проекта</strong>Создать модуль для WordPress, который:<br><br><ul><li>Принимает рекуррентные (ежемесячные) платежи через Т-банк.</li><li>Сохраняет номер телефона клиента в базе данных.</li><li>Генерирует ссылку для WhatsApp-группы после успешной оплаты.</li><li>Автоматически проверяет успешность ежемесячных платежей, уведомляет администратора, если платеж не прошел, и прекращает обработку удаленных клиентов.</li><li>Обеспечивает удобную админ-панель для управления данными клиентов и платежей.</li></ul><strong>1. Функциональные требования</strong>1.1. Процесс работы для клиента:<ol><li>Клиент нажимает на кнопку оплаты.</li><li>Всплывающее окно или форма запрашивает номер телефона.</li><li>После ввода телефона:<ul><li>Телефон сохраняется в базе данных.</li><li>Клиент перенаправляется на сайт Т-банка для ввода платежных данных.</li></ul></li><li>Т-банк информирует клиента о том, что это ежемесячный платеж.</li><li>После успешной оплаты:<ul><li>Клиенту отправляется ссылка на WhatsApp-группу.</li><li>Информация об оплате отправляется на email.</li></ul></li></ol>1.2. Автоматическая проверка платежей:<ol><li>Ежемесячно модуль проверяет, прошли ли рекуррентные платежи.</li><li>Если оплата не прошла:<ul><li>Отправляется сообщение администратору на email с указанием номера клиента.</li></ul></li></ol>1.3. Управление через админ-панель:<ol><li>Раздел в админке WordPress:<ul><li>Таблица с номерами клиентов.</li><li>Статусы ежемесячных оплат, для каждого номера в своё время проходит проверка.</li><li>Возможность удалить клиента (удаление прекращает обработку рекуррентных платежей).</li></ul></li></ol><strong>2. Технические требования</strong>2.1. База данных:<ul><li>Создать таблицу в базе данных WordPress для хранения данных клиентов:<ul><li><code>id</code> (уникальный идентификатор).</li><li><code>phone</code> (номер телефона).</li><li><code>status</code> (статус платежа: "активный", "неактивный").</li><li><code>last_payment_date</code> (дата последней успешной оплаты).</li><li><code>created_at</code> (дата добавления клиента).</li></ul></li></ul>2.2. Взаимодействие с Т-банком:<ul><li>Использовать API Т-банка для:<ul><li>Генерации токена для каждого платежа.</li><li>Отправки данных клиента (номер телефона, сумма платежа).</li><li>Получения статуса оплаты.</li></ul></li><li>Провести все необходимые тесты и получить подтверждение от Т-банка.</li></ul>2.3. Email уведомления:<ul><li>Email:<ul><li>Использовать встроенные функции WordPress (<code>wp_mail</code>) для отправки уведомлений.</li></ul></li></ul>2.4. Безопасность:<ul><li>Использовать nonce для защиты форм от CSRF-атак.</li><li>Сохранять данные о клиентах в таблице базы данных WordPress.</li></ul>2.5. Админ-панель:<ul><li>Создать страницу в разделе <strong>"Инструменты"</strong> или отдельное меню "Рекуррентные платежи".</li><li>Отображать таблицу с данными клиентов:<ul><li>Номер телефона.</li><li>Статус платежа.</li><li>Дата последнего платежа.</li></ul></li><li>Возможность:<ul><li>Удалить клиента.</li><li>Изменить статус вручную (например, если ошибка в API).</li><li>Экспортировать данные в CSV.</li></ul></li></ul><strong>3. Структура модульного кода</strong>3.1. Файлы модуля:<ul><li><code>/wp-content/plugins/recurring-payments/</code><ul><li><code>recurring-payments.php</code> — главный файл плагина.</li><li><code>/includes/</code><ul><li><code>class-recurring-payment.php</code> — основной класс обработки рекуррентных платежей.</li><li><code>class-ajax-handler.php</code> — обработчик AJAX-запросов.</li><li><code>class-tbank-api.php</code> — класс для взаимодействия с API Т-банка.</li><li><code>class-notifications.php</code> — уведомления через email и Telegram.</li><li><code>class-admin-page.php</code> — страница админ-панели.</li></ul></li><li><code>/templates/</code><ul><li><code>form-payment.php</code> — шаблон формы ввода телефона.</li></ul></li><li><code>/assets/</code><ul><li><code>style.css</code> — стили для админки и формы.</li><li><code>script.js</code> — JavaScript для взаимодействия с формой.</li></ul></li></ul></li></ul>3.2. Основной функционал:<ul><li><strong>Frontend</strong>:<ul><li>Форма для ввода номера телефона (через шорткод).</li><li>Кнопка оплаты, ведущая к API Т-банка.</li></ul></li><li><strong>Backend</strong>:<ul><li>Обработка результата оплаты через вебхук Т-банка.</li><li>Автоматическая проверка статуса ежемесячных платежей.</li><li>Админ-панель для управления клиентами.</li></ul></li></ul><strong>4. Этапы реализации</strong>Этап 1: Разработка структуры модуля<ul><li>Создать структуру папок и файлов модуля.</li><li>Реализовать шорткод для формы ввода телефона.</li></ul>Этап 2: Интеграция с Т-банком<ul><li>Реализовать класс <code>class-tbank-api.php</code> для взаимодействия с API:<ul><li>Отправка данных на оплату.</li><li>Получение токенов.</li><li>Проверка статуса оплаты.</li></ul></li><li>Провести тестирование API (в тестовом режиме).</li></ul>Этап 3: Уведомления<ul><li>Настроить отправку email и Telegram уведомлений для администратора:<ul><li>Успешная оплата.</li><li>Ошибка платежа.</li></ul></li></ul>Этап 4: Админ-панель<ul><li>Реализовать интерфейс для просмотра и управления данными клиентов.</li><li>Добавить функции удаления и редактирования клиентов.</li></ul>Этап 5: Автоматизация проверок<ul><li>Настроить WP-Cron для ежемесячной проверки статусов оплат.</li><li>Обработать сценарии:<ul><li>Успешный платеж.</li><li>Неудачная попытка.</li></ul></li></ul>Этап 6: Финальное тестирование<ul><li>Пройти тесты Т-банка (согласно их документации).</li><li>Проверить работу в боевом режиме.</li></ul><strong>5. Результат</strong><ul><li>Рабочий плагин WordPress с:<ul><li>Формой для ввода телефона.</li><li>Интеграцией с Т-банком для рекуррентных платежей.</li><li>Автоматической обработкой платежей.</li><li>Уведомлениями об ошибках.</li><li>Админ-панелью для управления клиентами.<br><br><br><br>Что уже реализовано<ol><li><strong>Интеграция с WooCommerce</strong>:<ul><li>Установлен и настроен плагин для работы с API Т-банка.</li><li>Плагин настроен на выполнение платежей в тестовом режиме.</li></ul></li><li><strong>Интерфейс оплаты на сайте</strong>:<ul><li>Создана кнопка оплаты, содержащая галочку для подтверждения согласия с условиями.</li><li>Добавлена форма для ввода номера телефона, отображаемая после клика на кнопку оплаты.</li><li>Пользователь вводит номер телефона перед перенаправлением на страницу оплаты.</li></ul></li><li><strong>Базовый функционал для взаимодействия с пользователем</strong>:<ul><li>Кнопка оплаты активируется только после подтверждения согласия с условиями (галочка).</li><li>Ввод номера телефона требуется перед выполнением запроса на оплату.</li></ul></li></ol></li></ul></li></ul>