HI

ऐप रिक्वायरमेंट डॉक्यूमेंट: ऐप स्पेक क्या है और आप इसे मंज़ूर क्यों करते हैं

एक पेज का स्पेक जिसे आप पहले मंज़ूर करते हैं: Deployflix ब्लॉग पोस्ट का कवर

ऐप रिक्वायरमेंट डॉक्यूमेंट, या ऐप स्पेक, किसी ऐप को बनाने से पहले उसका एक छोटा लिखित प्लान है: उसे कौन इस्तेमाल करेगा, उनमें से हर किसी को कौन-सी स्क्रीन दिखेंगी, वह कौन-सी जानकारी रखता है, किन सेवाओं से जुड़ता है, अभी के लिए क्या छोड़ा गया है और बिल्ड का अधिकतम खर्च कितना हो सकता है। आप इसे पढ़ते हैं, इस पर सवाल करते हैं और इसे बदलते हैं, और जब यह ठीक वैसे ऐप को बताता है जैसा आप सच में चाहते हैं, तभी आप इसे मंज़ूर करते हैं।

आप इसे पहले इसलिए मंज़ूर करते हैं क्योंकि ग़लती पकड़ने की सबसे सस्ती जगह स्पेक ही है। पेज पर एक लाइन इधर-उधर करने में कुछ ख़र्च नहीं होता। बिल्ड के बाद पता चलना कि ट्यूटर हर पेरेंट का फ़ोन नंबर देख सकते हैं, या फ़ीस किस्तों में नहीं भरी जा सकती, मतलब दोबारा बनाना।

सॉफ़्टवेयर स्पेसिफ़िकेशन, आसान शब्दों में क्या है?

सॉफ़्टवेयर में, स्पेसिफ़िकेशन (बड़े प्रोजेक्ट में अक्सर रिक्वायरमेंट डॉक्यूमेंट, या SRS यानी सॉफ़्टवेयर रिक्वायरमेंट्स स्पेसिफ़िकेशन कहा जाता है) ऐप की ज़रूरत वाले व्यक्ति और उसे बनाने वाले के बीच का समझौता है। यह बताता है कि ऐप को क्या करना है, यह नहीं कि कोड उसे कैसे करता है। किसी दुकान, क्लब या स्कूल के लिए आम तौर पर एक पेज काफ़ी है, बशर्ते वह साफ़-साफ़ और आसान शब्दों में हो।

स्पेक की जाँच आसान है: क्या दो अलग बनाने वाले इसे पढ़कर लगभग एक जैसा ऐप बना सकते हैं? अगर पेज पर लिखा है छात्र अपने नतीजे देख सकते हैं, तो यह एक इच्छा है। अगर लिखा है छात्र फ़ोन नंबर से साइन इन करता है और अपने टेस्ट के अंक, विषय के हिसाब से, बैच के औसत के साथ देखता है, तो यह एक रिक्वायरमेंट है जिसे कोई बना सकता है और आप जाँच सकते हैं।

एक पेज के ऐप रिक्वायरमेंट डॉक्यूमेंट में क्या होता है?

मान लीजिए एक ट्यूशन सेंटर है जिसे क्लास, हाज़िरी और फ़ीस के लिए ऐप चाहिए। उसके लिए एक काम के एक पेज के स्पेक में ये हिस्से होते हैं:

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

रोल के हिसाब से स्क्रीन वह हिस्सा है जिसे लोग जल्दी-जल्दी पढ़ जाते हैं, और यही सबसे ज़रूरी है। एक ऐप असल में डेटा के एक ही सेट को शेयर करने वाले कई ऐप होता है: मालिक का व्यू, ट्यूटर का व्यू और पेरेंट का व्यू। स्क्रीन को रोल-दर-रोल पढ़कर ही आप देख पाते हैं कि ट्यूटर हाज़िरी लगा तो सकता है, पर उसमें हुई ग़लती कोई ठीक नहीं कर सकता।

