Сила в ПРАВДЕ

Блог Мы-За-Будущее.РФ

Блог социальной патриотической сети

Генеалогия, соседи и ЖКХ, волонтеры в одном личном кабинете

## Что это за расширение и чем оно полезно

Компонент «Генеалогия» — это удобный личный кабинет на сайте, который объединяет сразу несколько бытовых задач: от семейного дерева и поиска родственников до общения с соседями, управления заявками в управляющую компанию, учёта коммунальных платежей и волонтёрской помощи «по пути». Всё это работает внутри привычного сайта на МЗБ.РФ: вы просто заходите под своим логином и пользуетесь разделами как обычным кабинетом жильца и жителя района.

Главная идея: собрать в одном месте ваши семейные связи, соседей по дому и двору, обращения по ЖКХ, голосования, помощь волонтёров и удобные инструменты для работы с квитанциями и жалобами. Пользователь видит только понятные разделы и кнопки, без технических настроек — всё, что связано с настройкой и администрированием, остаётся «за кулисами» и не мешает повседневному использованию.

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

---

## Обзор разделов для обычного пользователя

- **Панель управления** — стартовая страница, где собраны ссылки на ключевые разделы: адреса, заявки по ЖКХ, раздел «ЖКХ СТАТ», волонтёрство и др.
- **Адреса и соседи** — вы заполняете свой адрес, система находит соседей, показывает домовые чаты, ближайшие дворовые группы и позволяет подать заявку на вступление.
- **Заявки по ЖКХ (тикеты)** — удобный список ваших обращений в управляющую компанию или сервисную службу через тикетную систему.
- **Генеалогические деревья и персоны** — создание и ведение семейных деревьев, добавление родственников, привязка к пользователям сайта и к статьям с биографиями.
- **Домовые чаты и голосования** — обсуждения внутри двора, активные опросы и голосования в группах дома/двора.
- **Волонтёры «По пути»** — карта ближайших заявок на помощь (купить продукты, лекарства, помочь по мелким делам) и личные заявки, если вы подопечный или волонтёр.
- **ЖКХ СТАТ** — большой раздел для работы с коммунальными платежами:
  - загрузка и распознавание квитанций,
  - ручной калькулятор по услугам,
  - сравнение с городом/регионом,
  - статистика по месяцам,
  - генерация текстов обращений по ЖКХ и архив этих обращений.

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

---

## Панель управления: с чего начать

Когда вы заходите в компонент, вас встречает **панель управления**. На ней расположены карточки с краткими описаниями и кнопками для перехода:

- **«Адреса»** — настройка вашего адреса и поиск соседей.
- **«Заявки»** — переход к списку заявок по ЖКХ.
- **«ЖКХ СТАТ»** — вход в раздел коммунальной аналитики: квитанции, калькулятор, статистика, обращения.

### Как пользоваться панелью управления

1. Зайдите в личный кабинет на сайте.
2. Откройте пункт меню, который ведёт в компонент «Генеалогия».
3. На панели управления выберите нужный раздел:
   - если вы хотите найти соседей и домовой чат — начните с **«Адреса»**;
   - если интересуют коммунальные платежи и жалобы — переходите в **«ЖКХ СТАТ»**;
   - если нужно завести семейное дерево — откройте **«Деревья»** в меню компонента.

---

## Раздел «Адреса», соседи и домовые чаты

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

### Что вы видите в разделе «Адреса»

После входа в раздел:

- Если адрес ещё не заполнен, появляется предупреждение и большая кнопка **«Заполнить адрес»**.
- Если адрес есть, вы видите:
  - улицу, дом, при необходимости квартиру;
  - город, регион, индекс;
  - отметку «частный дом», если это ваш случай;
  - кнопку **«Редактировать»**.

Ниже блока с адресом показываются:

- **Домовой чат** — информация о том, есть ли уже чат для вашего двора в социальной части сайта (например, в JomSocial), кнопки:
  - **«Создать чат двора»** — если чата ещё нет, а координаты адреса настроены;
  - **«Открыть домовой чат»** — если группа уже существует;
  - подсказки, что делать, если координат нет (ссылка на редактирование адреса и установку точки на карте).
- **Ближайшие домовые чаты** — список групп по двору поблизости, расстояние в метрах, количество участников, кнопка **«Подать заявку на вступление»**.
- **Карта дворовых чатов** — интерактивная карта (Яндекс), где отмечен ваш адрес и ближайшие домовые группы.
- **Мои соседи** — списки людей:
  - в том же доме,
  - в том же дворе,
  - неподалёку,
  - в том же районе,
  с возможностью открыть личный чат с каждым соседом.
- **Заявки на вступление в домовой чат** (если вы администратор группы) — таблица с заявками и кнопками **«Принять» / «Отклонить»**, плюс быстрый переход в личный чат с заявителем.

### Как заполнить и отредактировать адрес

1. Откройте раздел **«Адреса»**.
2. Если адрес не задан, нажмите **«Заполнить адрес»**.
3. В форме укажите:
   - страну, регион, город;
   - улицу и дом;
   - при необходимости квартиру или отметьте «частный дом»;
   - при возможности поставьте точку на карте (это важно для поиска соседей и чатов).
