Стажировка C#: как разобрать тестовое на ASP.NET Core

Редакторская команда HireSeekerc#asp.net coreстажировкатестирование
Стажировка C#: как разобрать тестовое на ASP.NET Core

Вы открываете тестовое задание на стажировку C# и видите фразу «Просроченные книги тоже можно вернуть». Рядом требуют обработать повтор запроса. До первого контроллера решите, что именно повторяет клиент. Два нажатия на кнопку «Выдать» могут означать попытку занять уже выданный экземпляр. Повтор после сетевого таймаута может означать просьбу показать результат операции, которая уже прошла. От этого выбора зависят ответ API, записи в базе и тесты, которые вы приложите к решению.

Выпишите правила выдачи до первого маршрута

Возьмём учебное условие. Читатель выбирает свободный экземпляр книги и получает его на 14 суток. Поздний возврат разрешён, а API сообщает, была ли просрочка. Правило повтора согласуем отдельно. Начните с двух экземпляров одного издания: выдача одного оставляет второй доступным. Передавайте copyId, если экземпляр выбирает читатель. Для запроса по bookId понадобится правило, по которому API распределяет свободные экземпляры.

У выдачи есть свой идентификатор loanId. Читатель может вернуть экземпляр, взять его через неделю и получить другую выдачу. У двух записей будут разные сроки и даты возврата. Если маршрут возврата принимает loanId, запоздалый повтор старого запроса попадёт в старую выдачу. Маршрут по copyId рискует закрыть новую, если он ищет текущую активную запись по экземпляру.

Из условия можно получить три проверяемых правила.

  • У экземпляра одновременно может быть только одна активная выдача с returnedAtUtc: null.
  • Возврат закрывает конкретную выдачу и освобождает экземпляр. Время возврата сохраняет сервер.
  • Возврат просрочен, когда returnedAtUtc строго позже dueAtUtc. Возврат ровно в срок проходит без просрочки.

Последний пункт надо обозначить как допущение. Если условие говорит «до конца дня по времени библиотеки», прибавление 14 суток даст другой результат. Спросите, какой часовой пояс считать местным и включается ли последний день. Если ответы получить нельзя, изложите выбранное правило с примером даты в README.

Задайте уточняющий вопрос через наблюдаемое поведение. «Сервер создал выдачу, но клиент потерял ответ. Должен ли повтор с тем же ключом вернуть ту же выдачу с 201?» Такой вопрос помогает договориться и о статусе, и о количестве записей.

Назначьте HTTP-ответ каждому состоянию экземпляра

В учебном API POST /loans принимает readerId и copyId. При успехе он создаёт выдачу и отвечает 201 Created с Location: /loans/401. Запрос GET /loans/401 возвращает эту запись. В ASP.NET Core можно собрать ответ через CreatedAtAction. Проверьте адрес запросом GET: имя параметра маршрута легко перепутать с именем поля DTO. В JSON выдачи достаточно идентификаторов, срока и поля returnedAtUtc. До возврата это поле содержит null.

Для закрытия выдачи выберем PUT /loans/{loanId}/return. Этот адрес обозначает возврат конкретной выдачи. Обновляйте строку по loanId только при returnedAtUtc IS NULL одним атомарным запросом. Если обновлено ноль строк, перечитайте запись: отсутствующая даёт 404, закрытая — сохранённое время. В теле 200 OK верните loanId, dueAtUtc, returnedAtUtc и wasOverdue. При 204 No Content клиенту пришлось бы читать сведения о просрочке отдельным запросом.

ЗапросСостояние перед вызовомHTTP-ответЧто меняется в базе
POST /loansЭкземпляр свободен201 Created и адрес выдачиПоявляется активная выдача
POST /loansЭкземпляр уже выдан, это новая попытка409 Conflict, код copy_unavailableВыдача остаётся прежней
PUT /loans/401/returnСрок истёк, выдача активна200 OK, wasOverdue: trueСохраняется время возврата
PUT /loans/401/returnВыдача уже закрыта200 OK с сохранённым временемЗаписи остаются прежними
PUT /loans/999/returnВыдачи с таким ID нет404 Not FoundЗаписи остаются прежними

Проверьте ещё два входа перед реализацией. Если copyId отсутствует, верните 400 Bad Request. Если корректный идентификатор указывает на отсутствующий экземпляр, в этом контракте верните 404 Not Found. При использовании [ApiController] ошибки привязки и валидации модели могут дать 400 ещё до входа в метод. Для обязательного числового поля убедитесь, что пропущенное значение тоже отклоняется, например через nullable-свойство с [Required] и отдельную проверку допустимого диапазона. Для конфликта состояния используйте ProblemDetails с машинным кодом в расширении code. Тогда клиент сможет различать ошибки по коду, даже если текст для человека изменится.

