ИИ-агент
по поиску работы

Тестовое задание разработчика: проект, тесты и README

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

На этой странице

Сделай минимальное решение, которое выполняет условие, запускается у другого человека и позволяет проверить спорные случаи. В учебном проекте ниже нужно бронировать переговорные: сохранять встречи, отклонять пересечения и освобождать время после отмены. Это новый пример с сервером и базой, а не список задач с изменёнными названиями.

Скачать исходники проекта и тесты. Нужен Python 3.10 или новее, сторонних зависимостей нет. Готовый пример используй для разбора; в собственном портфолио указывай источник и сделанные тобой изменения.

Условие учебного проекта

У офиса две переговорные: A и B. Пользователь выбирает комнату, начало и конец встречи. Нужно показать активные брони, создать новую и отменить существующую. Данные должны сохраняться после перезапуска.

Условия зафиксированы заранее: один офис, местное время без часовых поясов, точность до минуты. Конец должен быть позже начала. Интервал полуоткрытый: встреча 10:00–11:00 совместима со следующей в 11:00–12:00. Отменённая бронь больше не занимает время. Одновременные запросы на одно время должны создавать только одну активную бронь.

Не входят в условие: аккаунты, повторяющиеся встречи, интеграция с календарём, рабочие часы офиса и публичное развёртывание. Эти границы уменьшают проект до проверяемого объёма. В реальном сервисе часть из них стала бы обязательной.

Что уточнить перед реализацией

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

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

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

Как устроено решение

booking.py содержит правила и работу с SQLite, server.py — небольшой HTTP-интерфейс, index.html — форму и список броней, test_booking.py — проверки. README объясняет запуск и ограничения.

Пересечение определяется так:

existing.start < new.end AND existing.end > new.start

Равенство границ не считается пересечением. Проверка выполняется только для той же комнаты и активных записей. Раздельные проверки «нет пересечения» и «записать бронь» без общей транзакции создают гонку: два запроса могут одновременно увидеть свободное время.

В примере используется BEGIN IMMEDIATE: SQLite сериализует проверку и вставку. Это простое решение для локального учебного сервиса; оно не является обещанием высокой производительности на большой нагрузке. Более сложную систему можно проектировать с другой СУБД и ограничениями, соответствующими требуемому масштабу.

ЗапросУспехЗначимая ошибка
GET /api/bookingsСписок активных бронейНеизвестный путь — 404
POST /api/bookings201 и идентификаторНеверные данные — 400; занято — 409
POST /api/cancel200, бронь отмененаНет активной брони — 404

Как запустить и проверить проект

Распакуй ZIP, перейди в каталог room-booking и выполни:

python3 -m unittest -v
python3 server.py --port 8767

Открой http://127.0.0.1:8767. Если порт занят, выбери другой через --port; останавливать чужой процесс не нужно. Сервер слушает только локальный адрес. База bookings.sqlite создаётся при первом обращении к данным; можно передать свой путь через --db.

Создай A на 2 ноября 2026, 10:00–11:00. Повтори тот же запрос — получишь конфликт. Создай соседнюю бронь A 11:00–12:00 и одновременную встречу B 10:00–11:00: обе допустимы. Отмени первую и снова забронируй её время. После перезапуска активные записи сохранятся.

Интерфейс показывает ответ сервера и не выдаёт ошибку за успешное создание. Этот ручной маршрут проверяет связь формы, API и базы; он дополняет проверки правил, а не заменяет их.

Во фронтенде ответ API проверяется явно: успешное выполнение fetch() ещё не означает HTTP-успех. Это поведение описано в MDN. Поэтому пример смотрит на response.ok и показывает сообщение сервера.

Какие тесты нужны

Проверяй границы, от которых зависит поведение. В приложении есть семь тестов: соседние интервалы, разные виды пересечения, другая комната, отмена с повторным бронированием, неверный ввод, сохранение после нового подключения и конкурентная попытка.

Конкурентная проверка запускает два потока с отдельными соединениями. Ожидается одна созданная бронь и один конфликт. Простое последовательное выполнение двух одинаковых запросов эту проблему не проверяет.

Нужны и негативные случаи: неизвестная комната, конец раньше начала, некорректная дата и неподдерживаемая временная зона. Если расширишь требования, добавь проверку нового поведения. Количество тестов само по себе не доказывает правильность проекта.

Что написать в README

README должен позволять стартовать из чистой папки: версия Python, команды, адрес, способ остановки и местоположение данных. Затем — правила интервалов, интерфейс API, важное техническое решение и ограничения.

Готовое объяснение для этого проекта: «Выбрал SQLite и стандартный HTTP-сервер, чтобы пример запускался без сторонних пакетов. Проверку пересечения и запись объединил в транзакцию. Время локальное для одного офиса; часовые пояса и права пользователей находятся за границами тренировки».

Пиши конкретные ограничения вместо «проект можно улучшать бесконечно». До публичного запуска нужны аутентификация, авторизация отмены, защита запросов, лимиты и эксплуатационные процедуры. Учебный сервер для этого не предназначен.

Структура README отвечает его назначению, описанному в GitHub Docs: помочь другому человеку понять и начать использовать проект. Для реального API отдельно потребуются проверки доступа к операциям — ориентиром служит OWASP REST Security. Здесь они прямо исключены из локальной тренировки.

Как защитить решение

Начни с демонстрации основного сценария, затем покажи конфликт и объясни транзакцию. На вопрос «почему не микросервисы?» ответ может быть таким: «В условии две комнаты и один локальный процесс. Разделение увеличило бы запуск и число отказов без пользы для этой задачи. Границы правил и HTTP уже выделены в модули».

На вопрос о масштабировании назови конкретное узкое место: сериализация записи, требования к правам, резервное копирование, другая модель времени. Не обещай, что смена базы автоматически решит все проблемы.

Если пользовался ИИ, следуй правилам работодателя и будь готов объяснить каждую существенную часть. Запуск готового примера не равен самостоятельной реализации. Полезное продолжение — добавить собственное требование, проверить его и показать, почему изменилось решение.

Варианты для фронтенда и бэкенда

Для фронтенда расширь состояния: загрузка списка, пустой ответ, серверная ошибка, конфликт после устаревшего просмотра. Добавь доступную работу с клавиатуры и явное подтверждение отмены. Не считай свободным время только потому, что его ещё не заняли в локальной копии списка.

Для бэкенда можно добавить пользователей и разрешение отменять только свою бронь, миграции и ограничение длительности встречи. Это отдельный объём. В сдаче исходного задания сначала должны работать согласованные обязательные сценарии.

Перед отправкой распакуй свой архив заново и пройди README. Для подготовки к обсуждению этапов отбора пригодится руководство по собеседованию.

Источники

Проект и условие оригинальные учебные; это не задание действующей компании.