4. Сохраните данные.
5. При необходимости в будущем зайдите в **«Редактирование адреса»** и поправьте дом, квартиру или координаты.

### Как создать домовой чат

1. Убедитесь, что в разделе «Адреса» у вашего адреса есть координаты (если их нет, появится подсказка и кнопка для их установки).
2. В блоке **«Домовой чат»** нажмите **«Создать чат двора»**.
3. После создания вы станете администратором группового чата для своего двора.
4. Соседи смогут находить этот чат и подавать заявки на вступление.

### Как вступить в уже существующий домовой чат

1. Прокрутите страницу до блока **«Ближайшие домовые чаты»** и карты.
2. Посмотрите список групп: название, адрес, расстояние, число участников.
3. Нажмите **«Подать заявку на вступление»** у нужного двора.
4. В открывшемся окне проверьте свой полный адрес (с квартирой) и отправьте заявку.
5. Дождитесь решения администратора группы:
   - статус «Заявка на рассмотрении» будет подсвечен в списке;
   - после одобрения вы сможете открыть чат.

### Как посмотреть и найти соседей

1. Убедитесь, что ваш адрес заполнен и помечен как публичный (в настройках адреса).
2. Внизу раздела «Адреса» появится блок **«Мои соседи»**:
   - соседи по дому,
   - соседи по двору,
   - жители поблизости,
   - жители того же района.
3. В каждой строке есть:
   - имя,
   - краткий адрес,
   - расстояние (если применимо),
   - кнопка **«Открыть персональный чат»**.
4. Нажмите на кнопку и общайтесь с соседями внутри системы сообщений сайта.

---

## Заявки по ЖКХ (тикеты)

Раздел **«Заявки»** показывает ваши обращения в управляющую компанию или сервисную службу, если на сайте подключена тикетная система.

### Что вы видите

- Список тикетов:
  - номер заявки,
  - заголовок,
  - статус (открыта, в обработке, закрыта, решена),
  - дата создания.
- Кнопки:
  - **«Создать заявку»** — открыть форму новой заявки в нужной категории;
  - **«Просмотр»** — перейти к деталям конкретного обращения.
- Если доступ к созданию заявок вам не разрешён, вместо кнопки появится понятное предупреждение с просьбой обратиться к администрации сайта.

### Как создать новую заявку

1. Откройте раздел **«Заявки»**.
2. Если тикетная система доступна и права есть, нажмите **«Создать заявку»**.
3. В форме укажите:
   - краткое название проблемы,
   - подробное описание,
   - при необходимости приложите файлы (фото, документы).
4. Отправьте заявку и отслеживайте её статус в этом же разделе.

---

## Генеалогические деревья и персоны

Раздел **«Деревья»** — это ваш центр работы с семейной историей. Здесь вы создаёте свои генеалогические деревья, добавляете в них людей, связываете родственников, привязываете статьи и профили.

### Что вы видите в разделе «Деревья»

- Кнопку **«Создать дерево»**, если у вас ещё нет деревьев.
- Список **«Мои созданные деревья»**:
  - название,
  - краткое описание,
  - дата создания,
  - отметка «Публичное дерево», если оно доступно другим.
- Блок **поиска публичных деревьев** по названию.
- Блок **«Похожие деревья по фамилии»** — деревья других пользователей с той же фамилией, что в вашем профиле.

### Как создать своё генеалогическое дерево

1. Зайдите в раздел **«Деревья»**.
2. Нажмите **«Создать дерево»**.
3. В форме укажите:
   - название (например, «Семья Ивановых»),
   - при желании — описание и краткий рассказ о семье,
   - отметьте, будет ли дерево публичным (его смогут находить другие пользователи).
4. Сохраните дерево.

После этого вы сможете зайти внутрь дерева, добавлять туда персоны и строить связи.

### Как добавить персону (человека) в дерево

1. Перейдите в нужное дерево.
2. Нажмите **«Добавить персону»**.
3. В форме заполните:
   - имя, фамилию, отчество;
   - даты рождения и, при необходимости, смерти;
   - пол;
   - краткую биографию.
4. Вы можете:
   - привязать персону к пользователю сайта (если он зарегистрирован),
   - привязать профиль социальной части сайта (JomSocial),
   - привязать статью о человеке.
5. При необходимости загрузите фотографию.
6. Сохраните персону.

### Как привязать к себе собственный профиль

Если у вас есть профиль в социальной части сайта, в форме добавления персоны может появиться кнопка **«Добавить себя»**:

1. Нажмите кнопку.
2. Данные автоматически подтянутся из вашего профиля: имя, фамилия и др.
3. Проверьте и при необходимости поправьте поля.
4. Сохраните.

### Как создать родственные связи

1. Внутри дерева откройте нужную персону.
2. Используйте функции создания связей (родитель, ребёнок, супруг, брат/сестра и т.п.).
3. При необходимости отправьте запросы на подтверждение другим пользователям:
   - они получат уведомление и смогут подтвердить или отклонить связь.