Разведите новую выдачу и повтор после таймаута

Пусть 3 ноября 2026 года в 10:00 UTC читатель 12 запрашивает экземпляр 27. Сервер создаёт выдачу 401 и прибавляет 14 суток: срок наступает 17 ноября в 10:00 UTC. Клиент теряет ответ 201 и через секунду отправляет тот же JSON. Совпадение идентификаторов ещё не показывает, повторяет он операцию или начинает новую. Для этого нужен отдельный признак, о котором договорились клиент и сервер.

В учебном контракте с повторами для POST /loans обязателен Idempotency-Key. Без него верните 400. Клиент выбирает ключ для новой операции и сохраняет его при повторной отправке. Сервер хранит ключ в области вызывающего клиента вместе с параметрами и результатом успешной выдачи. При совпадении ключа и параметров верните 201, прежний Location и сохранённое тело. Сравнивайте значения copyId и readerId: порядок полей JSON может измениться. Если с тем же ключом изменилось любое из этих значений, верните 409 с кодом idempotency_key_reused. Исходная выдача остаётся прежней.

Проверка ключа предшествует проверке доступности экземпляра. В обратном порядке повтор собственной успешной операции упрётся в copy_unavailable. Если ключ новый, проверяйте доступность и создавайте выдачу обычным путём. Если условие описывает только запрет двойной выдачи, можно обойтись без ключей. Тогда второй POST при занятом экземпляре закономерно вернёт 409, даже если тело совпадает. В README так и напишите. «Повтор POST /loans при активной выдаче даёт 409 Conflict. После таймаута исходный результат по повтору восстановить нельзя».

Что произойдёт, если ответ потерялся, а к моменту повтора книгу уже вернули? Запрос со старым ключом вернёт исходный 201 с returnedAtUtc: null. Это снимок результата выдачи. Текущее состояние клиент получит через GET по адресу из Location. Там уже будет дата возврата. Для новой выдачи свободного экземпляра понадобится новый ключ.

При выдаче сначала проверяют ключ и параметры, затем доступность для новой операции. При возврате находят выдачу по loanId и сравнивают сохранённое время со сроком. В конце сверяют HTTP-ответ и записи в базе. При выдаче HTTP-проверка отличает сохранённый 201 от нового конфликта, при возврате сверяет время и просрочку. По базе видно, появилась ли новая запись или закрылась существующая.

Два одновременных запроса могут увидеть свободный экземпляр через AnyAsync. Для SQLite добавьте частичный уникальный индекс по copyId с условием returnedAtUtc IS NULL. При поддержке ключей ограничьте их уникальность в области клиента и сохраняйте выдачу и результат в одной транзакции. После отката повторите проверку с чтения ключа, затем проверьте занятость для новой операции. При временной блокировке SQLite ограничьте число попыток. Верните 409, только если подтвердили конфликт по ключу или занятость экземпляра.

Квиз для C#/.NET-разработчика: API, EF Core и диагностика

Выберите одно решение в каждой из 15 рабочих ситуаций. Проверьте, как вы проектируете HTTP-контракты, работаете с EF Core и DI, ограничиваете доступ и разбираете сбои.

Вопрос 1
x
Выберите один ответ

Контракт требует `201 Created` и доступный адрес созданной выдачи в `Location`. В контроллере уже есть `GetLoan(int loanId)` с маршрутом `GET /loans/{loanId}`. Как завершить успешный `POST`?

Прогоните просрочку и повтор через настоящий маршрут

Запустите приложение в тестовом хосте через WebApplicationFactory и получите HttpClient методом CreateClient(). Передайте тип Program проекта API как параметр типа фабрики. Если точка входа задана инструкциями верхнего уровня и недоступна тестам, добавьте в проект API объявление public partial class Program { }. Запрос пройдёт через настоящий маршрут. В тестовой конфигурации подмените подключение к базе и зарегистрируйте управляемый TimeProvider, чтобы выставлять нужное время с точностью хранилища. Интеграционные тесты ASP.NET Core в документации Microsoft.

