Feedback Service Contract

[Ruchuee]

Описание изменений

Добавлен контракт к сервису

Мотивация и контекст

Для согласования API

Тип изменений

• Фича
• Багфикc
• Документация
• Рефакторинг

Чек‑лист автора

• Ветка feature/<key>
• CI зелёный
• Тесты добавлены / обновлены
• README / docs актуальны

[AxoRm]

1. Необходимо добавить вершонинг через переменную servers
2. Организовать единые ответы ошибок через components/responses
3. Поставить стандартные HTTP коды при успешном выполнении:

• • Для создания ресурсов (POST) выдавать 201 Created и заголовок Location с URI нового объекта.
• • Для успешных изменений без тела (PUT/PATCH/DELETE) отдавать 204 No Content

4. Использовать имена во множественном числе и существительные (/feedback/matches, /feedback/tournaments) вместо глаголов (add, user) в путях

5. Определить схему безопасности в components/securitySchemes (bearerAuth) и подключить security: - bearerAuth: [] ко всем защищённым эндпоинтам.

6. Реализовать полный CRUD для отзывов:

   • GET /feedback/matches/{id} и GET /feedback/tournaments/{id}
   • PUT /feedback/matches/{id} / PUT /feedback/tournaments/{id}
   • DELETE /feedback/matches/{id} / DELETE /feedback/tournaments/{id}

7. Добавить пагинацию и фильтрацию к списковым GET (например, limit, offset или cursor afterId) и вернуть метаданные (total, next, prev).

8. Перейти на единый стиль полей в теле запросов/ответов (camelCase вместо snake_case).

9. Указать tags: [Feedback] (или разделить на под-теги MatchFeedback, TournamentFeedback) для структурирования документации.

10. Добавить реальные примеры (example/examples) для основных запросов и ответов.