Об этом проекте

pgAdmin 4 — это платформа управления и разработки для базы данных PostgreSQL, описываемая как переписывание более раннего инструмента pgAdmin3. Она реализована как веб-приложение: Python (Flask) на стороне сервера, а для клиентского интерфейса — ReactJS, HTML5 и CSS. Варианты развёртывания: он может работать на веб-сервере и быть доступным через браузер либо запускаться автономно на рабочей станции через приложение на основе Electron, расположенное в подкаталоге runtime/, которое порождает процесс Python-сервера и отображает интерфейс. Предварительные требования, перечисленные в README: Node.js 20 или новее, yarn (включаемый через Corepack), Python 3.9 или новее и сервер PostgreSQL. Процесс сборки: сторонние библиотеки JavaScript, а также собственные JS, CSS и изображения проекта компилируются в бандл. В системах *nix это делается с помощью make install-node и make bundle; в Windows — yarn install и yarn run bundle внутри каталога web. Настройка среды Python: создайте и активируйте виртуальное окружение, обновите pip, убедитесь, что каталог bin/ PostgreSQL находится в PATH, чтобы pg_config можно было найти для сборки psycopg3, затем установите requirements.txt (и web/regression/requirements.txt для регрессионных тестов). Локальный файл конфигурации (web/config_local.py) может переопределять настройки из config.py, включая каталог данных, адрес и порт сервера, серверный или настольный режим, URI базы данных конфигурации, настройки SMTP, уровни логирования и пути SQLite. Первоначальная настройка базы данных конфигурации выполняется интерактивно в серверном режиме и неинтерактивно в настольном режиме, запускается через web/setup.py или путём запуска web/pgAdmin4.py. Документацию можно собрать с помощью Sphinx (make docs). Runtime можно собрать, выполнив yarn install в каталоге runtime и скопировав dev_config.json.in в dev_config.json с скорректированными путями. Цели упаковки включают архив исходного кода (make src), PIP wheel (make pip), macOS AppBundle и установщик Windows, с инструкциями для конкретных платформ в pkg/mac и pkg/win32. Миграции базы данных для конфигурационной БД SQLite создаются с помощью Flask-Migrate (flask db revision), при этом редактируется функция upgrade и увеличивается SCHEMA_VERSION в web/pgadmin/model/__init__.py. Варианты поддержки перечислены на pgadmin.org/support; о проблемах безопасности следует сообщать на адрес электронной почты для вопросов безопасности. Разработка ведётся на GitHub в организации pgadmin-org/pgadmin4, вклад вносится в виде pull-запросов в ветку master, а обсуждение проходит в списке рассылки pgadmin-hackers.