# ТЗ: Evrone HRM — корпоративная HR-система

Демонстрационная версия документа · категория «HR» · №10

> Это демонстрационное техническое задание: оно показывает структуру и глубину
> документа, который передаётся вместе с прототипом. Боевое ТЗ по этому солюшену
> готовится и заменит этот файл.

## 1. Суть решения

Оргструктура, онбординг, 1-on-1, цели OKR, performance review и оценка 360.

Внутренний HR-контур. Карточки сотрудников, оргструктура (юрлица, отделы, подчинённость), онбординг-треки, встречи 1-on-1 с заметками, цели KPI/OKR с каскадированием, ИПР, циклы performance review и оценка 360, опросы вовлечённости.

## 2. Технологический стек

| Слой | Решение |
|---|---|
| Backend | Ruby on Rails 8, PostgreSQL |
| Frontend | Hotwire (Turbo + Stimulus), Tailwind CSS |
| Фоновые задачи | Solid Queue |
| Файлы | Active Storage, S3-совместимое хранилище |
| Деплой | Docker, Kamal, production + staging |

## 3. Роли

- Сотрудник
- Руководитель
- HR-бизнес-партнёр
- Администратор

## 4. Модель данных

### 4.1. Employee

```
full_name: string
position: string
unit_id: references
manager_id: references, nullable
hired_at: date
```

### 4.2. Goal

```
employee_id: references
kind: enum # KPI, OKR
period: daterange
progress: integer
parent_goal_id: references, nullable
```

### 4.3. ReviewCycle

```
period: daterange
state: enum
assessments: has_many # включая оценку 360
```

## 5. Ключевые сценарии

1. HR ведёт оргструктуру - юрлица, отделы, подчинённость
2. Новичок проходит онбординг-трек с задачами и ответственными
3. Руководитель и сотрудник фиксируют итоги 1-on-1 и цели периода
4. Цикл performance review собирает самооценку, оценку руководителя и 360

## 6. Интеграции

- Кадровый учёт
- SSO
- Опросы вовлечённости
- Экспорт отчётов

## 7. Нефункциональные требования

- Серверный рендеринг, работоспособность ключевых страниц без JavaScript
- Мобильная адаптивность обязательна
- Роли и права проверяются на уровне сервера, а не интерфейса
- Логирование действий пользователей по значимым операциям
- Покрытие тестами моделей и ключевых сценариев
- Развёртывание одной командой, окружения production и staging

## 8. Состав MVP

Карточки + оргструктура + цели + один цикл ревью.

## 9. Критерии приёмки

1. Все сценарии из раздела 5 проходят end-to-end на тестовом стенде
2. Роли из раздела 3 видят только то, что им положено
3. Интеграции из раздела 6 работают через слой адаптеров и переключаются конфигурацией
4. Прототип разворачивается из репозитория одной командой
5. Документация по запуску и переменным окружения лежит в README