WIP
Some checks failed
Telegram Mini App Shop Builder / Compute version metadata (push) Has been cancelled
Telegram Mini App Shop Builder / Run Frontend tests (push) Has been cancelled
Telegram Mini App Shop Builder / Run Backend tests (push) Has been cancelled
Telegram Mini App Shop Builder / Run PHP_CodeSniffer (push) Has been cancelled
Telegram Mini App Shop Builder / Build module. (push) Has been cancelled
Telegram Mini App Shop Builder / release (push) Has been cancelled
Some checks failed
Telegram Mini App Shop Builder / Compute version metadata (push) Has been cancelled
Telegram Mini App Shop Builder / Run Frontend tests (push) Has been cancelled
Telegram Mini App Shop Builder / Run Backend tests (push) Has been cancelled
Telegram Mini App Shop Builder / Run PHP_CodeSniffer (push) Has been cancelled
Telegram Mini App Shop Builder / Build module. (push) Has been cancelled
Telegram Mini App Shop Builder / release (push) Has been cancelled
This commit is contained in:
@@ -61,4 +61,4 @@
|
||||
- Для frontend/admin используй компоненты VuePrime 4.
|
||||
- Для frontend/spa используй Daisy UI.
|
||||
- Чтобы получить название стандартной таблицы OpenCart, используй хелпер `db_table`, либо добавляй константу DB_PREFIX перед названием таблицы. Так ты получишь название таблицы с префиксом.
|
||||
- Все таблицы моего модуля TeleCart начинаются с префикса `telecart_`. Примеры миграций лежат в `module/oc_telegram_shop/upload/oc_telegram_shop/database/migrations`
|
||||
- Все таблицы моего модуля MegaPay начинаются с префикса `megapay_`. Примеры миграций лежат в `module/oc_telegram_shop/upload/oc_telegram_shop/database/migrations`
|
||||
|
||||
@@ -6,11 +6,11 @@
|
||||
"useDependencyInjection": true
|
||||
},
|
||||
"paths": {
|
||||
"telecart_module": "module/oc_telegram_shop/upload/oc_telegram_shop",
|
||||
"megapay_module": "module/oc_telegram_shop/upload/oc_telegram_shop",
|
||||
"frontendAdmin": "frontend/admin",
|
||||
"telegramShopSpa": "frontend/spa",
|
||||
"migrations": "module/oc_telegram_shop/upload/oc_telegram_shop/database/migrations",
|
||||
"telecartHandlers": "module/oc_telegram_shop/upload/oc_telegram_shop/src/Handlers",
|
||||
"megapayHandlers": "module/oc_telegram_shop/upload/oc_telegram_shop/src/Handlers",
|
||||
"adminHandlers": "module/oc_telegram_shop/upload/oc_telegram_shop/bastion/Handlers",
|
||||
"models": "module/oc_telegram_shop/upload/oc_telegram_shop/src/Models",
|
||||
"framework": "module/oc_telegram_shop/upload/oc_telegram_shop/framework"
|
||||
@@ -21,7 +21,7 @@
|
||||
"variables": "camelCase",
|
||||
"constants": "UPPER_SNAKE_CASE",
|
||||
"files": "PascalCase for classes, kebab-case for others",
|
||||
"tables": "snake_case with telecart_ prefix"
|
||||
"tables": "snake_case with megapay_ prefix"
|
||||
},
|
||||
"php": {
|
||||
"version": "7.4+",
|
||||
@@ -37,7 +37,7 @@
|
||||
"database": {
|
||||
"queryBuilder": true,
|
||||
"migrations": true,
|
||||
"tablePrefix": "telecart_",
|
||||
"tablePrefix": "megapay_",
|
||||
"noForeignKeys": true
|
||||
}
|
||||
}
|
||||
|
||||
@@ -1,15 +1,15 @@
|
||||
## TeleCart Pulse Heartbeat Telemetry
|
||||
## MegaPay Pulse Heartbeat Telemetry
|
||||
|
||||
### Цель
|
||||
Раз в час отправлять телеметрию (heartbeat) на TeleCart Pulse, чтобы фиксировать состояние магазина и версии окружения без участия пользователя.
|
||||
Раз в час отправлять телеметрию (heartbeat) на MegaPay Pulse, чтобы фиксировать состояние магазина и версии окружения без участия пользователя.
|
||||
|
||||
### Backend (`module/oc_telegram_shop/upload/oc_telegram_shop`)
|
||||
- `framework/TeleCartPulse/TeleCartPulseService.php`
|
||||
- `framework/MegaPayPulse/MegaPayPulseService.php`
|
||||
- Новый метод `handleHeartbeat()` собирает данные: домен (через `Utils::getCurrentDomain()`), username бота (через `TelegramService::getMe()`), версии PHP, модуля (из `composer.json`), OpenCart (`VERSION` и `VERSION_CORE`), текущий UTC timestamp.
|
||||
- Последний успешный пинг кешируется (ключ `telecart_pulse_heartbeat`, TTL 1 час) через существующий `CacheInterface`.
|
||||
- Последний успешный пинг кешируется (ключ `megapay_pulse_heartbeat`, TTL 1 час) через существующий `CacheInterface`.
|
||||
- Подпись heartbeat выполняется через отдельный `PayloadSigner`, который использует секрет `pulse.heartbeat_secret`/`PULSE_HEARTBEAT_SECRET`. Логируются предупреждения при ошибках кеша/бота/подписи.
|
||||
- Отправка идет на эндпоинт `heartbeat` с таймаутом 2 секунды и заголовком `X-TELECART-VERSION`, взятым из `composer.json`.
|
||||
- `framework/TeleCartPulse/TeleCartPulseServiceProvider.php`
|
||||
- Отправка идет на эндпоинт `heartbeat` с таймаутом 2 секунды и заголовком `X-MEGAPAY-VERSION`, взятым из `composer.json`.
|
||||
- `framework/MegaPayPulse/MegaPayPulseServiceProvider.php`
|
||||
- Регистрирует основной `PayloadSigner` (по `pulse.api_key`) и отдельный heartbeat signer (по `pulse.heartbeat_secret` или `PULSE_HEARTBEAT_SECRET`), инжектит `LoggerInterface`.
|
||||
- `src/Handlers/TelemetryHandler.php` + `src/routes.php`
|
||||
- Добавлен маршрут `heartbeat`, который вызывает `handleHeartbeat()` и возвращает `{ status: "ok" }`. Логгер пишет warning при проблемах.
|
||||
@@ -20,7 +20,7 @@
|
||||
- `src/main.js`: после `pulse.ingest(...)` вызывается `pulse.heartbeat()` без блокировки цепочки.
|
||||
|
||||
### Конфигурация / ENV
|
||||
- `PULSE_API_HOST` — базовый URL TeleCart Pulse (используется и для events, и для heartbeat).
|
||||
- `PULSE_API_HOST` — базовый URL MegaPay Pulse (используется и для events, и для heartbeat).
|
||||
- `PULSE_TIMEOUT` — общий таймаут HTTP (для heartbeat принудительно 2 секунды).
|
||||
- `PULSE_HEARTBEAT_SECRET` (или `pulse.heartbeat_secret` в настройках) — общий секрет для подписания heartbeat. Обязателен, иначе heartbeat не будет отправляться.
|
||||
- `pulse.api_key` — прежний API ключ, используется только для event-инджеста.
|
||||
|
||||
@@ -28,7 +28,7 @@
|
||||
|
||||
5. Миграция (если нужна новая таблица):
|
||||
- Создай миграцию в database/migrations/
|
||||
- Используй фиксированный префикс telecart_
|
||||
- Используй фиксированный префикс megapay_
|
||||
- Добавь индексы где необходимо
|
||||
|
||||
Следуй архитектуре MVC-L проекта и используй существующие паттерны.
|
||||
@@ -115,7 +115,7 @@
|
||||
Создай миграцию для таблицы [TABLE_NAME]:
|
||||
|
||||
1. Файл: database/migrations/[TIMESTAMP]_[DESCRIPTION].php
|
||||
2. Используй фиксированный префикс telecart_ для таблицы
|
||||
2. Используй фиксированный префикс megapay_ для таблицы
|
||||
3. Добавь все необходимые поля с правильными типами
|
||||
4. Добавь индексы для часто используемых полей
|
||||
5. Используй utf8mb4_unicode_ci collation
|
||||
|
||||
@@ -165,7 +165,7 @@ $result = $this->database->query("SELECT * FROM table_name WHERE status = 'activ
|
||||
- **Variables**: camelCase (`$customerData`)
|
||||
- **Constants**: UPPER_SNAKE_CASE (`MAX_RETRIES`)
|
||||
- **Files**: PascalCase для классов, kebab-case для остального
|
||||
- **Tables**: snake_case с префиксом `telecart_`
|
||||
- **Tables**: snake_case с префиксом `megapay_`
|
||||
|
||||
### Error Handling
|
||||
|
||||
|
||||
@@ -188,13 +188,13 @@ try {
|
||||
// ✅ Правильно
|
||||
$customers = $this->builder->newQuery()
|
||||
->select(['id', 'name', 'email'])
|
||||
->from('telecart_customers')
|
||||
->from('megapay_customers')
|
||||
->where('status', '=', 'active')
|
||||
->orderBy('created_at', 'DESC')
|
||||
->get();
|
||||
|
||||
// В крайних случаях можно использовать прямые SQL
|
||||
$result = $this->database->query("SELECT * FROM telecart_customers");
|
||||
$result = $this->database->query("SELECT * FROM megapay_customers");
|
||||
```
|
||||
|
||||
### Parameter Binding
|
||||
|
||||
Reference in New Issue
Block a user