Правки на backend Node.js

3.1 POST / image

• private/common/upload/image тут може відправлятись FormData об’єкт з кількома полями картинок

3.2 POST / specialization

• Нужно, чтобы пользователь мог выбрать одну категорию(IT, либо Logistics, либо другую) и несколько подкатегорий с этой категории. То есть, если он выбирает IT, он может себе выбрать несколько подкатегорий с IT, например React и Node Js, и пройти далее

3.3 POST / document

• private/common/upload/document тут також може відправлятись FormData об’єкт з кількома полями документів

3.4 POST / verification request, POST/get/status

• private/specialist/verification/account/request . Можна перевірити цей ендпоінт, я так розумію, що потрібно відправляти id, які повертаються у попередніх реквестах(private/common/upload/image, private/common/upload/document тощо). Вірно?
• private/specialist/verification/account/get/status . Якщо isRejected = true, то потрібно у відповіді отримати, який саме параметр з помилкою(фото, спеціальність, чи документи?).
• Мы можем изменить роль пользователя на специалиста только после успешного прохождения верификации специалиста. И когда мы отправляем реквесты private/specialist/verification/account/request или private/specialist/verification/account/get/status у нас не всегда пользователь в статусе успешного прохождения верификации ( при реквесте /verification/account/request так точно он не прошел верификацию). Поэтому, я думаю, можно ли переделать private/specialist/verification/account/request на private/client а private/specialist/verification/account/get/status на private/common. Если есть другие идеи пиши в ТГ).

4. User Data

• common/profile/data/get , було б добре у відповіді отримувати статус акаунту спеціаліста користувача. Наприклад, isApproved: boolean,  isRejected: boolean, isPending: boolean. Просто при зміні ролі користувача з клієнта на спеціаліст за допомогою функціоналу на сайті, я б дивився на ці флаги і якщо isApproved = true, переводив на спеціаліста, а якщо isRejected або isPending true, то переводив на сторінку register-specialist і там показував би статус верифікації.
• common/profile/data/get , потрібно у відповіді, якщо у  користувача немає аватарки, поле image зробити пустим “” , на даний момент там дефолтне посилання default.male.png.
• common/profile/data/get , потрібно у відповідь додати категорію та підкатегорії в яких працює юзер.

5. Districts

• public/districts/get/by/city/id, потрібно також  у відповіді, в списку районів отримувати all, тобто всі райони відповідного міста.

6. Categories 

• /public/categories/get/all . виправити картинки категорій

7. Sub-categories

• public/sub-categories/get/by/category/id невідповідність id підкатегорій з /public/specializations/get/all (тут є notSelected підкатегорія, під id 1, а в public/sub-categories/get/by/category/id немає).

8. Specializations 

• Потрібен ендпоінт щоб можна було отримати всі підкатегорії згруповані за категоріями, до яких вони відносяться. Бажано з кількість спеціалістів у всій категорії та у кожній з підкатегорій окремо. (для all-category page)

  Приклад:

9. Find specialist by id

• /public/specialist/find/all чи реалізований пошук за id категорії, просто коли передаю id категорії при відправці запиту завжди вертається один спеціаліст, а також можна передати неіснуюче id і помилки немає. В принципі, можна перевірити цей ендпоінт? Чи реалізований пошук по всім параметрам разом і окремо.

10. Get adverts

• public/adverts/find/all потрібно добавити у відповідь ще підкатегорії, в яких спеціаліст працює, а також його місто та додаткові умови (Договорная цена, Завершающая уборка, Хорошее настроение тощо).
• public/adverts/get/by/id повертає “Advert [id] not-found “, хоча за id 2 має бути оголошення, оскільки public/adverts/find/all повертає оголошення з цим id.
• public/adverts/get/by/id потрібно також додати у відповідь рейтинг спеціаліста (ratingPunctuality, ratingPrice, ratingWorkQuality, ratingCommon, ratingAverage).
• public/adverts/get/by/id, потрібно додати у відповідь особливі відмітки. Приклад з дизайну:
• public/adverts/get/by/id, потрібно додати у відповідь ціну за послуги.
• public/adverts/get/by/id, потрібно додати у відповідь дату створення свого акаунту спеціалістом.
• public/adverts/get/by/id, потрібно додати у відповідь чи оголошення в обраних, чи ні.
• public/adverts/find/all, потрібно додати у відповідь чи оголошення знаходиться в обраному, чи ні.
• public/adverts/find/all, необхідне сортування за ratingPunctuality, ratingPrice, ratingWorkQuality, ratingCommon, ratingAverage.
• Потрібен ендпоінт для отримання відгуків спеціаліста за його Advert id, з можливістю пагінації та сортуванням за датою додавання цього відгуку на платформу. Бажано отримувати такого плану response: {

Specialist: { "isVerified": true,      "ratingPunctuality": 0,      "ratingPrice": 0,      "ratingWorkQuality": 0,      "ratingCommon": 20,      "ratingAverage": 0,      "User": {       "image": "https://aws-s3.dev-rating-pro.ru/main",            "id": 2,            "firstName": "Slavik",            "lastName": "Timoschenko",            "createdAt": "2021-12-25T20:24:16.000Z"          }},reviews: [{review1},{review2},{review3},]}Приклад відгуку з дизайну: 

• Потрібен ендпоінт для отримання всіх виконаних робіт спеціаліста за його Advert id, з можливістю пагінації та сортуванням за датою додавання цієї роботи на платформу.

Приклад з дизайну (може бути до 3 фото): 

Бажано відповідь такого типу структури:

11) public/advert-facility-types/get

• У ендпоінтах з отримання advert-facility-types у відповідь необхідно додати іконки для кожного facility-type

12. Client advert

