================================================================================
Automation Workspace Manager (AWM)
Подробное описание проекта для сайта, презентаций и рекламных материалов
================================================================================

Версия документа: релиз 1.11.2 (линейка 1.11.x)
Язык: русский
Правообладатель и разработчик: ООО «АлексСистем» (ИНН 5257224259, ОГРН 1265200018423)
Аудитория: руководители, ИТ-специалисты, заказчики и пользователи без глубокой
технической подготовки; технические сведения вынесены в отдельные разделы.


--------------------------------------------------------------------------------
1. ЧТО ТАКОЕ AWM ПРОСТЫМИ СЛОВАМИ
--------------------------------------------------------------------------------

AWM (Automation Workspace Manager) — это веб-платформа для повседневной работы
с серверами и инфраструктурой.

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

AWM рассчитан на промышленную эксплуатацию: установка пакетом, резервное
копирование, роли и права, лицензирование, единый вход через корпоративный
SSO, работа нескольких филиалов (подразделений) в одной установке.

Коротко: AWM — «рабочее место» инженера и оператора инфраструктуры в браузере.


--------------------------------------------------------------------------------
2. ДЛЯ КОГО ПРЕДНАЗНАЧЕН ПРОДУКТ
--------------------------------------------------------------------------------

• Операторы и инженеры — запускают плейбуки Ansible, команды, Terraform,
  открывают SSH и удалённый рабочий стол, смотрят мониторинг и журналы.

• Администраторы платформы — ставят и обновляют систему, выдают доступ,
  настраивают лицензию, SSO, бэкапы, интеграции и уведомления.

• Руководители ИТ / ИБ — получают единую точку контроля: кто имеет доступ,
  какие действия выполнялись, где хранятся секреты, как устроены филиалы.

• Организации с несколькими площадками — одно решение для нескольких
  подразделений с изоляцией данных и общим администрированием.


--------------------------------------------------------------------------------
3. КАКИЕ ЗАДАЧИ РЕШАЕТ AWM
--------------------------------------------------------------------------------

3.1. Автоматизация без «зоопарка» инструментов
     Плейбуки Ansible, инвентари хостов, расписания, ad-hoc команды и Terraform
     живут в одном интерфейсе с журналами и правами доступа.

3.2. Безопасная работа с секретами
     Пароли, ключи и переменные хранятся централизованно и подставляются
     в задания по понятным именам, а не копируются в открытый текст файлов.

3.3. Удалённый доступ к серверам
     Веб-терминал SSH (несколько сеансов, передача файлов) и удалённый рабочий
     стол через интеграцию с Guacamole — без отдельной «зоопарка» клиентов.

3.4. Наблюдение за инфраструктурой
     Мониторинг серверов с агентом (Linux, Windows, macOS) и проверки без агента
     (ping, HTTP): обзор, графики, оповещения.

3.5. Учёт техники и расходников
     Отдельный модуль инвентаризации активов: карточки, этикетки, сканирование,
     перемещения, списания, отчёты PDF.

3.6. Командная работа и расширения
     Группы пользователей, уведомления, плагины (чат, календарь работ и др.).

3.7. Контроль и соответствие требованиям эксплуатации
     Роли и права, двухфакторная аутентификация (по политике администратора),
     аудит действий, системные логи, системный журнал syslog,
     резервное копирование, режим технических работ.


--------------------------------------------------------------------------------
4. ОСНОВНЫЕ ВОЗМОЖНОСТИ ДЛЯ ПОЛЬЗОВАТЕЛЯ (ОПЕРАТОРА)
--------------------------------------------------------------------------------

4.1. Вход и рабочее место
     • Вход по логину и паролю или через единый вход (SSO), если его включил
       администратор.
     • При включённой 2FA для локальной учётки — код из приложения-аутентификатора
       после пароля; подключение и управление — в профиле.
     • Выбор подразделения (филиала), если учётка состоит в нескольких.
     • Левое меню подстраивается под права и лицензию.
     • Темы оформления (в том числе светлая / тёмная) в профиле.
     • Адаптивная вёрстка: удобно и на широком мониторе, и на узком экране.

4.2. Ansible — автоматизация конфигурации и обслуживания
     • Создание и правка плейбуков (YAML) с проверкой синтаксиса.
     • История ревизий, импорт и экспорт.
     • Инвентари хостов (INI / YAML).
     • Запуск заданий, просмотр журнала в реальном времени, остановка.
     • Отложенный и периодический запуск (расписания).
     • Шаблоны плейбуков для повторного использования.
     • Подстановки секретов, ключей и переменных вида {{secret:…}},
       {{sshkey:…}}, {{var:…}} из текущего подразделения.