Выставьте часы на 3 ноября 2026 года в 10:00 UTC, создайте выдачу через POST и возьмите loanId из ответа. Проверьте срок 2026-11-17T10:00:00Z. Переведите часы на минуту за срок и вызовите PUT. Ожидайте 200 OK, wasOverdue: true и returnedAtUtc: 2026-11-17T10:01:00Z в ответе и то же время в базе. Через час повторите PUT и сравните время в ответах. Создайте новую выдачу того же экземпляра, повторите возврат по старому адресу и прочитайте новую запись: её returnedAtUtc должно остаться равным null. В отдельном сценарии верните книгу ровно в dueAtUtc и ожидайте wasOverdue: false.

В отдельном сценарии с тем же сроком отправьте первый PUT 17 ноября в 09:59 UTC, а повтор — в 10:01 UTC. В обоих ответах ожидайте 200 OK, время возврата 2026-11-17T09:59:00Z и wasOverdue: false. Так тест поймает обработчик, который сохраняет верную дату, но при повторе сравнивает срок с текущим временем.

Для теста повтора POST возьмите экземпляр без истории выдач и зафиксируйте часы на 3 ноября 2026 года в 10:00 UTC. Сначала проверьте 201, исходные readerId и copyId, ожидаемый срок 2026-11-17T10:00:00Z и returnedAtUtc: null. Сверьте Location с loanId из тела и прочитайте выдачу по этому адресу. Повторите запрос с исходными параметрами и ключом, сравните статус, Location и поля JSON. В новом DbContext проверьте, что у экземпляра ровно одна выдача. С новым ключом ожидайте 409 и copy_unavailable, с прежним ключом и изменённым параметром — 409 и idempotency_key_reused. В контракте без ключей второй запрос к занятому экземпляру даёт 409, а в базе остаётся одна строка.

Если приложение предназначено для SQLite, поднимайте в тестах SQLite с реальной схемой. Для базы в памяти держите подключение открытым до конца сценария. Создавайте отдельную базу и отдельный экземпляр TimeProvider для каждого теста, чтобы параллельные сценарии не меняли данные и время друг друга. Провайдер EF Core InMemory пропустит ошибки в индексах и другой реляционной логике. Если рабочая база использует иной движок, проверку его ограничений прогоняйте на тестовом экземпляре этого движка.

Оставьте ревьюеру команды и ожидаемые результаты

Представьте, что ревьюер клонировал репозиторий и первым делом запускает dotnet test. Укажите в README версию SDK, рабочую директорию и точную команду, особенно если в корне несколько файлов проектов. Когда тесты создают схему сами, запуск должен проходить сразу после восстановления зависимостей. Если нужна отдельная база, перечислите команды запуска и подготовки схемы и укажите, откуда приложение читает строку подключения. Проверьте эти шаги в чистой копии. Локальная база со старыми миграциями может скрыть, что новый разработчик даже не дойдёт до первого HTTP-запроса.

Оставьте короткий ручной сценарий рядом с командами. Укажите, что readerId: 12 и copyId: 27 берутся из учебных данных, и приведите команду, которая их создаёт, если приложение не делает этого автоматически. Выпишите параметры первого POST, заголовок Idempotency-Key для выбранного контракта и ожидаемый 201. Предложите скопировать Location из ответа для чтения выдачи. Для возврата возьмите loanId из тела ответа и подставьте его в PUT /loans/{loanId}/return. Такая инструкция сработает и тогда, когда выданный номер отличается от 401. Ручную демонстрацию просрочки можно оставить интеграционному тесту с управляемыми часами. Укажите имя теста, чтобы ревьюеру не пришлось переводить системное время или вручную править данные.

Объясните решение одной фразой рядом с командами. «При повторном возврате я отдаю сохранённое время, чтобы запоздалый повтор не изменил историю выдачи». Если условие требует сообщать об уже закрытой выдаче как о конфликте, поменяйте ожидаемый ответ на 409 и сохраните проверку прежнего времени и состояния новой выдачи. Так видна часть поведения, которую меняет требование, и можно обсудить её отдельно от маршрутов и модели данных.

Если в вакансиях .NET упоминается EF Core, укажите в README миграцию с ограничением активной выдачи. По обзору работы в .NET выберите темы подготовки к обсуждению решения, например маршрутизацию и тестирование API. В сообщении к заданию дайте ревьюеру точку входа. «Тесты запускаются из корня через dotnet test. Тест позднего возврата использует управляемые часы. В README описан ответ на повтор после таймаута». Перед отправкой сверьте команду, имена тестов и ожидаемые ответы с чистым запуском.

Читайте также

Свежие вакансии под ваши критерии — каждый день

HireSeeker собирает вакансии со всех площадок и присылает только релевантные. Бесплатно.