docs: сервер это контент курса, а не деталь реализации

[fey]

README сообщал только команды, и по нему нельзя было понять, что за проект: на сервер живьём ходят студенты из четырёх курсов, а уроки и самостоятельные цитируют его ответы дословно, вплоть до значений полей. Теперь README называет проект, показывает устройство в три строки (TypeSpec → OpenAPI → fastify-openapi-glue) и отсылает к AGENTS.md до первой правки.

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

• значения полей только на латинице — сервер один на все локали курсов, и русский текст в ответе читался бы как ошибка у испанского студента;
• дефолты skip: uint16 = 0 и limit: uint16 = 30 несут пагинацию — значение подставляет валидатор, и без них ломается только limit, что снаружи читается как «limit не поддерживается»;
• make generate очищает custom-server/src/generated/ перед записью — неудачная проба сносит закоммиченное;
• сервисы в тесте снимаются группой по PID — detached: true плюс process.kill(-pid), потому что внук npx переживает SIGTERM обёртке, а pkill -f "fastify start" совпадает с текстом собственной команды и убивает свою же оболочку;
• трейлинг-слеш даёт 404 — /postman/users/ не отвечает, и в текстах курсов адрес пишется без слеша.

Разметка новых абзацев по rumdl: абзац одной строкой, маркеры -. Пятьдесят одна находка MD013 и MD004, которые уже были в AGENTS.md, не тронута — это отдельный проход, иначе правка утонет в переформатировании.

🤖 Generated with Claude Code