84 lines
4.8 KiB
Markdown
84 lines
4.8 KiB
Markdown
# Слои показателей - Базовый модуль
|
||
name: mklab_base_indicators
|
||
version: 19.0.2025.11.17
|
||
author: MK.Lab
|
||
|
||
|
||
### 1. Общее описание
|
||
Слой показателей — это инструмент для отслеживания числовых метрик (KPI) по любым объектам Odoo: задачам, заказам, проектам и т.д. В основе слоя показателей лежит модель гиперграфа. Объекты системы становятся вершинами, между вершинами строятся связи, к вершинам привязываются показатели с плановыми и фактическими значениями во времени.
|
||
|
||
### 2. Установка
|
||
1. Скопируйте папку модуля mklab_base_indicators в директорию addons Odoo
|
||
|
||
2. Перезапустите сервер Odoo
|
||
|
||
3. Обновите список приложений: Настройки — Приложения — Обновить список
|
||
|
||
4. Найдите модуль через интерфейс администрирования и установите
|
||
|
||
5. Настройте права доступа для пользователей
|
||
|
||
## Как это выглядит в интерфейсе
|
||
|
||
В главном меню появляется раздел **«Слои показателей»** с двумя подразделами:
|
||
|
||
**Граф:**
|
||
- **Вершины графа** — список всех узлов с привязкой к объектам системы
|
||
- **Матрица связности** — список направленных связей между вершинами
|
||
|
||
**Показатели:**
|
||
- **Показатели** — список метрик с текущим значением, кодом, вершиной
|
||
- **Значения показателей** — история план/факт по датам
|
||
- **Внутренний код** — справочник классификаторов
|
||
|
||
|
||
|
||
### 3. Функциональность
|
||
3.1 Основные компоненты:
|
||
|
||
| Понятие | Модель | Описание |
|
||
|---|---|---|
|
||
| Вершина графа | `hg.node` | Узел — представитель любого объекта Odoo (задача, заказ, проект...) |
|
||
| Показатель | `hg.index` | Именованная метрика, привязанная к вершине |
|
||
| Значение показателя | `hg.value` | Конкретное значение: план, факт, дата |
|
||
| Матрица связности | `hg.link` | Направленная связь: одна вершина → множество вершин |
|
||
| Внутренний код | `hg.index.code` | Классификатор для группировки показателей |
|
||
|
||
3.2 Основные возможности:
|
||
- Автоматическое создание и управление вершинами графа
|
||
- Определение показателей и их характеристик
|
||
- Управление связями между элементами
|
||
- Вычисление текущих значений показателей
|
||
- Работа с временными рядами данных
|
||
|
||
|
||
### Пример использования
|
||
|
||
Перейдите в меню Слои показателей
|
||
|
||
|
||
|
||
### Создать вершины
|
||
|
||
Перейдите в **Слои показателей → Граф → Вершины графа** и создайте вершины для нужных объектов. Укажите название, модель (`project.task`, `sale.order` и т.д.) и ID записи.
|
||
|
||
|
||
|
||
### Настроить связи между сущностями
|
||
Перейдите в **Матрица связности** и создайте связи между вершинами: выберите источник и одну или несколько вершин-приёмников.
|
||
|
||
|
||
|
||
### Добавить показатели
|
||
В **Показатели** создайте метрику: укажите название, внутренний код, привяжите к вершине.
|
||
|
||
|
||
|
||
### Внести значения
|
||
В форме показателя на вкладке **Значения** добавляйте строки: дата, план, факт, тип (`Простой` или `Формула`).
|
||
|
||
**Текущее значение** обновляется автоматически — берётся последнее фактическое значение с датой не позднее сегодняшней.
|
||
|
||
|
||
|
||
 |