User story #5627
Updated by ♣ Ilya Lepkin-Titov 9 months ago
для проєкту ОККО є необхідність реалізувати інтеграцію з Listex.
*дійові особи:*
користувач з правами редагування (людина, яка буде створювати планограми) та супер адміністратор
*мета:*
оновити/заповнити дані по розмірам товарів через запит до бази Listex (за наявності у клієнта ключа доступу)
*передумова:*
1. у товарів не актуальні розміри
2. у товарів нема розмірів
Функціональні вимоги: *успішний сценарій:*
# Додати кнопку нового функціонал 1. користувач відриває планограму, з якою буде працювати
2. відкриває кубік аналітики і там натискає на кнопку, яка викликає вікно для формування запиту в кубіку аналітики. Listex
# При відкритті функціоналу Завантаження розмірів Listex:
## Відкривається вікно з вибором категорій.
## Користувач може додати лише 3. у самому вікні шукає потрібну категорію найнижчого рівня. рівня (та, яка далі містить в собі товари), це може бути як основне дерево товарів, так і альтернативне:
## Можна обрати лише одну категорію.
## В вікні вибору * робить це відкриваючи категорії додати 2 таби. по рівням
### Категорії - обрано за замовчуванням. * користується пошуком
### Альтернативні категорії.
# Подається 4. обирає категорію натискаючи на "+" та відправляє запит натискаючи на API Listex по товарам з обраної групи. "Підтвердити"
## Відповідь від API 429 - відображати повідомлення з текстом - Спробуйте пізніше, ліміт 500 товарів за 5хв вичерпано.
## Відповідь від API 429 - відображати повідомлення з текстом - Досягнуто ліміт скачування контенту.
## Відповідь від API 401 - відображати повідомлення з текстом - Відсутній apikey.
## Відповідь від API 404 - відображати повідомлення з текстом - Запитувана інформація не знайдено.
## Відповідь від API 404 - відображати повідомлення з текстом - Немає доступу до запитуваної інформації.
## Відповідь від API 400/500/501/503 - відображати повідомлення з текстом - Щось пішло не так.
## В таблиці відображати кількість доступних запитів. Брати з HTTP заголовку API-Usage-Limit.
## Поки обробляється запит 5. в процесі очікування на API, на екрані відображається видно лоадер, який реалізовано по верх над кнопкою закриття вікна. Це треба зробити, щоб користувач дочекався завантаження даних та не закрив вікно раніше, ніж то потрібно.
# Після
6. після завантаження даних формується таблиця: табличка, а також показується інформація по кількості товарів, які були завантажені з можливих 500
## Наборі полів:
### Назва в таблиці користувач бачить наступні дані:
* назва товару
### Штрих код * штрихкод (бо пошук даних відбувається за ним)
### Назва * назва основної одиниці виміру. виміру
### Колонка "Розбіжність" - відображає "так", "ні", якщо розміри товару * дані по розмірам товарів, які на зараз є в лістексі відрізняються від розмірів товару в шелфі. Розділяти кольором, "Так" - #4DFF3D1F, "Ні" - #FF3D4724.
### Розміри товару в шелфі - системі (ширина, висота, ширина, глибина. Виділяти кольором, #FF3D4724, розміри, глибина)
* дані, по розмірам товарів, які розрізняються.
### Розміри товару були знайдені в Listex - висота, ширина, глибина, з додаванням літери Listex, для цього в назві коронки буде маркер у вигляді литери "L" біля назви колонки.
## Користувач може сортувати таблицю за будь-якою колонкою, за спаданням або зростанням. * колонка маркер чи відрізняються поточні дані від тих, що були знайдені
## Користувач може використовувати пошук товару 7. за штрих-кодом і потреби користувач має змогу зробити сортування за назвою. зростанням/спаданням по будь-якій колонці
## Відображає кількість товарів, що були в запиті 8. клікнувши на Listex і кількість доступних запитів. Наприклад: (343/500).
### Перше, скільки товарів було в запиті на лістекс з обраної категорії. чекбокс користувач обирає по яким товарам треба зробити заміну/запис розмірів
### Друге, з API-Usage-Limit. * обирає одразу по всьому
## Користувач може обрати усі товари або обирати * обирає кожен товар окремо. окремо
# Після * має змогу скористатись пошуком для вибору конкретного товару (по назві, артикулу чи ШК)
9. після вибору потрібних товарів користувач підтверджує запис нових даних натиснувши "Застосувати"
# Результат - дані по розмірам оновлено. 10. у поп-апі справа з'явзяється інформація про успішність виконаної операції
*результат:*
# Додати опцію, яка буде надавати товарам статус, що їх габарити було змінено за допомогою функціоналу Завантаження відбулась зміна/запис розмірів Listex і не перезаписувати їх габарити з обміном.
*Flowchart:*
!last_version.drawio.png!
"Посилання товарів
*посилання на фігму з дизайном:":https://www.figma.com/design/mT5ks1IcjpN2haDcW3p1zv/Redesign-1.0?node-id=7251-7183&t=xFwB74kx7tPzTcPW-1 дизайном:*
https://www.figma.com/design/mT5ks1IcjpN2haDcW3p1zv/Redesign-1.0?node-id=7251-7183&t=xFwB74kx7tPzTcPW-1
_*важливо не забути*_
на майбутнє говорили про те, щоб при редизайні блоку групового управління будемо переносити цей блок туди, також потрібно:
1. зробити пошук через різні ресурси універсальним, щоб клієнти могли користуватись різними сервісами в залежності від країни
2. реалізувати на беку можливість створювати черги по запитам, щоб розуміти більш детально по скільком товарам інформація знайдена, яків. черзі і т.п.
*дійові особи:*
користувач з правами редагування (людина, яка буде створювати планограми) та супер адміністратор
*мета:*
оновити/заповнити дані по розмірам товарів через запит до бази Listex (за наявності у клієнта ключа доступу)
*передумова:*
1. у товарів не актуальні розміри
2. у товарів нема розмірів
Функціональні вимоги: *успішний сценарій:*
# Додати кнопку нового функціонал 1. користувач відриває планограму, з якою буде працювати
2. відкриває кубік аналітики і там натискає на кнопку, яка викликає вікно для формування запиту в кубіку аналітики. Listex
# При відкритті функціоналу Завантаження розмірів Listex:
## Відкривається вікно з вибором категорій.
## Користувач може додати лише 3. у самому вікні шукає потрібну категорію найнижчого рівня. рівня (та, яка далі містить в собі товари), це може бути як основне дерево товарів, так і альтернативне:
## Можна обрати лише одну категорію.
## В вікні вибору * робить це відкриваючи категорії додати 2 таби. по рівням
### Категорії - обрано за замовчуванням. * користується пошуком
### Альтернативні категорії.
# Подається 4. обирає категорію натискаючи на "+" та відправляє запит натискаючи на API Listex по товарам з обраної групи. "Підтвердити"
## Відповідь від API 429 - відображати повідомлення з текстом - Спробуйте пізніше, ліміт 500 товарів за 5хв вичерпано.
## Відповідь від API 429 - відображати повідомлення з текстом - Досягнуто ліміт скачування контенту.
## Відповідь від API 401 - відображати повідомлення з текстом - Відсутній apikey.
## Відповідь від API 404 - відображати повідомлення з текстом - Запитувана інформація не знайдено.
## Відповідь від API 404 - відображати повідомлення з текстом - Немає доступу до запитуваної інформації.
## Відповідь від API 400/500/501/503 - відображати повідомлення з текстом - Щось пішло не так.
## В таблиці відображати кількість доступних запитів. Брати з HTTP заголовку API-Usage-Limit.
## Поки обробляється запит 5. в процесі очікування на API, на екрані відображається видно лоадер, який реалізовано по верх над кнопкою закриття вікна. Це треба зробити, щоб користувач дочекався завантаження даних та не закрив вікно раніше, ніж то потрібно.
# Після
6. після завантаження даних формується таблиця: табличка, а також показується інформація по кількості товарів, які були завантажені з можливих 500
## Наборі полів:
### Назва в таблиці користувач бачить наступні дані:
* назва товару
### Штрих код * штрихкод (бо пошук даних відбувається за ним)
### Назва * назва основної одиниці виміру. виміру
### Колонка "Розбіжність" - відображає "так", "ні", якщо розміри товару * дані по розмірам товарів, які на зараз є в лістексі відрізняються від розмірів товару в шелфі. Розділяти кольором, "Так" - #4DFF3D1F, "Ні" - #FF3D4724.
### Розміри товару в шелфі - системі (ширина, висота, ширина, глибина. Виділяти кольором, #FF3D4724, розміри, глибина)
* дані, по розмірам товарів, які розрізняються.
### Розміри товару були знайдені в Listex - висота, ширина, глибина, з додаванням літери Listex, для цього в назві коронки буде маркер у вигляді литери "L" біля назви колонки.
## Користувач може сортувати таблицю за будь-якою колонкою, за спаданням або зростанням. * колонка маркер чи відрізняються поточні дані від тих, що були знайдені
## Користувач може використовувати пошук товару 7. за штрих-кодом і потреби користувач має змогу зробити сортування за назвою. зростанням/спаданням по будь-якій колонці
## Відображає кількість товарів, що були в запиті 8. клікнувши на Listex і кількість доступних запитів. Наприклад: (343/500).
### Перше, скільки товарів було в запиті на лістекс з обраної категорії. чекбокс користувач обирає по яким товарам треба зробити заміну/запис розмірів
### Друге, з API-Usage-Limit. * обирає одразу по всьому
## Користувач може обрати усі товари або обирати * обирає кожен товар окремо. окремо
# Після * має змогу скористатись пошуком для вибору конкретного товару (по назві, артикулу чи ШК)
9. після вибору потрібних товарів користувач підтверджує запис нових даних натиснувши "Застосувати"
# Результат - дані по розмірам оновлено. 10. у поп-апі справа з'явзяється інформація про успішність виконаної операції
*результат:*
# Додати опцію, яка буде надавати товарам статус, що їх габарити було змінено за допомогою функціоналу Завантаження відбулась зміна/запис розмірів Listex і не перезаписувати їх габарити з обміном.
*Flowchart:*
!last_version.drawio.png!
"Посилання товарів
*посилання на фігму з дизайном:":https://www.figma.com/design/mT5ks1IcjpN2haDcW3p1zv/Redesign-1.0?node-id=7251-7183&t=xFwB74kx7tPzTcPW-1 дизайном:*
https://www.figma.com/design/mT5ks1IcjpN2haDcW3p1zv/Redesign-1.0?node-id=7251-7183&t=xFwB74kx7tPzTcPW-1
_*важливо не забути*_
на майбутнє говорили про те, щоб при редизайні блоку групового управління будемо переносити цей блок туди, також потрібно:
1. зробити пошук через різні ресурси універсальним, щоб клієнти могли користуватись різними сервісами в залежності від країни
2. реалізувати на беку можливість створювати черги по запитам, щоб розуміти більш детально по скільком товарам інформація знайдена, яків. черзі і т.п.