अभी के लिए छोड़ा गया वाली लाइन भी उतनी ही ज़रूरी है। यह बताती है कि आपको क्या नहीं मिल रहा, और बिल्ड के बाद निराशा की आम वजह यही होती है। जो शामिल नहीं है उसकी छोटी, ईमानदार लिस्ट अच्छे स्पेक की निशानी है, कमज़ोर की नहीं।

जब आप Deployflix को कोई ऐप बताते हैं, तो वह जो स्पेक लिखता है वह इसी ढाँचे में होता है: ऐप कौन इस्तेमाल करता है, उसकी स्क्रीन, वह कौन-सा डेटा रखता है, अभी के लिए क्या छोड़ा गया है और बिल्ड का अधिकतम खर्च, उसी भाषा में जिसमें आपने लिखा। अगर आपके विवरण में कुछ साफ़ नहीं है, तो प्लान बनाने से पहले यह पूछता है। यह कैसे काम करता है दिखाता है कि स्टेप में स्पेक कहाँ आता है।

ऐप स्पेक को कैसे पढ़ें और उस पर सवाल कैसे करें?

स्पेक को किसी कॉन्ट्रैक्ट की तरह ऊपर से नीचे मत पढ़िए। इसे अपने बिज़नेस के एक दिन की तरह पढ़िए।

  1. हर रोल बनकर एक असली दिन से गुज़रें। वह क्या टैप करता है, उसे क्या दिखता है, वह क्या भरता है? फिर हर दूसरे रोल के लिए भी ऐसा ही करें।
  2. एक रिकॉर्ड को शुरू से आख़िर तक देखें। एक छात्र, ऑर्डर या बुकिंग चुनें। उसे कौन बनाता है, कौन बदलता है, कौन हटा सकता है, और आख़िर में वह कहाँ पहुँचता है?
  3. गड़बड़ वाले रास्ते देखें। कैंसल हुई बुकिंग, रिफ़ंड, ग़लत एंट्री, फ़ेल हुआ पेमेंट, छोड़कर जाने वाला सदस्य। अगर स्पेक में सिर्फ़ सब कुछ ठीक चलने की बात है, तो पूछें कि जब ठीक न चले तब क्या होता है।
  4. हर वह नंबर और शब्द जाँचें जो आप प्रिंट करेंगे। इनवॉइस फ़ॉर्मैट, फ़ीस की किस्तें, टैक्स की लाइनें और रसीद नंबर वैसे ही होने चाहिए जैसे आप आज काम करते हैं। अगर आपके इनवॉइस पर GST, VAT या सेल्स टैक्स जैसा कोई टैक्स दिखाना ज़रूरी है, तो ब्योरे अपने अकाउंटेंट से जँचवा लें।
  5. जो भी धुँधला हो, उसके बारे में पूछें। मैनेज, ट्रैक, आसान और रिपोर्ट जैसे शब्द फ़ैसलों को छिपा लेते हैं। पूछें: कौन-सी रिपोर्ट, उसमें क्या दिखेगा, किसके लिए?

मंज़ूर करने से पहले किन कमियों को देखना चाहिए?

जो स्पेक गड़बड़ होते हैं, उनमें से ज़्यादातर ग़लत नहीं होते; वे अधूरे होते हैं। ये कमियाँ सबसे ज़्यादा सामने आती हैं।

कौन क्या देख सकता है

रोल का नाम रखना आसान है और उन्हें धुँधला छोड़ देना भी। जाँचें कि हर रोल क्या देख सकता है, सिर्फ़ यह नहीं कि वह क्या कर सकता है। क्या ट्यूटर फ़ीस देख सकता है? क्या एक पेरेंट दूसरे बच्चे के अंक देख सकता है? क्या स्टाफ़ का कोई सदस्य ग्राहकों की लिस्ट डाउनलोड कर सकता है? अगर ऐप व्यक्तिगत जानकारी रखता है, तो अभी तय करें कि उसे कौन देख सकता है।

बदलना, कैंसल करना और पलटना