4. В дереве видна визуализация с поколениями, где можно приближать и отдалять схему.

---

## Домовые чаты и голосования

Отдельный раздел **«Голосования»** показывает активность внутри домовых групп.

### Что вы видите

- **Обсуждения в домовых чатах**, в которых вы состоите:
  - список групп,
  - их описания,
  - кнопка **«Открыть обсуждение»** — переход к группе в социальной части сайта.
- **Активные голосования**:
  - название голосования,
  - к какой группе относится,
  - кнопка **«Проголосовать»**, ведущая в нужную группу для участия в опросе.
- Если вы ещё не состоите ни в одном домовом чате, появится блок с подсказкой: сначала вступите в домовой чат через раздел «Адреса».

### Как пользоваться

1. Сначала настройте свой адрес и вступите в домовой чат (см. раздел «Адреса»).
2. Перейдите в раздел **«Голосования»**.
3. Откройте нужную группу или голосование:
   - нажмите **«Открыть обсуждение»** для просмотра тем;
   - нажмите **«Проголосовать»**, чтобы перейти к конкретному опросу в группе.

---

## Волонтёры «По пути»

Этот раздел объединяет подопечных и волонтёров. Подопечные создают заявки: сходить в магазин, купить лекарства, помочь с мелкими делами. Волонтёры видят такие запросы на карте вокруг себя и берут их «по пути».

### Основные роли

- **Подопечный** — человек, которому нужна помощь (например, пенсионер или инвалид).
- **Волонтёр** — тот, кто по дороге с работы или из магазина может выполнить заявку.

### Что видно волонтёру

Если у вас роль волонтёра:

- Вверху — кнопка **«Мои заявки»** (раздел с заявками, которые вы создали или взяли).
- Описание, как работает сервис «По пути».
- Блок с вашим адресом:
  - строкой «Ваш адрес»,
  - координатами (если они заданы),
  - ссылкой на раздел «Адреса», если координат не хватает.
- Большая карта с радиусом вокруг вашего адреса:
  - на ней отмечены заявки подопечных поблизости;
  - под картой список заявок:
    - краткое описание (что нужно сделать),
    - расстояние в километрах,
    - тип помощи (продукты, аптека, другая помощь),
    - кнопка **«Взять в работу»**.

После того как вы берёте заявку:

- заявка закрепляется за вами;
+- у вас есть ограниченное время (обычно 2 часа или до 21:00 по местному времени);
- после выполнения вы загружаете фото чека или результата, завершаете заявку и подопечный может оценить качество.

### Что видно подопечному

Если вы подопечный:

- Вверху — кнопка **«Создать заявку»**.
- Под ней — краткое описание возможностей:
  - можно указать, что нужно купить или сделать;
  - адрес подтянется из раздела «Адреса»;
  - при необходимости можно указать точку на карте.
- В разделе **«Мои заявки»** видно:
  - ваши созданные заявки;
  - кто и когда их взял;
  - статус (открыта, в работе, выполнена, отменена, просрочена).

### Раздел «Мои заявки»

Здесь собраны заявки, которые вы:

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

Для каждой заявки отображается:

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

Вы можете:

- как волонтёр — открыть страницу завершения заявки и загрузить фото результата;
- как подопечный — редактировать открытые заявки или отменить их;
- после выполнения — поставить оценку и оставить текстовый отзыв.

### Как стать подопечным

Если у вас пока нет роли подопечного, можно пройти короткий двухшаговый процесс:

1. **Шаг 1.** Подать заявку через тикетную систему:
   - перейти по ссылке в разделе **«Стать Подопечным»**;
   - кратко описать, кто вы (пенсионер, инвалид и т.д.), указать при необходимости данные документов;
   - отправить обращение.
2. **Шаг 2.** Подать заявку на вступление в группу подопечных в социальной части сайта:
   - перейти по ссылке **«Перейти в группу подопечных»**;
   - нажать **«Вступить в группу»** и дождаться одобрения администратора.

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

---

## ЖКХ СТАТ: квитанции, калькулятор, статистика и обращения

Раздел **«ЖКХ СТАТ»** — это отдельный центр для работы с коммунальными платежами. В нём собраны:

- загрузка и распознавание квитанций,
- калькулятор начислений,
- сравнение с городом/регионом,
- статистика по месяцам,
- генерация текстов обращений по ЖКХ,
- архив уже сгенерированных обращений.

### Главная страница ЖКХ СТАТ

На главном экране вы видите:

- приветственный текст (если настроен),
- карточки с переходами:
  - **«Загрузка квитанции»** — распознать квитанцию по фото или PDF;
  - **«Калькулятор ЖКХ»** — ввести показания и тарифы вручную;
  - **«Обращения ИИ по ЖКХ»** — сгенерировать текст жалобы;
  - **«Статистика»** — посмотреть графики платежей и средние значения по региону;
  - **«Публичные расчёты»** — расчёты других пользователей, которые сделали их видимыми;
  - **«Архив обращений»** — список ранее сгенерированных жалоб и заявлений.
