site_aegisone/py_service/docs/автоматическая_система_SHS.md at 4c3026a80faceca60166f5f10e5b680b2045ddf5

Files

T

angel 72b6879f4b v1.7.0: refactor max_bot to flat structure, add VCF+UserModel+NLP history context, portal pages and proxy fixes

- Refactored max_bot from nested packages to flat module structure
- Q2: Extended BotUser model (patronymic, email, org, address, vcf_raw, contact_hash, phone_verified, email_verified, last_interaction, total_conversations, total_tickets)
- Q2: VCF parser (FN, N, TEL, EMAIL, ORG, ADR), upsert on re-contact, NLP history context (_get_user_history_context -> YandexGPT)
- Q1: Broadcast preview modal with 10s confirmation timer
- Q3: CSS var(--white)->var(--bg-card), var(--text)->var(--text-primary)
- Q4: bot_settings showNotification(), editable max_bot_id
- Q5: Webhook secret passthrough via X-Max-Bot-Api-Secret
- Masking sensitive keys, dialog_cleared handler, migrate via _add_column_if_not_exists()
- Rate limit (asyncio.sleep 0.5 per 10), dead code removed, conv.intent context in contact.py
- Portal pages: bot_consent, bot_kb (edit), bot_settings, bot_test, bot_tickets, portal_settings
- Tests: 21/21 passing, added test_yandex_gpt.py, test_email_sender.py
- Deploy: deploy_full.sh, schema.sql, seed_knowledge_base.sql

2026-05-29 02:30:30 +03:00

8.7 KiB

Raw Blame History

Ниже — как должна работать автоматическая система SHS (System Health Score) в твоей модели AegisOne Engineering.

Это уже не “аналитика бизнеса”, а:

инженерная система раннего предупреждения о деградации компании

ЧТО ТАКОЕ SHS (СУТЬ СИСТЕМЫ)

SHS — это единый индекс здоровья бизнеса (0–100), который показывает:

насколько стабильно работает SLA-модель

где теряются деньги

где растут риски разрыва контрактов

где перегружается команда

где падает качество эксплуатации

ЛОГИКА СИСТЕМЫ SHS

Данные (CRM + SLA + инженеры) ↓ Нормализация метрик ↓ Взвешивание показателей ↓ Расчёт SHS ↓ Детектирование отклонений ↓ Сигналы риска (alerts)

ФИНАЛЬНАЯ ФОРМУЛА SHS

SHS = (0.22 × SLA Stability Index) + (0.18 × Revenue Stability Index) + (0.18 × Retention Index) + (0.15 × Engineering Performance Index) + (0.12 × Incident Stability Index) + (0.10 × Sales Flow Index) + (0.05 × Operational Efficiency Index)

РАСШИФРОВКА ВСЕХ КОМПОНЕНТОВ

3.1 SLA STABILITY INDEX (критический)

Смысл:

Насколько система выполняет SLA без сбоев.

Формула:

SSI = SLA_compliance × (1 - SLA_breach_severity)

Где:

SLA_compliance = выполненные заявки / все заявки

SLA_breach_severity = тяжесть нарушений (0–1)

Пример:

compliance = 0.96

нарушения = 0.1

→ SSI = 0.864

Риски:

падение ниже 0.85 = начинается утечка клиентов

3.2 REVENUE STABILITY INDEX

Смысл:

Стабильность денежного потока SLA

Формула:

RSI = 1 - (σ(MRR) / mean(MRR))

Интерпретация:

чем меньше колебания → тем выше индекс

Риски:

RSI < 0.7 → нестабильная финансовая модель

3.3 RETENTION INDEX (очень критично)

Формула:

RI = retained_clients / total_clients

Дополнение:

штраф за уход крупных клиентов:

RI_adjusted = RI - (lost_key_clients × 0.1)

Риски:

падение ниже 0.9 = системная проблема SLA

3.4 ENGINEERING PERFORMANCE INDEX

Смысл:

качество работы инженеров

Формула:

EPI = (0.3 × SLA compliance engineers) + (0.25 × diagnosis accuracy) + (0.2 × reopen rate inverse) + (0.15 × response time score) + (0.1 × documentation quality)

Важный момент:

это единственный KPI, который напрямую влияет на:

удержание клиентов

Риски:

EPI < 0.75 → будущие потери клиентов через 1–2 месяца

3.5 INCIDENT STABILITY INDEX

Смысл:

