==========================================
РуОду — Комиссии агентам: сценарные тесты
==========================================
.. |badge1| image:: https://img.shields.io/badge/maturity-Beta-yellow.png
:target: https://odoo-community.org/page/development-status
:alt: Beta
.. |badge2| image:: https://img.shields.io/badge/licence-LGPL--3-blue.png
:target: http://www.gnu.org/licenses/lgpl-3.0-standalone.html
:alt: License: LGPL-3
|badge1| |badge2|
Сквозной функциональный тест модуля ``ruodoo_commission`` на штатном
механизме туров Odoo (``web_tour`` + ``HttpCase.start_tour``, headless
Chrome). Тест имитирует работу пользователя через интерфейс и после
каждого этапа проверяет результат по данным в БД (ORM), а не только по
экрану. Предназначен для запуска перед релизом: падает, если бизнес-
процесс комиссий сломан.
Только для тестирования — модуль не несёт бизнес-логики.
**Содержание**
.. contents::
:local:
Что проверяется
===============
Один тестовый метод (``test_commission_full_flow``) последовательно
запускает три тура под пользователем «продавец + начисляет комиссии»:
#. **Заказ и начисление** (``ruodoo_commission_order_tour``):
создать заказ, выбрать клиента, добавить строку (товар, количество),
выбрать две комиссии в колонке «Комиссии», сохранить, подтвердить,
нажать «Начислить комиссию».
#. **Смарт-кнопка** (``ruodoo_commission_smart_button_tour``):
открыть заказ, нажать смарт-кнопку «Комиссии», увидеть список
сформированных счетов поставщика.
#. **Отмена** (``ruodoo_commission_cancel_tour``): отменить заказ через
интерфейс.
Проверки по БД между турами:
* заказ подтверждён; в строке один товар, количество 10, две комиссии;
* сумма комиссий строки и «ИТОГО КОМИССИЙ» заказа совпадают (150);
* комиссии не входят в итог заказа (``amount_total`` = 1000);
* сформированы два счёта поставщика (по числу получателей), оба
проведены; суммы (100 и 50) совпадают с суммами комиссий;
* журнал и счёт расходов в счетах — из настроек комиссии;
* счётчик смарт-кнопки равен 2;
* после отмены заказ в состоянии «Отменён», счета комиссий удалены.
Зависимости
===========
* ``ruodoo_commission`` — тестируемый модуль
* ``sale_management`` — заказы на продажу (UI-сценарий)
* ``account`` — счета поставщика
Требования окружения
====================
Туры выполняются в headless-браузере, поэтому в окружении нужны:
* **Chrome/Chromium** (Odoo ищет ``google-chrome`` / ``chromium`` в
``PATH``; путь можно задать переменной ``ODOO_BROWSER_BIN``);
* Python-пакет **websocket-client** (иначе тур-тест будет пропущен).
.. note::
Если браузер или ``websocket-client`` недоступны, Odoo помечает
тест как *skipped*. Пропуск не является успехом — для достоверного
прогона перед релизом обеспечьте оба компонента (например, в
``Dockerfile`` образа Odoo).
Запуск
======
::
odoo -d <test_db> -i ruodoo_commission_test_tours \
--test-enable --test-tags=/ruodoo_commission_test_tours \
--stop-after-init
Полезные опции: ``--screenshots=/tmp/commission_tours`` для скриншотов
при падении; ``ODOO_BROWSER_BIN=/path/to/chrome`` — явный путь к браузеру.
Как это устроено
================
* Туры (``static/tests/tours/*.js``) подключены как ассеты в
``web.assets_tests`` и зарегистрированы в
``registry.category("web_tour.tours")``.
* Селекторы — стабильные: по ``name`` полей/кнопок
(``button[name=action_accrue_commission]``,
``.o_field_many2many_tags[name=commission_ids]``), семантическим
классам Odoo и ``:contains`` только для данных, созданных тестом
(«Tour Customer», «Tour Commission …»).
* Данные (клиент, товар без налогов, два вида комиссий с журналом,
счётом расходов и партнёрами-получателями, пользователь с группами)
создаются в ``setUpClass`` через ORM. ORM используется только для
подготовки и проверок; действия сценария выполняются в UI.
Авторы
======
* MK.Lab, RuOdoo
Модуль сопровождается MK.Lab, RuOdoo.
.. image:: https://ruodoo.ru/logo.png
:alt: MK.Lab, RuOdoo
:target: https://ruodoo.ru
Модуль является частью решения РуОду.
