Імпорт модуля

Генерація — не єдиний спосіб, яким модуль потрапляє до вашої бібліотеки. Якщо у вас уже є модуль Odoo у вигляді ZIP — те, що ви створили вручну, завантажили з Apps Store або згенерували десь-інде, — ви можете імпортувати його. OdoMate перевіряє його на безпеку та якість, видобуває специфікацію з коду, пише для нього посібник користувача та додає його до вашої бібліотеки модулів як повноцінний модуль, версія 1.

Заувага

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

Початок імпорту

Відкрийте бібліотеку модулів і натисніть Import module поруч із заголовком бібліотеки.

1. Оберіть мову. Це мова, якою OdoMate пише специфікацію, короткий опис і посібник користувача модуля, — за замовчуванням це мова вашого інтерфейсу, але для цього імпорту можна обрати іншу.

2. Перетягніть або оберіть ZIP. Перетягніть файл .zip в область для завантаження або натисніть на неї, щоб обрати файл, — до 10 МБ. Імпорт починається одразу, щойно файл прийнято; окремого кроку підтвердження немає.

Обережно

ZIP-архів має містити рівно один модуль: або __manifest__.py на верхньому рівні, або одну папку верхнього рівня, що містить його. ZIP із кількома папками модулів або без жодної відхиляється ще до початку аналізу.

Що відбувається під час імпорту

Діалогове вікно показує п’ять кроків, поки OdoMate проходить їх, з таймером, що відлічує витрачений час, поруч:

1. Uploading and unpacking the ZIP
2. Scanning the code for security risks
3. Reading the module, writing its specification and user guide
4. Packaging a clean copy for your library
5. Test-installing it in a fresh Odoo database

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

Перевірка безпеки

Перш ніж робити щось інше, OdoMate сканує код модуля на невеликий набір небезпечних патернів — динамічне виконання коду або звернення до операційної системи через shell — не запускаючи жодного з них. Модуль, який спрацьовує цю перевірку, відхиляється одразу і ніколи не доходить до кроку встановлення. Усе інше, що помічає сканування, — неперевірену зовнішню залежність, хук встановлення, що виходить за межі ORM, файл даних із сирим SQL, — записується як знахідка у звіті аналізу, а не блокує імпорт.

Коли імпорт завершується

• Imported. Діалогове вікно показує Module imported із кнопкою View in library, яка одразу веде до нової картки. Далі модуль поводиться так само, як і будь-який згенерований: має специфікацію, посібник користувача, і його можна вдосконалити, відкотити, завантажити або надіслати в GitHub. Якщо тестове встановлення не пройшло повної перевірки, картка отримує той самий бейдж «не перевірено», що й у генерації.
• Rejected. Діалогове вікно показує Import rejected і, якщо причиною зупинки стала перевірка безпеки, — конкретні знахідки, які її спричинили. Натисніть Try another file, щоб спробувати інший ZIP, — до вашої бібліотеки нічого не додано.
• Failed. Діалогове вікно показує Import failed — платформа зіткнулася з проблемою, яка не мала стосунку до вашого модуля (сховище, виклик LLM, сайдкар встановлення). Натисніть Try another file, щоб повторити спробу.

Звіт аналізу

Звіт кожного імпорту — успішного, відхиленого чи невдалого з частковим скануванням — можна відкрити знову пізніше. Для імпортованого модуля той самий звіт, який показувало діалогове вікно, також варто переглянути з бібліотеки, якщо ви хочете перевірити, що знайшов OdoMate. Він містить:

• Odoo version — серію, визначену з маніфесту модуля, позначену, якщо це не Odoo 19, разом з конкретними ознаками застарілого API (наприклад, attrs=/states= або вигляд <tree>), знайденими в коді.
• Security and quality observations — консультативний прохід по коду, окремий від перевірки безпеки вище; він не може заблокувати імпорт, лише поінформувати вас.
• Automated checks — синтаксичні й семантичні помилки або попередження від тієї самої перевірки, яку використовує генерація.
• Install verification — чи справді вдалося тестове встановлення в чисту базу даних Odoo.

Відхилені завантаження

Завантаження, яке так і не стало модулем, не видаляється одразу. Під основним списком бібліотеки розділ Rejected uploads (за замовчуванням згорнутий) показує завантаження, що не пройшли перевірку безпеки, і зберігаються 30 днів. Кожен рядок показує, коли файл було завантажено, скільки знахідок він мав, і кнопку View report, яка знову відкриває той самий звіт аналізу.