насколько система “ломается”

Формула:

ISI = 1 - (incidents / objects × severity_weight)

Где severity_weight:

критический = 1.0

средний = 0.5

низкий = 0.2

Риски:

рост ISI вниз = деградация инфраструктуры

3.6 SALES FLOW INDEX

Смысл:

здоровье входящего потока денег

Формула:

SFI = (audits → SLA conversion rate) × lead quality

Пример:

конверсия 0.35

качество лидов 0.8

→ SFI = 0.28

Риски:

SFI < 0.25 → нет роста MRR

3.7 OPERATIONAL EFFICIENCY INDEX

Смысл:

насколько эффективно работает компания внутри

Формула:

OEI = revenue / (engineer_hours × cost)

Риски:

падение → перегруз команды

ИНТЕРПРЕТАЦИЯ SHS

SHS Состояние системы

85–100 масштабируемый рост 70–85 стабильная работа 50–70 скрытые проблемы <50 системный кризис

ГЛАВНАЯ СИЛА SHS — НЕ ЧИСЛО, А ДИНАМИКА

ВАЖНО:

Ты смотришь не на значение, а на:

Δ SHS (изменение)

ΔSHS = SHS_today - SHS_last_week

Критично:

падение > 5 пунктов за неделю → тревога

падение > 10 → кризис

СИСТЕМА АВТОМАТИЧЕСКИХ СИГНАЛОВ

GREEN ZONE:

SHS > 80

нет действий

YELLOW ZONE:

SHS 65–80

👉 действия:

проверить инженеров

проверить SLA просадки

проверить загрузку

RED ZONE:

SHS < 65

👉 действия:

аудит клиентов

пересмотр инженеров

срочный анализ SLA нарушений

заморозка новых продаж

КОГДА ПОЯВЛЯЮТСЯ РИСКИ

РИСК №1 — падение EPI

Причина:

инженеры начали “делать быстро, но плохо”

Симптом:

рост повторных заявок

жалобы клиентов через 2–3 недели

РИСК №2 — рост INCIDENT RATE

Причина:

старое оборудование

плохая эксплуатация

РИСК №3 — падение RETENTION

Самый опасный

👉 означает:

клиент уже не верит системе

РИСК №4 — нестабильный SFI

Причина:

слабый маркетинг

неправильный аудит

некачественные лиды

РИСК №5 — падение OEI

Причина:

перегруз инженеров

хаотичные выезды

нет стандартизации

КАК ИСПРАВЛЯТЬ РИСКИ

ЕСЛИ ПАДАЕТ SHS:

ШАГ 1 — локализация

разбить SHS на компоненты:

где падение?

SLA?

инженеры?

продажи?

ШАГ 2 — точечное вмешательство

проблема действие

EPI падает обучение инженеров + чек-листы retention падает аудит объектов SLA падает перераспределение нагрузки SFI падает фильтрация лидов

ШАГ 3 — стабилизация

ограничить новые продажи

усилить контроль SLA

снизить нагрузку

ВАЖНОЕ ПРАВИЛО СИСТЕМЫ

нельзя “растить бизнес”, если SHS падает

ВИЗУАЛИЗАЦИЯ SHS (CEO DASHBOARD)

SHS LINE

📈 динамика здоровья компании

STACKED INDEX CHART

SLA

Revenue

Engineers

Retention

ALERT MAP

🟥 проблемные зоны

ENGINEER IMPACT MAP

📍 какой инженер влияет на SHS

ГЛАВНЫЙ СМЫСЛ SHS

Ты больше не управляешь:

❌ людьми ❌ объектами ❌ заявками

Ты управляешь:

системой стабильности инженерного бизнеса

ЕСЛИ ДАЛЬШЕ РАЗВИВАТЬ

Я могу собрать:

автоматический SHS калькулятор (Excel / 1C / web)

real-time dashboard

систему предиктивных предупреждений (падение SHS за 7–14 дней)

интеграцию SHS в KPI инженеров

систему автоматического “замедления продаж” при риске

ИТОГ

SHS — это не метрика.

это “нервная система” твоей компании, которая заранее показывает, где бизнес начнёт терять деньги или клиентов

Если хочешь дальше, следующий логичный шаг:

сделать тебе полноценную цифровую модель AegisOne (дашборд + CRM + SHS + SLA + KPI инженеров в одной системе)

8.7 KiB Raw Blame History Unescape Escape

8.7 KiB

Raw Blame History