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

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

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

Без такого сервиса сигналы разнесены по CRM, поддержке, продуктовой аналитике и биллингу. Перед звонком менеджер открывает четыре системы, молчащие клиенты остаются без внимания, а продление обнаруживается за несколько дней до окончания договора.

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

- **Сводит сигналы в карточку клиента.** Активность в продукте, обращения и состояние оплат видны в одном месте, у каждого показателя есть источник и дата обновления.
- **Ранжирует клиентов по риску.** Очередь внимания учитывает оценку и значимость договора, показывает причину попадания в очередь и требует зафиксировать следующий шаг.
- **Держит продления на виду.** Представления на 30, 60 и 90 дней показывают ответственного, состояние клиента и незавершённые действия до переговоров.
- **Предупреждает об ухудшении.** Правила замечают устойчивое падение активности и создают уведомление с объяснением, без дублей при повторной загрузке.
- **Готовит отчёт к встрече.** Снимок состояния за выбранную дату даёт воспроизводимые цифры для квартальной встречи с клиентом.

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

- **Универсальной формулы нет.** Сигналы приводят к одной шкале, веса согласуют с владельцем процесса и проверяют на известных продлениях и отказах. Версию формулы хранят вместе с оценкой, чтобы смена весов не выглядела ухудшением клиента.
- **Отсутствие данных — не ноль.** Нужно различать новую компанию без истории, сбой загрузки и подтверждённое снижение активности. Новым клиентам показывают статус «Недостаточно данных» до конца периода наблюдения.
- **Свежесть важнее пересчёта.** Новое время расчёта не делает старые сигналы актуальными: сервис проверяет дату исходных данных, а просроченные загрузки выносит в отдельную очередь.
- **Красная карточка без действия бесполезна.** У каждого риска должен быть ответственный и срок следующего контакта; изменения журналируются.
- **Доступ ограничивают на сервере.** Менеджер видит своих клиентов, руководитель — команду. Ограничение действует в таблицах, виджетах и выгрузках; скрытая колонка его не заменяет.
- **Интеграция без миграции.** Существующую CRM подключают через API и фоновую синхронизацию или отдельное read-only подключение к разрешённым таблицам. Если штатный отчёт CRM уже закрывает задачу, отдельное приложение может не понадобиться.
- **Пороги — это настройки.** Порог риска и допустимый возраст расчёта выносят в конфиг и калибруют по истории, а не зашивают в код.

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

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

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

```text
Создай модели и миграции для дашборда состояния клиентов:
Account (внешний id, ответственный менеджер, дата начала, дата продления,
текущая оценка и время её расчёта), HealthSnapshot (клиент, конец периода,
оценки использования, поддержки и оплат, версия формулы), FollowUp
(клиент, исполнитель, срок, причина, дата выполнения), SyncRun (источник,
начало, окончание, статус, ошибка). Оценка допускает null, если данных
недостаточно. Добавь фабрики с реалистичными демо-данными.
```

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

### 2. Карточка клиента

```text
Сгенерируй Filament-ресурс для Account. В карточке покажи текущую оценку,
дату продления, историю снимков и договорённости о следующем шаге через
relation managers. Рядом с каждым показателем выведи источник и дату
обновления.
```

### 3. Очередь внимания и продления

```text
Добавь в таблицу клиентов фильтр «Требуют внимания»: свежая оценка ниже
порога из конфига, расчёт не старше суток. Добавь вкладки продлений на 30,
60 и 90 дней, группировку по менеджеру и действие «Назначить следующий
контакт» с обязательными исполнителем и сроком.
```

Проверьте, что клиенты без оценки не попадают в очередь риска, а показываются отдельно как «Недостаточно данных».

### 4. Синхронизация и предупреждения

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

### 5. Доступ и отчёт к встрече

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

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

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

- [Воронка продлений клиентов](https://wpcraft.ru/kb/stacks/filament/use-cases/sales/renewal-pipeline-tracker.md) — сроки продлений, ответственные и прогноз; оценка состояния отсюда служит сигналом риска продления.
- [Оценка риска сделок](https://wpcraft.ru/kb/stacks/filament/use-cases/sales/deal-risk-scoring.md) — та же логика оценки, но для новых сделок в воронке, а не для действующих клиентов.
- [Эскалации обращений](https://wpcraft.ru/kb/stacks/filament/use-cases/customer-support/escalation-tracker.md) — обращения и эскалации как сигналы состояния клиента; отдельный дубликат оценки состояния в поддержке не нужен.

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

- [Refine: Account Health Dashboard](https://refine.dev/use-cases/sales/account-health-dashboard/)
- [Filament 4.x: ресурсы, запросы и авторизация](https://filamentphp.com/docs/4.x/resources/overview)
- [Filament 4.x: фильтры таблиц](https://filamentphp.com/docs/4.x/tables/filters/overview)
- [Filament 4.x: экспорт](https://filamentphp.com/docs/4.x/actions/export)