﻿---
title: Аналитика контингента
description: "Дашборд на Laravel + Filament: численность и приведённый контингент, заполняемость программ, удержание по когортам и сравнение с прошлыми периодами."
---

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

Аналитический дашборд для руководства, учебного управления и заведующих кафедрами. Он показывает, сколько обучающихся сейчас учится по каждой программе, подразделению и корпусу, насколько заполнены программы, как меняется удержание и отсев и как это соотносится с прошлым годом. Это не рабочий инструмент приёма, а единый источник цифр о контингенте.

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

Для первого релиза достаточно численности, заполняемости и снимков на контрольные даты. Удержание по когортам и разбивки по составу добавляют после того, как определения согласованы с учебным управлением и накопился хотя бы год снимков.

## Что он делает

- **Даёт актуальную численность.** Число обучающихся по программам, подразделениям, формам обучения и корпусам строится из живых данных.
- **Считает заполняемость.** Текущая численность сравнивается с количеством мест программы, а статус отмечен цветом.
- **Показывает удержание и отсев.** Доли по когортам, программам и периодам считаются по единым правилам.
- **Сравнивает периоды.** Каждый показатель можно сопоставить с прошлым семестром или годом на ту же дату.
- **Держит одно определение цифры.** Руководство, учебное управление и кафедры видят одинаковые значения, потому что все представления используют один расчёт.
- **Готовит выгрузку к заседанию.** Экспорт совпадает с тем, что на экране, и не требует ручной доработки.

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

- **Граница сценария — уже зачисленные.** Сервис не ведёт абитуриентов и не управляет местами при зачислении. Для этого есть [воронка приёмной кампании](https://wpcraft.ru/kb/stacks/filament/use-cases/education/admissions-pipeline-dashboard.md) и [трекер зачисления](https://wpcraft.ru/kb/stacks/filament/use-cases/education/enrollment-pipeline-tracker.md); отсюда их результат виден как итоговая численность.
- **Определения фиксируют один раз.** Что считается «обучающимся», как считается приведённый контингент по формам обучения, какие статусы исключаются (академический отпуск, отчисление) — записывают в систему, а не держат в головах аналитиков.
- **Когорта задаётся правилом.** Удержание корректно, только если когорта определена одинаково: год поступления, форма обучения, первичный приём или перевод. Иначе цифры разных отчётов не сходятся.
- **Сравнение требует снимков.** Учётная система хранит текущее состояние, а не состояние на прошлое 1 ноября. Нужны снимки на контрольные даты, иначе сравнение год к году невозможно.
- **Места — тоже данные.** Без справочника мест по программам заполняемость не посчитать. Места меняются по годам, поэтому их хранят с периодом действия.
- **Подключение без миграции.** Дашборд читает учётную систему через отдельное read-only подключение или реплику и хранит у себя только снимки и справочники. Если учётная система уже строит нужные отчёты, может хватить BI-инструмента поверх неё.
- **Доступ и малые группы.** Заведующий кафедрой видит свои программы, руководство — всё. При разбивке по составу маленькие группы скрывают или объединяют, чтобы по цифрам нельзя было узнать конкретного человека.

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

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

### 1. Подключение и модели

```text
Настрой второе подключение к базе учётной системы только на чтение и создай
модели для обучающихся, программ и статусов обучения поверх её таблиц без
миграций. В основной базе создай ProgramCapacity (программа, период,
количество мест), CohortRule (название, условия) и EnrollmentSnapshot
(дата, программа, подразделение, форма обучения, численность, приведённый
контингент). Добавь демо-данные для локальной разработки.
```

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

### 2. Единые расчёты

```text
Вынеси в один сервисный класс расчёт численности, приведённого контингента,
заполняемости и удержания по когорте с параметрами: дата, программа,
подразделение, форма обучения. Все виджеты и выгрузки должны использовать
только его. Покрой расчёты тестами на демо-данных.
```

### 3. Снимки на контрольные даты

```text
Сделай задачу по расписанию, которая сохраняет EnrollmentSnapshot
на контрольные даты из настроек и раз в неделю в течение семестра.
Повторный запуск на ту же дату перезаписывает снимок, а не дублирует его.
Добавь команду для построения снимков за прошлые годы, если исторические
данные есть в учётной системе.
```

### 4. Дашборд

```text
Сделай страницу-дашборд с фильтрами по программе, подразделению, форме
обучения и дате. Добавь виджеты: численность и приведённый контингент,
заполняемость программ с цветовым статусом, удержание по когортам,
сравнение с прошлым годом на ту же дату.
```

### 5. Доступ и выгрузка

```text
Настрой доступ: заведующий кафедрой видит только свои программы, учебное
управление и руководство — всё. Скрывай значения в разбивках по составу,
если в группе меньше пяти человек. Добавь экспорт текущего представления
с датой расчёта и описанием показателей.
```

## Похожие сценарии

- [Воронка приёмной кампании](https://wpcraft.ru/kb/stacks/filament/use-cases/education/admissions-pipeline-dashboard.md) — привлечение и отбор абитуриентов до подтверждения места.
- [Трекер зачисления](https://wpcraft.ru/kb/stacks/filament/use-cases/education/enrollment-pipeline-tracker.md) — оформление зачисления и контроль мест по программам.
- [Дашборд выручки](https://wpcraft.ru/kb/stacks/filament/use-cases/finance/revenue-dashboard.md) — финансовая сторона контингента для платных программ.
- Чем отличается от [трекера зачисления](https://wpcraft.ru/kb/stacks/filament/use-cases/education/enrollment-pipeline-tracker.md): там операционная работа с каждым зачисляемым, здесь сводные показатели уже обучающихся.

## Материалы и источники

- [Refine: Enrollment Analytics Dashboard](https://refine.dev/use-cases/education/enrollment-analytics-dashboard/)
- [Filament 4.x: виджеты](https://filamentphp.com/docs/4.x/widgets/overview)
- [Filament 4.x: виджеты-графики](https://filamentphp.com/docs/4.x/widgets/charts)
- [Filament 4.x: фильтры таблиц](https://filamentphp.com/docs/4.x/tables/filters/overview)
- [Filament 4.x: экспорт](https://filamentphp.com/docs/4.x/actions/export)