Карта мережі

Інтерактивна карта (OpenStreetMap або Google) для нанесення фізичної оптичної мережі: відрізки кабелю (ламані лінії) та точкові елементи — муфти, бокси, дільники, інше. Усе зберігається в базі й доступне для перегляду та редагування.

Доступ: адміністратор, менеджер, комірник, інсталятор, майстер, директор (перегляд+редагування); спостерігач (тільки перегляд).

Інтерфейс

• Поле пошуку адреси (зверху) — введіть адресу; за вибором підказки карта центрується на знайденій точці й наближається. Пошук використовує той самий реєстр адрес, що й решта системи (Visicom).
• Перемикач провайдера карти (зверху, праворуч від пошуку) — OpenStreetMap (за замовчуванням, без ключа) або Google. Вибір запам'ятовується.
• Карта — перетягування, зум колесом/кнопками + / −.
• Панель інструментів (зліва на карті) — режими малювання та редагування.

Який провайдер обрати

OpenStreetMap працює одразу, без ключа й білінгу — рекомендований за замовчуванням. Google доступний як опція й потребує ключа VITE_GOOGLE_MAPS_KEY. Геометрія та об'єкти спільні — від вибору провайдера залежить лише підкладка карти.

Панель інструментів

Іконка	Режим	Дія
Рука	Переміщення / вибір	Панорамування; клік по об'єкту відкриває його картку для редагування
Кабель	Кабель	Малювання відрізка кабелю ламаною лінією
Муфта (іконка)	Муфта	Поставити точку-муфту
Бокс (іконка)	Бокс	Поставити точку-бокс
Розгалуження	Дільник	Поставити точку-дільник
Фігури	Інше	Поставити інший елемент
Шестикутник	Території	Дропдаун: Створити територію (полігон) та Редагувати будинки (потрібне право керування)
Кошик	Видалення	Клік по об'єкту видаляє його

Малювання кабелю

1. Оберіть інструмент Кабель. Через каретку (›) на кнопці кабелю відкривається стиль лінії: тип (суцільна / пунктир), товщина, колір — обраний стиль одразу видно на чернетці й він зберігається на кабелі.
2. Клікайте по карті — кожен клік додає вершину ламаної. Лінія підсвічується пунктиром.
3. Коли потрібно завершити, у нижній панелі натисніть Завершити (доступно від 2 точок). Скасувати або клавіша Esc — очистити чернетку.
4. У вікні Новий кабель заповніть:
   • Маркування — підпис кабелю (напр. ОК-8).
   • Кількість волокон.
   • Реальна довжина, м (із запасами) — попередньо підставляється геометрична довжина ламаної; скоригуйте з урахуванням запасів.
5. Натисніть Зберегти.

Зберігаються координати всіх точок лінії та атрибути.

Точкові елементи

1. Оберіть інструмент потрібного типу (Муфта / Бокс / Дільник / Інше).
2. Клікніть по карті в потрібному місці.
3. У вікні вкажіть Тип, Назву / маркування та за потреби Примітки.
4. Натисніть Зберегти.

Кожен елемент позначається на карті кольоровим пін-маркером з власною іконкою типу (муфта / бокс / дільник / інше), тож типи легко розрізнити з першого погляду.

Фільтр маркерів

У верхньому ряду керування (поряд із перемикачем Покриття) є чіпи-фільтри для кожного типу елемента — Муфта / Бокс / Дільник / Інше:

• На кожному чіпі — іконка типу, назва та кількість елементів цього типу на карті.
• Клік по чіпу вмикає/вимикає показ маркерів цього типу; активний чіп підсвічується кольором свого типу. Вимкнені типи лишаються в базі — ховається лише відображення.

Кольори будинків

• 🟢 Зелений — будинок забудований (є хоч одне погоджене встановлення матеріалу).
• 🟡 Жовтий — будинок у межах території, але ще не забудований (запланований).

Карта покриття

На карті зеленими маркерами підсвічуються будинки, на які встановлено хоч одну позицію матеріалу. Джерело — погоджені документи «Встановлення на об'єкт» (СП).

• Перемикач Покриття (зверху, ліворуч від вибору провайдера) вмикає/вимикає шар. У підписі — кількість будинків покриття.
• Наведення на маркер показує адресу й кількість позицій.
• Клік по будинку наближає карту до нього та відкриває меню з підсумком (позицій · кількість) і пунктом «Деталі — матеріали».
• Пункт «Деталі — матеріали» відкриває окрему сторінку об'єкта зі списком встановлень: матеріал, кількість, монтажник, дата, документ.

Звідки координати

Будинок зʼявляється на карті, якщо у його адреси є координати. Адреси з реєстру (Visicom) отримують координати автоматично; демо-адреси геокодовані наперед.

Кластеризація

Щоб карта не гальмувала на великій кількості точок, маркери групуються в кластери залежно від зуму (окремо будинки покриття й елементи мережі). Кластер показує кількість обʼєктів; клік по ньому або наближення розгортає його на окремі маркери.

Території (зони обслуговування)

Інструмент «Територія» (доступний лише з правом керування) дозволяє обвести зону на карті:

1. У групі «Території» оберіть «Створити територію», клікайте по карті, щоб поставити вершини полігону (мін. 3).
2. Завершити → у вікні задайте назву й колір → Зберегти.
3. Площа заливається кольором; усі будинки в межі підтягуються з OpenStreetMap у наш реєстр адрес і стають членами території (навіть якщо ми там ще нічого не встановлювали — напр. нова забудова).
4. Тогл «Території» (у верхньому ряду) вмикає/вимикає шар.
5. Клік по полігону (режим «Переміщення / вибір») відкриває редагування назви/кольору; режим Видалення — прибирає територію.

Межа vs список адрес

Межа — це намальований полігон. Список адрес-членів редагується окремо (див. розділ Території в адмінці). Редагування списку не змінює межу; щоб змінити межу — перемалюйте полігон.

Детальніше про склад адрес і персонал — Території.

Редагування будинків на карті

У групі «Території» (каретка ›) оберіть «Редагувати будинки» — режим виправляє неточності геокодування прямо на карті:

• Перемістити — перетягніть мітку будинку в правильне місце; нові координати зберігаються одразу.
• Видалити — клік по мітці → у поповері кнопка «Видалити будинок». Якщо на адресі немає встановлень — її видаляють повністю; якщо є — лише прибирають з території (адреса лишається в реєстрі).
• Додати — клік по порожньому місцю: адресу буде підставлено за точкою (Visicom reverse-geocode, можна підправити) і додано в реєстр та у території, що містять цю точку.

Зум для редагування

У цьому режимі мітки не кластеризуються — наближтесь, щоб зручно перетягувати окремі будинки.

Редагування та видалення

• Редагувати — у режимі Переміщення / вибір клікніть по кабелю або елементу: відкриється його картка з полями. Змініть значення → Зберегти.
• Видалити — або кнопкою Видалити в картці об'єкта, або інструментом Видалення з подальшим кліком по об'єкту.

Ключ потрібен лише для Google

Режим Google працює за наявності ключа VITE_GOOGLE_MAPS_KEY (Maps JavaScript API). Якщо ключ не задано — перемикач Google показує підказку, а карта залишається доступною в режимі OpenStreetMap.