Files
site_aegisone/py_service/docs/Инструкция по админ-панели.md
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

86 lines
4.8 KiB
Markdown

# Инструкция по админ-панели AegisOne
## Вход в систему
1. Перейдите на `https://aegisone.ru/service/`
2. Введите логин и пароль, выданные владельцем
3. При 3 неверных попытках — блокировка на 3 минуты
## Дашборд
Главная страница после входа. Карточки показывают ключевые метрики:
- **Активные объекты** — количество обслуживаемых объектов
- **Активные задачи** — открытые и в работе
- **Открытые инциденты** — текущие инциденты
- **SLA контракты** — активные договоры
- **SLA Compliance** — процент соблюдения SLA
- **SHS** — общий индекс здоровья системы
Нажмите на любую карточку для перехода в соответствующий раздел.
## Управление сотрудниками (только владелец)
- Создание учётных записей с ролями: Владелец / Инженер / Техник
- Блокировка/разблокировка сотрудников
- Сброс пароля
## Объекты
- Добавление объектов с параметрами: тип, площадь, регион
- Автоматическое создание из опросника
- Просмотр Risk Score, Object Index, SLA цены
## Назначения
Привязка сотрудников к объектам. Роль сотрудника определяется автоматически из его профиля.
## SLA контракты
- Создание контрактов с привязкой к объекту
- Номер договора (для синхронизации с 1С)
- Уровень обслуживания: Start / Business / Enterprise
- Гибкое время реакции (в часах)
## Опросник объекта
Пошаговое обследование объекта:
1. **Коммерческий** — название, тип, адрес, контакты
2. **Технический** — видеонаблюдение, СКУД, пожарная сигнализация, инфраструктура
3. **Эксплуатация** — текущее обслуживание, регламенты, проблемы
4. **Риски** — критические риски объекта
5. **Расчёт SLA** — уровень обслуживания, дополнительные требования
После завершения автоматически рассчитываются: Risk Score, Complexity Index, Object Index, SLA цена.
## Блог
- Создание/редактирование статей
- **Slug** — адрес статьи, генерируется автоматически из заголовка (можно изменить вручную)
- **Категории**: Аудит, SLA, Инциденты, Технадзор, Документация, Риск-инжиниринг, Кейсы
- **Содержание** — HTML-формат. Используйте тулбар над редактором для вставки форматирования
- Статусы: Черновик → Опубликовать → Архив
## Документация
- Файлы `.md` в папке `service/docs/` автоматически обнаруживаются
- Владелец управляет доступом инженеров к каждому документу
- Инженер видит только разрешённые документы
## Примеры из практики (карусель на главной)
- Добавление кейсов с заголовком, описанием и эффектом
- Поле «Порядок» определяет порядок в карусели
- Флажок «Активен» — показывает/скрывает кейс на главной
## CEO дашборд (только владелец)
Обзор бизнес-метрик: MRR, удержание клиентов, конверсия, производительность.
## Коэффициенты формул
Все расчётные коэффициенты можно редактировать. Изменения применяются ко всем новым расчётам.
## Паспорта объектов
Автоматически генерируются при завершении опросника. Содержат полный расчёт рисков и рекомендаций.