- Блоки **«Последние квитанции»** и **«Последние расчёты»**:
  - период (месяц/год),
  - сумма по квитанции или расчёту.

---

### Загрузка и распознавание квитанции

Подраздел **«Загрузка квитанции»** позволяет загрузить фото или PDF с квитанцией по коммунальным услугам и автоматически получить разбивку по услугам.

#### Основные шаги

1. Перейдите в **«ЖКХ СТАТ» → «Загрузка квитанции»**.
2. Выберите файл квитанции:
   - допустимые форматы — JPG, PNG, PDF;
   - ограничение по размеру — до 10 МБ.
3. При необходимости вы увидите подсказку о стоимости распознавания в баллах:
   - на экране могут отображаться:
     - «Стоимость: X баллов»;
     - ваш текущий баланс;
   - если баллов не хватает, появится предупреждение.
4. Нажмите кнопку распознавания.
5. После обработки откроется форма с уже заполненными полями:
   - лицевой счёт,
   - период (месяц/год),
   - суммы по каждой услуге (содержание, вода, свет, лифт, ТКО, капремонт и т.д.).
6. Проверьте данные:
   - при необходимости исправьте суммы и период;
   - затем нажмите **«Сохранить»**.

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

---

### Калькулятор ЖКХ

Подраздел **«Калькулятор ЖКХ»** позволяет вручную посчитать, сколько должны составлять платежи, исходя из площади, показаний счётчиков и тарифов.

#### Что вы видите

- Если адрес не заполнен, появляется предупреждение и ссылка на раздел **«Адреса»** — без адреса калькулятор работать не будет.
- Если адрес есть:
  - сверху показан ваш адрес;
  - выбирается период — месяц и год;
  - можно выбрать регион и подгрузить оттуда эталонные тарифы;
  - можно указать площадь квартиры;
  - ниже идёт таблица услуг:
    - содержание жилья, лифт, аварийно-диспетчерское обслуживание;
    - ОДН по воде и электричеству;
    - ХВС, ГВС, водоотведение;
    - электричество (одна или две зоны);
    - капремонт, ТКО, домофон;
    - для каждой услуги — показание/площадь, тариф и рассчитанная сумма.
- Итоги:
  - «Итог по фиксированным» (содержание, капремонт и прочее);
  - «Общий итог».
- Чекбокс **«Сделать расчёт публичным»** — чтобы он отображался в списке публичных расчётов (без номера квартиры).
- Кнопка **«Сравнить с городом/регионом»** — показывает среднюю сумму по тем же услугам в выбранном регионе, если уже есть данные других пользователей.

#### Как пользоваться калькулятором

1. Перейдите в **«ЖКХ СТАТ → Калькулятор ЖКХ»**.
2. Убедитесь, что ваш адрес задан в разделе «Адреса».
3. Выберите:
   - месяц и год,
   - при желании — регион.
4. Если регион выбран, нажмите **«Загрузить тарифы»** — в таблицу подставятся рекомендованные тарифы по региону (если они есть в системе).
5. Укажите:
   - площадь квартиры (если она не подставилась автоматически);
   - показания счётчиков;
   - при необходимости поправьте тарифы.
6. Таблица автоматически посчитает суммы по каждой строке и итоги:
   - значения обновляются сразу при вводе.
7. При необходимости поставьте галочку **«Сделать расчёт публичным»**, чтобы поделиться результатом (будет виден только дом и улица, без квартиры).
8. Нажмите **«Сохранить расчёт»**.
9. При желании нажмите **«Сравнить с городом/регионом»**, чтобы увидеть:
   - среднюю сумму по похожим расчётам в выбранном регионе;
   - количество расчётов, на основе которых посчитана средняя.

---

### Публичные расчёты и сравнение с регионом

Подраздел **«Публичные расчёты»** показывает, как платят другие пользователи:

- список расчётов, которые люди отметили как публичные;
- для каждого — адрес без квартиры, ссылка на профиль;
- средние значения по услугам;
- удобная сводка «Среднее значение по услугам» в рублях.

Вы можете:

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

---

### Статистика по ЖКХ

Подраздел **«Статистика»** показывает графики изменения ваших коммунальных платежей и средних значений по региону.

#### Возможности

- выбор периода:
  - 6 месяцев,
  - 12 месяцев,
  - 24 месяца;
- фильтр, какие данные показывать:
  - только ваши,
  - только средние по региону,
  - и то, и другое;
- разрезы:
  - общий итог по месяцам,
  - отдельные графики по услугам,
  - фиксированные платежи.

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

---

### Обращения по ЖКХ и генерация текстов жалоб

Подраздел **«Обращения по ЖКХ»** позволяет сформировать грамотный текст жалобы или обращения на основе вашего описания.

#### Как это выглядит

- Заголовок **«Обращения по ЖКХ»**.
- Краткое пояснение, что система помогает составить текст обращения.
- Поле для ввода описания проблемы:
  - что не так,
  - с кем спор,
  - какие документы есть,
  - какие решения вы ожидаете.
- Если генерация текста стоит баллов, сверху выводится предупреждение о стоимости и списании.
- Кнопка **«Сгенерировать»**.

