उपयोग गाइड

प्रोजेक्ट

एक प्रोजेक्ट हमेशा किसी ग्राहक का होता है। यह टास्क, टिकट, कोड, डिप्लॉयमेंट, समय, लागत और मापों को एक जगह लाता है।

प्रोजेक्ट सूची (The project list)

प्रोजेक्ट में आप “सभी”, “सक्रिय”, “अवरुद्ध”, “रिव्यू” और “रुका हुआ” के अनुसार फ़िल्टर करते हैं और कार्ड और तालिका (प्रोजेक्ट, ग्राहक, स्थिति, प्रगति, टास्क, डिप्लॉय) में से चुनते हैं। खोज नाम और ग्राहक के अनुसार फ़िल्टर करती है।

प्रोजेक्ट बनाना (Creating a project)

“प्रोजेक्ट बनाएँ” (या “+ नया” › प्रोजेक्ट, शॉर्टकट p) ये पूछता है:

ग्राहक (ज़रूरी) और नाम (कम से कम दो अक्षर),
पता — VentionDesk द्वारा सुझाया गया स्लग; उमलाउट पूरे लिखे जाते हैं (“mueller”, “muller” नहीं)। यह फिर हर URL में और टास्क रनर की कॉन्फ़िगरेशन में दिखता है, इसलिए इसे सोच-समझकर चुनें,
प्रकार (वेब, ऐप, API, आंतरिक, डेटा), स्थिति, GitHub रिपॉज़िटरी (owner/name के रूप में), ब्रांच, लाइव पता और विवरण।

प्रोजेक्ट पेज का हेडर (The header of the project page)

डिप्लॉय (केवल मालिक) प्रोजेक्ट के टारगेट के साथ “डिप्लॉय शुरू करें” खोलता है। डिप्लॉय शुरू किया जाता है; वह सफल हुआ या नहीं, यह बाद में “डिप्लॉयमेंट” टैब में दिखता है। जहाँ किसी टारगेट में अभी कुछ कमी है, वहाँ लिखा होता है कि क्या — जैसे “होस्टिंग असाइन करें”। होस्टिंग प्रोवाइडर तभी असाइन किए जा सकते हैं जब वे संचालन › स्रोत में जुड़े हों।
इस प्रोजेक्ट के लिए टाइम ट्रैकिंग शुरू करने वाला टाइमर।
इनवॉइस बनाएँ (केवल मालिक) और रिपॉज़िटरी खोलें।
पेंसिल “प्रोजेक्ट संपादित करें” खोलती है; “प्रोजेक्ट हटाएँ” केवल मालिक इस्तेमाल कर सकता है।
कंपनी बदलें (केवल मालिक) प्रोजेक्ट को किसी दूसरे ग्राहक को सौंपता है। टिकट, नोट, दस्तावेज़ और ड्राफ़्ट साथ चले जाते हैं। फ़ाइनल इनवॉइस और भेजे गए कोटेशन नहीं: ऐसे में बदलाव रद्द हो जाता है और दस्तावेज़ों के नाम बताता है — उन्हें रद्द करें और फिर से जारी करें।

नीचे मुख्य आँकड़े प्रगति, खुले, टिकट, बजट और बिना बिल हैं; क्लिक करने पर संबंधित टैब खुलता है।

टैब (The tabs)

ओवरव्यू (Overview)

गतिविधि (नवीनतम छह प्रविष्टियाँ, “और पंक्तियाँ” बाक़ी खोलता है), अगले कदम, बजट (“लागत और बजट”, केवल मालिक), लिंक (ग्राहक, रिपॉज़िटरी, होस्टिंग, टिकट इनटेक, ईमेल इनटेक) और प्रोजेक्ट के आइडिया।

टिकट इनटेक वाली पंक्ति मापी जाती है: “जुड़ा हुआ” आख़िरी रिपोर्ट के साथ, जैसे ही फ़ॉर्म, ऐप या सर्वर से इस प्रोजेक्ट में कोई टिकट आया हो — चाहे सार्वजनिक कुंजी से या इनटेक कुंजी से। “सेट अप है” का मतलब है: एक रास्ता खुला है, लेकिन अभी तक कुछ नहीं आया। “सेट अप करें” (केवल मालिक) आपको इस प्रोजेक्ट को खोले हुए सेटिंग्स › टिकट इनटेक पर ले जाता है — वहीं कुंजियाँ, ओरिजिन और मेलबॉक्स हैं।

प्रोजेक्ट के आइडिया (केवल मालिक) — वह आइडिया जिससे प्रोजेक्ट बना, या आइडिया पेज पर इस प्रोजेक्ट को सौंपा गया कोई और आइडिया — शीर्षक, स्थिति और एक पंक्ति के टेक्स्ट वाले छोटे कार्ड के रूप में दिखते हैं। शीर्षक पर क्लिक करने से आइडिया, आइडिया पेज पर संपादन के लिए खुलता है।

टास्क (Tasks)

