Мониторинг земель

Веб-приложение для мониторинга земель на основе картографических данных. Приложение предоставляет интерактивную карту с возможностью просмотра различных слоев данных о земельных ресурсах, систему заявок на услуги и документооборот.

📋 Содержание

• 🔧 Требования к окружению
• 🚀 Функциональность
• 🛠️ Технологии
• 🏗️ Архитектура
• ⚡ Установка и запуск
• 🔌 API Endpoints
• 🗄️ База данных
• 👥 Система ролей
• 🌍 Локализация
• 🗜️ Gzip сжатие
• 🛠️ Разработка
• 🧪 Тестирование
• 🔧 Устранение неполадок
• 🔄 Миграция на ArcGIS Server
• 🚀 Деплой
• 🪟 Развертывание на Windows
• 📋 История версий
• 📞 Контакты

🔧 Требования к окружению

💻 Системные требования

• ОС: Linux (Ubuntu 18.04+), macOS 10.15+, Windows 10+
• Python: 3.8 или выше
• PostgreSQL: 12 или выше
• RAM: минимум 2GB, рекомендуется 4GB+
• Дисковое пространство: минимум 1GB свободного места

🌐 Сетевые требования

• Доступ к интернету для загрузки зависимостей
• Доступ к геосерверам (локальный и глобальный)
• Открытый порт 8080 для веб-интерфейса

🚀 Функциональность

🗺️ Картографическая система

• Интерактивная карта: Отображение картографических данных с использованием Leaflet.js и ESRI Leaflet
• Многослойность: Поддержка различных слоев (границы областей, почвенные карты, геоботанические карты, земельные участки)
• Поиск по кадастровому номеру: Быстрый поиск земельных участков по кадастровому номеру с визуализацией на карте
  • Интерактивный интерфейс поиска с автоматической подсветкой найденных участков
  • Модальное окно с детальными атрибутами участка (площадь, адрес, назначение и др.)
  • Автоматическое центрирование карты на найденном участке
  • Поддержка всех типов геометрии (Point, LineString, Polygon, MultiPolygon)
  • Интеграция с ЕГКН (Единый государственный кадастр недвижимости)
• Поиск: Поиск по областям, районам и наименованиям
• Базовые карты: Поддержка различных базовых карт (Google Maps, Bing Maps, OSM)
• Настройка прозрачности: Регулировка прозрачности слоев
• Автоматическое переключение геосерверов: Отказоустойчивость при недоступности серверов
• ArcGIS Server интеграция: Поддержка ArcGIS REST API для улучшенной производительности
• Динамические слои: Автоматическое получение метаданных и легенд слоев
• Оптимизированные запросы: Кэширование и оптимизация запросов к серверу
• REST API интеграция: Прямое подключение к ArcGIS Server через REST API
• Динамические слои: Автоматическое получение метаданных и управление видимостью слоев
• Тестирование сервисов: Страница /test для просмотра списка сервисов ArcGIS с измерением времени загрузки
• ОЦСК сервисы: Интеграция с ОЦСК (Открывая цифровая сельскохозяйственна карта) сервисами
  • Маршрут /ocsk-services для получения списка ОЦСК сервисов из JSON файла
  • Отображение ОЦСК сервисов на карте с элементами управления
  • Панель агрохимии с настройками для работы с ОЦСК данными
  • Интеграция с JavaScript модулем для управления ОЦСК сервисами

🔐 Система аутентификации и авторизации

• Аутентификация по ЭЦП: Система входа в приложение с использованием электронной цифровой подписи
• Управление сессиями: Flask-Session для безопасного хранения данных пользователей с настраиваемым временем жизни (3 часа по умолчанию)
• Роли пользователей: Система ролей (user, admin) с разграничением прав доступа
• История авторизаций: Отслеживание всех попыток входа/выхода пользователей
• Управление пользователями: Добавление, редактирование и удаление пользователей (для администраторов)

👤 Личный кабинет и настройки

• Настройки пользователей: Сохранение и загрузка персональных настроек (телефон, email)
• Личный кабинет: Управление заявками на услуги с реальными данными из БД
• Профиль пользователя: Просмотр и редактирование личной информации

📋 Система заявок и документооборота

• Создание заявок: Пошаговая форма создания заявок на услуги
• Управление заявками: Просмотр, редактирование и удаление заявок
• Детальный просмотр заявок: Модальное окно с полной информацией о заявке при клике на номер
• Статусы заявок: Отслеживание статуса выполнения заявок
• Документооборот: Прикрепление документов к заявкам с поддержкой различных форматов
• Фильтрация и поиск: Поиск заявок по различным критериям
• Права доступа: Разграничение прав на просмотр и управление заявками
• Уведомления о приеме заявок: Автоматическая генерация PDF уведомлений с QR-кодом для верификации

🏞️ Мои участки и отводы (в настройках)

• CRUD: добавление, редактирование, удаление записей
• Хранение: БД giprozem.user_plots (координаты в формате GeoJSON, JSONB)
• Права: доступно роли пользователя (00) и выше

🌍 Многоязычность и интерфейс

• Многоязычность: Поддержка русского и казахского языков
• Адаптивный дизайн: Современный интерфейс на основе Bootstrap 5
• Уведомления: Система уведомлений для пользователей
• Модальные окна: Интерактивные диалоги для различных операций
  • в т.ч. модалка редактирования участков с валидацией

📊 Система логирования и мониторинга

• Детальное логирование: Логирование всех операций в файл и консоль
• Мониторинг геосерверов: Автоматическая проверка доступности серверов
• Отслеживание ошибок: Логирование ошибок и исключений
• Логирование действий пользователей: Отслеживание всех действий пользователей с фильтрацией и экспортом
• Системные логи: Просмотр, скачивание и управление лог файлами системы
  • Ротация файлов: до 5 файлов, каждый не более 1 МБ
  • Просмотр содержимого лог файлов в веб-интерфейсе
  • Скачивание отдельных файлов и архива всех логов
  • Информация о размере, дате изменения и количестве строк

📈 Экспорт данных

• Экспорт в Excel: Функционал экспорта данных земельных участков в формат Excel
  • Маршрут /export/zu-excel для экспорта результатов поиска участков
  • Автоматическое форматирование данных для Excel с сохранением структуры
  • Интеграция с модулем поиска для экспорта найденных участков
  • Кнопка экспорта в модальном окне результатов поиска
  • Поддержка экспорта атрибутов участков (кадастровый номер, площадь, адрес и др.)

🛠️ Технологии

⚙️ Серверная часть

• Python 3.8+
• Flask 2.3.3 - веб-фреймворк
• Flask-Session 0.5.0 - управление сессиями пользователей
• Flask-Compress 1.14 - gzip сжатие статических файлов и API ответов
• PostgreSQL 12+ - база данных
• psycopg2-binary 2.9.7 - драйвер для PostgreSQL
• Requests 2.31.0 - HTTP клиент для проксирования запросов (GeoServer + ArcGIS Server)
• cryptography 41.0.7 - работа с сертификатами ЭЦП
• Flask-Babel 4.0.0 - локализация
• python-dotenv 1.0.0 - управление переменными окружения
• psycopg 3.x - современный драйвер PostgreSQL (используется в коде)

🎨 Клиентская часть

• HTML5/CSS3 - разметка и стили
• Bootstrap 5 - UI фреймворк
• Leaflet.js - библиотека для интерактивных карт
• ESRI Leaflet v2.1.4 - интеграция с ArcGIS Server (REST API, Dynamic Map Layers)
• jQuery - JavaScript библиотека
• Bootstrap Icons - иконки
• ES6 Modules - модульная система JavaScript
• Proj4js - проекции координат
• Turf.js - геопространственные вычисления

🏗️ Архитектура

🔧 Модульная архитектура backend (Flask)

Бэкенд разделён на модули с четким разделением ответственности:

Структура приложения

• app.py — точка входа Flask, использует create_app()
• app/__init__.py — фабрика create_app(): конфигурация, Babel, регистрация блюпринтов
• app/logging_setup.py — настройка логирования с ротацией файлов
• app/extensions.py — объявления экстеншенов (babel)
• app/i18n.py — выбор локали пользователя

Blueprints (маршруты)

