Gifty Engineering Docs 🎁
Добро пожаловать в центр знаний Gifty — экосистемы для умного подбора подарков. Этот портал объединяет архитектурные решения, технические гайды и API-справочники для всей команды разработки.
🧭 Быстрая навигация
| Раздел | Описание | Ссылка |
|---|---|---|
| Онбординг | Пошаговый план для новых сотрудников: доступы, чаты, первая задача. | Открыть → |
| Локальный сетап | Запуск всей системы (Docker, API, Bot) за 5 минут. | Открыть → |
| Архитектура | Верхнеуровневый обзор того, как данные превращаются в рекомендации. | Открыть → |
| Данные и БД | Описание доменов данных, схемы PostgreSQL и правил миграций. | Открыть → |
🏗 Ключевые системы
🧠 Recommendation Engine
Наш SOTA-движок на базе Qwen2-VL и Vector Search. Мы не просто ищем товары, мы анализируем их по 10 психологическим осям (GUTG). 👉 Подробнее о RecSys →
🕷 Parsing System
Масштабируемая система сбора данных на Scrapy и RabbitMQ. Автоматический маппинг категорий и AI-валидация. 👉 Как работают парсеры →
🤖 Telegram Admin Bot
Центр управления полетами. Мониторинг здоровья, ручное управление парсингом и выдача доступов. 👉 Гайд по боту →
🧪 Качество и Мониторинг
Мы верим в TDD и наблюдаемость (Observability):
- Тесты: Каждая фича покрывается
pytest. Гайд по тестированию → - Аналитика: Мы отслеживаем бизнес-успех через PostHog. Зачем нам аналитика? →
- CI/CD: Автоматический деплой при каждом пуше. Процесс деплоя →
Есть вопросы?
Пишите своему ментору — мы всегда рады помочь!
Вклад в документацию
Если вы нашли ошибку или хотите добавить новый раздел, не стесняйтесь создавать Pull Request!