Nikita Kiselev
4a3dcc11d1
Implement comprehensive event tracking system for TeleCart Pulse that ensures all user interactions and order events are reliably captured and delivered to the analytics platform, even in case of network failures or service outages. Business Value: - Guaranteed event delivery: All events are stored in database before sending, ensuring no data loss even if SaaS service is temporarily unavailable - Automatic retry mechanism: Failed events are automatically retried with configurable attempts, reducing manual intervention - Real-time monitoring: Admin dashboard displays event statistics (pending, sent, failed) to track system health and delivery status - Data integrity: Idempotency keys prevent duplicate events, ensuring accurate analytics and metrics - Performance optimization: Statistics are cached for 1 hour to reduce database load while maintaining visibility Key Features: - Event queue system: Events are queued in database with status tracking (pending/sent/failed) - Asynchronous processing: Events are sent via background tasks, not blocking user interactions - Error tracking: Failed events include detailed error reasons for debugging - Campaign tracking: Only events with valid campaign_id and tracking_id are stored, ensuring data quality - Admin visibility: Statistics dashboard shows delivery status at a glance This system ensures reliable data collection for campaign analytics, A/B testing, and performance metrics, providing accurate insights for business decisions.
TeleCart
Telegram магазин на базе OpenCart. Позволяет создать полноценный интернет-магазин в виде Telegram Mini App.
🚀 Возможности
- 📱 Telegram Mini App интерфейс
- 🛒 Полноценная корзина и оформление заказов
- 🎨 Адаптивный дизайн с поддержкой темной/светлой темы
- 📊 Административная панель для управления настройками
- 🔍 Поиск и фильтрация товаров
- 📦 Интеграция с OpenCart
🛠 Технологии
- Backend: PHP (OpenCart), Composer
- Frontend: Vue.js 3, Vite, Tailwind CSS, Pinia
- Инфраструктура: Docker, Docker Compose
- Тестирование: PHPUnit, Vitest
📦 Структура проекта
telecart/
├── frontend/
│ ├── admin/ # Административная панель
│ └── spa/ # Telegram Mini App
├── module/ # Модуль OpenCart
├── docker/ # Docker конфигурации
└── src/ # Исходный код OpenCart
🚀 Быстрый старт
Требования
- Docker и Docker Compose
- PHP >= 7.4
- Node.js >= 20.19.0 или >= 22.12.0
Установка
# Клонировать репозиторий
git clone git@github.com:telecart-labs/telecart.git
cd telecart
# Настроить проект
make setup
# Запустить в режиме разработки
make dev
Доступные команды
make setup- Первоначальная настройка проектаmake start- Запустить контейнерыmake stop- Остановить контейнерыmake dev- Запустить в режиме разработкиmake dev-admin- Запустить админ-панель в режиме разработкиmake test- Запустить тестыmake lint- Проверить код линтером
📝 Лицензия
Это коммерческий платный модуль. Все права защищены. Использование модуля возможно только после приобретения лицензии.
🤝 Вклад в проект
Мы приветствуем вклад в развитие проекта! Пожалуйста, создавайте issue и pull request'ы.
📄 Документация
Дополнительная документация находится в папке docs/.