Работа с целями (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 - список сотрудников с правом просмотра