Показувати зняті з експлуатаціїїхні показання зберігаються назавжди
Скарги
На сусідів, на стан будинку, на керуючу компанію або міські служби. Власник квартири отримує сповіщення про скаргу на нього.
Нова скарга
Не показувати моє ім'я сусідовімодератор і адміністратор автора бачать завжди
Скарги
Збори коштів
Хто скільки здав і на що витрачено, з чеками і фотозвітами.
Збори
Оберіть збір зі списку.
Оголошення
Оголошення для всього будинку публікуються після перевірки модератором.
Надіслати каналами зв'язкупошта і Telegram тим, хто їх увімкнув
На перевірці
Опубліковані
Загальні збори мешканців
Коли, де і з яким порядком денним. Кого скликають — визначає аудиторія.
Нові збори
Календар будинку
Роботи, відключення послуг, суботники, ремонти в квартирах, заїзди і виїзди. Виділіть діапазон днів, щоб додати подію.
Нова подія
Увесь будинокусі квартири, перелічувати не треба
Розріз будинку
Клацайте квартири, службові приміщення і шахти — вони додаються до події.
Позначаться на розрізі будинку кольором категорії, мешканці отримають сповіщення.
Проблеми по квартирах
Аварії, роботи, заявки і скарги разом. Скарги видно власнику квартири, модератору і адміністратору — на розріз будинку вони не виносяться.
Події
Клац по дню показує його події. Клац по другому дню виділяє діапазон.
Електромережа
Напруга, струм і потужність по фазах. Дані надходять із приладу на вводі.
Оновлювати кожні 30 секундбез цього графік оновиться лише кнопкою «Оновити»
Проведіть мишею по графіку, щоб наблизити проміжок. Подвійний клац повертає період.
Статистика по фазах
По місяцях
Графік планових відключень
Світло єСвітла немаєСвітла не буде перші 30 хвСвітла не буде другі 30 хв
Відключення світла
Датчики будинку
Що встановлено, де стоїть і які показання. Графіки будуються за полями, дозволеними в картці датчика.
Журнал відвідувачів
Оберіть квартиру на розрізі, вкажіть вид відвідувача — час підставиться сам.
Розріз будинку
Клац по квартирі підставляє її номер у форму. Жовтим позначені квартири, де сьогодні чекають гостя.
Новий запис
час і дата підставляються автоматично
Очікуються сьогодні
Журнал
Довідник будинку
Інструкції, правила і корисні телефони: дільничний, поліклініка, майстри.
Статті
Оберіть статтю зі списку.
Новий контакт
Корисні контакти
Роботи по будинку
Де і що зроблено, ким, коли, за скільки і з яких матеріалів. З фотозвітами і чеками.
Новий звіт про роботи
Мій кабінет
Картка квартири, історія змін і журнал звернень до ваших контактів.
Новий мешканець
Хто переглядав мої контакти
Мої гості
Попередьте консьєржа — він впустить гостя і позначить прибуття.
Сповіщення про електромережу
Приходять у Telegram. Оберіть, за якими фазами стежити і які повідомлення отримувати.
Нічне мовчанняу цей час бот не пише; пропущене надійде після
Канали сповіщень
Куди надсилати повідомлення про інциденти у вашій квартирі, заявки і оголошення.
Пошта
Telegram
Телефонпотрапляє в список для обдзвону — SMS не надсилаються
Telegram
Мої дії на порталі
Пароль
Мої права
Адміністрування
Користувачі, права, будинок, розділи порталу і журнали.
Заявки на реєстрацію
Запити на відновлення пароля
Код видно лише адміністратору. Для каналу «телефоном» передайте його мешканцю особисто, переконавшись, хто саме телефонує.
Новий користувач
Від 0.1 до 2. Бачить і змінює лише адміністратор.
Поверхи заповнюються лише для групи «старший по поверху»: саме за ними він бачить контакти.
Користувачі
ПІБ
Пошта
Група
Кв.
Поверхи
Стан
Розріз будинку
Клац по квартирі відкриває її картку. Порожня клітинка — вільне місце на поверсі, клац по ній заводить нову квартиру.
заповненабез власникавільне місце
Список
Додати квартиру
Позиція — місце на поверсі зліва направо, від 0. За нею будується розріз будинку.
Або призначити сутність
Вільній клітинці можна дати не квартиру, а приміщення: комору, електрощитову, колясочну.
Оберіть квартиру зі списку.
Токен можна замінити будь-коли: впишіть новий у поле нижче і збережіть. Стара прив'язка мешканців при цьому лишається.
Конструктор повідомлень
Текст із форматуванням, картинка або відео, кнопки-посилання і голосування. Видно, хто за що проголосував.
Журнал надсилань
Пишіть і форматуйте просто тут — у Telegram піде так само.
Перетягніть сюди картинку чи відео або клацніть, щоб обрати
Кнопка-посилання веде на сайт або розділ порталу. Кнопка голосування рахує, хто її натиснув.
Як це виглядатиме
Групи і канали
Додайте бота в групу чи канал — він з'явиться тут одразу. Далі оберіть, які розділи там доступні і які сповіщення туди надсилати. У групі бот за замовчуванням не бачить звичайних повідомлень (privacy mode у Telegram), тому розділи відкриваються кнопками: напишіть у групі /menu, і бот покаже їх під повідомленням. Щоб бот розумів і назви розділів текстом, вимкніть privacy mode у @BotFather: /mybots → Bot Settings → Group Privacy → Turn off.
Потрібно, якщо бот був у каналі ще до оновлення порталу: Telegram повідомляє про додавання лише раз.
Статистика бота
Журнал звернень
Тексти, які надсилає бот
Telegram-бот
Бот працює з тими самими правами, що й сайт: якщо контакт не показано тут, бот його теж не віддасть. Кожен запит потрапляє в журнал.
Після зміни токена перезапустіть службу бота: systemctl restart portal-telegram
Що дозволено в боті
Прив'язані акаунти
Групи
Користувачі
Права беруться з групи. Будь-яке з них можна окремо розширити або обмежити конкретній людині — таке право позначається як особисте і не змінюється при правці групи.
Оберіть групу або користувача
Дані будинку
Після переходу на ОСББ у списку служб з'являються сантехнік, електрик, майстер, прибиральник і двірник.
Конструктор схеми
Клац по клітинці відкриває її для правки: назва, вид, мітка. Клац по порожньому місцю створює нову сутність — комору, електрощитову, приямок. Квартири редагуються на вкладці «Квартири і мешканці».
Нова сутність
Службова адреса запису. Можна писати як завгодно — великі літери й кирилиця перетворяться самі.
Стояки
Ліфти та інші наскрізні елементи. Стан згодом писатимуть датчики.
Усі сутності
Категорії інцидентів
Три перемикачі керують поведінкою: чи захоплює стояк підвал і технічний поверх, чи стосується поломка всієї шахти ліфта, чи мешканець описує проблему своїми словами.
Нова категорія
Стояк захоплює підвал і технічний поверхдля води, опалення, каналізації
Завжди стосується всієї шахти ліфтадля поломок ліфта
Мешканець описує своїми словамикатегорія «Інше»: шум, комахи, пожежа
Види відвідувачів
Перелік, з якого обирає консьєрж і мешканець. Службові виклики (поліція, швидка) позначаються окремо.
Дані бере Open-Meteo — безкоштовно і без ключа. Портал звертається до сервісу не частіше разу на 15 хвилин і віддає всім мешканцям збережену відповідь, тому безкоштовного ліміту вистачає з великим запасом.
Показувати погодузначок, температура і прогноз на три дні
Повітряні тривоги
Дані з відкритого агрегатора ubilling.net.ua, оновлюються раз на 45 секунд. Це довідкова інформація, а не офіційне сповіщення — покладатись у критичній ситуації слід на офіційні канали.
Показувати стан тривогисмуга з областю і станом
Час на сервері
Якщо час порталу відрізняється від вашого годинника, служба працює в іншому часовому поясі. Виправляється на сервері: timedatectl set-timezone Europe/Kyiv, далі systemctl restart portal-api.
Прилади і ключі
Прилад сам надсилає дані на адресу з ключем — авторизацію він проходити не вміє, тому адреса і є секретом. Ключ можна перевипустити, історія показань при цьому лишається.
Графік планових відключень
Портал сам забирає графік із сайту обленерго за адресою будинку. Назву вулиці пишіть так, як у довіднику ДТЕК. Коли вимкнено — портал нікуди не ходить, розділ графіка на сторінці не показується і в Telegram його теж немає.
Показувати графік відключеньтягнути дані з сайту обленерго і показувати їх мешканцям
Попередження наперед
Кожен рядок — окреме нагадування. Кнопка «+ Додати правило» створює новий, «×» прибирає. Підстановки в тексті: {start} початок, {end} увімкнення, {minutes} за скільки (вже з одиницями: «2 год»), {duration} скільки триватиме, {date} доба. Порожній текст — піде типовий. Хто отримає — вирішують налаштування виду «Планові відключення» нижче і підписки груп.
«Світло за приладом» — чи зважати на справжній стан мережі перед надсиланням:
автоматично — не писати те, що вже застаріло (про увімкнення мовчимо, коли світло вже є, про вимкнення — коли його вже немає);
тільки якщо світло Є — так робиться попередження «час відключення настав, а світло ще є, ліфтом краще не користуватися»;
тільки якщо світла НЕМАЄ — нагадування лише в темряві;
байдуже — надсилати за графіком, хай там що каже прилад. Коли приладу немає або він мовчить, портал вірить графіку.
Надсилати новий графік, щойно він з'явивсязазвичай це графік на завтра; іде негайно, попри нічне мовчання
Писати, коли графік змінивсячас початку або увімкнення зсунувся в будь-який бік; теж іде негайно
У цих двох текстах доступна підстановка {plan} — увесь графік доби («18:00–21:30, 23:00–24:00»), а в тексті про зміну ще й {changes} — перелік того, що саме зсунулось.
Приклади повідомлень
Аварійні відключення
Аварія — це не графік: вона не в таблиці, а окремим рядком у відповіді сайту ДТЕК по нашому будинку (саме з нього на їхній сторінці береться червона плашка «за вашою адресою відсутня електроенергія»). Портал питає сайт частіше за графік і пише лише тоді, коли щось змінилося: аварія почалася, зсунувся орієнтовний час відновлення, світло повернули. Це окремий вид сповіщень: кожна група і кожен канал вмикають його собі самі («Групи і канали»), мешканець — у своєму кабінеті, а разом усе вимикається перемикачем «Аварійні відключення» нижче.
Стежити за аваріямипитати сайт і повідомляти про позачергові відключення
Надсилати ботоммешканцям у Telegram-бот
Надсилати в групипідписані на «Аварійні відключення»
Писати про відновленняколи світло повернули
Підстановки: {address} адреса, {reason} причина зі слів ДТЕК, {start} час початку, {end} орієнтовний час відновлення, {was} попередній час відновлення, {group} група. Порожнє поле — піде типовий текст.
Норми і сповіщення мережі
Повідомлення про вихід за норму надсилається один раз. Через час повторної перевірки портал дивиться знову і, якщо значення повернулось, пише «в нормі».
Останні звернення до адрес
Сюди потрапляє кожен запит, зокрема з невідомим ключем. Якщо тут порожньо — прилад не достукався до порталу взагалі: перевірте мережу, адресу і порт.
Новий прилад
Одиниці виміру
Якщо числа на порталі відрізняються від екрана приладу рівно в 1000 разів — прилад шле кіловольти або кілоампери. Поставте множник 1000 для відповідного показника.
Показувати блок стану мережіяк погода і тривоги
Коментарі в усіх розділах
Хто написав, з якої квартири, з якої адреси і коли. Приховані не видаляються — вони лишаються тут із позначкою і повертаються тією ж кнопкою.
Зміни карток мешканців
Кожна правка картки власника чи квартиранта лягає окремим записом: видно, що було до неї і хто змінював. Нічого не видаляється.
Розділи і доступ
Для кожного розділу вказано право, яке його відкриває. Винятки сильніші за право: можна відкрити або закрити розділ цілій групі чи окремій людині. Ці самі правила діють і в Telegram-боті.
Датчики
Датчик — сутність будинку: дим, затоплення, температура. Його можна прив'язати одразу до кількох місць. Дані приходять на власну адресу з ключем.
Підключення Tuya
Два способи: через застосунок Tuya Smart або Smart Life (без проєкту на iot.tuya.com) і через проєкт з Access ID. Підключень може бути кілька. Які поля приладу зберігати і за якими будувати графік — обирається в картці датчика.
Проєкт на iot.tuya.com і передплата IoT Core не потрібні.
Код користувача — у застосунку Tuya Smart або Smart Life: вкладка «Я» (Profile) → Налаштування → Код користувача.
Client id і schema — у застосунку їх немає: це дані застосунку-клієнта, через який іде вхід. Якщо у вас працює Home Assistant, візьміть його значення:
grep -E "TUYA_CLIENT_ID|TUYA_SCHEMA" /usr/src/homeassistant/homeassistant/components/tuya/const.py
(у Docker — через docker exec homeassistant …).
QR сканується в тому самому застосунку: вкладка «Я» → значок сканера вгорі праворуч.
Види датчиків
Новий датчик
Саме це побачать мешканці в розділі «Датчики будинку» і в боті. Коди розрізу лишаються тут, в адмініструванні.
Клацайте по розрізу: квартири і службові приміщення додаються й прибираються. Можна обрати кілька місць одразу.
Поля приладу
Прилад шле багато службових полів. Оберіть, які зберігати, як їх називати і за якими будувати графік у розділі «Датчики будинку».
Сценарії сповіщень
Коли спрацювати, в який період і кому написати. Повідомлення надсилається один раз на перехід умови; доки значення лишається за межею, портал мовчить.
Новий сценарій
Джерело і умова
Коли діє
Кому
Підстановки: {time}, {date}, {value}, {unit}, {sensor}, {place}. Перший рядок стає заголовком.
0 — без обмеження
Повідомляти, коли значення повернулось у норму
Аварійний сценарійнадсилається попри нічне мовчання і обмеження частоти
Системне сповіщеннямешканець не зможе його вимкнути
Сценарій увімкнено
Нічне мовчання
У ці проміжки бот мовчить, а повідомлення не зникають: портал надсилає їх, щойно тиша скінчиться. Проміжків може бути кілька. Аварійні сценарії тишу ігнорують.
Журнал спрацювань
Порядок розділів у меню
Стрілками змініть порядок, перемикачем приховайте розділ від усіх мешканців.
Функціональні розділи
Зовнішні заявки: контакт-центр 1551
Портал забирає звернення мешканців нашого будинку з публічного API київського 1551 і показує їх у розділі «Заявки». Нічого там не змінює — лише дзеркалить, разом зі світлинами. Звернення шукаються за координатами будинку, тому зайві сусідні відсіюються звіркою адреси.
Показувати заявки 1551забирати їх щогодини і показувати мешканцям у розділі «Заявки»
Коли оновлювати
Годин може бути скільки завгодно: портал оновить звернення щойно настане чергова. Зручно, коли треба мати свіжі дані зранку і ввечері, а решту доби чужий сервіс не смикати.
Рамка 0.0002 — це приблизно 20 метрів навколо точки. Якщо звернень знаходиться замало, збільшіть її до 0.0005; якщо лізуть сусідні будинки — зменшіть. Координати можна взяти з OpenStreetMap.
Зберігати світлини до себена чужому сервері вони з часом зникають
Звернення за дзвінком
Це головне джерело переліку звернень. Мапа 1551 колись віддавала перелік звернень у точці будинку, а тепер — лише кластер із лічильником («169»), без жодного номера. Дістати звернення з мапи неможливо, тому портал бере перелік із відкритих даних міста, а внутрішній номер кожного звернення з'ясовує пошуком на сайті — і далі вже тягне картку, історію та світлини як завжди.
На сайті 1551 видно лише те, що подали через сайт чи застосунок. Продиктоване оператору по телефону туди не потрапляє зовсім — зате є у відкритих даних міста (data.1551.gov.ua). Портал читає їх окремо, бере тільки записи зі способом подання «Дзвінок в 1551» за нашою адресою і позначає такі звернення в переліку. Світлин і дати закриття у відкритих даних немає; час зміни стану портал фіксує сам, щойно побачить інший стан.
Забирати звернення за дзвінкомз відкритих даних міста, поруч із рештою звернень
Тільки звернення за дзвінкомтипово вимкнено: без відкритих даних нові звернення з сайту до порталу не потраплять
Файл місяця — на все місто, тож прохід триває хвилини; дані оновлюються щоночі, частіше ходити немає сенсу.
Картку кожного
звернення портал питає один раз — звідти беруться світлини, історія
станів і фактичні дати виконання та закриття. «Перечитати картки»
змушує опитати їх заново, якщо 1551 дописав дати до старих звернень.
Служби, до яких подають заявки
Внутрішні служби (сантехнік, електрик, двірник) можна зробити доступними і за керуючої компанії — поле «Доступна за».
Код
Назва
Тип
Телефон
Доступна за
Стан
Нова служба
Пошта
Власний сервер
STARTTLS
Резерв: Gmail
Використовувати резервнадсилати через Gmail замість власного сервера
Черга повідомлень
Реєстрація нових мешканців
Дозволити самостійну реєстраціювимкнено — форма реєстрації зникає зі сторінки входу, облікові записи заводить лише адміністратор
З однієї мережі можна підтвердити не більше трьох різних поштових адрес на добу. Посилання з листа живе три хвилини.
Заблоковані облікові записи
Бан-лист
Адреси і поштові скриньки, яким закрито доступ. Адреса блокується автоматично після 15 невдалих спроб за 30 хвилин.
Аудиторії
Кому можна адресувати оголошення: поверх, стояк, тип квартири, роль або довільний список на кшталт власників тварин.
Нова аудиторія
Оберіть аудиторію зі списку.
Категорії календаря
Групи визначають, хто подає події категорії. Понад це право видається або відбирається окремій людині на вкладці «Права» — там ці категорії є окремими рядками.
Нова категорія
Журнал дій мешканців
Заявки, скарги, показання, картки, оголошення — з фільтром за мешканцем і квартирою.