commit 8c5b0950709fb2f66748b3a0846ed799670b0a1a7371eb5669865f2a31af8804
Author: admin <sysop200@bk.ru>
Date:   Fri Oct 23 17:48:13 2026 +0000

    Добавить readme.md

diff --git a/readme.md b/readme.md
new file mode 100644
index 0000000..fb63cc1
--- /dev/null
+++ b/readme.md
@@ -0,0 +1,84 @@
+
+---
+
+### Этап 1. Доработка функционала карты и связка с данными
+
+1. **Вынос реестра данных по участкам из JS в отдельный JSON / MODX:**
+* Сейчас массив должников жестко зашит в `debtPlots` в скрипте.
+* Вынесем структуру в отдельный файл или динамический ресурс MODX (JSON), где для каждого участка будут храниться: статус оплаты (долг/оплачено), сумма задолженности, площадь (сотки), кадастровый номер и отметка «Продается» (если актуально).
+
+
+2. **Обогащение всплывающего окна (Popup):**
+* Добавление точной информации: улица (1-я Дачная, Окружная и т.д.), площадь, сумма взноса или задолженности.
+* Кнопка прямого действия в попапе: «Оплатить взнос онлайн» (с переходом к реквизитам/QR-коду) или «Связаться с владельцем» (для участков на продаже).
+
+
+3. **Фильтры слоев над картой:**
+* Кнопки-переключатели под поисковой строкой: `Все участки`, `Должники` (подсвечивает только долги), `Инфраструктура` (шлагбаум, КТП-1, мусорные площадки).
+
+
+
+---
+
+### Этап 2. Раздел «Наши платежи и Должники»
+
+1. Страница «Наши должники» с обратной связью на карту:
+
+
+* Таблица с номерами участков и суммами долга в едином академическом стиле `article.css`.
+* При клике на номер участка в таблице происходит автоматический переход на главную страницу, карта плавно центрируется на этом участке и открывает карточку.
+
+
+2. **Генератор квитанций и QR-кода для оплаты (СБП):**
+* Размещение на странице реквизитов динамического QR-кода стандарта ГОСТ (для Сбербанк Онлайн / Т-Банк), в который уже «зашиты» расчетный счет СНТ, БИК, ИНН и поле для ввода номера участка садоводом.
+
+
+
+---
+
+### Этап 3. Разделы документов и протоколов общего собрания
+
+1. Реестр документов («Правовые документы», «Протоколы собраний», «Заявления»):
+
+
+* Оформление списков файлов в виде аккуратных карточек документов с кнопками «Просмотр» (открывает встроенное PDF-модальное окно) и «Скачать».
+* Шаблоны заявлений для садоводов (на вступление в члены, смена собственника, справка об отсутствии задолженности).
+
+
+
+
+2. Раздел «Электроэнергия / МОЭСК»:
+
+
+* Памятка по прямым договорам, показаниям счетчиков и переходу сетей товарищества.
+
+
+
+
+
+---
+
+### Этап 4. Доработка главной страницы и мобильная адаптивность
+
+1. Сайдбар «Быстрые действия» (`[[$sidebar.quick-actions]]`):
+
+
+* Привязка рабочих ссылок к кнопкам оплаты, вызова аварийной службы/электрика и реквизитов.
+
+
+
+
+2. Информационная строка оповещений (`alert-strip`):
+
+
+* Настройка вывода срочных уведомлений правления (например, отключение электричества, грейдирование дорог) через TV-параметр `is_alert`.
+
+
+
+
+3. **Тестирование UX на смартфонах:**
+* Проверка жестов pinch-to-zoom на карте в мобильных браузерах и кликабельности номеров участков пальцем.
+
+
+
+---