प्रोजेक्ट का कानबन बोर्ड — देखें टास्क और बोर्ड।

टिकट (Tickets)

इस प्रोजेक्ट के टिकट; क्लिक करने से टिकट खुलता है। इनटेक चैनल आप यहाँ नहीं, बल्कि सेटिंग्स › टिकट इनटेक में सेट करते हैं।

Git और PR (Git & PRs)

GitHub से कमिट, पुल रिक्वेस्ट, ब्रांच और चेक रन, जैसे ही रिपॉज़िटरी दर्ज हो और GitHub जुड़ा हो। “अभी सिंक करें” वह लाता है जो अभी तक नहीं आया; वरना सिंक हर रात चलता है, और नए इवेंट तुरंत आते हैं। जिस कमिट के मैसेज में VentionDesk-Task: <task ID> पंक्ति हो, वह उस टास्क से जुड़ जाता है। कमिट और पुल रिक्वेस्ट दोनों पहली आठ पंक्तियाँ दिखाते हैं (खुले PR पहले); “और पंक्तियाँ” बाक़ी खोलता है।

डिप्लॉयमेंट (Deployments)

एनवायरनमेंट, स्थिति, कमिट, अवधि, ट्रिगर और समय वाली तालिका, जो GitHub, Vercel, Render और दूसरे होस्टिंग प्रोवाइडर से भरती है — नवीनतम आठ रन, “और पंक्तियाँ” पुराने दिखाता है। विवरण में: “प्रोवाइडर पर बिल्ड लॉग खोलें” और “डिप्लॉय की गई साइट खोलें”।

रोडमैप (Roadmap)

शीर्षक, से और तक वाले चरण (“चरण बनाएँ”); हर चरण के लिए “पूरा चिह्नित करें”, “फिर से खोलें” और “चरण संपादित करें”। roadmap:write वाली एजेंट कुंजी चरण बनाती, बदलती, क्रम में लगाती और पूरा चिह्नित करती है — वह कोई चरण हटा नहीं सकती।

समय (Time)

“समय जोड़ें”, प्रति सप्ताह घंटे, बँटवारा और इस प्रोजेक्ट की सभी प्रविष्टियाँ — देखें टाइम ट्रैकिंग।

लागत — केवल मालिक (Costs, owner only)

नाम, प्रकार, प्रति माह या प्रति वर्ष राशि और अवधि वाली चालू लागतें (“मद जोड़ें”)। बजट आप “बजट सेट करें” से सेट करते हैं। खपत गिनी जाती है, संभाली नहीं जाती: दर्ज समय गुणा घंटे की दर।

एनालिटिक्स (Analytics)

तीन सेक्शन: उपयोग और परफ़ॉर्मेंस (पिछले सात दिनों के मॉनिटर से त्रुटि दर और P95 लोड टाइम; विज़िट और कन्वर्ज़न तब तक ख़ाली रहते हैं जब तक कोई स्रोत उन्हें नहीं मापता — टाइल पर प्रश्नचिह्न बताता है क्यों), त्रुटियाँ (असाइन करने के लिए “त्रुटि स्रोत” पंक्ति के साथ) और मॉनिटर (एक कार्ड में सूची और फ़ॉर्म)।

मॉनिटर बनाएँ: URL, प्रकार (“उपलब्धता” या “सर्टिफ़िकेट”) और अंतराल। अगर कोई मॉनिटर लगातार दो बार विफल होता है, तो एक टिकट बनता है; जैसे ही वह फिर से पहुँच में आता है, टिकट हल हो जाता है।
Sentry, Bugsnag या Rollbar से त्रुटियाँ, जैसे ही “त्रुटि स्रोत असाइन करें” में प्रोवाइडर का कोई प्रोजेक्ट चुना जाए। “टास्क के रूप में बनाएँ” किसी त्रुटि को टास्क में बदलता है। “हल” उसे पहले प्रोवाइडर पर हल के रूप में चिह्नित करता है — आपके त्रुटि स्रोत के एक्सेस से — और उसके बाद ही यहाँ; यह बटन मालिक और स्टाफ़ सदस्यों के पास है। अगर प्रोवाइडर पर एक्सेस केवल पढ़ने का है (event:write के बिना Sentry, Organization Administrator या Project Owner भूमिका के बिना Bugsnag, “write” स्कोप वाले प्रोजेक्ट एक्सेस टोकन के बिना Rollbar), अगर प्रोवाइडर उस त्रुटि को अब नहीं जानता या दस सेकंड के भीतर जवाब नहीं देता, तो त्रुटि खुली रहती है और कारण सूची के नीचे दिखता है। errors:read वाली एजेंट कुंजी अपने प्रोजेक्ट की त्रुटियाँ पढ़ती है; errors:write के साथ वह इसी तरह किसी त्रुटि को हल के रूप में चिह्नित करती है। अगर त्रुटि बाद में फिर आती है, तो उसे रिग्रेशन माना जाता है।