4.3. Команды (ad-hoc)
     • Быстрый запуск разовых команд на выбранных хостах без отдельного
       полноценного плейбука — с тем же контролем доступа и журналированием.

4.4. Terraform — инфраструктура как код
     • Рабочие области (workspaces).
     • Операции Plan / Apply / Destroy.
     • Потоковые журналы выполнения.
     • Лимиты по лицензии на число областей и параллельных запусков.

4.5. Секреты, переменные и SSH-ключи
     • Централизованное хранилище чувствительных данных.
     • Использование в инвентарях и заданиях без хранения паролей «в открытую»
       в текстах плейбуков.
     • Разделение по подразделениям: одинаковые имена в разных филиалах
       не смешиваются.

4.6. SSH-терминал в браузере
     • Несколько одновременных сеансов (в пределах лицензии).
     • Работа с файлами по SFTP.
     • Административный контроль политик терминала.

4.7. Удалённое управление (рабочий стол)
     • Подключения через интеграцию с Apache Guacamole.
     • Сессии удалённого рабочего стола из интерфейса AWM.
     • Управление доступом на уровне прав и подразделений.
     • Каналы обмена файлами в рамках сессии (в поддерживаемых сценариях).

4.8. Редактор кода и файлы проекта
     • Дерево файлов, создание папок, перенос перетаскиванием.
     • Редактирование с автосохранением / ручным сохранением.
     • Импорт и экспорт проекта архивом ZIP.
     • Удобен для правок содержимого, связанного с автоматизацией.

4.9. Мониторинг (пакеты Pro / Corp)
     • Хосты с агентом AWM: CPU, память, диск, нагрузка и другие метрики;
       агенты для Linux, Windows и macOS.
     • «Проверяемые» хосты без агента: ping и HTTP/API с сервера AWM.
     • Панель обзора с карточками, фильтрами, полноэкранным режимом.
     • Детальная карточка хоста с графиками.
     • Библиотека метрик, скриптов и триггеров; оповещения.
     • Выгрузка отчётов (в т.ч. PDF) в поддерживаемых сценариях.

4.10. Инвентаризация активов (пакеты Pro / Corp)
      • Учёт техники, ЗИП, расходников и инструментов.
      • Категории, статусы, цены, гарантии, количества.
      • Дашборд, импорт/экспорт CSV, печать этикеток, сканирование
        штрих-кодов / QR / инвентарных номеров.
      • Массовые операции: перемещение, выдача, списание и др.
      • Журнал операций и выгрузки PDF.
      • Важно: это НЕ то же самое, что «Инвентари Ansible» (списки хостов
        для плейбуков).

4.11. Системный журнал (syslog) — пакеты Pro / Corp
      • Приём сообщений syslog от серверов и сетевого оборудования (UDP/TCP).
      • Просмотр событий: виды «Лента» и «Таблица», подсветка по уровню важности,
        фильтры, относительное время, карточка события.
      • Экспорт по текущим фильтрам: CSV, JSON и PDF.
      • Настройка приёмника и тест приёма готовыми командами (Linux / Windows).
      • Опциональное хранение потока в ClickHouse (отдельно от мониторинга)
        с переносом из основной БД при включении.
      • Отправка событий AWM во внешний syslog (настраивается администратором).

4.12. Уведомления и профиль
      • Колокольчик уведомлений в интерфейсе.
      • Персональные настройки оповещений.
      • Профиль пользователя: контакты, тема, сессии и связанные параметры.

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


--------------------------------------------------------------------------------
5. ВОЗМОЖНОСТИ ДЛЯ АДМИНИСТРАТОРА И ОРГАНИЗАЦИИ
--------------------------------------------------------------------------------

5.1. Пользователи, роли и права
     • Гибкая модель RBAC: роли собираются из понятных прав («что можно делать»),
       а не только из жёстких «админ / не админ».
     • Готовые наборы прав для типовых ролей (оператор, аудитор,
       администратор подразделения и др.).
     • Группы пользователей для совместного доступа к ресурсам.
     • Опциональная двухфакторная аутентификация (TOTP) только для локальных
       учёток: подключение в профиле, код из приложения при входе; администратор
       может включить функцию и обязать всех локальных пользователей или только
       администраторов. Для SSO (Keycloak) MFA настраивается у поставщика
       идентификации, не встроенным TOTP программы.
     • Режим одной активной сессии: глобально в настройках безопасности и
       персонально в профиле — при новом входе остальные сессии пользователя
       завершаются.

