Тестовое задание разработчика: проект, тесты и 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/bookings | 201 и идентификатор | Неверные данные — 400; занято — 409 |
| POST /api/cancel | 200, бронь отменена | Нет активной брони — 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. Для подготовки к обсуждению этапов отбора пригодится руководство по собеседованию.
Источники
- Python: sqlite3.
- SQLite: транзакции и BEGIN IMMEDIATE.
- Python: unittest.
- Python: ограничения http.server.
Проект и условие оригинальные учебные; это не задание действующей компании.
