Перейти к содержанию

Онбординг разработчика

Добро пожаловать в команду Gifty. Этот документ — подробный маршрут на первые дни: где искать задачи, как устроены встречи и какие доступы нужно получить. Если что-то непонятно, первым контактным лицом всегда является ваш ментор.

Быстрый чек‑лист на старт

  • Получить персональный пароль у ментора для регистрации в телеграм‑боте.
  • Зарегистрироваться в боте и запросить нужные доступы.
  • Получить доступ к GitHub‑репозиторию и настроить локальную среду.
  • Настроить доступ к базе данных через DataGrip + SSH.
  • Ознакомиться с архитектурой системы и актуальными направлениями работы.

Где задачи и как мы синхронизируемся

Задачи

  • Все задачи ведутся в Weeek. Доступ к доске и проектам предоставляет ментор.
  • Статусы задач, приоритеты и дедлайны — только в Weeek. Если задача обсуждается устно, попросите зафиксировать ее карточкой.

Встречи

  • Понедельник и среда: в 20:30 по МСК, формат 15‑минутных синков.
  • Пятница: в 20:00 по МСК, общий статус‑апдейт.

Если вы не можете присутствовать — напишите заранее в командный чат и оставьте краткий апдейт по своим задачам.

Доступы и обязательные регистрации

1) Регистрация в телеграм‑боте

Бот — основной канал для запросов доступов и первичных инструкций.

  • Бот: @giftyai_team_bot
  • Пароль выдает ваш ментор
  • Команда регистрации:
/start <пароль>

После регистрации перейдите к гайду по работе с ботом и ознакомьтесь с доступными сценариями (запросы доступов, подтверждения, статусы).

Ссылка: Гайд по работе с ботом

2) Доступ к GitHub

Получение доступа возможно двумя способами:

  • отправить запрос через телеграм‑бота,
  • или быть добавленным в репозиторий напрямую вашим ментором.

После получения доступа обязательно прочитайте документацию по рабочему процессу с GitHub: структура веток, правила коммитов, pull‑requests и ревью.

Ссылка: Документация по работе с GitHub

3) Доступ к базе данных (DataGrip + SSH)

Для работы с базой используем DataGrip с SSH‑туннелем.

Что нужно от ментора или через бота:

  • SSH‑хост и порт
  • SSH‑пользователь
  • приватный ключ или пароль
  • хост/порт базы, имя базы, пользователь БД

Инструкция по настройке DataGrip:

  1. Установите DataGrip: официальный сайт.
  2. Откройте Data Sources and Drivers → + → PostgreSQL.
  3. Заполните параметры подключения к базе (Host, Port, Database, User, Password).
  4. Перейдите во вкладку SSH/SSL и включите Use SSH tunnel.
  5. Укажите SSH Host, Port, User.
  6. В разделе аутентификации выберите Key pair или Password и укажите ключ/пароль.
  7. Нажмите Test Connection и убедитесь, что соединение успешно.

Важно: SSH‑данные и доступы — конфиденциальны, не пересылайте их в открытые каналы.

После подключения ознакомьтесь с практиками работы с базой и правилами безопасности.

Ссылка: Гайд по работе с базой данных

Качество и деплой

Автоматические тесты (Pytest)

Мы уделяем большое внимание качеству кода. Перед тем как ваш Pull Request будет влит в основную ветку, он должен пройти проверку автоматическими тестами. Вы также можете (и должны) запускать тесты локально.

👉 Гайд по тестированию

CI/CD Пайплайн

В проекте настроен автоматический деплой через GitHub Actions. - При каждом пуше в develop или main запускаются тесты и линтеры. - После успешных тестов происходит сборка Docker-образов и обновление сервисов на сервере.

👉 Подробнее о деплое и CI/CD

Мониторинг и Аналитика

Для отслеживания здоровья системы и поведения пользователей мы используем стек PostHog + Prometheus + Loki. Если ваша задача связана с добавлением новых метрик или логов, ознакомьтесь с гайдами:

👉 Система аналитики и KPI

Что прочитать в первую очередь

  1. Обзор архитектуры системы — чтобы понять, как устроены ключевые компоненты и их взаимодействие.

👉 Обзор архитектуры

  1. Текущие направления, майлстоуны и дедлайны — чтобы видеть глобальные цели и сроки.

👉 Текущие направления и майлстоуны

Если что-то не работает

  • Сначала проверьте этот документ и связанные гайды.
  • Если ответа нет — напишите ментору и уточните, что именно не получается и на каком шаге.