fix(http-api): общие данные для REST и RPC, ответы по спецификации

[fey]

Зачем

Мок http-api работал в динамическом режиме (-d), и данные генерировал faker. Из этого росли две проблемы, обе видны студенту в уроках курса HTTP API.

Данные не общие. Урок kinds сравнивает REST и RPC «на одних и тех же данных». На самом деле RPC отдавал три задачи из rpc.js, а REST — новую латинскую мешанину на каждый запрос:

REST  GET /tasks/2      → {"id":-39177245,"title":"et est incididunt","status":"In Progress"}
RPC   tasks.get id=2    → {"id":2,"title":"Записать скринкаст про HTTP API","status":"In Progress"}

Ответы не соответствовали спецификации. Модели объявляют uint16, то есть 0..65535, а приходило "id":-39177245, "total":-33234336, "limit":70134490. Динамический режим про это ограничение не знает. Два запроса к одному адресу давали разные ответы, а GET /tasks/1 возвращал не задачу с идентификатором 1.

Обнаружено при проверке деплоя по FEEDBACK-36.

Что сделано

• Моделям http-api добавлены @example, а prism для этой спецификации запущен без -d. Ответы теперь берутся из примеров спецификации.
• Набор задач вынесен в custom-server/src/data/tasks.js — у RPC и примеров спецификации один текст, а не две копии в разных файлах.
• make test вместо echo no tests поднимает мок с приложением и проверяет ответы запросами.
• Сборка запускается на пуллреквестах.

Примеры подогнаны под то, что уроки уже печатают, поэтому правка попутно делает верным существующий текст:

Где	Что совпало
250-example	пользователи 1 и 2 (max@hotmail.com / Allison Bernier, Colt97@yahoo.com / Hudson Schowalter), total: 10
500-authentication	токен в ответе /login
400-kinds	три задачи, те же что у RPC

Пользователь 1 это max@hotmail.com, под которым логинятся в самостоятельной. Посты принадлежат ему же: статичный мок не умеет отбирать записи по пути, поэтому /posts и /users/1/posts отдают один список, и общий автор не даёт им противоречить друг другу.

Что осталось как было

Три остальные спецификации (http-protocol, js-playwright, postman) остаются на -d осознанно: примеров в них нет, и статичный режим отдал бы вместо данных заглушки вида "string". Их курсы не затронуты, проверено запросами.

Пример запроса в 250-example/self_study.md цитирует прежний faker-вывод с отрицательными числами и после этой правки станет неверным. Это правка курса, отдельным заходом.

Проверка

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

REST GET /tasks/1  → {"id":1,"title":"Опубликовать курс по основам JavaScript",...,"status":"Backlog"}
RPC  tasks.get id=1 → {"jsonrpc":"2.0","result":{"id":1,"title":"Опубликовать курс по основам JavaScript",...}}

GET /nosuch → 404    DELETE /tasks → 405    POST /tasks {} → 422    DELETE /tasks/1 → 204
POST /posts без токена → 401    с токеном → 201    /courses без ключа → 401    с ключом → 200
RPC: ошибка в теле, код 200

Тест проверен на способность падать: правка одной задачи в data/tasks.js без правки спецификации даёт два провала и выход с кодом 1.

🤖 Generated with Claude Code