Public release from ruodoo-project: 19.0 - 2026-11-01 22:52:25 UTC

directive_common/README.md

@@ -0,0 +1,70 @@
+# Слой директив — Подключение к штатным моделям (Directive Common)
+**name:** directive_common
+**version:** 19.0.1.0.0
+**author:** RuOdoo
+
+
+### 1. Общее описание
+
+Модуль-компаньон подключает слой директив `directive_layer` к штатным бизнес-объектам Odoo: задачам, заказам, счетам, платежам, складу и производству. Служит рабочим примером для разработчиков, которые хотят подключить директивы к своим объектам, и несёт крон-симулятор программных и машинных агентов. Демо-пользователи (`data/users.xml`) грузятся только в demo-БД.
+
+
+### 2. Установка
+
+1. Убедитесь, что установлен модуль `directive_layer`
+
+2. Разместите папку `directive_common` в директории `addons`
+
+3. Перезапустите сервер Odoo
+
+4. Обновите список приложений: **Настройки → Приложения → Обновить список**
+
+5. Найдите **«Directive Common»** и установите
+
+### 3. Функциональность
+
+3.1 К каким объектам подключены директивы:
+
+| Объект | Когда создаётся задание | Кто исполняет |
+|---|---|---|
+| Задача проекта | При переходе задачи в определённую стадию | Человек |
+| Заказ на продажу | При подтверждении заказа | WMS-агент (автоматически) |
+| Входящий счёт | При подтверждении счёта от поставщика | Аудит-бот (автоматически) |
+| Исходящий платёж | При переходе платежа в обработку | Банковский шлюз (автоматически) |
+| Перемещение склада | После подтверждения перемещения | AGV-робот (автоматически) |
+| Рабочий центр | Когда операция резки готова к запуску | IoT-оборудование (автоматически) |
+
+3.2 Элементы на форме объекта:
+
+На форме каждого из перечисленных объектов появляются три элемента:
+
+- **Кнопка «Выбрать тип»** в шапке — назначает группу заданий для записи
+- **Кнопка «Директивы»** — показывает количество заданий, открывает список
+- **Поле «Исполнение»** — текущий сводный статус всех заданий по записи
+
+![img_1.png](img_1.png)
+
+После выполнения задания в чат записи автоматически поступает сообщение от исполнителя. 
+
+### Пример использования
+
+### Открыть объект и назначить группу заданий
+
+Перейдите в любой поддерживаемый объект, например **Продажи → Заказы**. Нажмите кнопку **«Выбрать тип»** в шапке формы и выберите группу шаблонов заданий.
+
+![img_2.png](img_2.png)
+
+### Выполнить бизнес-действие
+
+Подтвердите заказ, переведите задачу в нужную стадию, проведите платёж и т.д. Задание создастся автоматически и появится в кнопке **«Директивы»**.
+
+### Посмотреть список заданий
+
+Нажмите кнопку **«Директивы»** на форме объекта — откроется список всех заданий с текущими стадиями, дедлайнами и исполнителями.
+
+![img_3.png](img_3.png)
+
+### Проверить результат в чате
+
+После выполнения задания перейдите в чат записи — там появится сообщение от исполнителя с результатом работы.
+