а почему соскакивал, в чем проблема была?
-загрузка файлов ( надо было использовать, что было в проекте, рецепт который у низ най сайте не очень подходит)
-документацию через декоратор дописывать ( например для логина)
-Item всегда должен содержать @id
-когда нужен только get collection - костыль для get item + unset в декораторе свагера, чтоб никуда не попало
ну и тд. нужно что то маленькое сделать - куча писанины ( transformer\cotextbuilderи итд) и не всегда это очевидно