# 06 · Кабинет жителя

[← Home](Home.md)

Личный кабинет (`/cabinet`) — то, что видит житель, получив учётную запись
(создаётся администратором из карточки жителя; самостоятельная регистрация
отключена по умолчанию).

## Вход

Логин — **номер телефона** (в любом написании: `+7 999 123-45-67`,
`89991234567`, `9991234567`), либо выданный администратором логин/e-mail.
Учётную запись создаёт администратор одной кнопкой из карточки жителя:
логин = цифры телефона, **пароль генерируется автоматически** и показывается
один раз; при первом входе система потребует сменить пароль (Профиль →
Безопасность). Вход общий для всех ролей: `/login`. Житель видит только своё.

## Пульт шлагбаума (`/remote`)

Полноэкранный режим «одной кнопки» — специально для телефона в машине:

* **гигантская кнопка «ОТКРЫТЬ»** — занимает ~95% экрана (вся ширина,
  доминирующая высота), нажатие подтверждается полноэкранным зелёным/красным
  откликом и вибрацией; во время cooldown показывает обратный отсчёт;
* **живая камера выбранного шлагбаума** сверху (30% экрана): кадры через
  сервер, MJPEG-поток через прокси или прямой поток — как настроил админ;
  при нескольких воротах — переключатель камер, выбор запоминается;
  если камера недоступна, кнопка продолжает работать;
* статус устройства одной строкой, смена темы, выход в кабинет — компактно
  в верхней панели, чтобы не мешать;
* экран не гаснет, пока пульт открыт (Wake Lock).

Ссылка на пульт есть в меню и в кабинете («Полноэкранный пульт с камерой»).

## Главная

* **Большая кнопка «Открыть шлагбаум»** — если у карточки включены флаги
  «доступ» и «включен». Каждое нажатие пишется в журнал с типом доступа
  `own` (свой) и отметкой квартиры.
* Статус: последний пропуск, баланс/задолженность, активные гостевые пропуска.
* Объявления от управляющего (баннеры с важностью и сроком).

## Мои оплаты (`/cabinet/payments`)

* Счета: номер, период, сумма, срок, статус (ожидает/частично/оплачен/
  просрочен), кнопка **«Оплатить»** — переход по настроенной ссылке
  (CloudTips/ЮKassa/реквизиты — что настроил админ).
* История оплат (дата, сумма, метод).
* Текущий баланс: переплата хранится и учитывается в следующих начислениях.

## Гостевой доступ (`/cabinet/guest`)

* **«Создать пропуск»**: срок (пресеты 1–72 ч, по умолчанию 12), имя гостя,
  телефон, госномер, цель визита — какие поля обязательны, решает админ.
* Результат сразу: **ссылка с QR** (отправить гостю), **короткий код**
  (продиктовать по телефону), **PIN** (клавиатура панели).
* Список своих пропусков: активные/использованные/истёкшие, сколько раз
  открыли, кнопка **«Отозвать»**.
* Лимиты (сколько активных, сколько в день) задаёт администратор.

## Журнал (`/cabinet/log`)

Открывания, относящиеся к квартире жителя: свои и гостевые — время, тип
доступа, результат. Прозрачность: «кто въезжал по моему коду».

## Профиль (`/cabinet/profile`)

* Свои данные (только чтение): ФИО, квартира, контакты, машины — правит
  администратор (защита от самовольного добавления машин/номеров).
* Пароль, 2FA (можно включить для себя), тема оформления (светлая/тёмная/
  системная — сохраняется per-user), активные сессии с возможностью выйти
  на других устройствах.

## Что житель НЕ может

* Видеть чужие данные, журнал дома, настройки.
* Открывать шлагбаум при выключенном флаге «доступ» или «включен»
  (кнопка скрывается, API отвечает отказом, событие пишется как denied).
* Создавать гостевые пропуска сверх лимитов или если `allow_guest_pass=0`.
* Регистрироваться сам (по умолчанию).

---
Дальше: [07 · Гостевой доступ](07-Guest-Access.md)