हर रिकॉर्ड को किसी दिन सुधारने की ज़रूरत पड़ेगी। जाँचें कि स्पेक में लिखा है कि कोई एंट्री कौन बदल या कैंसल कर सकता है, और क्या पुरानी वैल्यू रखी जाती है।

पैसा

अगर ऐप पेमेंट लेता है, तो स्पेक में पेमेंट के चरण दिखने चाहिए: ग्राहक किन तरीकों से पेमेंट कर सकते हैं (कार्ड और स्थानीय पेमेंट तरीके), पेमेंट किस चीज़ के लिए है, क्या कुछ राशि पहले दी जा सकती है, ग्राहक को पेमेंट के बाद क्या मिलता है और पेमेंट न होने या असफल होने पर क्या होता है। रिफ़ंड के नियम बिज़नेस का फ़ैसला हैं, इसलिए अपने नियम लिख लें। गेटवे आम तौर पर हर लेन-देन पर कुछ प्रतिशत शुल्क लेते हैं और कई देशों में उसके साथ एक तय शुल्क भी लगता है, इसलिए अपने गेटवे की कीमतों वाला पेज देखें। Deployflix के ऐप Razorpay या कैशफ़्री जैसे पेमेंट गेटवे से पेमेंट लेते हैं; अंतरराष्ट्रीय गेटवे जल्द आ रहे हैं। हमारे इंटीग्रेशन पेज पर देखें कि अभी किन सेवाओं से जुड़ सकते हैं।

मैसेज और रिमाइंडर

अगर आप रिमाइंडर चाहते हैं, तो बताएँ कि वे लोगों तक कैसे पहुँचें: ईमेल से, ऐप के अंदर, या किसी और तरीके से। अगर स्पेक में किसी चैनल का ज़िक्र नहीं है, तो मान लें कि वह नहीं है।

आपका मौजूदा डेटा

स्प्रेडशीट और पुराने रजिस्टर अक्सर नए ऐप में ले जाने पड़ते हैं। पूछें कि इन्हें लाना स्पेक का हिस्सा है या छोड़ा गया वाली लिस्ट में है।

डिवाइस और भाषाएँ

लोग इसे फ़ोन पर इस्तेमाल करेंगे, दुकान के काउंटर वाले कंप्यूटर पर या दोनों पर? क्या इसे अंग्रेज़ी के साथ स्पैनिश, अरबी, फ़्रेंच या किसी दूसरी भाषा में भी चाहिए? इन बातों से स्क्रीन तय होती हैं, इसलिए बिल्ड शुरू होने से पहले इन्हें तय कर लें। Deployflix आपके ऐप के शब्द आपकी बताई भाषा में लिखता है और खुद 41 भाषाओं में काम करता है।

कुछ भी बनने से पहले स्पेक को मंज़ूर क्यों करें?

क्योंकि एक वाक्य बदलना ऐप बदलने से सस्ता है। बिल्ड से पहले, पेरेंट का रोल या फ़ीस की एक किस्त जोड़ना पेज पर एक बदलाव भर है। बिल्ड के बाद, वही बदलाव उन स्क्रीन, डेटा और अनुमतियों को छू सकता है जो पहले ही पूरी हो चुकी थीं।

मंज़ूरी देने से आपके पास तैयार ऐप को जाँचने का एक आधार भी होता है। बिल्ड पूरा होने पर, स्पेक खोलें और एक-एक करके टिक करें: हर रोल, हर स्क्रीन, डेटा का हर हिस्सा। जो भी छूटा हो, उसे उठाना जायज़ है।

स्पेक में आपके आगे बढ़ने का फ़ैसला करने से पहले ही लागत भी तय हो जाती है। जब बिल्ड की अधिकतम लागत स्पेक पर लिखी हो, तो आप वह रकम सामने रखकर फ़ैसला कर सकते हैं। Deployflix पर यह ऊपरी सीमा आपकी मंज़ूरी से पहले दिखाई जाती है और आप सिर्फ़ बिल्ड में सचमुच इस्तेमाल हुए क्रेडिट का भुगतान करते हैं, जैसा कि कीमतों वाले पेज पर समझाया गया है।

