http://www.baeldung.com/swagger-2-documentation-for-spring-rest-api

1. Создание пользователя
   POST /users

2. Получение пользователя
   GET /users/{userId}

3. Поиск пользователей с фильтрами (используем PagingAndSortingRepository)
   GET /users?page & pageSize & lastName&firstName&email&nickname....

4. Удаление пользователя - Перевод в статус inactive
   DELETE /users/{userId}

5. Обновление параметров пользователя
   PUT /users/{userId}

• Для управления пользователями (регистрация, имена статуса и прочая)
• Для управления друзьями
• Для управления встречами
• что еще.. ?

1. Запрос на добавление в друзья / подтверждение дружбы
   POST /{userId}/friends
   input body: {
   friendIds: [id1, id2...]
   }

2. Удалить друга / отменить запрос
   DELETE /{userId}/friends/{friendId}

3. Показать всех друзей
   GET /{userId}/friends
   output body {
   friends: [],
   incomingRequests: [], // Добавляются ко мне в други
   outcomingRequests: [], // Я добавляюсь в други
   }

1. Назначить встречу / Подтвердить встречу
   POST /meetings

2. Завершить встречу
   POST /meetings/{meetingId}/complete

3. Отменить встречу (+ нужно сохранять кто отменил)
   POST /meetings/{meetingId}/cancel

4. Получить информацию по встрече
   GET /meetings/{meetingId}
   output body {
   // Координаты и прочая...
   }

1. Регистрация пользователя (логин, пароль, почта)
   POST /auth/registration

2. Логин пользователя (логин, пароль) -> token (out of scope)
   POST /auth/login

3. (out of scope) Выход
   POST /auth/logout

При старте добавить наполнение базы данных сущностями для удобства работы с api