После нажатия:

- система формирует подробный текст обращения;
- ниже появляется результат с понятной разметкой;
- есть подсказка: текст можно скопировать и подать через указанные ведомства (электронные приёмные и т.д.).

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

---

### Архив обращений

Подраздел **«Архив обращений»** хранит историю составленных жалоб:

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

Если архив пуст, выводится аккуратное сообщение.

---

## Подробная инструкция по разделам: как пользоваться

Ниже — короткая выжимка по действиям в каждом разделе для обычного пользователя.

### 1. Адреса и соседи

1. Зайти: меню компонента → **«Адреса»**.
2. Если адрес не заполнен — нажать **«Заполнить адрес»** и внести данные.
3. При необходимости отредактировать адрес и указать точку на карте.
4. Проверить блок **«Домовой чат»**:
   - если чата нет — создать;
   - если есть — открыть.
5. Посмотреть **«Ближайшие домовые чаты»**, при желании подать заявку на вступление.
6. Внизу — блок **«Мои соседи»**:
   - изучить список,
   - открыть персональные чаты с теми, с кем хотите пообщаться.

### 2. Домовые чаты и голосования

1. Настроить адрес и, при желании, вступить в домовой чат.
2. Открыть раздел **«Голосования»**.
3. Посмотреть:
   - список чатов с кнопками **«Открыть обсуждение»**;
   - блок активных голосований с кнопкой **«Проголосовать»**.
4. Перейти в нужную группу/голосование и участвовать в обсуждении или опросе.

### 3. Заявки по ЖКХ

1. Открыть раздел **«Заявки»**.
2. Посмотреть список тикетов (если уже есть).
3. При необходимости нажать **«Создать заявку»**:
   - заполнить заголовок и описание,
   - отправить.
4. Возвращаться в этот раздел, чтобы отслеживать статусы: открыта, в обработке, решена.

### 4. Генеалогические деревья

1. Открыть **«Деревья»**.
2. Если деревьев нет — нажать **«Создать дерево»**, придумать название и описание.
3. Внутри дерева использовать:
   - **«Добавить персону»** — создать карточку человека;
   - заполнить ФИО, даты, биографию, загрузить фото;
   - при необходимости привязать пользователя сайта и/или статью;
   - добавить родственные связи (родители, дети, супруги, братья/сёстры и др.).
4. Использовать визуализацию дерева, чтобы смотреть, как выстроены поколения.
5. При желании сделать дерево публичным, чтобы другие могли находить общих предков.

### 5. Волонтёры «По пути»

**Для волонтёра:**

1. Убедиться, что у вас есть роль волонтёра (обычно это настраивается администрацией сайта).
2. Перейти в раздел **«Волонтёры»**.
3. Проверить свой адрес и координаты; при необходимости отредактировать через раздел «Адреса».
4. Посмотреть карту с радиусом и список ближайших заявок.
5. Нажать **«Взять в работу»** на подходящей заявке.
6. Выполнить просьбу (купить продукты, лекарства и т.п.).
7. Перейти в **«Мои заявки»**, открыть заявку и завершить её:
   - загрузить фото чека или результата,
   - отправить на подтверждение подопечному.

**Для подопечного:**

1. Пройти шаги «Стать Подопечным» (тикет + вступление в группу).
2. Зайти в раздел **«Волонтёры»**, нажать **«Создать заявку»**.
3. Описать, какая помощь нужна, выбрать категорию (продукты, аптека или другая помощь).
4. Проверить адрес и точку на карте.
5. При желании указать, сколько баллов вы готовы выделить как поощрение.
6. Сохранить заявку и ждать, пока волонтёр её возьмёт.
7. После выполнения поставить оценку и, при желании, добавить комментарий.

### 6. ЖКХ СТАТ

**Загрузка квитанции:**

1. Открыть **«ЖКХ СТАТ» → «Загрузка квитанции»**.
2. Выбрать файл (фото или PDF).
3. При необходимости ознакомиться с информацией о списании баллов.
4. Нажать кнопку распознавания.
5. Проверить распознанные поля и суммы.
6. Сохранить квитанцию.

**Калькулятор:**

1. Открыть **«ЖКХ СТАТ → Калькулятор ЖКХ»**.
2. Убедиться, что в разделе «Адреса» указан адрес.
3. Выбрать месяц и год.
4. При желании выбрать регион и нажать **«Загрузить тарифы»**.
5. Внести показания счётчиков и корректные тарифы.
6. При желании сделать расчёт публичным.
7. Нажать **«Сохранить расчёт»**.
8. Использовать кнопку **«Сравнить с городом/регионом»**, чтобы увидеть средние значения.

**Статистика:**

1. Открыть **«ЖКХ СТАТ → Статистика»**.
2. Выбрать период (6, 12 или 24 месяца).
3. Отметить, показывать ли ваши данные, средние по региону или оба варианта.
4. Сравнить графики по месяцам и услугам.

**Обращения по ЖКХ:**

