Експорт, попередній перегляд і контрольоване відновлення

21. Експорт / Імпорт#

Збільшити ↗

Вкладка Експорт / Імпорт потрібна для резервної копії налаштувань і даних модуля, перенесення конфігурації між магазинами або швидкого повернення до робочого стану після невдалих змін.

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

Що входить до резервної копії#

Резервна копія може містити:

• налаштування модуля, службові налаштування виконання, токени провайдерів і облікові дані Telegram, які зберігаються в OpenCart;
• правила, чергу і історію відкладених подій;
• правила ризикових замовлень і із замаскованими приватними даними журнал рішень із прив'язками до створених замовлень;
• OTP-телефони і стан підтверджень;
• спроби авторизації дзвінком;
• журнал безпеки;
• IP-блокування і карантин джерел;
• дані вкладки Звіт;
• сповіщення адміністратору;
• журнал використання бюджету sap_sms_budget_usage.

Резервна копія не містить:

• файли модуля;
• кеш OCMOD;
• файли або сесії зовнішнього сервісу tgserv;
• зовнішні облікові записи провайдерів SMS, Telegram або дзвінків.

Якщо токен Telegram, SMS-токен або облікові дані Stream Telecom збережені саме в налаштуваннях OpenCart, вони входять до резервної копії як частина налаштувань модуля. Тому файл .sapbackup треба зберігати як приватний файл, а пароль — окремо від нього.

Як зробити експорт#

1. Відкрийте вкладку Експорт / Імпорт.
2. У блоці Експорт введіть пароль резервної копії.
3. Натисніть Експортувати.
4. У модальному вікні виберіть, які розділи включити.
5. Натисніть Експортувати у модальному вікні.
6. Збережіть файл .sapbackup у безпечному місці.

Що вибирати в модальному вікні експорту#

Типові варіанти:

Як зробити імпорт#

1. Відкрийте вкладку Експорт / Імпорт.
2. Перетягніть файл .sapbackup у поле імпорту або натисніть на поле і виберіть файл.
3. Введіть пароль резервної копії.
4. Натисніть Попередній перегляд.
5. Перевірте список змін, попередження та блокувальні помилки.
6. Якщо блокувальних помилок немає і зміни правильні, натисніть Відновити.

Поле імпорту приймає тільки .sapbackup. Інші файли модуль не приймає.

Що показує попередній перегляд#

Попередній перегляд нічого не записує в базу даних. Він:

• розшифровує резервну копію;
• перевіряє пароль;
• перевіряє контрольну суму;
• перевіряє, чи є потрібні таблиці та колонки;
• показує кількість налаштувань, таблиць і рядків у резервній копії;
• показує реальні зміни налаштувань;
• показує реальні зміни правил планувальника;
• показує попередження і блокувальні помилки.

Якщо в правилі планувальника відрізняється тільки службове поле на кшталт date_modified, модуль не повинен показувати це як зміну правила. Попередній перегляд має показувати зміни змісту, а не шум від технічних дат.

Статус Blocker зупиняє відновлення. Наприклад, якщо в поточній базі немає колонки, яка є у резервній копії. Статус Warning не зупиняє відновлення, але попередження треба прочитати до натискання Відновити.

Що відбувається при відновленні#

При натисканні Відновити модуль:

1. створює зашифровану резервну копію поточного стану перед імпортом;
2. установлює блокування операції, щоб паралельний імпорт не пошкодив дані;
3. тимчасово вимикає виконання модуля на час операції;
4. перевіряє та оновлює схему даних через наявний механізм встановлення й оновлення;
5. відновлює тільки ті розділи, які є у файлі резервної копії;
6. повертає стан виконання після успішного відновлення;
7. очищає тимчасові блокування в черзі відкладених подій і звільняє протерміновані записи reserved у журналі бюджету, щоб стара резервна копія не відновила неактуальний резерв як активний.

Важливо: якщо розділ не входив до резервної копії, він не видаляється під час імпорту. Наприклад, якщо ви експортували тільки Налаштування модуля і Звіт, то Відкладені події, стан OTP і таблиці захисту не мають бути перезаписані.

Для розділів, які входять до резервної копії, відновлення замінює поточні дані відповідного розділу даними з файлу. Тому перед натисканням Відновити завжди переглядайте майбутні зміни.

Режим приватності#

Якщо ввімкнено Режим приватності й модуль відкрив не головний адміністратор, вкладка Експорт / Імпорт не показується. Серверні адреси експорту, попереднього перегляду, відновлення та завантаження резервної копії перед імпортом також заблоковані.

Це зроблено спеціально: навіть якщо поля в адмінці замасковані, повна резервна копія містить реальні токени, телефони, стан OTP, спроби авторизації дзвінком, черги, логи і стан захисту. Давати такий інструмент користувачу без доступу до приватних даних - це не обслуговування, а діра.

Головний адміністратор може використовувати Експорт / Імпорт навіть при ввімкненому режимі приватності.

Практичні правила безпеки#

• Не відправляйте .sapbackup у відкриті чати.
• Не зберігайте пароль поруч із файлом резервної копії.
• Для тимчасового перенесення використовуйте окремий пароль і видаляйте файл після завершення.
• Перед великим відновленням експортуйте поточний стан вручну, навіть якщо модуль автоматично створює резервну копію перед імпортом.
• Не натискайте Відновити, якщо попередній перегляд показує зміни, яких ви не очікували.