Squashed commit message

backend/src/bastion/Handlers/SendMessageHandler.php

@@ -0,0 +1,123 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Bastion\Handlers;
+
+use App\Exceptions\TelegramCustomerNotFoundException;
+use App\Exceptions\TelegramCustomerWriteNotAllowedException;
+use App\Models\TelegramCustomer;
+use GuzzleHttp\Exception\GuzzleException;
+use Symfony\Component\HttpFoundation\JsonResponse;
+use Acme\ECommerceFramework\Http\Request;
+use Acme\ECommerceFramework\Telegram\TelegramService;
+use Psr\Log\LoggerInterface;
+use RuntimeException;
+
+/**
+ * Handler для отправки сообщений Telegram-пользователям из админ-панели
+ *
+ * @package Bastion\Handlers
+ */
+class SendMessageHandler
+{
+    private TelegramService $telegramService;
+    private TelegramCustomer $telegramCustomerModel;
+    private LoggerInterface $logger;
+
+    public function __construct(
+        TelegramService $telegramService,
+        TelegramCustomer $telegramCustomerModel,
+        LoggerInterface $logger
+    ) {
+        $this->telegramService = $telegramService;
+        $this->telegramCustomerModel = $telegramCustomerModel;
+        $this->logger = $logger;
+    }
+
+    /**
+     * Отправить сообщение Telegram-пользователю
+     *
+     * @param Request $request HTTP запрос с id (ID записи в таблице) и message
+     * @return JsonResponse JSON ответ с результатом операции
+     * @throws TelegramCustomerNotFoundException Если пользователь не найден
+     * @throws TelegramCustomerWriteNotAllowedException Если пользователь не разрешил писать в PM
+     * @throws RuntimeException Если данные невалидны
+     * @throws \Exception
+     * @throws GuzzleException
+     */
+    public function sendMessage(Request $request): JsonResponse
+    {
+        $customerId = $this->extractCustomerId($request);
+        $message = $this->extractMessage($request);
+
+        // Находим запись по ID
+        $customer = $this->telegramCustomerModel->findById($customerId);
+        if (! $customer) {
+            throw new TelegramCustomerNotFoundException($customerId);
+        }
+
+        $telegramUserId = (int) $customer['telegram_user_id'];
+
+        // Проверяем, что пользователь разрешил писать ему в PM
+        if (! $customer['allows_write_to_pm']) {
+            throw new TelegramCustomerWriteNotAllowedException($telegramUserId);
+        }
+
+        // Отправляем сообщение (telegram_user_id используется как chat_id)
+        // Используем пустую строку для parse_mode чтобы отправлять обычный текст
+        $this->telegramService->sendMessage(
+            $telegramUserId,
+            $message,
+        );
+
+        $this->logger->info('Message sent to Telegram user', [
+            'oc_customer_id' => $customerId,
+            'telegram_user_id' => $telegramUserId,
+            'message_length' => strlen($message),
+        ]);
+
+        return new JsonResponse([
+            'success' => true,
+            'message' => 'Message sent successfully',
+        ]);
+    }
+
+    /**
+     * Извлечь ID записи из запроса
+     *
+     * @param Request $request HTTP запрос
+     * @return int ID записи в таблице acmeshop_customers
+     * @throws RuntimeException Если ID отсутствует или невалиден
+     */
+    private function extractCustomerId(Request $request): int
+    {
+        $jsonData = $request->json();
+        $customerId = isset($jsonData['id']) ? (int) $jsonData['id'] : 0;
+
+        if ($customerId <= 0) {
+            throw new RuntimeException('Customer ID is required and must be positive');
+        }
+
+        return $customerId;
+    }
+
+    /**
+     * Извлечь сообщение из запроса
+     *
+     * @param Request $request HTTP запрос
+     * @return string Текст сообщения
+     * @throws RuntimeException Если сообщение отсутствует или пустое
+     */
+    private function extractMessage(Request $request): string
+    {
+        $jsonData = $request->json();
+        $message = isset($jsonData['message']) ? trim($jsonData['message']) : '';
+
+        if (empty($message)) {
+            throw new RuntimeException('Message is required and cannot be empty');
+        }
+
+        return $message;
+    }
+}