Хорошо поставленная задача есть? А если найду? 🕵️‍♂️: Часть 4 - Backend

В предыдущей части я рассказал, как правильно поставить задачу для фронтенд разработчика. Если вы пропустили этот пост, обязательно посмотрите его, начните ставить качественные задачи уже сегодня.

Теперь давайте рассмотрим, как правильно поставить задачу для бэкенд разработчика на примере нашего проекта:

Представьте, что мы разрабатываем онлайн-платформу для бронирования путешествий, которая позволит пользователям искать, сравнивать и бронировать билеты на самолеты и поезда. Цель проекта — создать удобное и интуитивно понятное приложение, обеспечивающее пользователям плавный и приятный опыт бронирования путешествий.

Задача для бэкенд разработчика: Реализация API для формы поиска

1. Контекст👀
В рамках проекта "Путешествия" мы создаем страницу поиска и бронирования, которая позволит пользователям искать билеты на самолеты и поезда. Для обеспечения работы этой страницы необходимо реализовать API, которое будет обрабатывать запросы с формы поиска и возвращать соответствующие результаты.

2. Чёткие инструкции🃏
Необходимо разработать API для обработки запросов с формы поиска на странице бронирования путешествий. Вот основные шаги:

⭐️Реализовать эндпоинт /search, который будет принимать параметры поиска: тип транспорта (самолет или поезд), пункт отправления, пункт назначения, даты поездки и количество пассажиров.
⭐️Подключить API к базе данных, чтобы извлекать актуальную информацию о доступных билетах.
⭐️Обработать логику поиска и фильтрации данных по заданным критериям.
Вернуть результаты поиска в формате JSON, включающим информацию о рейсах, их стоимости и доступности.
⭐️Реализовать обработку ошибок, включая некорректные данные и случаи отсутствия результатов.

3. Ограничения😺
⭐️API должно обрабатывать запросы быстро, с максимальным временем ответа не более 1 секунды.
⭐️Необходимо обеспечить безопасность данных, передаваемых через API, используя протокол HTTPS.
⭐️Поддержка нагрузки до 1000 одновременных запросов.

4. Источники данных😚
Ссылки на спецификации API и схемы базы данных можно найти в нашем API документации.

5. Текущее состояние системы🦇
В настоящее время API не реализовано. Существуют только схемы базы данных и общая архитектура проекта. Важно обеспечить совместимость с существующими компонентами системы.

6. Примеры использования♟

Положительный кейс: Пользователь вводит корректные данные в форму поиска, и API возвращает список доступных рейсов с их стоимостью и временем отправления.
Отрицательный кейс: Пользователь вводит некорректные данные (например, пункт отправления и назначения совпадают), и API возвращает сообщение об ошибке.

7. Как проверить?
Критерии приемки:

📌API корректно принимает и обрабатывает запросы с параметрами поиска.
📌 Результаты поиска возвращаются в формате JSON и соответствуют введенным критериям.
📌 Время ответа API не превышает 1 секунды.
Обработка ошибок работает корректно, возвращаются понятные сообщения об ошибках.
📌API стабильно работает под нагрузкой до 1000 одновременных запросов.

А как вы ставите задачи на разработку?📝 Расскажите про проверенные методы, которые помогают вашей команде работать эффективнее.

🌟В следующем посте расскажу, как правильно ставить задачи для тестировщиков.