5.2. Подразделения (филиалы)
     • Режим одной площадки или нескольких подразделений.
     • Изоляция плейбуков, инвентарей, секретов, мониторинга и учёта активов
       по выбранному подразделению.
     • Основное (системное) подразделение — для управления установкой в целом.

5.3. Единый вход (SSO)
     • OpenID Connect (например, Keycloak и совместимые IdP).
     • Назначение подразделения по атрибуту или ручной выбор при входе.
     • Синхронизация пользователей (по настройкам администратора).

5.4. Лицензирование
     • Пакеты Self / Pro / Corp с разными лимитами и включёнными модулями.
     • Пробный период для знакомства с платформой.
     • Активация по ключу с привязкой к оборудованию установки (HWID).

5.5. Резервное копирование
     • Ручные бэкапы и планы по расписанию (в пакетах, где функция включена).
     • Восстановление из архива через интерфейс администрирования.

5.6. Аудит и журналы
     • Журнал аудита действий пользователей.
     • Системные логи сервиса.
     • Экспорт и политики хранения (по возможностям раздела).

5.7. Интеграции и оповещения
     • Каналы уведомлений во внешние системы (по настроенным интеграциям).
     • События платформы → выбранные каналы.
     • Входящие уведомления из внешних систем (в поддерживаемых сценариях).

5.8. Фоновые задачи и масштаб
     • Встроенный режим выполнения задач.
     • Опционально Celery + Redis для очередей.
     • Опционально узлы AWM Worker для распределённого исполнения заданий.

5.9. Безопасность промышленного контура
     • Обязательные секреты и ограничения окружения (JWT, CORS, trusted hosts,
       cookie secure, CSRF и др.).
     • Глобальные списки разрешённых/запрещённых сетей (CIDR) и опциональные
       профили доступа по путям: приём агента/воркера, scrape метрик и админ-API
       можно ограничить внутренней сетью, оставляя UI доступным снаружи.
     • Рекомендуемое разделение публичного и внутреннего reverse proxy
       (примеры nginx в поставке).
     • Режим технических работ с ограничением входа.
     • Политики паролей, сессий и двухфакторной аутентификации (TOTP) в
       настройках безопасности.
     • Согласие на обработку персональных данных при первом входе
       (по настройкам поставки).

5.10. Сопровождение
      • Установка и обновление из релизного архива или DEB.
      • Диагностический сбор сведений для поддержки.
      • Миграция с SQLite (лаборатория) на PostgreSQL (промышленный контур).
      • Кастомизация текстов экрана входа и состава меню навигации.


--------------------------------------------------------------------------------
6. ЛИЦЕНЗИОННЫЕ ПАКЕТЫ (ОБЗОР БЕЗ ЮРИДИЧЕСКИХ ДЕТАЛЕЙ)
--------------------------------------------------------------------------------

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

• Self — компактный набор для индивидуального / небольшого сценария;
  расширенные модули (мониторинг, инвентаризация активов, syslog, multi-office,
  полноценные бэкапы/аудит в матрице пакета) ограничены или отключены.

• Pro — рабочий контур команды: заметные лимиты, мониторинг, инвентаризация,
  syslog, бэкапы и аудит по матрице пакета.

• Corp — расширенный / без жёстких лимитов по матрице пакета, включая
  сценарии нескольких подразделений и полный набор корпоративных функций.

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

--------------------------------------------------------------------------------
7. ЧЕМ AWM ОТЛИЧАЕТСЯ НА РЫНКЕ (ПОЗИЦИОНИРОВАНИЕ)
--------------------------------------------------------------------------------

• Не «ещё один CI», а операционное рабочее место для эксплуатации:
  запуск, доступ, секреты, наблюг, мониторинг, учёт — рядом.

• Веб-первый подход: инженеру достаточно браузера.

• Русскоязычный интерфейс и документация под эксплуатацию
  (в том числе комплект по ГОСТ/ЕСПД для поставки).

• Готовность к филиальной модели и SSO «из коробки» админ-контура.

• Расширяемость плагинами без ломки ядра.

• Прозрачное разделение ролей: оператор работает с заданиями,
  администратор — с доступом, лицензией и сопровождением.


--------------------------------------------------------------------------------
8. ТИПОВЫЕ СЦЕНАРИИ ИСПОЛЬЗОВАНИЯ
--------------------------------------------------------------------------------