• private/client/instruments/adverts/create має приймати також параметр фото. Клієнт під час створення оголошення має можливість додати максимум 3 фото.

• private/client/instruments/adverts/update/by/id/:id має приймати також наступні параметри: specializationId, price, visits та фото.

12. Create specialist advert

• /specialist/instruments/adverts/create має приймати ще параметр “Ціни за послуги” (масив об’єктів з назвою послуги та її ціною)

• /specialist/instruments/adverts/create. При створенні оголошення спеціаліст може додати роботи, які він вже виконав в секції “Виконані роботи”. Необхідно реалізувати додавання цих виконаних робіт на бекенді.

Після кліку на кнопку випливає модальне вікно, де спеціаліст заповнює інформацію про свій виконаний проект:Спеціаліст може додати декілька виконаних робіт собі в оголошення. 

13. Get specialist advert

• /specialist/instruments/adverts/get/by/id необхідно додати у відповідь “Ціни за послуги” та “Виконані роботи”. Бажано з такою структурою:

14. Update specialist advert

• specialist/instruments/adverts/update/by/id відповідно потрібно в респонсі оновлення також приймати “Ціни за послуги” та “Виконані роботи”

15. Favorite-adverts

• client/favorite-adverts/lists/get/by/id, при передачі id FavoriteAdvertList, викидує помилку "FavoriteAdvertList [id] not-found", хоча FavoriteAdvertList з таким id існує (client-adverts/find/all його видає).
• client/favorite-adverts/lists/delete/by/id, викидає помилку при видаленні ("failed to delete FavoriteAdvertList"), при цьому список видаляє.

16. switch-to specialist or client

19. Get category and subCategories where specialist work

• потрібна можливість отримувати категорію та підкатегорії спеціальностей в яких спеціаліст працює. Наприклад, добавити у відповідь цього ендпоінта: /private/specialist/profile/data/get

20. private/specialist/projects/create

• Спеціаліст, перед створенням нового проекту, має підтвердити номер замовника з яким він хоче створити проект. Це є підтвердженням того, що вони справді зв'язувались і оговорили замовлення. Потрібен ендпоінт, щоб відправляти на підтвердження номер замовника і якщо замовник з таким номером існує в базі даних приходить true та id замовника. А спеціаліст проходить далі до створення проекту.
• Можна уточнити по параметрам які передають в цей ендпоінт private/specialist/projects/create? clientId - це id замовника? categoryId, subCategoryId - це спеціаліста?
• Також потрібно додати в ендпоінт параметр візити (: : ISO-8601: eg: 2021-11-21T16:00:00") на вхід в  private/specialist/projects/create.
• Необхідно додати в ендпоінт параметр startAt (дата початку проекту).
• Необхідно додати в ендпоінт параметри city та district.

21. /client/projects/get/all

• Поле Specialist у відповіді має вітдавати масив з об'єктами спеціалістів, оскільки на оголошення клієнта можуть подати заявку декілька спеціалістів. В залежності скільки спеціалістів подали заявку, на стільки і буде заповнено масив.
• В об'єкті спеціаліста має також бути advertId спеціаліста, за яким він подався на оголошення клієнта.

22. /client/projects/get/by/id/:id

• /client/projects/get/by/id/:id потрібно у відповідь добавити місто проекту.
• Також у відповідь потрібно добавити об'єкт наявного коментарю до завершеного проекту з його відповідним id.

23. client/projects/review

• /client/projects/review/create. Поле reviewFiles в боді запиту приймає : [ ]. Upload.id - це з відповіді /common/upload/image ???

25) Notifications

• private/specialist/notifications/get/all?offset=0&limit=2&order=desc&by=id викидає 500 помилку ("Your request could not be processed at the moment")
• client/notifications/settings/get or client/notifications/settings/set. Настройки сповіщень мають бути і для спеціаліста також, на даний момент тільки для клієнта.
• Потрібен окремий ендпоiнт для сповіщень про перегляди контакту спеціаліста, або можливість отримувати сповіщення за окремим типом з specialist/notifications/get/all.
• Потрібен функціонал прочитування сповіщень, тобто переводити з isRead: false в isRead: true.
• Потрібно отримувати загальну кількість непрочитаних повідомлень.

26) Показники 

• Реалізувати ендпоінт для отримання показників спеціаліста

27) agreementWithSpecialist

• потрібні два ендпоінти (get та post) для реалізації модального вікна: “Чи зв'язались із спеціалістом?”.

За функціоналом типу reminder.  Це модальне вікно відкривається в клієнта через 5хв після кліку на кнопку “Показати контакт спеціаліста”. Я думаю, що мають бути такі параметри в реквесті: параметр time в форматі timestamp;

параметр specialist - це:

API Admin

• Восстановление пароля за email

нужно ендпоинт, чтобы отправить email.

• administrator/specialists/get/all?offset=0&limit=20&order=desc&by=id  и administrator/specialists/get/all?offset=0&limit=20&order=desc&by=id  в этих ендпоинтах нужно добавить параметр поиска по имени и фамилии
• administrator/clients/get/all?offset=0&limit=20&order=desc&by=id  и administrator/specialists/get/all?offset=0&limit=20&order=desc&by=id также нужно, чтобы в ответе приходило поле count с количеством всех клиентов и специалистов.
• administrator/specialists/get/all нужно добавить параметр balance в response этого ендпоинта
• clients/update/by/id при реквесте отдает положительный ответ но не делает изменения.
• searchKeys in subCategories
  • при запиті підкатегорій, необхідно в response отримувати масив пошукових ключів в об'єкті кожної підкатегорії;
  • необхідно добавити ендпоінти для додавання та видалення пошукового ключа за id окремої subCategory;