ऐप बनने के बाद बदलावों की योजना कैसे बनती है?

कोई ऐप शायद ही कभी पूरी तरह तैयार होता है। नया कोर्स, दूसरी जगह, फ़ीस लेने का नया तरीक़ा: हर एक पर पहले बिल्ड जितना ही ध्यान देना चाहिए।

हर बदलाव की योजना उसके अपने छोटे स्पेक की तरह बनाएँ: क्या बदलता है, यह किन रोल और स्क्रीन को छूता है, कौन-सा डेटा जुड़ता या बदलता है, क्या वैसा ही रहता है, और इसका खर्च कितना हो सकता है। इसे उन्हीं सवालों के साथ पढ़ें और काम शुरू होने से पहले मंज़ूर करें। पिछला वर्ज़न रखें, ताकि अगर बदलाव गड़बड़ हो जाए तो आप उस वर्ज़न पर लौट सकें जो काम करता था।

Deployflix बदलावों को इसी तरह संभालता है: आप बताते हैं कि क्या बदलना है, यह उस बदलाव को अगले वर्ज़न के रूप में प्लान करता है, और मंज़ूरी के बिना कुछ नहीं बनता। हर पिछला वर्ज़न रखा जाता है। किसी संगठन में, सिर्फ़ वही लोग मंज़ूरी दे सकते हैं जिनका रोल इसकी अनुमति देता है, जैसा कि सुरक्षा पेज बताता है।

एक ऐप स्पेक टेम्पलेट जिसे आप इस्तेमाल कर सकते हैं

अगर आप अपना स्पेक ख़ुद लिख रहे हैं, तो ये हेडिंग कॉपी करें और हर एक को आसान वाक्यों से भरें:

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

रोल, स्क्रीन और डेटा के तैयार उदाहरणों के लिए, कोचिंग बैच मैनेजमेंट सिस्टमEN या क्लिनिक अपॉइंटमेंट बुकिंग ऐपEN देखें। कोई आइडिया परखने वाला फ़ाउंडर स्पेक को और भी छोटा रख सकता है, एक रोल, कुछ स्क्रीन और जो शामिल नहीं है उसकी पक्की लिस्ट के साथ, जैसे स्टार्टअप MVP वेब ऐपEN के लिए।

सवाल

ऐप स्पेक और रिक्वायरमेंट डॉक्यूमेंट में क्या फ़र्क़ है?

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

ऐप स्पेक किसे लिखना चाहिए?

जो व्यक्ति बिज़नेस को जानता है, वह सामग्री देता है: रोल, रोज़ का काम और नियम। बनाने वाला इसे एक व्यवस्थित स्पेक में बदल सकता है, लेकिन यह सही है या नहीं, यह सिर्फ़ आप बता सकते हैं।

क्या मंज़ूरी देने के बाद स्पेक बदला जा सकता है?

हाँ। इसे एक बदलाव की तरह लें: बताइए कि क्या अलग है, अपडेट हुआ प्लान पढ़ें और उसे फिर से मंज़ूर करें। पिछला वर्ज़न रखें ताकि आप तुलना कर सकें या उस पर लौट सकें।

ऐप स्पेक कितना लंबा होना चाहिए?

इतना लंबा कि कोई ज़रूरी बात अंदाज़े पर न छूटे, और इतना छोटा कि आप पूरा पढ़ लें। ज़्यादातर छोटे बिज़नेस के ऐप के लिए एक पेज सही है; अगर यह बहुत लंबा हो जाए, तो चरणों में बनाने पर विचार करें।

अपना ऐप बताइए

अपनी ज़रूरत अपने शब्दों में लिखिए। Deployflix खर्च के साथ एक पेज का प्लान लिखता है, और आपकी मंज़ूरी के बाद ही बनाता है।