आपके Hapio प्रोजेक्ट के लिए हमारे ओपन-सोर्स एडमिन पैनल का परिचय

हैपियो एक हेडलेस सिस्टम है। आप अपने ग्राहकों को दिखने वाला बुकिंग अनुभव तैयार करते हैं, और हम पर्दे के पीछे उपलब्धता, शेड्यूल और बुकिंग का प्रबंधन करते हैं। लेकिन हर प्रोजेक्ट में एक बैक-ऑफिस भी होता है। किसी को इस सप्ताह की बुकिंग देखने, दोपहर का समय आरक्षित करने, नई सेवा जोड़ने या ग्राहक द्वारा शिकायत की गई बुकिंग को ठीक करने की आवश्यकता होती है। अब तक, यह सारा काम हर कोई खुद ही करता था।

आज हम Hapio Admin जारी कर रहे हैं, जो Hapio API के लिए एक ओपन-सोर्स एडमिन पैनल है। इसे क्लोन करें, अपना API टोकन डालें, और कुछ ही मिनटों में आपके प्रोजेक्ट के लिए एक संपूर्ण बैक ऑफिस तैयार हो जाएगा।

यह क्या करता है

Hapio Admin, Hapio API v1 के सभी कार्यों को कवर करता है: स्थान, संसाधन, सेवाएं, शेड्यूल, बुक करने योग्य स्लॉट, बुकिंग और बुकिंग समूह। यदि API कोई कार्य कर सकता है, तो पैनल में उसके लिए एक पेज, फॉर्म या बटन मौजूद है।

कुछ मुख्य बातें:

कैलेंडर। सप्ताह, दिन, माह और सूची के रूप में अपनी बुकिंग देखें, एक समय में एक स्थान और उस स्थान के समय क्षेत्र के अनुसार। बुकिंग के पीछे किसी संसाधन का शेड्यूल हल्का दिखाने के लिए "खुला समय दिखाएँ" चालू करें, ताकि अंतराल आसानी से पहचाना जा सके।
बुकिंग। दिनांक सीमा, स्थान, संसाधन, सेवा, अस्थायी रोक और रद्द की गई बुकिंग के लिए फ़िल्टर के साथ एक क्रमबद्ध तालिका। सूची से सीधे बुकिंग को अंतिम रूप दें, रद्द करें, पुनर्स्थापित करें या हटाएँ, और बुकिंग समूहों के साथ संबंधित बुकिंग को एक साथ रखें।
किसी स्लॉट से बुकिंग करें। सेवा पर मौजूद बुक करने योग्य स्लॉट टैब, आपके ग्राहकों को दिखने वाली उपलब्धता को दर्शाता है। प्रत्येक स्लॉट में एक बुक बटन होता है जो पहले से भरा हुआ बुकिंग फॉर्म खोलता है।
समय सारिणी। प्रत्येक संसाधन के लिए साप्ताहिक घंटे निर्धारित करें, छुट्टियों और अपवादों के लिए एकमुश्त समय सारिणी जोड़ें, और उपलब्ध समय और पूरी तरह से बुक किए गए समय की उपलब्धता की समयरेखा देखें।
नियमों को ओवरराइड करें। प्रत्येक बुकिंग फॉर्म एपीआई के ओवरराइड फ़्लैग को प्रदर्शित करता है, ताकि आवश्यकता पड़ने पर एडमिन निर्धारित समय सीमा के बाहर या रद्द करने की समय सीमा के बाद भी बुकिंग कर सके।
जब आपको रॉ JSON की आवश्यकता हो, तब इसका उपयोग करें। प्रत्येक विवरण पृष्ठ में रॉ API प्रतिक्रिया के साथ एक JSON टैब होता है, जिसमें कॉपी और पूर्ण प्रतिस्थापन (PUT) विकल्प होते हैं। सामान्य संपादन केवल आपके द्वारा परिवर्तित फ़ील्ड के साथ PATCH फ़ाइल भेजते हैं।
साझा करने योग्य दृश्य। फ़िल्टर, सॉर्टिंग और टैब URL में ही मौजूद होते हैं, इसलिए किसी दृश्य को बुकमार्क किया जा सकता है या किसी सहकर्मी को भेजा जा सकता है। डार्क मोड शामिल है और यह फ़ोन पर भी काम करता है।

आपका टोकन सर्वर पर ही रहेगा

ब्राउज़र को आपका Hapio API टोकन कभी नहीं दिखता। पैनल एक छोटे सर्वर-साइड प्रॉक्सी से बात करता है जो टोकन जोड़ता है और अनुरोध को Hapio को भेजता है। प्रॉक्सी केवल आपके द्वारा अनुमति प्राप्त होस्टनामों के लिए ही प्रतिक्रिया देता है और क्रॉस-साइट अनुरोधों को अस्वीकार करता है।

इसमें कोई अंतर्निहित लॉगिन सुविधा नहीं है। इसे अपने कंप्यूटर पर या पहले से मौजूद VPN या सिंगल साइन-ऑन के पीछे चलाएँ। टोकन को केवल वही क्षमताएँ दें जिनकी आपके प्रशासकों को आवश्यकता है, और Hapio उन्हें लागू करेगा। हेडर में आपकी शेष दर सीमा वास्तविक समय में दिखाई देगी।

शुरू करना

आपको Node.js 22 या उसके बाद का संस्करण और Hapio पोर्टल से एक API टोकन की आवश्यकता होगी।



git clone https://github.com/Hapio-Booking-and-Scheduling-API/hapio-admin-panel-nextjs
cd hapio-admin
npm install
cp .env.example .env.local   # set HAPIO_API_TOKEN
npm run dev                  # http://127.0.0.1:3000

बिना किसी प्रोजेक्ट के इसे आज़माने के लिए, npm run mock यह डेमो डेटा के साथ Hapio API का इन-मेमोरी मॉक शुरू करता है। यदि आपका अपना प्रोजेक्ट खाली है, npm run seed इसमें डेमो स्थान, संसाधन, सेवाएं और बुकिंग शामिल हैं, और --clean उन्हें फिर से हटा देता है।

पोर्टल में क्या रहता है

API टोकन, वेबहुक और प्रोजेक्ट सेटिंग्स के लिए कोई API एंडपॉइंट नहीं हैं, इसलिए वे Hapio पोर्टल में ही रहते हैं। पैनल के प्रोजेक्ट पेज पर आपके प्रोजेक्ट की जानकारी दिखाई देती है और हर वेबहुक इवेंट की सूची दी जाती है, साथ ही हस्ताक्षर सत्यापित करने के तरीके के बारे में भी बताया जाता है।

Hapio Admin Next.js 16, React 19, Tailwind CSS 4 और shadcn/ui का उपयोग करके बनाया गया है। कैलेंडर हमारे अपने React कैलेंडर कंपोनेंट Hapio Calendar पर आधारित है। यह MIT लाइसेंस के अंतर्गत आता है और यूनिट और एंड-टू-एंड परीक्षणों द्वारा सुरक्षित है। GitHub पर समस्याएँ और पुल अनुरोध आमंत्रित हैं।

Hapio Admin के साथ, बैक ऑफिस पहले दिन से ही तैयार हो जाता है। आज ही इसे आजमाएं!