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