8.1. Ежедневная эксплуатация Linux/Windows-парка
     Оператор запускает проверенные плейбуки на инвентарях филиала, смотрит
     журнал, при необходимости заходит по SSH или remote desktop.

8.2. Внедрение «инфраструктуры как кода»
     Команда ведёт Terraform-области в AWM, согласовывает plan/apply,
     хранит переменные и секреты централизованно.

8.3. Дежурство и инциденты
     Мониторинг показывает состояние хостов; уведомления уходят в каналы;
     аудит фиксирует действия; при сбое администратор поднимает бэкап.

8.4. Склад и учёт ИТ-активов
     Кладовщик/инженер сканирует этикетку, оформляет выдачу или перемещение,
     печатает новые этикетки, выгружает отчёт.

8.5. Несколько филиалов одной компании
     Общая платформа, разные подразделения, свои секреты и хосты;
     центральный администратор управляет ролями и лицензией.


--------------------------------------------------------------------------------
9. СОСТАВ ПРОДУКТОВОЙ ЭКОСИСТЕМЫ (ПРОСТЫМИ СЛОВАМИ)
--------------------------------------------------------------------------------

• AWM (ядро) — веб-приложение: интерфейс, API, БД, права, задания.

• Агент мониторинга — программа на сервере, которая отдаёт метрики в AWM
  (отдельная поставка/сборка для целевых ОС).

• AWM Worker (опционально) — отдельный узел, который выполняет задания
  рядом с инфраструктурой, разгружая основной сервер.

• Плагины — дополнительные разделы меню (чат, календарь и др.).

• Документация — руководства оператора, администратора и разработчика;
  релизный комплект в форматах, принятых поставкой.


--------------------------------------------------------------------------------
10. ТЕХНИЧЕСКОЕ ОПИСАНИЕ (ДЛЯ ИТ И ВНЕДРЕНИЯ)
--------------------------------------------------------------------------------

10.1. Назначение техническое
      Централизованная веб-платформа оркестрации Ansible/Terraform, хранения
      секретов и ключей, интерактивного доступа (SSH/RDP-подобные сессии через
      Guacamole), мониторинга, учёта активов, приёма/пересылки syslog,
      администрирования RBAC/SSO/бэкапов.

10.2. Архитектура (логически)
      • Клиент: современный веб-браузер.
      • Сервер приложений: Python, веб-фреймворк FastAPI, шаблоны UI.
      • Данные: PostgreSQL (рекомендуется для промышленной среды);
        SQLite — для лаборатории/демо.
      • Опционально: Redis + Celery (очереди фоновых задач).
      • Опционально: ClickHouse — time-series мониторинга и/или события
        системного журнала (раздельные настройки; по документации администратора).
      • Опционально: узлы Worker по API.
      • Интеграция удалённого рабочего стола: Apache Guacamole.
      • Лицензирование: серверная проверка entitlements / нативный модуль
        защиты лицензии в поставке.

10.3. Платформы установки
      • Ориентир: Astra Linux SE 1.8+ или Ubuntu Server 24.04+ (матрица поставки).
      • systemd-сервис, установка из tar.gz или .deb.
      • Типовой путь приложения в установке: /opt/AWM
      • Конфигурация окружения: /etc/awm/awm.env

10.4. Сетевые аспекты
      • HTTPS за обратным прокси (nginx и аналоги).
      • WebSocket для интерактивных сеансов (терминал / remote desktop) —
        требует корректной настройки прокси.
      • При выходе UI в интернет — публичный VIP без путей агента/воркера/metrics
        и внутренний VIP (или allow CIDR) для приёма; плюс профили CIDR в AWM.
      • Метрики Prometheus на /metrics с Bearer-токеном (рекомендуется).
      • Приёмник syslog: UDP/TCP с фильтром CIDR; не публиковать порт в интернет.

10.5. Безопасность (кратко)
      • JWT-сессии, CSRF-защита для изменяющих запросов UI.
      • RBAC на уровне прав и ролей; изоляция по подразделениям (office).
      • Секреты не должны попадать в открытый текст плейбуков.
      • Обязательные производственные переменные (JWT_SECRET, CORS_ORIGINS,
        TRUSTED_HOSTS, COOKIE_SECURE и др.) — сервис отказывается стартовать
        с небезопасными значениями по умолчанию.

10.6. Ориентир ресурсов (одноузловая установка)
      До ~30 пользователей и ~150 хостов: порядка 4–8 vCPU, 8–16 GiB ОЗУ,
      80–160 GiB SSD с запасом под данные, журналы и БД. Тяжёлые параллельные
      нагрузки — через Worker / расширение контура (см. документацию).