• app/blueprints/public.py — публичные маршруты: GET /
• app/blueprints/proxy.py — проксирование запросов: GET /Proxy/Wms, GET /Proxy/Wfs, GET /Proxy/Map/*
• app/blueprints/account.py — аутентификация: POST /Account/Login, GET /Account/Logout
• app/blueprints/api.py — REST API: настройки, заявки, документы, справочники, пользователи

Сервисы и репозитории

• app/services/certificates.py — работа с сертификатами ЭЦП
• app/repositories/database_manager.py — слой доступа к данным, управление БД
  • автоматически гарантирует наличие ключевых таблиц/индексов (в т.ч. giprozem.user_plots, индексы логов)

🎯 Модульная архитектура фронтенда (ES Modules)

Реализована современная модульная система для JavaScript:

Структура JavaScript

• static/js/app.js — точка входа ES-модуля, инициализация всех UI-модулей
• static/js/notifications.js — модуль уведомлений
• static/js/map.js — картографический функционал (Leaflet + ESRI Leaflet, ArcGIS Server интеграция)
• static/js/modules/ — функциональные модули:
  • auth.js — авторизация и управление сессиями
  • documents.js — загрузка и управление документами
  • geojson.js — работа с GeoJSON данными
  • language.js — смена языка интерфейса
  • menu.js — обработчики меню
  • modals.js — жизненный цикл модальных окон
  • orders.js — создание заявок на услуги
  • personal.js — личный кабинет и управление пользователями
  • requests.js — управление заявками и фильтрация
  • request-details.js — просмотр детальной информации о заявках
  • search.js — поиск земельных участков по кадастровому номеру
  • services.js — загрузка справочников
  • settings.js — настройки пользователя
  • validators.js — валидация форм

Подключение в HTML

• ES-модули подключаются через type="module"
• Обратная совместимость с legacy кодом через экспорт в window
• Единая точка входа через app.js

⚡ Установка и запуск

📋 Требования

• Python 3.8 или выше
• PostgreSQL 12+
• pip (менеджер пакетов Python)
• psycopg2-binary (драйвер PostgreSQL)
• Виртуальное окружение Python (venv)

🔧 Установка

1. Клонируйте репозиторий:

git clone <repository-url>
cd LandMonitoring

2. Создайте виртуальное окружение:

python3 -m venv venv
source venv/bin/activate  # На Windows: venv\Scripts\activate

3. Установите зависимости:

pip install -r requirements.txt

Примечание: Если возникают проблемы с установкой psycopg2-binary, установите системные зависимости:

# Ubuntu/Debian
sudo apt-get install python3-dev libpq-dev

# macOS
brew install postgresql

# CentOS/RHEL
sudo yum install python3-devel postgresql-devel

4. Настройте базу данных PostgreSQL:

Важно: Убедитесь, что PostgreSQL запущен и доступен:

# Проверка статуса PostgreSQL
sudo systemctl status postgresql

# Запуск PostgreSQL (если не запущен)
sudo systemctl start postgresql

-- Создайте схему giprozem
CREATE SCHEMA IF NOT EXISTS giprozem;

-- Таблица настроек пользователей
CREATE TABLE IF NOT EXISTS giprozem.user_settings (
    iin VARCHAR(12) PRIMARY KEY,
    phone VARCHAR(20),
    email VARCHAR(100),
    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
    updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);

-- Таблица истории авторизаций
CREATE TABLE IF NOT EXISTS giprozem.auth_history (
    id SERIAL PRIMARY KEY,
    iin VARCHAR(12) NOT NULL,
    fio VARCHAR(200),
    login_time TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
    logout_time TIMESTAMP,
    ip_address INET,
    user_agent TEXT,
    success BOOLEAN DEFAULT TRUE,
    error_message TEXT
);

-- Таблица ролей (справочник)
CREATE TABLE IF NOT EXISTS giprozem.roles (
    role_code VARCHAR(10) PRIMARY KEY,
    name_ru VARCHAR(100) NOT NULL,
    name_kk VARCHAR(100) NOT NULL
);

-- Наполнение ролей (без дубликатов)
INSERT INTO giprozem.roles (role_code, name_ru, name_kk) VALUES
('00','Пользователь','Пайдаланушы'),
('01','Исполнитель','Орындаушы'),
('02','Канцелярия','Кеңсе'),
('03','Руководитель','Басшы'),
('99','Администратор','Әкімші')
ON CONFLICT (role_code) DO NOTHING;

-- Таблица ролей пользователей (многие-ко-многим)
CREATE TABLE IF NOT EXISTS giprozem.user_roles (
    iin VARCHAR(12) NOT NULL,
    role_code VARCHAR(10) NOT NULL
);

-- Таблица услуг
CREATE TABLE IF NOT EXISTS giprozem.services (
    id SERIAL PRIMARY KEY,
    code VARCHAR(10) UNIQUE NOT NULL,
    name_ru VARCHAR(200) NOT NULL,
    name_kk VARCHAR(200) NOT NULL,
    description_ru TEXT,
    description_kk TEXT,
    price DECIMAL(10,2) DEFAULT 0.00,
    duration_days INTEGER DEFAULT 30,
    is_active BOOLEAN DEFAULT TRUE
);

-- Таблица статусов заявок
CREATE TABLE IF NOT EXISTS giprozem.request_statuses (
    id SERIAL PRIMARY KEY,
    code VARCHAR(10) UNIQUE NOT NULL,
    name_ru VARCHAR(100) NOT NULL,
    name_kk VARCHAR(100) NOT NULL,
    color VARCHAR(20) DEFAULT '#007bff'
);

-- Таблица заявок
CREATE TABLE IF NOT EXISTS giprozem.requests (
    id SERIAL PRIMARY KEY,
    request_number VARCHAR(30) UNIQUE NOT NULL,
    user_iin VARCHAR(12) NOT NULL,
    service_id INTEGER REFERENCES giprozem.services(id),
    status_id INTEGER REFERENCES giprozem.request_statuses(id),
    title VARCHAR(200) NOT NULL,
    description TEXT,
    address TEXT,
    coordinates JSONB,
    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
    updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
    completed_at TIMESTAMP
);

-- Таблица документов (хранение бинарных данных файла)
CREATE TABLE IF NOT EXISTS giprozem.documents (
    id SERIAL PRIMARY KEY,
    request_id INTEGER REFERENCES giprozem.requests(id) ON DELETE CASCADE,
    filename VARCHAR(255) NOT NULL,
    original_filename VARCHAR(255) NOT NULL,
    file_data BYTEA NOT NULL,
    file_size BIGINT NOT NULL,
    mime_type VARCHAR(100),
    description VARCHAR(500),
    uploaded_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
    uploaded_by VARCHAR(12) NOT NULL
);

-- Таблица последовательности номеров заявок
CREATE TABLE IF NOT EXISTS giprozem.request_number_sequence (
    service_code VARCHAR(10) NOT NULL,
    date_part VARCHAR(6) NOT NULL,
    last_sequence INTEGER NOT NULL DEFAULT 0,
    updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);

-- Таблица участков пользователя (вкладка "Мои участки и отводы")
CREATE TABLE IF NOT EXISTS giprozem.user_plots (
    id SERIAL PRIMARY KEY,
    user_iin VARCHAR(12) NOT NULL,
    name TEXT NOT NULL,
    location TEXT,
    cadastral_number VARCHAR(20),
    egkn_id VARCHAR(20),
    coordinates JSONB,
    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
    updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);

-- Журнал действий пользователей
CREATE TABLE IF NOT EXISTS giprozem.user_activity_logs (
    id SERIAL PRIMARY KEY,
    user_iin VARCHAR(12) NOT NULL,
    action_type VARCHAR(50) NOT NULL,
    action_description TEXT,
    resource_type VARCHAR(50),
    resource_id VARCHAR(100),
    ip_address INET,
    user_agent TEXT,
    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
    additional_data JSONB
);

-- Индексы для оптимизации
CREATE INDEX IF NOT EXISTS idx_auth_history_iin ON giprozem.auth_history(iin);
CREATE INDEX IF NOT EXISTS idx_auth_history_login_time ON giprozem.auth_history(login_time);
CREATE INDEX IF NOT EXISTS idx_requests_user_iin ON giprozem.requests(user_iin);
CREATE INDEX IF NOT EXISTS idx_requests_status_id ON giprozem.requests(status_id);
CREATE INDEX IF NOT EXISTS idx_documents_request_id ON giprozem.documents(request_id);
CREATE UNIQUE INDEX IF NOT EXISTS ux_user_roles_iin_role ON giprozem.user_roles (iin, role_code);
CREATE UNIQUE INDEX IF NOT EXISTS ux_reqnum_seq_service_date ON giprozem.request_number_sequence (service_code, date_part);
CREATE INDEX IF NOT EXISTS idx_user_plots_user_iin ON giprozem.user_plots (user_iin);
CREATE INDEX IF NOT EXISTS idx_user_activity_logs_user_iin ON giprozem.user_activity_logs (user_iin);
CREATE INDEX IF NOT EXISTS idx_user_activity_logs_created_at ON giprozem.user_activity_logs (created_at);
CREATE INDEX IF NOT EXISTS idx_user_activity_logs_action_type ON giprozem.user_activity_logs (action_type);

🚀 Запуск

1. Активируйте виртуальное окружение (если не активировано):

source venv/bin/activate  # На Windows: venv\Scripts\activate

Проверка активации: В начале командной строки должно появиться (venv).

2. Настройте подключение к БД в файле config.env:

# Настройки базы данных PostgreSQL
DATABASE_HOST=192.168.1.100
DATABASE_PORT=5432
DATABASE_NAME=db
DATABASE_USER=postgres
DATABASE_PASSWORD=your_password
DATABASE_SCHEMA=giprozem

# ArcGIS Server URL
ARCGIS_SERV_URL=https://178.89.0.228:56443/arcgis/rest/services

# Геосервер - локальный доступ
GEOSERVER_LOCAL_URL=http://192.168.1.253:8080/geoserver
# Геосервер - глобальный доступ
GEOSERVER_GLOBAL_URL=http://178.89.245.2:8887/geoserver

# Настройки Flask
SECRET_KEY=your-super-secret-key-change-this-in-production
DEBUG=True
HOST=0.0.0.0
PORT=8080

# Настройки аутентификации
SESSION_TIMEOUT=3600

# Настройки логирования
LOG_LEVEL=INFO
LOG_FILE=app.log

# Настройки прокси
PROXY_TIMEOUT=30
PROXY_VERIFY_SSL=False

# Настройки карты (координаты центра Казахстана)
DEFAULT_MAP_CENTER_LAT=48.0196
DEFAULT_MAP_CENTER_LON=66.9237
DEFAULT_MAP_ZOOM=6

# Лимиты документов
MAX_DOCUMENTS_PER_REQUEST=10
MAX_DOCUMENT_SIZE_MB=10

3. Скомпилируйте переводы:

python compile_translations.py

4. Запустите приложение:

python3 app.py

Проверка запуска: В консоли должны появиться сообщения о запуске Flask и выборе геосервера.

5. Откройте браузер и перейдите по адресу:

http://localhost:8080

✅ Проверка установки

После запуска приложения проверьте:

1. Доступность веб-интерфейса:

   curl -I http://localhost:8080
   

2. Статус геосервера:

   curl http://localhost:8080/api/geoserver/status
   

3. Проверка ArcGIS Server:

   curl -I "http://localhost:8080/Proxy/Map/Kaz/MapServer?f=json"
   

4. Подключение к БД:

   • Проверьте логи в logs/app.log
   • Должны быть сообщения о подключении к БД

5. Проверка зависимостей:

   pip list | grep -E "(Flask|psycopg|requests|cryptography)"
   

📁 Структура проекта

LandMonitoring/
├── app.py                        # Точка входа Flask
├── run_server.py                 # Альтернативный запуск сервера
├── app/                          # Пакет приложения (бэкенд модули)
│   ├── __init__.py               # create_app(): конфиг, Babel, блюпринты
│   ├── logging_setup.py          # настройка логирования
│   ├── extensions.py             # экстеншены (babel)
│   ├── i18n.py                   # выбор локали
│   ├── blueprints/
│   │   ├── public.py             # GET /
│   │   ├── proxy.py              # GET /Proxy/Wms, GET /Proxy/Wfs, GET /Proxy/Map/*
│   │   ├── account.py            # POST /Account/Login, GET /Account/Logout
│   │   ├── api.py                # REST API (настройки, заявки, документы, справочники)
│   │   └── egkn.py               # GET /get-zu/<kad_nomer> - поиск по ЕГКН
│   ├── services/
│   │   ├── certificates.py       # CertificateWorker - работа с ЭЦП
│   │   ├── notifications.py     # NotificationService - генерация PDF уведомлений
│   │   ├── arcgis.py            # ArcGISService - работа с ArcGIS REST API
│   │   └── coordinates_parser.py # Парсинг координат
│   └── repositories/
│       └── database_manager.py   # DatabaseManager - слой доступа к данным
├── config.py                     # Конфигурация приложения
├── config.env                    # Переменные окружения
├── compile_translations.py       # Компиляция переводов
├── babel.cfg                     # Конфигурация Babel
├── requirements.txt              # Зависимости Python
├── README.md                     # Документация проекта
├── DEPLOYMENT.md                 # Инструкции по деплою
├── docker.md                     # Документация по Docker
├── IMPORT_FEATURES.md            # Документация по импорту функций
├── PyArmor.md                    # Документация по защите кода
├── windows.md                    # Инструкция развертывания на Windows
├── LICENSE                       # Лицензия проекта
├── Dockerfile                    # Docker образ приложения
├── compose.yaml                  # Docker Compose конфигурация
├── static/
│   ├── css/
│   │   ├── app.css
│   │   ├── map.css
│   │   └── notifications.css
│   ├── js/
│   │   ├── app.js                # Точка входа ES-модуля
│   │   ├── notifications.js      # Модуль уведомлений
│   │   ├── map.js                # Картографический функционал
│   │   ├── egkn_districts.json   # Справочник областей и районов для ЕГКН
│   │   ├── eds/
│   │   │   └── eds.js            # ЭЦП функционал
│   │   └── modules/              # Функциональные модули
│   │       ├── auth.js           # Авторизация и управление сессиями
│   │       ├── coordinates-import.js # Импорт координат
│   │       ├── coordinates-utils.js   # Утилиты для работы с координатами
│   │       ├── documents.js      # Загрузка и управление документами
│   │       ├── geojson.js        # Работа с GeoJSON данными
│   │       ├── language.js       # Смена языка интерфейса
│   │       ├── logging.js        # Модуль логирования действий пользователей
│   │       ├── menu.js           # Обработчики меню
│   │       ├── modals.js         # Жизненный цикл модальных окон
│   │       ├── order-map.js      # Карта в модалке создания заявки
│   │       ├── orders.js         # Создание заявок на услуги
│   │       ├── personal.js       # Личный кабинет и управление пользователями
│   │       ├── request-details.js # Просмотр детальной информации о заявках
│   │       ├── requests.js       # Управление заявками и фильтрация
│   │       ├── search.js         # Поиск земельных участков по кадастровому номеру
│   │       ├── services.js       # Загрузка справочников
│   │       ├── settings.js       # Настройки пользователя
│   │       ├── system-logs.js    # Работа с системными логами
│   │       └── validators.js     # Валидация форм
│   ├── data/
│   │   └── ocsk-services.json    # JSON файл с OCSK сервисами
│   ├── images/
│   │   └── logo.png
│   ├── icons/
│   │   └── bootstrap-icons/      # Bootstrap Icons
│   ├── favicon.ico               # Иконка сайта
│   └── lib/                      # Внешние библиотеки
│       ├── bootstrap/            # Bootstrap 5
│       ├── jquery/               # jQuery
│       ├── leaflet/              # Leaflet.js и плагины
│       ├── esri-leaflet-v2.1.4/  # ESRI Leaflet для ArcGIS
│       ├── proj4.js              # Проекции координат
│       ├── proj4leaflet.js       # Проекции для Leaflet
│       └── turf.min.js           # Геопространственные вычисления
├── templates/
│   ├── layouts/
│   │   └── base.html
│   ├── pages/
│   │   ├── index.html            # Главная страница
│   │   ├── test.html             # Страница тестирования ArcGIS сервисов
│   │   ├── testview.html         # Детальный просмотр сервиса
│   │   ├── license.html          # Страница лицензии
│   │   └── readme.html           # Страница README
│   ├── partials/
│   │   ├── navbar.html           # Навигационная панель
│   │   ├── footer.html           # Подвал страницы
│   │   ├── map_controls.html     # Элементы управления картой
│   │   ├── opacity_panel.html   # Панель прозрачности слоев
│   │   ├── personal_cabinet_button.html
│   │   └── toast.html            # Шаблон уведомлений
│   └── modals/
│       ├── agro_settings.html    # Настройки агрохимии
│       ├── confirm_delete.html   # Подтверждение удаления
│       ├── logging.html          # Логирование действий пользователей
│       ├── order_service.html    # Создание заявки на услугу
│       ├── personal_cabinet.html # Личный кабинет
│       ├── plots_edit.html       # Редактирование участков
│       ├── request_details.html # Детальный просмотр заявки
│       ├── requests.html         # Таблица заявок
│       ├── search_result.html    # Результаты поиска участков
│       ├── settings.html         # Настройки пользователя
│       ├── user_edit.html        # Редактирование пользователя
│       └── user_management.html  # Управление пользователями
└── translations/
    ├── messages.pot              # Шаблон переводов
    ├── ru/
    │   └── LC_MESSAGES/
    │       ├── messages.po        # Русские переводы
    │       └── messages.mo       # Скомпилированные переводы
    └── kk/
        └── LC_MESSAGES/
            ├── messages.po        # Казахские переводы
            └── messages.mo        # Скомпилированные переводы

🔌 API Endpoints

Основные маршруты

• GET / - Главная страница приложения
• GET /test - Страница просмотра сервисов ArcGIS с измерением времени загрузки
• GET /testview - Детальный просмотр конкретного сервиса ArcGIS
• GET /Proxy/Wms - Прокси для WMS запросов (GeoServer)
• GET /Proxy/Wfs - Прокси для WFS запросов (GeoServer)
• GET /Proxy/Map/<path:service_path> - Прокси для ArcGIS REST API запросов

API маршруты

• GET /api/search - Поиск областей и районов
• POST /api/login - Вход в систему
• GET /api/map/layers - Получение слоев карты
• GET /api/map/basemaps - Получение базовых карт
• GET /api/geoserver/status - Статус геосервера
• GET /Proxy/Map/* - Проксирование ArcGIS REST API запросов

API для участков (настройки)

• GET /api/settings/plots — список участков текущего пользователя
• POST /api/settings/plots — добавление участка
• PUT /api/settings/plots/<plot_id> — обновление участка
• DELETE /api/settings/plots/<plot_id> — удаление участка

API для настроек пользователей

• POST /api/settings/save - Сохранение настроек пользователя
• GET /api/settings/get - Получение настроек пользователя
• GET /api/auth/history - История авторизаций пользователя

API для заявок и документов

• GET /api/requests - Заявки пользователя (с поддержкой include_documents=true)
• GET /api/all-requests - Все заявки (с поддержкой include_documents=true)
• GET /api/services - Список услуг
• GET /api/request-statuses - Статусы заявок
• POST /api/requests/create - Создание новой заявки
• GET /api/document-limits - Лимиты документов
• POST /api/requests/<id>/documents - Загрузка документа
• GET /api/documents/<id> - Скачивание документа
• DELETE /api/requests/<id>/documents/<doc_id> - Удаление документа
• DELETE /api/requests/<id> - Удаление заявки

API для управления пользователями

• GET /api/users - Список всех пользователей
• GET /api/users/<iin> - Информация о пользователе
• POST /api/users - Добавление пользователя
• PUT /api/users/<iin> - Обновление пользователя
• DELETE /api/users/<iin> - Удаление пользователя
• GET /api/roles - Список ролей

API для авторизации

• POST /Account/Login - Авторизация по сертификату ЭЦП
• GET /Account/Logout - Выход из системы
• GET /api/auth/status - Статус авторизации

API для логов

• GET /api/logs — получение логов с фильтрами и пагинацией
• GET /api/logs/users/<iin> — логи по пользователю
• GET /api/logs/export — экспорт логов в CSV
• DELETE /api/logs/cleanup?days=<N> — очистка старых логов

API для системных логов

• GET /api/system-logs/files — получение списка системных лог файлов
• GET /api/system-logs/content/<filename> — просмотр содержимого лог файла
• GET /api/system-logs/download/<filename> — скачивание отдельного лог файла
• GET /api/system-logs/download-all — скачивание архива всех лог файлов

API для просмотра заявок

• GET /api/requests/<request_id>/details - Получение детальной информации о заявке

API для уведомлений о приеме заявок

• GET /api/download-notification/<request_id> - Скачивание PDF уведомления о приеме заявки
• GET /api/verify-notification/<request_number> - Верификация уведомления через QR-код (публичный доступ, использует номер заявки)
• GET /api/requests/<request_id>/notification-status - Проверка наличия уведомления для заявки

API для локализации

• POST /api/set_language - Смена языка интерфейса

API для ОЦСК сервисов

• GET /ocsk-services - Получение списка ОЦСК сервисов из JSON файла

API для экспорта данных

• GET /export/zu-excel - Экспорт данных земельных участков в формат Excel

🗄️ База данных

Схема giprozem

Таблица user_settings

Хранит настройки пользователей:

• iin (VARCHAR(12)) - ИИН пользователя (первичный ключ)
• phone (VARCHAR(20)) - Номер телефона
• email (VARCHAR(100)) - Email адрес
• created_at (TIMESTAMP) - Дата создания записи
• updated_at (TIMESTAMP) - Дата последнего обновления

Таблица auth_history

Хранит историю авторизаций:

• id (SERIAL) - Уникальный идентификатор
• iin (VARCHAR(12)) - ИИН пользователя
• fio (VARCHAR(200)) - ФИО пользователя
• login_time (TIMESTAMP) - Время входа
• logout_time (TIMESTAMP) - Время выхода
• ip_address (VARCHAR(45)) - IP адрес
• user_agent (TEXT) - User-Agent браузера
• success (BOOLEAN) - Успешность авторизации
• error_message (TEXT) - Сообщение об ошибке

Таблица user_roles

Роли пользователей:

• iin (VARCHAR(12)) - ИИН пользователя
• role_code (VARCHAR(10)) - Код роли (user, admin)

Таблица services

Справочник услуг:

• id (SERIAL) - Уникальный идентификатор
• code (VARCHAR(10)) - Код услуги
• name_ru (VARCHAR(200)) - Название на русском
• name_kk (VARCHAR(200)) - Название на казахском
• description_ru (TEXT) - Описание на русском
• description_kk (TEXT) - Описание на казахском
• price (DECIMAL(10,2)) - Стоимость услуги
• duration_days (INTEGER) - Срок выполнения в днях
• is_active (BOOLEAN) - Активность услуги

Таблица request_statuses

Статусы заявок:

• id (SERIAL) - Уникальный идентификатор
• code (VARCHAR(10)) - Код статуса
• name_ru (VARCHAR(100)) - Название на русском
• name_kk (VARCHAR(100)) - Название на казахском
• color (VARCHAR(20)) - Цвет для отображения

Таблица requests

Заявки пользователей:

• id (SERIAL) - Уникальный идентификатор
• request_number (VARCHAR(20)) - Номер заявки
• user_iin (VARCHAR(12)) - ИИН пользователя
• service_id (INTEGER) - ID услуги
• status_id (INTEGER) - ID статуса
• title (VARCHAR(200)) - Название заявки
• description (TEXT) - Описание
• address (TEXT) - Адрес объекта
• coordinates (JSONB) - Геометрия в формате GeoJSON
• created_at (TIMESTAMP) - Время создания
• updated_at (TIMESTAMP) - Время обновления
• completed_at (TIMESTAMP) - Время завершения
• notification_pdf (BYTEA) - PDF уведомление о приеме заявки
• notification_created_at (TIMESTAMP) - Время создания уведомления

Таблица documents

Документы заявок:

• id (SERIAL) - Уникальный идентификатор
• request_id (INTEGER) - ID заявки
• filename (VARCHAR(255)) - Имя файла в системе
• original_filename (VARCHAR(255)) - Оригинальное имя файла
• file_size (BIGINT) - Размер файла в байтах
• mime_type (VARCHAR(100)) - MIME-тип файла
• description (VARCHAR(500)) - Описание документа
• uploaded_at (TIMESTAMP) - Время загрузки
• uploaded_by (VARCHAR(12)) - ИИН загрузившего

Таблица request_number_sequence

Последовательность номеров заявок:

• service_code (VARCHAR(10)) - Код услуги
• date_part (VARCHAR(6)) - Часть даты (YYYYMM)
• last_sequence (INTEGER) - Последний номер последовательности
• updated_at (TIMESTAMP) - Время обновления

Таблица user_plots

Участки пользователя (вкладка "Мои участки и отводы"):

• id (SERIAL) — первичный ключ
• user_iin (VARCHAR(12)) — ИИН владельца
• name (TEXT) — наименование (обязательно)
• location (TEXT) — местоположение
• cadastral_number (VARCHAR(20)) — кадастровый номер (необязательно)
• egkn_id (VARCHAR(20)) — идентификатор ЕГКН (необязательно)
• coordinates (JSONB) — координаты (GeoJSON, необязательно)
• created_at (TIMESTAMP) — дата создания
• updated_at (TIMESTAMP) — дата изменения

Рекомендуемые индексы:

• CREATE INDEX IF NOT EXISTS idx_user_plots_user_iin ON giprozem.user_plots (user_iin);

Таблица user_activity_logs

Журнал действий пользователя (для модалки "Логирование"):

• id (SERIAL), user_iin (VARCHAR(12))
• action_type (VARCHAR(50)) — тип действия (напр. login, add_plot, update_plot, delete_plot, ...)
• action_description (TEXT), resource_type (VARCHAR(50)), resource_id (VARCHAR(100))
• ip_address (INET), user_agent (TEXT)
• created_at (TIMESTAMP), additional_data (JSONB)

Индексы:

• idx_user_activity_logs_user_iin, idx_user_activity_logs_created_at, idx_user_activity_logs_action_type

👥 Система ролей и прав доступа

Роли пользователей

user (обычный пользователь)

• Просмотр карты и слоев
• Создание и управление собственными заявками
• Загрузка документов к своим заявкам
• Просмотр истории авторизаций
• Изменение личных настроек

admin (администратор)

• Все права обычного пользователя
• Просмотр всех заявок в системе
• Управление пользователями (добавление, редактирование, удаление)
• Назначение ролей пользователям
• Доступ к административным функциям

Авторизованные пользователи

В системе предустановлены следующие пользователи:

📝 Система логирования

Приложение ведет детальное логирование всех операций:

Логи

• Файл: logs/app.log (автоматическая ротация при 1MB)
• Консоль: Все логи выводятся в консоль
• Формат: Время - Модуль - Уровень - Сообщение

Логируемые события

• Геосервер: Выбор доступного сервера, WMS/WFS запросы
• Авторизация: Попытки входа/выхода, ошибки сертификатов
• Настройки: Сохранение/получение пользовательских настроек
• База данных: Операции с БД, ошибки подключения
• Заявки: Создание, редактирование, удаление заявок
• Документы: Загрузка, скачивание, удаление документов
• Пользователи: Управление пользователями и ролями

Уровни логирования

• INFO: Успешные операции, выбор геосервера
• WARNING: Попытки доступа без авторизации, неверные данные
• ERROR: Ошибки БД, сетевые ошибки, исключения

⚙️ Конфигурация

🗄️ Конфигурация схемы базы данных

Приложение поддерживает настраиваемую схему базы данных через переменную окружения DATABASE_SCHEMA:

Настройка схемы

# В файле config.env
DATABASE_SCHEMA=giprozem

Значения по умолчанию

• По умолчанию: public (если переменная не задана)
• Текущая: giprozem (настроена в config.env)

Архитектура

• Динамическая схема: Все SQL запросы используют схему из конфига
• Безопасность: Использование f-строк с параметризованными запросами
• Гибкость: Возможность легкой смены схемы без изменения кода
• Обратная совместимость: Поддержка существующих данных

Примеры использования

# В коде приложения
schema = self._get_schema()  # Получение схемы из конфига
query = f"SELECT * FROM {schema}.users WHERE id = %s"  # Использование в SQL

Преимущества

• Мультитенантность: Возможность использования разных схем для разных окружений
• Изоляция данных: Четкое разделение данных по схемам
• Упрощение деплоя: Одно приложение для разных схем БД

Автоматическое переключение геосерверов

Приложение автоматически проверяет доступность геосерверов при запуске:

1. Сначала проверяется локальный URL (GEOSERVER_LOCAL_URL)
2. Если локальный недоступен, используется глобальный URL (GEOSERVER_GLOBAL_URL)
3. Если оба недоступны, используется локальный по умолчанию

Для проверки текущего статуса геосервера используйте API:

curl http://localhost:8080/api/geoserver/status

🔄 Переход на ArcGIS Server

В версии v1.3.7 реализован переход отображения пространственных данных с GeoServer на ArcGIS Server. Это обеспечивает более стабильную работу с картографическими данными и улучшенную производительность.

Архитектура перехода

Двойная система поддержки:

• GeoServer: Сохранен для обратной совместимости (WMS/WFS запросы)
• ArcGIS Server: Новый основной источник данных (REST API)

Конфигурация ArcGIS Server

Добавлена новая переменная окружения ARCGIS_SERV_URL:

# ArcGIS Server URL
ARCGIS_SERV_URL=https://178.89.0.228:56443/arcgis/rest/services

Новые возможности

1. REST API интеграция:

• Прямое подключение к ArcGIS Server через REST API
• Поддержка динамических слоев (Dynamic Map Layers)
• Автоматическое получение метаданных слоев

2. Улучшенная производительность:

• Кэширование метаданных слоев
• Оптимизированные запросы к серверу
• Снижение нагрузки на сеть

3. Расширенная функциональность:

• Автоматическое получение списка слоев
• Динамическое управление видимостью слоев
• Улучшенная система легенд

Технические изменения

Backend (Flask):

• Новый маршрут /Proxy/Map/<path:service_path> для проксирования ArcGIS запросов
• Конфигурация ARCGIS_SERV_URL в config.py
• Улучшенная обработка ошибок в прокси-функциях

Frontend (JavaScript):

• Интеграция с ESRI Leaflet библиотекой
• Новые функции для работы с ArcGIS REST API:
  • getLayerNames() - получение списка слоев
  • getLayerFeatures() - получение объектов слоя
  • getLegend() - получение легенды слоя
• Замена WMS слоев на ESRI Dynamic Map Layers

Структура URL для ArcGIS:

/Proxy/Map/Kaz/MapServer          # Основные границы
/Proxy/Map/U/MapServer            # Земельные участки
/Proxy/Map/GR_Pch/MapServer       # Почвенные карты
/Proxy/Map/GR_Rst/MapServer       # Геоботанические карты
/Proxy/Map/Pch/MapServer          # Почвенные карты районов
/Proxy/Map/Rst/MapServer          # Геоботанические карты районов

Преимущества перехода

Производительность:

• ⚡ Быстрая загрузка слоев
• 🔄 Оптимизированное кэширование
• 📊 Снижение сетевого трафика

Надежность:

• 🛡️ Стабильная работа с большими объемами данных
• 🔧 Улучшенная обработка ошибок
• 📈 Масштабируемость

Функциональность:

• 🗺️ Расширенные возможности картографирования
• 📋 Автоматическое получение метаданных
• 🎨 Улучшенная система легенд

Обратная совместимость

Система полностью совместима с существующим кодом:

• ✅ WMS/WFS запросы продолжают работать через GeoServer
• ✅ Все существующие функции сохранены
• ✅ Плавный переход без потери данных

Миграция данных

Переход выполнен автоматически:

• 🔄 Автоматическое определение доступности серверов
• 📊 Сохранение всех существующих настроек
• 🎯 Прозрачная работа для пользователей

Настройки в config.env

# ArcGIS Server URL
ARCGIS_SERV_URL=https://178.89.0.228:56443/arcgis/rest/services

🔐 Аутентификация

Процесс авторизации

1. Загрузка сертификата: Пользователь загружает файл сертификата ЭЦП
2. Валидация: Система проверяет корректность сертификата
3. Извлечение ИИН: Из сертификата извлекается ИИН пользователя
4. Проверка авторизации: Проверяется наличие ИИН в списке авторизованных пользователей
5. Создание сессии: При успешной авторизации создается сессия пользователя с session.permanent = True
6. Запись в историю: Все попытки авторизации записываются в БД

Управление сессиями (Flask-Session)

Приложение использует Flask-Session для безопасного управления сессиями пользователей:

Конфигурация сессий

• Тип хранения: filesystem - сессии хранятся в файловой системе
• Директория: flask_session/ - папка для файлов сессий
• Время жизни: 10800 секунд (3 часа) - настраиваемое время жизни сессии
• Максимум файлов: 500 - ограничение на количество файлов сессий
• Права доступа: 384 (0o600) - безопасные права доступа к файлам

Параметры в config.env

# Настройки Flask-Session
SESSION_TYPE=filesystem
SESSION_FILE_DIR=flask_session
SESSION_FILE_THRESHOLD=500
SESSION_FILE_MODE=384
PERMANENT_SESSION_LIFETIME=10800

Преимущества Flask-Session

• Безопасность: Сессии не хранятся в cookies браузера
• Надежность: Файловое хранение обеспечивает сохранность данных
• Масштабируемость: Возможность переключения на Redis или другие бэкенды
• Контроль: Настраиваемое время жизни и автоматическая очистка
• Производительность: Быстрый доступ к данным сессий

Автоматическая очистка

• Старые сессии автоматически удаляются по истечении времени жизни
• Система контролирует количество файлов сессий (не более 500)
• При превышении лимита удаляются самые старые сессии

🌍 Локализация

Приложение поддерживает локализацию с использованием Flask-Babel. Реализована поддержка русского (ru) и казахского (kk) языков.

Структура файлов локализации

translations/
├── messages.pot          # Шаблон переводов
├── ru/
│   └── LC_MESSAGES/
│       ├── messages.po   # Русские переводы
│       └── messages.mo   # Скомпилированные русские переводы
└── kk/
    └── LC_MESSAGES/
        ├── messages.po   # Казахские переводы
        └── messages.mo   # Скомпилированные казахские переводы

Компиляция переводов

python compile_translations.py

Добавление новых строк для перевода

1. Добавьте строку в HTML шаблон с функцией _():

   <span>{{ _('Новая строка') }}</span>
   

2. Извлеките новые строки:

   pybabel extract -F babel.cfg -k _ -o translations/messages.pot .
   

3. Обновите файлы переводов:

   pybabel update -i translations/messages.pot -d translations -l ru
   pybabel update -i translations/messages.pot -d translations -l kk
   

4. Отредактируйте файлы .po в папках translations/ru/LC_MESSAGES/ и translations/kk/LC_MESSAGES/

5. Скомпилируйте переводы:

   python compile_translations.py
   

6. Перезапустите приложение, чтобы применить новые .mo файлы.

Использование в коде

В HTML шаблонах:

{{ _('Текст для перевода') }}

В Python коде:

from flask_babel import gettext as _

text = _('Текст для перевода')

Смена языка

Пользователи могут сменить язык через интерфейс:

• Кнопка "ҚАЗ" - казахский язык
• Кнопка "РУС" - русский язык

Язык сохраняется в сессии и применяется при следующей загрузке страницы.

⚡ Оптимизация API

Проблема и решение

Ранее для получения заявок и их документов требовалось делать множество отдельных HTTP запросов. Это приводило к медленной загрузке страниц и высокой нагрузке на сервер.

Решение: Добавлен параметр include_documents в API endpoints для получения заявок.

Новые возможности

API /api/requests

GET /api/requests?include_documents=true

Параметры:

• include_documents (boolean) - включить документы в ответ
• limit - количество заявок (по умолчанию 50)
• service - фильтр по коду услуги
• status - фильтр по коду статуса
• number - фильтр по номеру заявки
• date - фильтр по дате создания

API /api/all-requests

GET /api/all-requests?include_documents=true

Параметры:

• include_documents (boolean) - включить документы в ответ
• limit - количество заявок (по умолчанию 100)
• service - фильтр по коду услуги
• status - фильтр по коду статуса
• user - фильтр по ИИН пользователя
• number - фильтр по номеру заявки
• date - фильтр по дате создания

Примеры использования

Получение заявок без документов (по умолчанию)

curl "http://localhost:8080/api/requests"

Получение заявок с документами

curl "http://localhost:8080/api/requests?include_documents=true"

Получение всех заявок с документами и фильтрацией

curl "http://localhost:8080/api/all-requests?include_documents=true&limit=10&status=CREATED"

Структура ответа

Когда include_documents=true, каждая заявка содержит массив документов:

{
  "requests": [
    {
      "id": 1,
      "request_number": "240101SERVICE0000001",
      "title": "Заявка на услугу",
      "documents_count": 2,
      "total_size": 1048576,
      "documents": [
        {
          "id": 1,
          "request_id": 1,
          "filename": "uuid_filename.pdf",
          "original_filename": "document.pdf",
          "file_size": 524288,
          "file_size_formatted": "512.0 КБ",
          "mime_type": "application/pdf",
          "description": "Описание документа",
          "uploaded_at": "2024-01-01T10:00:00",
          "uploaded_by": "745896125463"
        }
      ]
    }
  ]
}

Преимущества

1. Производительность: Один запрос вместо множества
2. Скорость: Быстрая загрузка страниц
3. Эффективность: Снижение нагрузки на сервер
4. Удобство: Простое использование API

🗜️ Gzip сжатие

Приложение использует Flask-Compress для автоматического gzip сжатия статических файлов и API ответов.

Конфигурация сжатия

# Настройки в config.py
COMPRESS_MIMETYPES = [
    'text/html', 'text/css', 'text/xml', 'application/json', 'application/javascript',
    'application/xml+rss', 'text/javascript', 'application/xml', 'text/plain'
]
COMPRESS_LEVEL = 6
COMPRESS_MIN_SIZE = 500

Что сжимается

• Статические файлы: JavaScript, CSS, HTML файлы
• API ответы: JSON ответы от всех API endpoints
• Условия: Размер > 500 байт, клиент поддерживает gzip

Экономия трафика

Проверка сжатия

# Проверка статических файлов
curl -H "Accept-Encoding: gzip" -I http://localhost:8080/static/js/map.js

# Проверка API ответов
curl -H "Accept-Encoding: gzip" -I http://localhost:8080/api/requests

Заголовки ответа

При сжатии в заголовках ответа появляется:

Content-Encoding: gzip
Content-Length: [сжатый размер]

🛠️ Разработка

Добавление новых слоев

Для добавления нового слоя карты:

1. Для ArcGIS Server слоев:

   • Добавьте URL сервиса в конфигурацию ArcGIS
   • Обновите JavaScript код в static/js/map.js с новыми переменными _esri_*
   • Добавьте функции для работы с новым слоем (getLayerNames, getLayerFeatures)

2. Для GeoServer слоев:

   • Добавьте информацию о слое в API /api/map/layers
   • Обновите клиентский JavaScript код в static/js/map.js
   • Добавьте соответствующие элементы управления в HTML шаблон

Добавление новых базовых карт

Для добавления новой базовой карты:

1. Добавьте информацию в API /api/map/basemaps
2. Обновите клиентский код для поддержки нового типа карты

Добавление новых пользователей

Для добавления нового авторизованного пользователя:

1. Отредактируйте функцию _authorize_by_iin() в app/blueprints/account.py
2. Добавьте нового пользователя в словарь authorized_users

Добавление новых модулей JavaScript

1. Создайте модуль в static/js/modules/your-module.js
2. Импортируйте и инициализируйте его в static/js/app.js
3. Если требуется вызов из HTML/onclick — явно экспортируйте функцию в window внутри модуля
4. Не добавляйте новые <script> в шаблоны — используйте существующую точку входа app.js

🧪 Тестирование

Запуск тестов API

python test_api.py

Запуск тестов фронтенда

python test_frontend_fix.py

Ручное тестирование

1. Тестирование авторизации:

   • Загрузите валидный сертификат ЭЦП
   • Проверьте вход в систему
   • Проверьте выход из системы

2. Тестирование карты:

   • Проверьте загрузку слоев (GeoServer + ArcGIS Server)
   • Проверьте переключение базовых карт
   • Проверьте настройку прозрачности
   • Проверьте работу с ArcGIS REST API
   • Проверьте автоматическое получение легенд слоев

3. Тестирование локализации:

   • Переключитесь между языками
   • Проверьте корректность переводов

4. Тестирование заявок:

   • Создайте новую заявку
   • Загрузите документы
   • Проверьте фильтрацию и поиск
   • Кликните на номер заявки для просмотра деталей
   • Проверьте отображение всех данных в модальном окне

5. Тестирование управления пользователями (для администраторов):

   • Добавьте нового пользователя
   • Назначьте роли
   • Проверьте права доступа

🔧 Устранение неполадок

Проблемы с подключением к БД

1. Проверьте настройки в config.env
2. Убедитесь, что PostgreSQL запущен
3. Проверьте доступность сервера БД

4. Проверьте установку psycopg2-binary:

   pip list | grep psycopg
   

5. Если psycopg2-binary не установлен:

   pip install psycopg2-binary
   

6. Проверьте права доступа пользователя БД к схеме giprozem

Проблемы с геосервером

1. Проверьте доступность геосерверов
2. Проверьте логи приложения
3. Используйте API для проверки статуса: /api/geoserver/status

Проблемы с ArcGIS Server

1. Проверьте доступность ArcGIS Server:

   curl -I "http://localhost:8080/Proxy/Map/Kaz/MapServer?f=json"
   

2. Проверьте настройку ARCGIS_SERV_URL в config.env

3. Убедитесь, что ArcGIS Server доступен по указанному URL

4. Проверьте логи приложения на ошибки проксирования ArcGIS запросов

Проблемы с авторизацией

1. Проверьте корректность сертификата ЭЦП
2. Убедитесь, что ИИН пользователя добавлен в список авторизованных
3. Проверьте логи авторизации

Проблемы с сессиями

1. Проверьте права доступа к папке сессий:

   ls -la flask_session/
   chmod 755 flask_session/
   

2. Очистите старые сессии:

   rm -rf flask_session/*
   

3. Проверьте настройки сессий в config.env:

   • Убедитесь, что PERMANENT_SESSION_LIFETIME установлен корректно
   • Проверьте, что SESSION_FILE_DIR указывает на существующую папку

4. Проверьте логи приложения на ошибки, связанные с сессиями

Проблемы с локализацией

1. Убедитесь, что переводы скомпилированы: python compile_translations.py
2. Проверьте корректность файлов .po
3. Перезапустите приложение

Проблемы с загрузкой документов

1. Проверьте лимиты файлов в конфигурации
2. Убедитесь, что папка для загрузки доступна для записи
3. Проверьте логи приложения на наличие ошибок
4. Проверьте права доступа к папке logs/:
   
   
   

   chmod 755 logs/
   
   

   
   

Проблемы с виртуальным окружением

1. Убедитесь, что виртуальное окружение активировано:

   echo $VIRTUAL_ENV
   

2. Если не активировано, активируйте:

   source venv/bin/activate
   

3. Проверьте установленные пакеты:

   pip list
   

4. Если пакеты отсутствуют, переустановите:

   pip install -r requirements.txt
   

🔄 Миграция на ArcGIS Server

Краткое описание изменений

В версии v1.3.7 реализован переход отображения пространственных данных с GeoServer на ArcGIS Server. Основные изменения:

• ✅ Добавлена конфигурация ARCGIS_SERV_URL
• ✅ Новый маршрут /Proxy/Map/<path:service_path> для ArcGIS REST API
• ✅ Интеграция с ESRI Leaflet библиотекой
• ✅ Автоматическое получение метаданных слоев
• ✅ Улучшенная система легенд
• ✅ Оптимизированные запросы к серверу
• ✅ Сохранена обратная совместимость с GeoServer

Техническая поддержка

При возникновении проблем с ArcGIS Server:

1. Проверьте доступность сервера по URL из ARCGIS_SERV_URL
2. Убедитесь в корректности настроек в config.env
3. Проверьте логи приложения на ошибки проксирования
4. Обратитесь к разделу "Устранение неполадок" в документации

🚀 Деплой

Подготовка к продакшену

1. Измените DEBUG=False в config.env
2. Установите безопасный SECRET_KEY
3. Настройте HTTPS
4. Настройте reverse proxy (nginx)
5. Проверьте доступность ArcGIS Server по URL из ARCGIS_SERV_URL
6. Убедитесь, что все геосерверы доступны

Docker (опционально)

Создайте Dockerfile:

FROM python:3.8-slim

# Установка системных зависимостей для psycopg2
RUN apt-get update && apt-get install -y \
    python3-dev \
    libpq-dev \
    gcc \
    && rm -rf /var/lib/apt/lists/*

WORKDIR /app
COPY requirements.txt .
RUN pip install -r requirements.txt

COPY . .

EXPOSE 8080
CMD ["python3", "app.py"]

Docker Compose (опционально):

Создайте docker-compose.yml:

version: '3.8'
services:
  app:
    build: .
    ports:
      - "8080:8080"
    environment:
      - DATABASE_HOST=postgres
      - DATABASE_PORT=5432
      - DATABASE_NAME=landmonitoring
      - DATABASE_USER=postgres
      - DATABASE_PASSWORD=password
      - ARCGIS_SERV_URL=https://178.89.0.228:56443/arcgis/rest/services
      - GEOSERVER_LOCAL_URL=http://192.168.1.253:8080/geoserver
      - GEOSERVER_GLOBAL_URL=http://178.89.245.2:8887/geoserver
    depends_on:
      - postgres
    volumes:
      - ./logs:/app/logs

  postgres:
    image: postgres:13
    environment:
      - POSTGRES_DB=landmonitoring
      - POSTGRES_USER=postgres
      - POSTGRES_PASSWORD=password
    volumes:
      - postgres_data:/var/lib/postgresql/data
      - ./init.sql:/docker-entrypoint-initdb.d/init.sql

volumes:
  postgres_data:

Systemd сервис

Создайте /etc/systemd/system/landmonitoring.service:

[Unitl]
Description=Land Monitoring
After=network.target postgresql.service
Wants=postgresql.service

[Service]
Type=simple
User=app-host
Group=app-host
WorkingDirectory=/opt/LandMonitoring
Environment=PATH=/opt/LandMonitoring/venv/bin
Environment=ARCGIS_SERV_URL=https://178.89.0.228:56443/arcgis/rest/services
Environment=GEOSERVER_LOCAL_URL=http://192.168.1.253:8080/geoserver
Environment=GEOSERVER_GLOBAL_URL=http://178.89.245.2:8887/geoserver
ExecStart=/opt/LandMonitoring/venv/bin/python /opt/LandMonitoring/app.py
ExecReload=/bin/kill -s HUP $MAINPID
Restart=always
RestartSec=10
StandardOutput=journal
StandardError=journal
SyslogIdentifier=app-host

[Install]
WantedBy=multi-user.target

🪟 Развертывание на Windows

Для развертывания приложения на Windows Server предусмотрена детальная инструкция с использованием современных инструментов:

📋 Что включено в инструкцию

• Системные требования: Windows Server 2019/2022, Python 3.13, nginx, Waitress
• Пошаговая установка: Полная настройка окружения от А до Я
• WSGI сервер: Использование Waitress для продакшена
• Reverse Proxy: Конфигурация nginx для Windows
• Windows службы: Автоматический запуск с помощью NSSM
• SSL/HTTPS: Настройка Let's Encrypt сертификатов
• Мониторинг: Логирование и управление службами
• Безопасность: Настройка файрвола и пользователей
• Резервное копирование: Автоматические бэкапы

🔗 Подробная инструкция

Полное руководство по развертыванию доступно в файле: windows.md

✨ Ключевые особенности

• Production-ready: Готовое решение для продакшена
• Автоматизация: Службы Windows и планировщик задач
• Отказоустойчивость: Автоматический перезапуск служб
• Масштабируемость: Nginx + Waitress для высокой нагрузки
• Безопасность: HTTPS, файрвол, изоляция пользователей

📄 Система генерации уведомлений о приеме заявок

Описание

Реализована система автоматической генерации PDF уведомлений о приеме заявок с QR-кодом для верификации.

Архитектура

Компоненты системы

1. NotificationService (app/services/notifications.py)

   • Генерация PDF документов с использованием ReportLab
   • Создание QR-кодов для верификации
   • Форматирование данных заявки в документ

2. DatabaseManager (расширен)

   • Хранение PDF уведомлений в БД (поле notification_pdf)
   • Методы для работы с уведомлениями
   • Проверка наличия уведомлений

3. API Endpoints (расширен)

   • /api/download-notification/<request_id> - скачивание уведомления
   • /api/verify-notification/<request_id> - верификация через QR-код
   • /api/requests/<request_id>/notification-status - статус уведомления

4. Frontend (расширен)

   • Кнопка "Уведомление" в таблице заявок
   • JavaScript модуль для скачивания уведомлений

Функциональность

Автоматическая генерация

• При создании заявки автоматически генерируется PDF уведомление
• Уведомление содержит все данные заявки и QR-код
• PDF сохраняется в БД в поле notification_pdf

Содержимое уведомления

• Заголовок "УВЕДОМЛЕНИЕ О ПРИЕМЕ ЗАЯВКИ"
• Номер заявки и дата приема
• Информация о заявителе (ФИО, ИИН)
• Данные об услуге и заявке
• Адрес и координаты объекта
• QR-код для верификации
• Место для подписи ответственного лица

QR-код верификации

• Содержит полный URL: {NOTIFICATION_DOMAIN}/api/verify-notification/{request_number}
• Домен настраивается в config.env (NOTIFICATION_DOMAIN)
• При сканировании открывается PDF уведомления
• Позволяет проверить подлинность документа

Интерфейс пользователя

• Кнопка "Уведомление" в таблице заявок
• Скачивание PDF файла с именем Уведомление_{номер_заявки}.pdf
• Уведомления об успешном скачивании

Безопасность

• Проверка прав доступа к уведомлениям
• Валидация данных перед генерацией PDF
• Логирование всех операций с уведомлениями
• Безопасная обработка QR-кодов

Зависимости

Добавлены в requirements.txt:

reportlab==4.0.7
qrcode[pil]==7.4.2

Конфигурация

Настройка домена для QR-кодов

В файле config.env добавлена настройка:

# Настройки для QR-кодов уведомлений
NOTIFICATION_DOMAIN=http://192.168.1.111:8080

Этот домен используется для генерации полных URL в QR-кодах уведомлений.

Билингвальность уведомлений

PDF уведомления генерируются на двух языках одновременно:

• Русский язык: основной язык системы
• Казахский язык: государственный язык Республики Казахстан

Все элементы документа дублируются на обоих языках:

• Заголовки и подзаголовки
• Названия полей и описания
• Названия услуг (берутся из базы данных)
• Подписи и служебная информация

Поддержка кириллицы в PDF

Для корректного отображения русских и казахских символов в PDF система автоматически ищет и использует системные шрифты с поддержкой кириллицы:

• macOS: SF Pro, New York, Geneva, SF Compact, Arial
• Linux/Docker: DejaVu Sans, Liberation Sans, FreeSans, Arial
• Windows: Arial, Calibri, Tahoma

Важно для Docker: В Dockerfile автоматически устанавливаются пакеты fonts-dejavu, fonts-dejavu-core, fonts-dejavu-extra, которые обеспечивают полную поддержку кириллицы в контейнерах Linux.

При отсутствии подходящих системных шрифтов используется Times-Roman как fallback (возможны проблемы с кириллицей).

Использование

Создание заявки

При создании заявки через API автоматически генерируется уведомление:

# В app/blueprints/api.py
request_id = db_manager.create_request(iin, service_id, title, description, address, coordinates)

if request_id:
    # Автоматическая генерация уведомления
    request_data = db_manager.get_request_with_service_info(request_id)
    user_data = {'iin': iin, 'fio': session.get('user_fio', 'Не указано')}
    pdf_data = notification_service.generate_notification_pdf(request_data, user_data)
    db_manager.save_notification_pdf(request_id, pdf_data)

Скачивание уведомления

// В static/js/modules/requests.js
function downloadNotification(requestId) {
    const link = document.createElement('a');
    link.href = `/api/download-notification/${requestId}`;
    link.download = `Уведомление_${requestId}.pdf`;
    document.body.appendChild(link);
    link.click();
    document.body.removeChild(link);
}

Тестирование

Система протестирована:

• ✅ Генерация PDF уведомлений
• ✅ Создание QR-кодов
• ✅ Сохранение в БД
• ✅ API endpoints
• ✅ Frontend интеграция

Логирование

Все операции с уведомлениями логируются:

• Создание уведомления при создании заявки
• Скачивание уведомлений
• Ошибки генерации
• Попытки доступа к уведомлениям

Расширение

Система легко расширяется:

• Добавление новых полей в уведомление
• Изменение дизайна PDF
• Дополнительные форматы (DOCX, HTML)
• Email отправка уведомлений
• Массовая генерация уведомлений

📋 История версий

v1.5.6 - 2025-12-XX

• ✅ Улучшение системы загрузчиков: реализована система управления несколькими загрузчиками
  • Введена система управления загрузчиками с _loaderStack для обработки множественных загрузчиков
  • Обновлены функции showLoader и hideLoader для управления видимостью загрузчиков на основе стека
  • Улучшена стабильность отображения индикаторов загрузки при параллельных операциях
• ✅ Расширение кадастровых данных: добавлены новые поля для улучшения обработки атрибутов
  • Добавлены новые поля zuFields3 для дополнительной кадастровой информации
  • Улучшена обработка атрибутов земельных участков
• ✅ Улучшения UI элементов: обновлены элементы управления картой и подвала
  • Заменен btn-zu-check на checkZU для лучшей согласованности в обработке чекбоксов
  • Скорректированы привязки событий и UI элементы в элементах управления картой и подвала
  • Улучшен пользовательский опыт при работе с картой

v1.5.5 - 2025-11-XX

• ✅ Оптимизация запросов к слоям карты: улучшена логика получения объектов слоев
  • Изменены параметры запроса с "1=1" на "np=1" в вызовах getLayerFeatures для слоев PCH и RST
  • Уточнена логика выборки данных для повышения точности получаемых результатов
• ✅ Фильтрация объектов с нулевыми атрибутами: оптимизирована отрисовка карты
  • Добавлено условие пропуска объектов, где все кадастровые атрибуты (gr_pch, gr_rst, gr_ah) равны нулю
  • Улучшена эффективность рендеринга карты за счет исключения неинформативных объектов
• ✅ Расширение кадастровых данных: добавлены новые поля и обновлена обработка атрибутов
  • Введены новые поля zuFields2 для дополнительной кадастровой информации, включая "Кадастровый номер" и "Площадь земельного участка"
  • Обновлены ключи атрибутов с русского на английский язык для единообразия обработки данных
  • Скорректирована логика в showIdentResult для использования новых полей на основе атрибутов объектов

v1.5.4 - 2025-11-XX

• ✅ Улучшения UI настроек агрохимии: добавлена легенда с цветовыми индикаторами в модальном окне агрохимии
  • Добавлена новая секция легенды для визуального представления диапазонов данных
  • Введены CSS стили для легенды, включая цветовые индикаторы и метки для лучшей ясности
  • Обновлен JavaScript для динамической настройки стилей меток в зависимости от уровня масштабирования
• ✅ Исправление обработки состояния PCH: исправлено значение data-value чекбокса для корректной обработки состояния почвенных карт (PCH) в функции setRaion

v1.5.3 - 2025-11-XX

• ✅ Оптимизация управления агрохимическими данными: улучшена логика работы с агрохимией
  • Добавлена переменная _firstTimePchLoad для отслеживания первого загрузки почвенных карт (PCH)
  • Обновлено значение переменной _minZoomToShowAgroLabels с 8 до 9 для оптимизации производительности
  • Введены новые поля agroFields для агрохимических данных (номер поля, площадь поля)
  • Улучшена логика переключения между слоями: почвенные карты, геоботанические карты и агрохимия
  • Обновлены функции обработки состояния агрохимии (enableAgro, disableAgro) для корректной работы при смене районов
  • Оптимизирована последовательность загрузки слоев при выборе района на карте

v1.5.2 - 2025-11-XX

• ✅ Улучшения агрохимии: обновлены настройки агрохимии и улучшена доступность
  • Изменено название заголовка в модальном окне агрохимии на "Агрохимические показатели"
  • Добавлен чекбокс для выбора всех годов в настройках агрохимии
  • Обновлены стили в app.css для улучшения доступности и визуального оформления
  • Обновлены переводы для новых строк в messages.po (русский и казахский языки)
  • Расширены функции управления агрохимическими данными в map.js

v1.5.1 - 2025-10-XX

• ✅ Улучшенная обработка ошибок ЕГКН: добавлена интеллектуальная обработка ошибок в маршруте /get-zu/
  • Реализована проверка текста ошибок от EGKN_WFS на наличие "map.gov4c.kz"
  • Ошибки с "map.gov4c.kz" заменяются на "Internal Server Error - сервис временно недоступен"
  • Остальные ошибки отображаются в оригинальном виде для лучшей диагностики
  • Добавлено детальное логирование ошибок для отладки и мониторинга
  • Улучшена стабильность работы с внешними сервисами ЕГКН

v1.5.0 - 2025-10-XX

• ✅ ОЦСК сервисы: добавлена интеграция с ОЦСК сервисами
  • Реализован маршрут /ocsk-services для получения списка ОЦСК сервисов из JSON файла
  • Добавлены элементы управления для отображения ОЦСК сервисов на карте в map_controls.html
  • Обновлен JavaScript для загрузки и управления ОЦСК сервисами на карте
  • Интеграция с модулем map.js для работы с ОЦСК данными
• ✅ Агрохимия: расширен функционал работы с агрохимическими данными
  • Интеграция с сервисом Ah: подключение к ArcGIS сервису https://ags.giprozem.kz/arcgis/rest/services/Ah/MapServer
  • Фильтры по годам: комбобокс для выбора года из поля yearob для анализа агрохимических показателей
  • Фильтры по показателям: комбобокс для выбора агрохимических показателей:
    • n – Азот, p – Фосфор, k – Калий, ph – Кислотность, gum – Гумус
    • b – Бор, mn – Марганец, zn – Цинк, cu – Медь, co – Кобальт
  • Динамическая загрузка данных: получение объектов в зависимости от выбранных значений в комбобоксах
  • Цветовая схема раскраски: автоматическая раскраска по полю gr{показатель} (grn, grp, grk и т.д.):
    • 1 - #fd0000, 2 - #ffa803, 3 - #fffd01, 4 - #52ff00, 5 - #00ffff, 6 - #0004fa
  • Интерактивные подписи: отображение показателя в подписи (центроид) при наведении
  • Клиентская обработка: рисование и раскраска данных на стороне клиента для оптимальной производительности
  • Обновлены стили для панели агрохимии и добавлены новые элементы управления
  • Создан модальный диалог agro_settings.html для настройки параметров агрохимии
  • Интеграция с картографическим модулем для отображения агрохимических данных
• ✅ Экспорт в Excel: реализован функционал экспорта данных земельных участков в формат Excel
  • Новый маршрут /export/zu-excel для экспорта результатов поиска участков
  • Автоматическое форматирование данных для Excel с сохранением структуры
  • Интеграция с модулем search.js для экспорта найденных участков
  • Кнопка экспорта в модальном окне результатов поиска
  • Поддержка экспорта атрибутов участков (кадастровый номер, площадь, адрес и др.)
  • Обновлены стили для панели настроек агрохимии в app.css
  • Расширен функционал картографических операций в map.js

v1.4.1 - 2025-10-XX

• ✅ Исправление кириллицы в PDF: решена проблема с отображением русских и казахских символов в PDF уведомлениях
  • Добавлена установка шрифтов DejaVu Sans в Docker-контейнер (fonts-dejavu, fonts-dejavu-core, fonts-dejavu-extra)
  • Расширен список путей поиска шрифтов в NotificationService для Linux/Docker окружения
  • Шрифт DejaVu Sans обеспечивает полную поддержку кириллицы (русский и казахский языки)
  • Обновлен Dockerfile для автоматической установки необходимых шрифтов при сборке образа
  • Теперь вместо квадратиков (■■■) отображается корректный текст на русском и казахском языках

v1.4.0 - 2025-10-XX

• ✅ Поиск по кадастровому номеру: реализован полнофункциональный модуль поиска земельных участков по кадастровому номеру
  • Новый модуль search.js для обработки логики поиска с полной документацией
  • Интерфейс поиска в navbar с кнопкой очистки и индикатором загрузки
  • Модальное окно search_result.html для отображения детальных атрибутов найденного участка
  • Визуализация найденных участков на карте с автоматическим центрированием и подсветкой
  • Расширенные стили для панели результатов поиска в app.css (137 строк новых стилей)
  • Интеграция с существующим API ЕГКН (/get-zu/<kad_nomer>)
  • Поддержка всех типов геометрии (Point, LineString, Polygon, MultiPolygon)
  • Автоматическое форматирование и отображение атрибутов участка (кадастровый номер, площадь, адрес и др.)
  • Очистка предыдущих результатов поиска при новом запросе
  • Полная поддержка локализации (русский/казахский) для всех элементов интерфейса
  • Обработка ошибок с информативными уведомлениями пользователю
• ✅ Улучшения картографии: расширены функции работы с геометрией в map.js
  • Новые функции для преобразования координат и работы с различными типами геометрии
  • Улучшена поддержка отображения результатов поиска на карте

v1.3.18 - 2025-10-XX

• ✅ Улучшения базы данных: добавлено поле created_at в запросы создания заявок с безопасной обработкой дат
• ✅ Отображение координат на карте: реализована функция showRequestOnMap для визуализации геометрии заявок на карте
• ✅ Обработка геометрии: добавлены функции simpleReverseCooridnates для реверсирования координат различных геометрических типов
• ✅ Поддержка проекций: подключена библиотека proj4leaflet.js для работы с различными системами координат
• ✅ Интерфейс кадастровых номеров: улучшен UI для ввода и обработки кадастровых номеров с индикаторами загрузки
• ✅ Восстановление порядка скриптов: исправлен порядок подключения proj4.js и proj4leaflet.js в base.html
• ✅ Улучшенная обработка ошибок: обновлены сообщения об ошибках и добавлено логирование для отладки слоев

v1.3.17 - 2025-10-XX

• ✅ Интеграция с ЕГКН: добавлен новый модуль app/blueprints/egkn.py для работы с Единым государственным кадастром недвижимости
• ✅ API поиска участков: новый endpoint GET /get-zu/<kad_nomer> для поиска земельных участков по кадастровому номеру
• ✅ Справочник районов: добавлен файл static/js/egkn_districts.json с полным справочником областей и районов Казахстана
• ✅ Конфигурация WFS: новая настройка EGKN_WFS в config.py для настраиваемого шаблона WFS-запросов к ЕГКН
• ✅ Валидация кадастровых номеров: проверка формата (только цифры, длина 11-12 символов) и автоматическое определение района
• ✅ Поддержка SRS: автоматическое определение системы координат (SRS) для каждого района
• ✅ UTF-8 кодировка: корректная обработка кириллицы в ответах API
• ✅ Расширенное логирование: детальное логирование WFS-запросов и ошибок для отладки

v1.3.16 - 2025-10-XX

• Маршрут GET /get-zu/<kad_nomer>: поиск участка по кадастровому номеру с валидацией (только цифры, длина 11–12) и определением district_id из static/js/egkn_districts.json.
• Конфигурация EGKN_WFS в config.py — шаблон WFS-запроса настраивается через config.env; серверный WFS-запрос возвращает GeoJSON или 404, если features пустой.
• Ответы API и логирование: ответы возвращаются в UTF-8 (кириллица сохраняется), добавлено логирование пути к egkn_districts.json и информативные ошибки.

v1.3.15 - 2025-09-XX

• Обработка слоёв и сообщения об ошибках
  • Переработаны тексты ошибок: убрано лишнее «по выбранному региону», формулировки стали короче и понятнее.
  • Унифицированы сообщения и поведение во всех функциях включения/отключения слоёв.
• Диагностическое логирование
  • Добавлены консольные логи: отслеживание состояний чекбоксов и вызовов функций для упрощения отладки.

v1.3.14 - 2025-09-XX

• Улучшены элементы управления картой и прозрачность слоёв/базовой карты
  • Доработана логика обработки ползунков прозрачности и UX мелочи
• Документация
  • Добавлен файл AGENTS.md с правилами взаимодействия, код-стайлом и ревью
• Обслуживание репозитория
  • Удалён устаревший артефакт landmonitoring-image.tar
  • Папка flask_session/ исключена из трекинга git

v1.3.13 - 2025-09-XX

• Добавлена настройка прозрачности базовой карты
  • В панели «Прозрачность» появился отдельный ползунок «Базовая карта»
  • Диапазон 0–100%: 0% — полностью прозрачная, 100% — полностью непрозрачная
  • Прозрачность применяется к активной базовой карте через setOpacity и хранится в состоянии карты
  • UI: templates/partials/map_controls.html — блок opacity-main с #basemapOpacityRange
  • JS: static/js/map.js — обработчик $('input[type=range].range-opacity') вызывает handlePkGkOpacity('basemap', value),
    
    где для базовой карты выполняется _mapLayer?.setOpacity(opacity) и сохраняется _basemapOpacity
  • Стили: static/css/map.css — оформление панели прозрачности и ползунка
• Улучшения картографического UI и локализации
  • Обновлены переводы подсказок (tooltip) и подписей для панели прозрачности, базовых карт и легенды
  • Уточнены заголовки и тексты в легенде, подтверждена двуязычность
• Технические обновления и обслуживание
  • Обновлена документация по PyArmor и runtime-файлам
  • Обновлены инструкции по Docker/WSGI; улучшен .dockerignore
  • Удалены устаревшие артефакты (landmonitoring-image.tar) и мелкие исправления репозитория
  • Уточнена интеграция ArcGIS сервисов и обработка результатов (result file)

v1.3.12 - 2025-09-XX

• Локализация и тултипы на главной странице
  • Переведены все подсказки: «Почвенная карта», «Карта земельных участков», «Прозрачность», «Полный экстент», «Увеличить», «Уменьшить» и др.
  • Исправлены атрибуты Bootstrap тултипов (data-bs-toggle), удалены устаревшие data-bs-toggle2
  • Добавлен централизованный словарь JS переводов (_translations) и автоперевод заголовка/сообщения в системе уведомлений
• Полная чистка и обновление переводов (ru/kk)
  • Очищены .po от устаревших записей #~, удалены дубликаты, сняты fuzzy
  • Исправлен путь к каталогам переводов, пересобраны .mo
  • Добавлены недостающие переводы уведомлений: «Успешно», «Заявка обновлена», «Файл загружен», «Результат загружен», «Документ удален» и др.
• Улучшения UX уведомлений
  • Все вызовы window.notifications.* теперь автоматически переводятся при наличии словаря _translations
  • Единые переводы для заголовков «Ошибка», «Внимание», «Информация»

v1.3.11 - 2025-09-XX

• Окно «Просмотр заявки»: полное редактирование для роли 01 (Исполнитель) и администратора
  • Редактируемые поля: Статус, Заголовок, Описание, Адрес, Документы (загрузка/удаление), Уведомление (генерация), Результат (загрузка файла), Координаты (GeoJSON)
  • Геометрия редактируется как GeoJSON (jsonb). Пустое значение очищает координаты
  • Кнопка «Показать на карте» доступна всегда; при наличии геометрии передаёт на карту
• База данных (schema app)
  • Таблица requests: подтверждена поддержка поля coordinates jsonb
  • Добавлены поля: result_file BYTEA, result_created_at TIMESTAMP
  • DDL выполняется безопасно: lock_timeout = 3s, statement_timeout = 10s
• API
  • PUT /api/requests/<id>: принимает title, description, address, status_code, coordinates (json)
  • POST /api/requests/<id>/result: загрузка файла результата (роль 01/админ)
  • GET /api/requests/<id>/result-status: наличие результата
  • GET /api/download-result/<id>: скачивание результата
  • GET /api/requests/<id>/details: флаг has_result
• Frontend
  • request-details.html: добавлены инпуты для Заголовка/Описание/Адрес, редактор GeoJSON
  • request-details.js: корректный режим редактирования, строгий сброс состояния при открытии/закрытии, валидация GeoJSON, обновление таблиц «Заявки»/«Личный кабинет» после сохранения
  • Кнопка «Редактировать» корректно отображается (дозагрузка статуса авторизации при необходимости)
• Исправления
  • Зависание при инициализации индексов/DDL — добавлены таймауты
  • JSON serialization bytes — возвращается только has_result
  • GROUP BY для has_result — использован bool_or(...)
  • result_text удалён из PUT; результат — отдельный endpoint
  • Серая подложка после Сохранить/Загрузить/Генерации — модалка не пересоздаётся, корректно закрывается
  • Обновление списков после сохранения — определяется активная модалка и обновляется соответствующий список

v1.3.10 - 2025-09-XX

• ✅ Исправлено отсутствие дат/времени в модалке «Логирование» и в «Настройки» → «История авторизаций»
  • Backend: гарантирована установка времени при вставке записей
    • DatabaseManager.save_auth_history(...) теперь явно задаёт login_time = CURRENT_TIMESTAMP
    • В _ensure_indexes добавлена проверка/установка DEFAULT и безопасный backfill для:
      • app.user_activity_logs.created_at
      • app.auth_history.login_time
  • База данных (schema app):
    • Установлены DEFAULT значения для указанных колонок
    • Выполнен разовый backfill NULL значений (миграция данных без простоя)
  • Frontend: форматирование дат на месте (dd.mm.yyyy HH:MM:SS) продолжает работать корректно

v1.3.9 - 2025-09-XX

• ✅ Окно «Просмотр заявки»: разграничение прав и режим редактирования
  • Роль 01 (Исполнитель): редактирование всех полей — «Статус», «Документы» (загрузка/удаление), «Уведомление» (генерация), «Результат» (загрузка файла)
  • Прочие роли: только просмотр; добавлено отображение поля «Результат»
• ✅ Поле «Результат» переведено в файловый формат и хранится в БД аналогично уведомлениям
  • БД: в таблицу requests добавлены поля result_file BYTEA и result_created_at TIMESTAMP
  • Репозиторий: добавлены методы save_result_file, get_result_file, has_result
  • API:
    • POST /api/requests/<id>/result — загрузка результата (доступ для роли 01 и администратора)
    • GET /api/requests/<id>/result-status — проверка наличия результата
    • GET|HEAD /api/download-result/<id> — скачивание результата (права, как для уведомлений)
    • GET /api/requests/<id>/details — добавлен флаг has_result
  • UI:
    • В модалке «Просмотр заявки» добавлена кнопка «Скачать» для результата и загрузка результата в режиме редактирования (роль 01)
    • В таблицах «Личный кабинет» и «Заявки» столбец «Результат» показывает кнопку «Скачать» при наличии результата
  • JS:
    • documents.js: добавлена функция downloadResult(requestId)
    • requests.js, personal.js: вывод кнопки скачивания результата по has_result
    • request-details.js: загрузка результата (POST) и отображение кнопки скачивания

v1.3.8 - 2025-09-XX

• ✅ Страница тестирования ArcGIS сервисов: добавлена страница /test для просмотра списка сервисов ArcGIS с возможностью детального просмотра и измерения времени загрузки
• ✅ ArcGIS Service интеграция: новый сервис ArcGISService для работы с ArcGIS REST API
• ✅ Тестовые представления: добавлены страницы /test и /testview для тестирования и мониторинга ArcGIS сервисов
• ✅ Демо-режим: автоматическое переключение на тестовые данные при недоступности ArcGIS сервера
• ✅ Измерение производительности: отображение времени загрузки сервисов для мониторинга производительности
• ✅ Обновление переводов: расширена поддержка локализации для новых функций
• ✅ Улучшения картографических функций: обновления в CSS и JavaScript для лучшей работы с картами

v1.3.7 - 2025-08-XX

• ✅ Переход на ArcGIS Server: реализован переход отображения пространственных данных с GeoServer на ArcGIS Server
• ✅ Новая конфигурация ARCGIS_SERV_URL: добавлена поддержка ArcGIS REST API
• ✅ Двойная система поддержки: сохранена совместимость с GeoServer (WMS/WFS) и добавлена поддержка ArcGIS Server
• ✅ Улучшенная производительность: оптимизированные запросы к серверу, кэширование метаданных
• ✅ Расширенная функциональность: автоматическое получение списка слоев, улучшенная система легенд
• ✅ Новый маршрут прокси: /Proxy/Map/<path:service_path> для ArcGIS REST API запросов
• ✅ Интеграция с ESRI Leaflet: поддержка динамических слоев и REST API
• ✅ Настраиваемая схема базы данных: вынесена схема БД в конфиг (DATABASE_SCHEMA)
• ✅ Динамическое использование схемы: все SQL запросы используют схему из конфига
• ✅ Гибкость конфигурации: по умолчанию public, текущая giprozem
• ✅ Обратная совместимость: поддержка существующих данных
• ✅ Улучшенная архитектура: централизованное управление схемой через _get_schema()
• ✅ Документация Windows: добавлена ссылка на подробную инструкцию развертывания на Windows

v1.3.6 - 2025-08-XX

• ✅ Детальный просмотр заявок: новое модальное окно с полной информацией о заявке при клике на номер
• ✅ Интерактивные номера заявок: кликабельные номера заявок в таблицах "Заявки" и "Личный кабинет"
• ✅ API для детальной информации: новый endpoint /api/requests/<id>/details для получения полных данных заявки
• ✅ Модульная архитектура: добавлен модуль request-details.js для управления просмотром заявок
• ✅ Улучшенная система модальных окон: корректная обработка z-index и жизненного цикла для нового окна

v1.3.5 - 2025-08-XX

• ✅ Билингвальные PDF уведомления: все уведомления генерируются на русском и казахском языках одновременно
• ✅ Исправление скачивания уведомлений: решена проблема с зависанием запросов при скачивании PDF
• ✅ Улучшенная обработка ошибок: корректные сообщения об отсутствии уведомлений и ошибках доступа

v1.3.4 - 2025-08-XX

• ✅ Система уведомлений о приеме заявок: автоматическая генерация PDF уведомлений с QR-кодом для верификации (NotificationService, ReportLab, хранение в БД, API endpoints, frontend интеграция)
• ✅ QR-код верификации: публичный доступ к уведомлениям через QR-код для проверки подлинности документов
• ✅ Расширение БД: добавлены поля notification_pdf и notification_created_at в таблицу requests
• ✅ Исправление кодировки: решена проблема с отображением кириллицы в PDF (использование шрифта Times-Roman с поддержкой Unicode)
• ✅ Исправление QR-кода: QR-код теперь содержит полный URL с доменом и номером заявки (настраиваемый домен в config.env)

v1.3.3 - 2025-08-XX

• ✅ Системные логи: полный функционал для работы с лог файлами (просмотр, скачивание, управление, ротация до 5 файлов по 1 МБ, веб-интерфейс, API endpoints, проверка прав администратора, модуль system-logs.js)
• ✅ Gzip сжатие: автоматическое сжатие статических файлов и API ответов (экономия трафика 60-80%, поддержка JavaScript/CSS/HTML/JSON, уровень сжатия 6, минимальный размер 500 байт)

v1.3.2 - 2025-08-XX

• ✅ Добавлена галочка "Получать уведомления" в настройки пользователя
• ✅ Расширена таблица user_settings полем notifications_enabled
• ✅ Обновлены API endpoints для работы с настройками уведомлений
• ✅ Добавлены переводы для нового функционала (русский/казахский)
• ✅ Улучшена валидация данных в формах настроек

v1.3.1 - 2025-08-XX

• ✅ Исправлены критические ошибки в работе с БД (psycopg3)
• ✅ Улучшена обработка ошибок и валидация данных
• ✅ Оптимизированы SQL-запросы и индексация
• ✅ Добавлена поддержка современных драйверов PostgreSQL

v1.3.0 - 2025-08-XX

• ✅ Система ролей пользователей (user, admin)
• ✅ Управление пользователями для администраторов
• ✅ Модульная архитектура JavaScript (ES6 Modules)
• ✅ Улучшенная система уведомлений
• ✅ Оптимизация производительности API
• ✅ Расширенная система логирования
• ✅ Вкладка "Мои участки и отводы" в "Настройки" (CRUD, хранение в БД, GeoJSON)

v1.2.0 - 2025-08-XX

• ✅ Оптимизация API для получения документов
• ✅ Улучшенная система логирования
• ✅ Поддержка локализации (русский/казахский)
• ✅ Система заявок и документооборота
• ✅ Автоматическое переключение геосерверов
• ✅ История авторизаций пользователей

v1.1.0 - 2025-08-XX

• ✅ Аутентификация по ЭЦП
• ✅ Настройки пользователей
• ✅ Интерактивная карта с множественными слоями
• ✅ Поиск по областям и районам

v1.0.0 - 2025-07-XX

• ✅ Базовая функциональность карты
• ✅ Подключение к геосерверу
• ✅ Проксирование WMS/WFS запросов

📄 Лицензия

Проект разработан для РГП "ГИПРОЗем" и является проприетарным программным обеспечением.

📞 Контакты

🏢 РГП "ГИПРОЗем"

Республиканское государственное предприятие "ГИПРОЗем"

👨‍💻 Разработчик

Виктор С. - Ведущий разработчик

Для получения дополнительной информации, технической поддержки или коммерческих предложений обращайтесь в РГП "ГИПРОЗем".