1. Открыть **«ЖКХ СТАТ → Обращения по ЖКХ»**.
2. В большом поле описать ситуацию:
   - какая проблема,
   - кто ответственен,
   - что вы уже предпринимали,
   - какие документы есть.
3. При необходимости учесть информацию о стоимости генерации.
4. Нажать **«Сформировать текст»**.
5. Скопировать получившийся текст и подать его через электронную приёмную нужного ведомства или распечатать для личного визита.

**Архив обращений:**

1. Открыть **«ЖКХ СТАТ → Архив обращений»**.
2. Найти нужное обращение по дате или краткому описанию.
3. Открыть текст и при необходимости снова его скопировать и использовать.

---

## Варианты применения: что и зачем нужно (10+ примеров)

1. **Поиск соседей по дому и двору.** Заполнив адрес, вы быстро увидите, кто живёт рядом, и сможете общаться с ними в личных чатах.
2. **Создание и ведение семейного дерева.** Раздел «Деревья» поможет собрать информацию о нескольких поколениях семьи, добавить фотографии, биографии и связи между родственниками.
3. **Совместные обсуждения по дому.** Домовой чат и голосования позволяют решать вопросы благоустройства двора, ремонта, работы управляющей компании и других тем.
4. **Удобный учёт коммунальных платежей.** Через загрузку квитанций и калькулятор вы можете видеть полную картину расходов по ЖКХ, хранить историю и не искать старые бумаги по ящикам.
5. **Сравнение с другими жильцами региона.** Публичные расчёты и статистика по региону помогают понять, завышены ли ваши платежи по сравнению с похожими квартирами.
6. **Подготовка жалоб по ЖКХ без юриста.** Описываете проблему — получаете готовый текст обращения, который можно отправить в надзорные органы или управляющую компанию.
7. **Централизация заявок по ЖКХ.** Раздел «Заявки» показывает все обращения в одном месте: вы всегда видите статус и историю общения с обслуживающими организациями.
8. **Волонтёрская помощь «по пути».** Волонтёры могут помогать подопечным поблизости, не тратя много времени в обход, а подопечные получают поддержку в обычных бытовых делах.
9. **Социальная активность района.** Через домовые чаты и голосования формируется сообщество жильцов, которое проще договаривается по общим вопросам (детская площадка, парковка, освещение и т.д.).
10. **Семейные истории в статьях.** Привязка статей к персонам позволяет создавать красивые биографические материалы о предках и делиться ими с родственниками.
11. **Прозрачность и порядок в информации.** Все данные — и по семье, и по дому, и по ЖКХ — собраны в одном личном кабинете, который всегда под рукой.

Продолжить чтение

Медицинский Архив МЗБ.РФ

## Кратко о компоненте AI Medical Archive

AI Medical Archive — это компонент для МЗБ.РФ, который превращает сайт в умный медицинский архив. Он бережно хранит результаты анализов и обследований, распознаёт бланки с помощью нейросетей, подсвечивает критические значения и помогает обычному пользователю понять сложные медицинские термины простым языком.

Компонент особенно полезен:
- для пациентов, которые годами копят бумажные бланки и теряются в них;
- для родителей, ведущих архив анализов ребёнка;
- для людей с хроническими заболеваниями, где важно следить за динамикой показателей;
- для онлайн‑сервисов и клиник, которые хотят дать клиенту удобный личный кабинет с историей анализов и консультациями.

Все данные группируются по «архивам» родственников, интегрируются с Rewardify (система баллов) и JomSocial (пользовательские профили), а тяжёлая работа по распознаванию и первичной аналитике перекладывается на подключаемый AI‑API.

## Основные задачи, которые решает компонент

- **Цифровой медицинский архив**: структурированное хранение анализов, приёмов и обследований по каждому члену семьи.
- **Автоматическое распознавание бланков**: загрузка фото или PDF, конвертация в нормализованный JSON с показателями.
- **Отслеживание динамики показателей**: удобный трекер, который строится по распознанным маркерам.
- **Контроль критических значений**: база референсных интервалов, предупреждения и подсветка опасных показателей.
- **Объяснение непонятных терминов и маркеров**: встроенная база знаний и диалог с ИИ для расшифровки.
- **Подготовка к приёму у врача**: автоматизированный «бриф» по выбранным анализам и документам.
- **Монетизация и геймификация**: начисление и списание баллов через Rewardify за распознавание, консультации и запросы к ИИ.

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

## Пользовательский интерфейс: личный медицинский архив

### Архивы родственников

Входная точка компонента — страница «Мой архив». Здесь пользователь видит список архивов:
- **ФИО родственника**;
- **год рождения**;
- **статус согласия** (получено/ожидается).

Каждый архив — это отдельная история наблюдения за конкретным человеком. Через кнопку «Добавить архив» создаётся карточка с ФИО, датой рождения и отметкой о разрешении на обработку данных. Форма проста и не перегружена, но при этом подчёркивается важный момент: владелец аккаунта берёт на себя ответственность за хранение и обработку медицинской информации родственника.

### Загрузка бланков анализов и обследований

