इस प्रोजेक्ट के बारे में

pgAdmin 4 PostgreSQL डेटाबेस के लिए एक प्रबंधन और विकास प्लेटफ़ॉर्म है, जिसे पहले के pgAdmin3 टूल के पुनर्लेखन के रूप में वर्णित किया गया है। इसे एक वेब एप्लिकेशन के रूप में लागू किया गया है: सर्वर साइड पर Python (Flask), और क्लाइंट-साइड UI के लिए ReactJS, HTML5 और CSS। तैनाती विकल्प: यह एक वेब सर्वर पर चल सकता है और ब्राउज़र के माध्यम से एक्सेस किया जा सकता है, या runtime/ सबडायरेक्टरी में स्थित Electron-आधारित रनटाइम एप्लिकेशन के माध्यम से वर्कस्टेशन पर स्टैंडअलोन रूप से चल सकता है, जो एक Python सर्वर प्रक्रिया को फोर्क करता है और UI प्रदर्शित करता है। README में सूचीबद्ध पूर्वापेक्षाएँ: Node.js 20 या बाद का संस्करण, yarn (Corepack के माध्यम से सक्षम), Python 3.9 या बाद का संस्करण, और एक PostgreSQL सर्वर। बिल्ड वर्कफ़्लो: तृतीय-पक्ष JavaScript लाइब्रेरीज़ के साथ-साथ प्रोजेक्ट की अपनी JS, CSS और छवियाँ एक बंडल में संकलित की जाती हैं। *nix सिस्टम पर यह make install-node और make bundle से किया जाता है; Windows पर, web डायरेक्टरी के अंदर yarn install और yarn run bundle से। Python वातावरण सेटअप: एक वर्चुअल वातावरण बनाएँ और सक्रिय करें, pip को अपग्रेड करें, सुनिश्चित करें कि PostgreSQL की bin/ डायरेक्टरी PATH पर है ताकि psycopg3 बनाने के लिए pg_config पाया जा सके, फिर 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 चलाकर और dev_config.json.in को समायोजित पथों के साथ dev_config.json में कॉपी करके बनाया जा सकता है। पैकेजिंग लक्ष्यों में एक सोर्स टारबॉल (make src), एक PIP wheel (make pip), एक macOS AppBundle, और एक Windows इंस्टॉलर शामिल हैं, जिसमें pkg/mac और pkg/win32 में प्लेटफ़ॉर्म-विशिष्ट निर्देश हैं। SQLite कॉन्फ़िग DB के लिए डेटाबेस माइग्रेशन Flask-Migrate (flask db revision) से बनाए जाते हैं, upgrade फ़ंक्शन को संपादित करके और web/pgadmin/model/__init__.py में SCHEMA_VERSION को बढ़ाकर। समर्थन विकल्प pgadmin.org/support पर सूचीबद्ध हैं; सुरक्षा समस्याओं की रिपोर्ट सुरक्षा ईमेल पते पर की जानी चाहिए। विकास GitHub पर pgadmin-org/pgadmin4 के अंतर्गत होता है, जिसमें master ब्रांच के विरुद्ध पुल रिक्वेस्ट के रूप में योगदान और pgadmin-hackers मेलिंग सूची पर चर्चा होती है।