Справочник сотрудников и оргструктура

Что это за сервис

Внутренний справочник компании: кто в какой команде работает, кому подчиняется, где находится и как с ним связаться. Пользуются все сотрудники, а ведут его HR и руководители.

Без такого сервиса данные о людях разбросаны по вики, профилям в мессенджере, анкетам адаптации и общей таблице, которую кто-то завёл несколько лет назад. Новичок первую неделю выясняет, кто за что отвечает. Руководитель перед заявкой на найм сверяет структуру команды в трёх системах. HR каждую неделю вручную правит таблицу, которую половина компании считает главным источником, а другая половина давно не открывает. При этом в кадровой системе нет разграничения по полям, и чувствительные сведения видят все или никто.

Что он делает

Находит человека за секунды. Поиск по имени, должности, подразделению, навыкам и локации; в карточке — контакты, руководитель, команда и рабочие часы.
Показывает оргструктуру. Дерево подчинения строится по полю «руководитель» и меняется вместе с исходными данными, без ручной перерисовки схемы.
Разграничивает поля по ролям. Сотрудник видит рабочие контакты коллег, руководитель — дополнительные сведения о своей команде, HR — полную карточку.
Даёт сотруднику править своё. Телефон, часовой пояс, рабочие часы и фото человек меняет сам, а подразделение и должность остаются за HR.
Следит за актуальностью. Карточки, которые давно не обновлялись, попадают в очередь напоминаний руководителю, а уволенные сотрудники исчезают из активного справочника.

Нюансы и особенности

Один источник правды. Если кадровые данные ведутся в 1С:ЗУП или другой HR-системе, справочник синхронизируется с ней по расписанию и не допускает ручных правок полей, которыми она владеет. Иначе через полгода появятся две расходящиеся версии.
Готовые продукты часто хватает. Модуль сотрудников в Битрикс24, BambooHR или корпоративном портале закрывает базовый поиск и оргсхему. Своё приложение оправдано, когда нужны собственные поля, сложная видимость или связь с другими внутренними сервисами.
Персональные данные — по минимуму. Храните только то, что нужно для работы справочника. Паспортные данные, зарплата и сведения о здоровье здесь не нужны; порядок обработки согласуйте с ответственным за 152-ФЗ в компании.
Видимость проверяют на сервере. Скрытие колонки в интерфейсе не защищает данные: ограничение должно действовать в таблицах, карточке, поиске и экспорте. Перед запуском войдите под обычным сотрудником и проверьте, что лишнего не видно.
Руководитель обязателен. Без поля «руководитель» дерево подчинения рвётся. Требуйте его в каждой карточке и проверяйте при сохранении, что человек не подчиняется сам себе и цепочка не замыкается.
Дубли отсекают при импорте. Уникальный ключ — рабочая почта или табельный номер; ручное создание карточки без него блокируется.
Увольнение — это статус. Карточку не удаляют, а переводят в архив: она пропадает из поиска, но остаётся для истории и отчётов в пределах сроков хранения, принятых в компании.

Как сгенерировать через ИИ-агентов

Промпты рассчитаны на AI-агента (Claude Code, Cursor и аналоги) в Laravel-проекте с установленным Filament 4.x. Отправляйте их по одному и проверяйте результат каждого шага.

1. Данные и модели

Создай модели и миграции для справочника сотрудников: Employee (табельный
номер и рабочая почта — уникальные, ФИО, должность, подразделение,
руководитель — ссылка на Employee, локация, часовой пояс, телефон,
статус «работает / в архиве», дата последнего обновления карточки),
Department (название, руководитель, родительское подразделение), Location.
Запрети сохранять сотрудника руководителем самого себя и циклы
подчинения. Добавь фабрики с демо-данными на 200 человек.

2. Карточка и поиск

Сгенерируй Filament-ресурс для Employee: таблица с глобальным поиском по
ФИО, должности и подразделению, фильтры по подразделению, локации и
статусу. В карточке покажи контакты, руководителя, прямых подчинённых и
коллег по команде. Архивные сотрудники по умолчанию скрыты.

3. Оргструктура и самообслуживание

Добавь страницу оргструктуры: дерево подразделений и подчинения с
раскрытием по уровням. Сделай профиль сотрудника, где он сам может
изменить телефон, часовой пояс, рабочие часы и фото. Остальные поля
доступны для правки только HR.

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

4. Синхронизация с кадровой системой

Сделай фоновую задачу по расписанию, которая загружает сотрудников из
кадровой системы по API или из CSV, сопоставляет их по табельному номеру,
обновляет поля, которыми владеет кадровая система, и переводит уволенных
в архив. Веди журнал запусков с числом изменённых записей и ошибками.
Карточки без обновления дольше 90 дней отправляй руководителю в
уведомлении.

5. Роли и видимость полей

Настрой роли: сотрудник видит рабочие контакты и структуру, руководитель
дополнительно видит служебные поля своей команды, HR видит и правит всё.
Примени ограничения к таблице, карточке, поиску и экспорту. Добавь
экспорт справочника подразделения для HR.

Войдите под сотрудником без роли HR и убедитесь, что служебные поля не приходят ни в таблицу, ни в выгрузку.