Перейти к содержанию

О программном продукте

Назначение

«АИС Домовые чаты» — веб-приложение для сотрудников, которые администрируют общедомовые чаты в MAX. Система объединяет работу с адресами, чатами, управляющими компаниями, участниками, ботами, сообщениями, рассылками и опросами в одном интерфейсе.

Основные задачи системы:

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

Доступные разделы зависят от прав учётной записи и настроек серверной части.

Категории пользователей

Оператор

Работает с доступными ему прикладными разделами: адресами, чатами, управляющими компаниями, участниками, сообщениями, рассылками и опросами. Набор разделов определяется назначенными правами.

Администратор

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

Архитектура

«АИС Домовые чаты» построена по клиент-серверной схеме:

  1. Пользователь открывает одностраничное веб-приложение в браузере.
  2. Интерфейс обращается к серверному API по HTTPS.
  3. Серверная часть хранит данные и взаимодействует с внешними сервисами, включая MAX, DaData и сервис анализа сообщений.

В этом репозитории находится клиентская часть. Она реализована на React и TypeScript, собирается с помощью Vite и использует REST API. Интерфейс разделён на независимые бизнес-модули; маршрутизация, проверка авторизации и права доступа находятся на уровне приложения.

Браузер пользователя
        |
        v
Статическое React-приложение
        |
        v
REST API «АИС Домовые чаты»
        |
        +-- хранилище данных
        +-- MAX
        +-- DaData
        +-- сервис анализа сообщений

Авторизация и права доступа

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

Доступ разделён на права:

  • адресный классификатор;
  • чаты;
  • управляющие компании;
  • участники чатов;
  • сообщения;
  • просмотр рассылок и опросов;
  • управление рассылками, опросами и выборками получателей;
  • администрирование.

Недоступные разделы отображаются в меню неактивными, а прямой переход по защищённому адресу блокируется.

Состав документации