feat(tasks): обслуживать /tasks кодом — заработали skip, limit и отбор по пути

[fey]

Закрывает #16. Тикет: FEEDBACK-371.

Зачем

Статичный мок prism отдаёт пример из спецификации дословно, поэтому /tasks не применял skip и limit и на любой /tasks/{id} отвечал одной и той же задачей:

$ curl -s 'https://http.hexlet.app/http-api/tasks?skip=5&limit=10'   # то же, что без параметров
$ curl -s https://http.hexlet.app/http-api/tasks/2
{"id":1,"title":"Опубликовать курс по основам JavaScript",...}

Уроки приходилось подгонять под это: в 250-example оговаривать, что параметры не работают, а в 400-kinds прибивать сравнение REST и RPC к задаче 1.

Что стало

$ curl -s 'http://.../http-api/tasks?skip=1&limit=1'
{"tasks":[{"id":2,"title":"Записать скринкаст про HTTP API",...}],"total":3,"skip":1,"limit":1}

$ curl -s http://.../http-api/tasks/2
{"id":2,"title":"Записать скринкаст про HTTP API",...}

$ curl -s -o /dev/null -w '%{http_code}' http://.../http-api/tasks/999
404

/tasks обслуживает приложение. Операции вынесены в tasks-store.js, и его же использует JSON-RPC — два стиля делят логику, а не только текст задач, поэтому задача с одним номером в REST и в RPC одна и та же по построению.

Сохранено намеренно

Коды ответов. Раньше их давал prism из спецификации, и на них построены самостоятельные. Воспроизведены руками:

Запрос	Код
GET /tasks	200
GET /tasks/1	200
GET /tasks/999	404
POST /tasks с {}	422
DELETE /tasks	405
DELETE /tasks/1	204

405 требует отдельных маршрутов на неподходящие методы: без них fastify отвечает 404 на существующий адрес с чужим методом.

Неизменяемость набора. POST и DELETE отвечают 201 и 204, но список не трогают. Сервер учебный, запросы идут одновременно от множества студентов, и мутации сделали бы уроки невоспроизводимыми. Проверяется тестом.

Маршрутизация

В Caddyfile два точных блока, /http-api/tasks и /http-api/tasks/*, а не tasks* — чтобы не перехватывать посторонние адреса. Проверено: /http-api/tasksfoo по-прежнему уходит к моку и отвечает 404. Префикс не срезается, поэтому приложение регистрирует полные пути.

Спецификация

Приведена к поведению: skip и limit объявлены uint16, как у остальных коллекций (были string), и добавлен 404 у get, update, delete. По спецификации читают документацию курса, расходиться с ответами ей нельзя. Проверено в контейнере: /http-api-openapi/json показывает 200, 404 и format=uint16.

Проверка

make test дополнен и вырос до 48 проверок: пагинация, отбор по пути, 404, 422 на отрицательном skip, неизменяемость набора после POST, плюс сверка примеров спецификации с набором данных — раньше совпадение выходило само, теперь ответы даёт код, а примеры остались документацией и могут разойтись молча.

Тест проверен на способность падать: если find перестаёт искать по id, падают 4 проверки и прогон выходит с кодом 1.

Сверх прогона собран образ и поднят контейнер, запросы шли через Caddy, как на проде. Соседние пути остались за моком (/users, /users/1, /posts, /posts/1, /comments, /login, /courses — все 200), остальные курсы не задеты (/http-protocol/example, /js-playwright/users, /postman/cookie, документация, главная — все отвечают).

Осталось за рамками

Остальные коллекции по-прежнему за статичным моком, поэтому у них skip/limit не работают, а /users/1/posts совпадает с /posts. Лечится тем же способом; в AGENTS.md это описано как то, что осталось.

После мержа и деплоя можно снять две скрытые пометки <!-- TODO --> в courses/ru/http_api_course и убрать оговорку про skip и limit из 250-example.

🤖 Generated with Claude Code