Техническое задание HR Индикаторы

TZ_HR_INDICATORS.md

@@ -0,0 +1,376 @@
+# Техническое задание: Индикаторы HR
+
+## 1. Общее описание
+
+**Название:** HR Индикаторы — корпоративный дашборд управления персоналом.
+
+**Цель:** Единая панель для HR-директора и руководителей — все метрики персонала в реальном времени: от кадрового учёта до прогнозов.
+
+**Пользователи:**
+- HR-директор (полный доступ)
+- Руководители отделов (свой отдел)
+- HR-менеджеры (операционные метрики)
+- Топ-менеджмент (обзорный дашборд)
+
+---
+
+## 2. Технический стек
+
+| Слой | Технология |
+|------|-----------|
+| Фронтенд | React 18 + TypeScript + Tailwind |
+| Чарты | Recharts / ECharts |
+| Бэкенд | Node.js (Fastify) + TypeScript |
+| База данных | PostgreSQL 16 |
+| Кэш / очереди | Redis |
+| Авторизация | OAuth 2.0 / Azure AD / Keycloak |
+| Интеграция | 1С:Зарплата и кадры (REST API), SAP, Excel-импорт |
+| Деплой | Docker + Kubernetes |
+
+---
+
+## 3. Разделы дашборда
+
+### 3.1. Кадровое администрирование
+
+**Показатели:**
+- Всего сотрудников, штатных единиц, вакантных ставок
+- Штатное расписание (должность, ставок, занято, вакантно)
+- Кадровые приказы за период (приём, увольнение, перевод, отпуск, больничный, командировка)
+- Трудовые договоры: действующие, срочные, истекающие, ГПХ
+- График истечения договоров на 6 месяцев (диаграмма)
+- Документы: медосмотры, дипломы, воинский учёт (просроченные — красным)
+- Кадровые риски с приоритетами
+
+**Источники данных:** 1С:Зарплата и кадры, кадровый ЭДО
+
+---
+
+### 3.2. Подбор, отбор, приём, увольнение, адаптация
+
+**Показатели:**
+- Нанято / уволено за период, баланс
+- Воронка подбора: отклики → интервью → собеседование → оффер → выход
+- Конверсия каждого этапа, стоимость найма
+- Средний срок закрытия вакансии
+- Причины увольнений (диаграмма)
+- Динамика найма/увольнений по месяцам
+- Адаптация: % прошедших испытательный срок, удовлетворённость, оценка наставника
+
+**Источники данных:** ATS-система, HR-портал, 1С
+
+---
+
+### 3.3. Обучение и развитие
+
+**Показатели:**
+- Охват обучением (% персонала), часов на человека
+- Бюджет обучения (освоение %)
+- Программы: название, прошли, план, % выполнения
+- Эффективность: средняя оценка, применение знаний, рост KPI
+- Квартальный план обучения
+- Сертифицированные специалисты
+
+**Источники данных:** LMS, HR-портал
+
+---
+
+### 3.4. Кадровый резерв
+
+**Показатели:**
+- Численность резерва по уровням (топ, руководители, ведущие, перспективные)
+- Назначено из резерва за период
+- Ключевые позиции под риском: должность → преемник → готовность
+- План развития резервистов (ФИО, цель, программа, прогресс %)
+- % закрытия позиций из резерва
+
+**Источники данных:** HR-портал, Performance Management
+
+---
+
+### 3.5. Работа с молодёжью
+
+**Показатели:**
+- Сотрудников до 30 лет (количество и %)
+- Программа стажировок: направление, стажёров, трудоустроено
+- Взаимодействие с вузами: ВУЗ, практикантов, принято
+- Программа «Молодой лидер»: участников, наставников, выполнили, повышены
+- Молодёжные инициативы: проекты, участники
+
+**Источники данных:** HR-портал, ATS
+
+---
+
+### 3.6. Оплата труда, мотивация, удержание
+
+**Показатели:**
+- Средняя зарплата по компании
+- Структура дохода по грейдам (G1-G6): оклад, бонус %, итого
+- Топ-5 по KPI и бонусам за месяц
+- Соцпакет: ДМС, спорт, питание, гибкий график, удалёнка (охват %)
+- Причины демотивации (опрос) — диаграмма
+- Индекс лояльности eNPS
+- Средний стаж работы в компании
+
+**Источники данных:** 1С:Зарплата, опросы, HR-портал
+
+---
+
+### 3.7. Управление персоналом
+
+**Показатели:**
+- Численность по отделам (таблица + диаграмма)
+- Укомплектованность штата %
+- KPI по отделам (план/факт, статус)
+- Дисциплина: опоздания, больничные, прогулы, переработки
+- Гендерный состав по категориям (руководители/специалисты)
+- Руководители vs специалисты: численность, возраст, стаж
+- Возрастная структура (диаграмма)
+
+**Источники данных:** 1С, СКУД (турникеты), HR-портал
+
+---
+
+### 3.8. HR-бюджет
+
+**Показатели:**
+- Годовой бюджет всего и в разрезе статей (ФОТ, бонусы, соцпакет, обучение, подбор)
+- Бюджет по кварталам (план/факт)
+- Полная стоимость сотрудника по должностям (оклад × коэффициент)
+- Анализ экономии (вакансии, рефералы, онлайн-обучение, снижение текучести)
+- Динамика ФОТ год к году
+
+**Источники данных:** 1С:Зарплата, финансовая система
+
+---
+
+### 3.9. Оценка персонала
+
+**Показатели:**
+- Охват оценкой (%)
+- Методы оценки и их применение (KPI, 360°, OKR, аттестация, самооценка)
+- Распределение по рейтингу: A (превосходит) / B (соответствует) / C (развитие) / D (ниже)
+- High performers / Low performers
+- Динамика выполнения OKR по отделам (целей, выполнено, в процессе, под риском)
+
+**Источники данных:** Performance Management, OKR-трекер
+
+---
+
+### 3.10. Well-being
+
+**Показатели:**
+- Индекс счастья (0-10)
+- Уровень стресса по сотрудникам (низкий/средний/высокий/критический)
+- Обращения к психологу (EAP)
+- Охват программами здоровья (ДМС, спорт, йога, массаж)
+- Причины стресса (опрос) — диаграмма
+
+**Источники данных:** Опросы, HR-портал, EAP-провайдер
+
+---
+
+### 3.11. Внутренние коммуникации
+
+**Показатели:**
+- Индекс вовлечённости
+- eNPS (промоутеры / нейтралы / критики) + динамика
+- Каналы коммуникации (портал, email, Telegram, Town Hall) — охват и открываемость
+- HR Service Desk: обращений/мес, решено, среднее время ответа
+- Анонимная обратная связь
+- Exit-интервью (кол-во, причины)
+
+**Источники данных:** Опросы, HR Service Desk, коммуникационные платформы
+
+---
+
+### 3.12. HR-бренд
+
+**Показатели:**
+- Рейтинг на HeadHunter / Glassdoor
+- Отзывы сотрудников (кол-во, динамика)
+- Воронка работодателя на HH: просмотры → отклики → выход
+- Топ-причины выбора компании (опрос)
+- Социальные сети (LinkedIn, Instagram, Telegram) — подписчики, вовлечённость
+- Награды и рейтинги
+- Участие в ярмарках вакансий
+
+**Источники данных:** HeadHunter API, соцсети, ATS
+
+---
+
+### 3.13. Автоматизация HR
+
+**Показатели:**
+- % оцифрованных HR-процессов (по каждому: учёт, зарплата, подбор, обучение, оценка, адаптация, резерв)
+- HR-системы: название, охват, зрелость
+- План цифровизации: проект, срок, статус
+- DAU HR-портала
+- % самообслуживания сотрудников
+- Бумажные процессы (оставшиеся %)
+
+**Источники данных:** IT-отдел, HR-портал, ЭДО
+
+---
+
+### 3.14. Тренды и прогнозы
+
+**Показатели:**
+- Тренд численности (год к году, 3-5 лет)
+- Тренд ключевых HR-метрик (текучесть, eNPS, срок найма, ФОТ, вовлечённость, стаж)
+- Прогноз численности и найма на следующий год
+- Прогноз текучести
+- Уходящие на пенсию (ближайшие 2 года)
+- Прогноз рисков (вероятность × влияние)
+
+**Источники данных:** Все вышеперечисленные, ML-модель прогнозирования
+
+---
+
+## 4. ИИ-ассистент
+
+**Функции:**
+- Чат-интерфейс (плавающая кнопка в правом нижнем углу)
+- Обработка запросов на естественном языке (NLP)
+- Ответы на вопросы по всем 14 разделам
+- Аналитические расчёты на лету (суммы, проценты, сравнения)
+- Визуализация ответов (диаграммы текстом)
+- Рекомендации на основе данных
+
+**Технологии:**
+- OpenAI API / локальная LLM для NLP
+- RAG (Retrieval Augmented Generation) для ответов на основе данных компании
+- Кэширование частых запросов в Redis
+
+**Примеры запросов:**
+- «Сколько людей в отпуске?»
+- «KPI по отделам за июнь»
+- «Сравни текучесть IT и продаж»
+- «Бюджет обучения — сколько освоено?»
+- «Какие договоры истекают в этом месяце?»
+- «Прогноз численности на 2027»
+
+---
+
+## 5. API (основные эндпоинты)
+
+```
+GET    /api/hr/headcount               — численность
+GET    /api/hr/headcount/departments   — по отделам
+GET    /api/hr/turnover                — текучесть
+GET    /api/hr/turnover/trend          — тренд текучести
+GET    /api/hr/hiring/funnel           — воронка подбора
+GET    /api/hr/hiring/monthly          — найм/увольнения по месяцам
+GET    /api/hr/adaptation              — адаптация
+GET    /api/hr/training                — обучение (охват, программы)
+GET    /api/hr/training/effectiveness  — эффективность обучения
+GET    /api/hr/reserve                 — кадровый резерв
+GET    /api/hr/youth                   — работа с молодёжью
+GET    /api/hr/compensation            — оплата труда (грейды)
+GET    /api/hr/compensation/top-bonus  — топ KPI и бонусы
+GET    /api/hr/benefits                — соцпакет
+GET    /api/hr/engagement              — вовлечённость и eNPS
+GET    /api/hr/engagement/trend        — динамика eNPS
+GET    /api/hr/gender                  — гендерный состав
+GET    /api/hr/age-structure           — возрастная структура
+GET    /api/hr/discipline              — дисциплина
+GET    /api/hr/budget                  — HR-бюджет
+GET    /api/hr/budget/quarterly        — по кварталам
+GET    /api/hr/budget/cost-per-hire    — стоимость найма
+GET    /api/hr/performance             — оценка персонала (рейтинг)
+GET    /api/hr/performance/okr         — OKR по отделам
+GET    /api/hr/wellbeing               — well-being метрики
+GET    /api/hr/communications          — каналы коммуникации
+GET    /api/hr/communications/enps     — eNPS детально
+GET    /api/hr/employer-brand          — HR-бренд
+GET    /api/hr/employer-brand/social   — соцсети
+GET    /api/hr/automation              — автоматизация (%)
+GET    /api/hr/automation/plan         — план цифровизации
+GET    /api/hr/trends                  — тренды
+GET    /api/hr/trends/forecast         — прогнозы
+GET    /api/hr/risks                   — кадровые риски
+GET    /api/hr/documents               — документы (просроченные)
+GET    /api/hr/contracts/expiring      — истекающие договоры
+GET    /api/hr/vacations               — отпуска (статистика)
+POST   /api/ai/ask                     — запрос к ИИ-ассистенту
+```
+
+---
+
+## 6. База данных (ключевые таблицы)
+
+```sql
+employees: id, name, department_id, position_id, grade, hire_date, 
+           birth_date, gender, status (active/on_leave/fired), 
+           manager_id, created_at, updated_at
+
+departments: id, name, manager_id, headcount_plan
+
+positions: id, title, grade_min, grade_max, salary_range_min, salary_range_max
+
+contracts: id, employee_id, type (permanent/fixed/gph), start_date, end_date,
+           status, document_url
+
+hr_orders: id, employee_id, type (hire/fire/transfer/vacation/sick/business_trip),
+           date, status
+
+vacations: id, employee_id, planned_date, actual_start, actual_end, 
+           days_total, days_remaining
+
+attendance: id, employee_id, date, check_in, check_out, status (present/late/absent)
+
+training: id, program_name, type, provider, budget, participants_count, 
+          avg_rating, date
+
+training_participants: training_id, employee_id, passed, score
+
+reserve: id, employee_id, target_position_id, readiness_level, 
+         program, progress_pct
+
+performance: id, employee_id, period, method (kpi/360/okr/attestation), 
+             score, rating (A/B/C/D)
+
+okr: id, department_id, quarter, objective, key_result, progress_pct, status
+
+wellbeing: id, employee_id, date, stress_level (0-10), burnout_risk, 
+           eap_used, satisfaction_score
+
+engagement_survey: id, date, participant_count, engagement_score, enps_score
+
+hr_budget: id, year, quarter, category (fot/bonus/social/training/hiring),
+           plan_amount, actual_amount
+
+recruitment_funnel: id, month, stage, candidates_count
+```
+
+---
+
+## 7. Интеграции
+
+| Система | Тип | Назначение |
+|---------|------|-----------|
+| 1С:Зарплата и кадры | REST API | Сотрудники, оклады, приказы, штатка |
+| HeadHunter | API | Вакансии, отклики, рейтинг |
+| ATS (Хантфлоу / Potok) | API | Воронка подбора |
+| LMS (Moodle / iSpring) | API | Обучение, курсы |
+| СКУД (турникеты) | API | Посещаемость, опоздания |
+| Active Directory / Azure AD | LDAP | Авторизация пользователей |
+| Корпоративный портал | API | Обращения, опросы |
+| Telegram / Slack | Webhook | Уведомления, алерты |
+
+---
+
+## 8. Этапы разработки
+
+| Этап | Содержание | Срок |
+|------|-----------|------|
+| 1 | Проектирование БД, API авторизации, интеграция 1С | 2 недели |
+| 2 | Разделы 1-2: кадровое администрирование, подбор | 2 недели |
+| 3 | Разделы 3-5: обучение, резерв, молодёжь | 2 недели |
+| 4 | Разделы 6-8: оплата, управление, бюджет | 2 недели |
+| 5 | Разделы 9-12: оценка, well-being, коммуникации, бренд | 2 недели |
+| 6 | Разделы 13-14: автоматизация, тренды | 1 неделя |
+| 7 | ИИ-ассистент (NLP + RAG) | 2 недели |
+| 8 | Тестирование, деплой, обучение пользователей | 2 недели |
+
+**Итого:** 15 недель, команда 3-4 разработчика.