Перейти к основному содержимому

Заведение жителей и лицевых счетов

Инструкция для администратора управляющей компании. Цель - чтобы в базе были адрес + квартира + лицевой счёт. После этого житель регистрируется сам по номеру ЛС (рекомендуемый путь) или получает учётку от администратора.

Что нужно в базе​

Без трёх сущностей регистрация по лицевому счёту не работает:

  1. Дом
  2. Помещение (квартира)
  3. Лицевой счёт (номер из квитанции)

Связь: дом → квартира → лицевой счёт → (после регистрации) житель. ФИО в реестр ЛС не вносится - житель указывает ФИО и телефон сам после первого входа.

Вариант 1. Ручной ввод (мало квартир)​

  1. Дома (/admin/houses) - создать дом, указать адрес (лучше через подсказки), сохранить.
  2. Помещения (/admin/premises) - выбрать дом, указать номер квартиры (при необходимости подъезд/этаж), сохранить.
  3. Лицевые счета (/admin/accounts) - выбрать дом и помещение, ввести номер ЛС как в квитанции, сохранить.

Готово: житель может регистрироваться по этому ЛС.

Вариант 2. Импорт (много домов и ЛС)​

Откройте Импорт (/admin/import). Кодировка UTF-8, разделитель ;. Всегда: сначала предпросмотр, потом импорт.

Рекомендуется: один файл «Реестр» (тип REGISTRY)​

Один проход создаёт дом (если ещё нет), квартиру (если ещё нет) и лицевой счёт. Формат CSV или XLSX (шаблоны - на странице импорта).

Колонки:

house_address;premise_number;account_number;premise_type;entrance;floor;fias_id;lat;lng

Обязательные: house_address, premise_number, account_number. В адресе должен быть номер дома (д N).

Пример:

house_address;premise_number;account_number
"г. Казань, ул. Пушкина, д 10";12;LS-100-12
"г. Казань, ул. Пушкина, д 10";13;LS-100-13

Пошаговый импорт (если удобнее разнести файлы)​

Порядок обязателен: Дома → Помещения → Лицевые счета.

HOUSES:    address_line;fias_id;lat;lng
PREMISES:  house_address;number;premise_type;entrance;floor
ACCOUNTS:  account_number;house_address;premise_number;owner_email

Адрес в файлах помещений и счетов должен совпадать с адресом уже загруженного дома. Поле owner_email необязательно - только если пользователь уже есть в системе.

Как появляется учётка жителя​

Вариант А. Саморегистрация (предпочтительно)​

  1. Реестр ЛС уже заведён (вручную или импортом).
  2. Житель открывает экран входа → Регистрация жителя.
  3. Вводит лицевой счёт из квитанции.
  4. Видит короткий адрес и подтверждает.
  5. Указывает email, пароль, согласие на обработку персональных данных.
  6. Входит в кабинет и заполняет ФИО и телефон - после этого доступны заявки и привязка бота MAX.

На один ЛС могут зарегистрироваться несколько человек (например, два собственника).

Вариант Б. Учётку создаёт администратор​

  1. Пользователи (/admin/users) → создать пользователя.
  2. Указать email, ФИО, телефон (обязателен), роль Житель (RESIDENT).
  3. Система покажет временный пароль - передайте жильцу email и пароль лично.
  4. При первом входе житель сменит пароль и дозаполнит профиль.

Массовое создание учёток - импорт типа USERS:

email;full_name;phone;role;temp_password
ivanov@example.com;Иванов Иван Иванович;+79001234567;RESIDENT;

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

Сообщение жителям​

Для саморегистрации жителям нужны: адрес кабинета, номер лицевого счёта из квитанции и короткая инструкция (регистрация → ФИО и телефон → заявки). Уведомите жителей также о боте MAX - привязка выполняется в профиле после регистрации (см. Бот MAX).

Типичные ошибки​

  • Импортируют лицевые счета раньше домов и квартир - «дом/помещение не найдено».
  • Адрес в файле помещений/счетов не совпадает с адресом дома.
  • Житель вводит ЛС, которого нет в базе - «не найден».
  • Создают жителя без телефона - форма и импорт не примут.
  • Ждут заявки сразу после регистрации - сначала нужно дозаполнить профиль (ФИО и телефон).
  • Ждут регистрацию кабинета в чате MAX - учётка создаётся только через регистрацию кабинета, бот кабинет не регистрирует.

Минимальная проверка​

  1. Вручную: дом → квартира 1 → ЛС TEST-001.
  2. Выйти из админ-панели.
  3. Пройти регистрацию жителя с ЛС TEST-001.
  4. Подтвердить адрес → email и пароль → согласие.
  5. Заполнить ФИО и телефон.
  6. Убедиться, что в профиле виден привязанный адрес, и создать тестовую заявку.