10.7. API и расширения
      • HTTP API для автоматизации и интеграций (доступ по правам / токенам).
      • Плагины со своим UI и правами.
      • Внешние уведомления и входящие события.

10.8. Документация комплекта
      • Оператору: руководство пользователя, мониторинг, плагины,
        инвентаризация активов.
      • Администратору: установка, руководство администратора, worker,
        мониторинг, развёртывание.
      • Разработчику / сопровождению изготовителя: архитектура, сборка,
        лицензионные пакеты, защита лицензии.


--------------------------------------------------------------------------------
11. КЛЮЧЕВЫЕ ВЫГОДЫ ДЛЯ ЗАКАЗЧИКА (ТЕЗИСЫ ДЛЯ ПРЕЗЕНТАЦИИ)
--------------------------------------------------------------------------------

1) Одна точка входа для автоматизации, доступа и контроля.
2) Меньше риска утечки паролей за счёт централизованных секретов.
3) Прозрачность: кто запускал, что менял, что произошло на хосте.
4) Масштаб от небольшой команды до филиальной сети.
5) Готовность к промышленной установке и обновлениям.
6) Русский интерфейс и эксплуатационная документация.
7) Расширение функциями без отказа от уже внедрённых процессов.
8) Модульность по лицензии: можно начать с базового контура и наращивать
   мониторинг, учёт активов, syslog и multi-office.


--------------------------------------------------------------------------------
12. ОГРАНИЧЕНИЯ И ЧЕСТНЫЕ ОЖИДАНИЯ
--------------------------------------------------------------------------------

• AWM не заменяет полностью специализированные системы класса CMDB «на все
  случаи» или enterprise SIEM — он закрывает операционный контур автоматизации,
  доступа, мониторинга и учёта в рамках модулей продукта.

• Качество автоматизации зависит от качества плейбуков и процессов команды;
  платформа даёт управление, контроль и удобство исполнения.

• Мониторинг, инвентаризация активов, syslog и ряд функций доступны
  в зависимости от лицензионного пакета.

• Для промышленной среды требуется корректная настройка ОС, СУБД, прокси,
  резервного копирования и секретов окружения.


--------------------------------------------------------------------------------
13. КРАТКАЯ «ВИЗИТКА» (МОЖНО ДЛЯ САЙТА / ОДНОГО СЛАЙДА)
--------------------------------------------------------------------------------

Automation Workspace Manager (AWM) — веб-платформа промышленной эксплуатации
инфраструктуры: Ansible и Terraform, секреты и ключи, SSH и удалённый рабочий
стол, мониторинг серверов, учёт активов, системный журнал, роли и аудит,
филиалы и SSO — в одном рабочем месте оператора и администратора.


--------------------------------------------------------------------------------
14. ГЛОССАРИЙ ДЛЯ НЕТЕХНИЧЕСКОЙ АУДИТОРИИ
--------------------------------------------------------------------------------

Плейбук — готовый сценарий автоматизации (что сделать на серверах).
Инвентарь Ansible — список серверов/групп, на которых запускают сценарий.
Секрет — пароль или иной чувствительный параметр, хранимый в системе.
Подразделение — филиал/площадка внутри одной установки AWM.
SSO — вход теми же учётными данными, что и в корпоративный портал.
Агент мониторинга — небольшая служба на сервере, которая сообщает метрики.
Роль — набор разрешённых действий для группы пользователей.
Аудит — журнал «кто что сделал» в системе.


--------------------------------------------------------------------------------
15. КОНТАКТЫ И ДАЛЬНЕЙШИЕ МАТЕРИАЛЫ
--------------------------------------------------------------------------------

Для сайта и коммерческих материалов рекомендуется дополнять этот текст:
• актуальным номером релиза и датой (текущий релиз комплекта описания — 1.11.2);
• скриншотами ключевых экранов (Ansible, мониторинг, инвентаризация, админ,
  системный журнал);
• сравнительной таблицей пакетов Self / Pro / Corp из коммерческого прайса;
• ссылками на руководства оператора и администратора из комплекта поставки.

Технические детали внедрения, переменные окружения и процедуры установки
приводятся в документации администратора комплекта AWM (раздел administrators
документации продукта) и не дублируются здесь полностью, чтобы текст оставался
читаемым для широкой аудитории.


================================================================================
Конец описания
================================================================================