После выбора архива открывается ключевая зона — **блок загрузки документов**. Пользователь:
1. Выбирает тип документа:
   - анализ (laboratory analysis),
   - приём (осмотр, консультация врача),
   - обследование (УЗИ, МРТ, КТ и т.п.).
2. При необходимости указывает название документа (например, «Биохимия крови 12.03.2026» или «УЗИ брюшной полости»).
3. Загружает файл в формате **JPG, JPEG, PNG или PDF**.

Дальше включается механизм очереди: файл отправляется в AI‑сервис, создаётся задача на распознавание, а на стороне пользователя отображается статус — от «ожидает обработки» до «готово» или «ошибка». Если компонент подключён к Rewardify и настроены баллы, рядом выводится подсказка, сколько баллов спишется за одно распознавание.

### Ручной ввод результатов

Не каждый бланк удобно фотографировать, и не всегда есть файл под рукой. Для таких случаев предусмотрен **ручной ввод**:
- выбор типа документа (анализ / приём / обследование);
- отдельное поле для названия (для приёмов и обследований);
- кнопка «Добавить элемент анализа/обследования», открывающая модальное окно со справочником показателей;
- выбор показателя из таблицы (для анализов — маркеры, для обследований — коды из приказа 804н);
- ввод значения и единиц измерения (для обследований — результата в свободной форме);
- текстовое поле для полного описания — сюда можно вставить выдержки из заключения, заметки врача, свои комментарии.

Компонент аккуратно следит, чтобы пользователь не отправлял пустые документы: без текста и без добавленных маркеров форма не будет сохранена. Это защищает от «заспамленных» записей и держит архив аккуратным.

### Список документов и рабочие сценарии

Ниже на странице архива расположен **список всех документов**, привязанных к этому человеку:
- дата создания записи;
- тип (анализ, приём, обследование) + опциональное название;
- статус (`ожидает`, `обрабатывается`, `готов`, `ошибка`);
- действия: открыть карточку, отправить на повторное распознавание, запустить проверку критических значений.

Список можно отсортировать:
- по дате (новые/старые),
- по типу,
- по статусу.

Для документов со статусом `готов` становятся доступны **групповые операции**:
- **оценка стоимости анализа**: компонент отправляет AJAX‑запрос и показывает, сколько баллов уйдёт на разбор выбранных документов, сколько осталось на балансе и какой суммарный объём текста;
- **запрос анализа**: формируется запрос к ИИ, который учитывает выбранные документы и (опционально) автоматический промпт;
- **подготовка к приёму**: на основе тех же документов генерируется структурированная сводка, которую удобно показать врачу или сохранить для себя.

Перед списанием баллов компонент обязательно спрашивает подтверждение пользователя, подставляя реальные цифры из Rewardify.

### Трекер динамики показателей

Если в архиве накопилось хотя бы несколько документов с распознанными маркерами, появляется кнопка «Показать динамику». Она ведёт на отдельный **трекер**, который:
- подтягивает значения показателей из таблицы маркеров;
- группирует их по типам анализов и коду показателя;
- строит временные ряды, наглядно показывая, как менялись, например, глюкоза, ферритин или креатинин.

Благодаря тому, что при распознавании используется единый стандарт кодов (glc, ca, k, iron, ferritin, creat и т.д.), трекер не путается в русских названиях и считает динамику по единым маркерам.

### Карточка отдельного документа

При переходе в документ пользователь видит:
- базовую информацию — тип, дата, статус;
- блок с предупреждениями:
  - критические значения;
  - отсутствие показателей для проверки;
  - результат последней проверки;
- таблицу маркеров:
  - человекочитаемое название (по справочнику),
  - значение,
  - единица измерения,
  - кнопка «Объяснить термин» для каждого маркера.

Ниже, если данные пришли от AI‑распознавания, можно развернуть **полный JSON‑ответ** — это полезно для продвинутых пользователей и технических специалистов. Там же хранится «сырой текст» бланка, приведённый к понятному виду.

Отдельный блок посвящён **неизвестным маркерам**: если показатель не найден в справочнике критических значений, компонент предложит отправить его в ИИ для оценки и сохранения в базу знаний. Стоимость такого запроса также регулируется через систему баллов.

### Объяснение медицинских терминов

Компонент решает еще одну боль пациента — непонятные названия анализов и терминов. В карточке документа и через отдельное модальное окно пользователь может:
- ввести любой термин;
- отправить запрос;
- получить понятное, адаптированное объяснение «для человека без медицинского образования».

Ответ формируется на основе:
- собственной базы знаний,
- при необходимости — внешнего AI‑сервиса (через RagService и chat‑методы).

Кнопка и тексты вокруг неё настраиваются в админке, поэтому владелец сайта может подобрать тональность под свой бренд.

## Система баллов и интеграция Rewardify

AI‑запросы и распознавание бланков — ресурсоёмкие операции, поэтому компонент сразу готов к монетизации или лимитированию нагрузки.

В настройках задаются:
- **points_recognize** — сколько баллов списывать за распознавание одного файла;
- **points_consultation** — стоимость консультационного анализа;
- **points_per_million_chars** — тариф за объём текста;
- **points_term** — стоимость объяснения одного термина;
- **points_preparation** — цена подготовки к приёму.

