Работа с целями (OKR)

Работа с целями (OKR)

Система позволяет управлять целями и ключевыми результатами для сотрудников, команд и компании.

• Goal — высокоуровневая цель. Цели могут быть вложенными и иметь parent_goal_id.
• Key Result — измеримый показатель достижения цели.
• Check-in — запись об изменении значения ключевого результата.

Иерархия и веса

• Цели могут иметь вложенную структуру.
• У каждой цели и каждого ключевого результата есть weight, который влияет на прогресс родительской сущности.

Получение данных

При запросе конкретной цели через GET /api/v1/goals/{id} возвращаются все данные, включая вложенные ключевые результаты и текущий прогресс.

Для поиска целей используйте POST /api/v1/goals/search.

Основные параметры фильтрации:

• owner_type — company, department, team, employee
• text — текст в названии цели
• status — active, completed, cancelled
• is_shared — доступна ли цель другим пользователям
• confidence_level — on_track, at_risk, off_track
• date_period_start и date_period_end
• only_top_level — только цели без родителя
• parent_goal_id — список родительских целей

Управление прогрессом

1. Создание цели: POST /api/v1/goals
2. Добавление key result: POST /api/v1/goals/{goal_id}/key-results
3. Check-in: POST /api/v1/goals/{goal_id}/key-results/{kr_id}/checkin

Изменение value и confidence_level приводит к пересчёту прогресса ключевого результата и связанных вышестоящих целей.

Основные поля Goal

• id — уникальный идентификатор цели
• title — название цели
• description — описание
• owner_type — тип владельца цели
• owner_employee_id, owner_department_id, owner_team_id — ID владельца в зависимости от типа
• is_shared — доступность для других пользователей
• date_start, date_end — период действия цели
• status — текущий статус
• progress — текущий прогресс в процентах
• confidence_level — уровень уверенности в достижении
• weight — вес цели относительно родителя
• is_archived — признак архивации
• goal_key_results_count — количество ключевых результатов
• has_children — есть ли вложенные цели

Поля parent goal

parent_goal содержит краткую информацию о родительской цели, включая:

• id
• parent_goal_id
• assign_to_ids
• visible_to_ids

Остальные поля повторяют основные поля цели.

Ключевые результаты

goal_key_results — массив объектов с измеримыми показателями.

• id
• goal_id
• title
• description
• metric_type — number, percentage, currency, boolean
• start_value
• target_value
• current_value
• progress
• confidence_level
• weight

Check-ins

goal_key_result_check_ins хранит историю изменений:

• id
• employee_id
• value

Служебные поля

• acl — права доступа текущего пользователя
• created_by — создатель цели
• assign_to — назначенный сотрудник
• visible_to — список сотрудников с правом просмотра