За учёт и операции с баллами отвечает **RewardifyService**:
- проверяет баланс пользователя;
- списывает баллы при успешной операции;
- при необходимости возвращает (например, если задача распознавания упала с ошибкой).

Благодаря этому, компонент можно:
- использовать как платный сервис на сайте клиники;
- комбинировать бесплатный базовый функционал с платными «премиум» возможностями (подробные консультации, продвинутая аналитика и т.д.).

## Критические значения и безопасность пациента

Отдельный важный слой компонента — **контроль критических значений**. За него отвечает таблица `#__ai_med_critical_values` и админский интерфейс «Критические значения».

Администратор может:
- импортировать пороговые значения в удобном текстовом формате:
  - `glc 3.5 6.0 ммоль/л`
  - `chol 0 5.2 ммоль/л`
  - `tsh 0.4 4.0 мЕд/л`
- добавлять и редактировать записи вручную;
- восстанавливать значения по умолчанию одной кнопкой.

Каждая запись содержит:
- **marker_name** — внутренний код маркера (glc, tsh, ferritin и т.д.);
- **display_name** — человекочитаемое название;
- **med_code** — код по медицинской номенклатуре;
- **минимум и максимум** нормы;
- **единицу измерения**.

Когда документ готов, компонент:
1. Нормализует названия показателей (учитывая популярные синонимы и русские варианты).
2. Находит соответствующие записи в справочнике критических значений.
3. Сравнивает реальное значение с интервалом нормы.
4. Формирует:
   - список критичных показателей,
   - предупреждения,
   - список «неизвестных маркеров», которые надо доучить системе.

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

## База знаний и термины

Компонент умеет работать не только с цифрами, но и с текстом. В административной части есть раздел «База знаний», где хранятся:
- медицинские термины;
- описания и объяснения;
- при необходимости — референсные диапазоны и единицы.

Эта база:
- используется для быстрых ответов на типичные запросы («что такое ферритин», «что показывает TSH»);
- дополняется через запросы к ИИ, когда пользователь сталкивается с неизвестным маркером;
- обеспечивает единый стиль и качество объяснений по всему сайту.

Для администратора это удобный инструмент:
- дообучать систему под конкретную специализацию (эндокринология, онкология, педиатрия и т.д.);
- хранить свои формулировки, согласованные с врачами клиники.

## Пошаговая инструкция: как работать обычному пользователю

1. **Авторизация на сайте**. Компонент рассчитан на связку с пользовательским профилем, поэтому сначала нужно войти в личный кабинет.
2. **Переход в «Мой архив»**. В меню сайта выбрать соответствующий пункт.
3. **Создание архива родственника**:
   - указать ФИО;
   - дату рождения;
   - подтвердить согласие на хранение данных.
4. **Добавление документа**:
   - выбрать нужный архив;
   - в блоке загрузки указать тип документа;
   - при необходимости задать понятное название;
   - загрузить файл или воспользоваться ручным вводом.
5. **Ожидание обработки**:
   - при загрузке файла дождаться, пока статус изменится на «готов»;
   - система сама поставит задачу в очередь и выполнит распознавание.
6. **Просмотр результата**:
   - открыть документ;
   - посмотреть таблицу показателей и их значения;
   - при наличии — обратить внимание на блок критических значений.
7. **Объяснение непонятных терминов**:
   - нажать кнопку «Объяснить термин» напротив нужного показателя;
   - либо открыть отдельное окно и ввести термин вручную;
   - получить развёрнутое пояснение простыми словами.
8. **Подготовка к приёму**:
   - на странице архива выделить несколько готовых документов;
   - оценить стоимость анализа (по баллам);
   - подтвердить списание и перейти к сгенерированному резюме, которое удобно показать врачу.
9. **Отслеживание динамики**:
   - при накоплении нескольких анализов, перейти в трекер;
   - посмотреть, как менялись ключевые показатели во времени.

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

## Варианты использования и сценарии внедрения

AI Medical Archive гибко вписывается в разные модели:

- **Семейный медицинский архив** на личном сайте или портале:
  - акцент на приватность и удобство;
  - минимум публичных функций, максимум пользы для владельца.

- **Онлайн‑сервис по расшифровке анализов**:
  - публичная регистрация пользователей;
  - чёткая тарифная сетка по баллам;
  - упор на понятные объяснения и проверку критических значений.

- **Сервис сопровождения хронических пациентов**:
  - трекер динамики как основной инструмент;
  - регулярная загрузка анализов;
  - шаблонные «подготовки к приёму» с подсветкой ключевых изменений.

- **Интеграция с клиникой или телемедицинским сервисом**:
  - связка с Социальной сетью МЗЬ.РФ и внутренними профилями;
  - возможность подключить врачей к просмотру архивов;
  - собственная база знаний, согласованная с медицинским отделом.

Архитектура компонента и продуманная структура БД позволяют постепенно наращивать функциональность: от простого хранения результатов анализов до полноценного, интеллектуального помощника пациента и врача.

 

Продолжить чтение