कोड विश्लेषण और सिस्टम दस्तावेज़ीकरण जनरेटर

आप कोड विश्लेषण और सिस्टम दस्तावेज़ीकरण के विशेषज्ञ हैं। आपका कार्य इस प्रोजेक्ट/वर्कस्पेस में दिए गए सोर्स कोड का विश्लेषण करना और एक व्यापक Markdown दस्तावेज़ तैयार करना है जो कई दर्शकों (कार्यकारी, तकनीकी, व्यवसाय और उत्पाद) के लिए ऑनबोर्डिंग गाइड के रूप में कार्य करे। ## निर्देश दिए गए सोर्स कोड का विश्लेषण करें और निम्नलिखित जानकारी निकालें, इसे एक सुव्यवस्थित Markdown दस्तावेज़ में व्यवस्थित करें: --- ## 1. कार्यकारी-स्तरीय दृश्य: कार्यकारी सारांश ### एप्लिकेशन का उद्देश्य - इस सिस्टम का मुख्य उद्देश्य क्या है? - यह उच्च स्तर पर किस समस्या का समाधान करना चाहता है? ### यह कैसे काम करता है (उच्च-स्तर) - गैर-तकनीकी दर्शकों के लिए समग्र सिस्टम प्रवाह को संक्षिप्त और सुलभ तरीके से वर्णित करें। - सिस्टम द्वारा किए जाने वाले मुख्य चरण या प्रक्रियाएं क्या हैं? ### उच्च-स्तरीय व्यावसायिक नियम - कोड में लागू मुख्य व्यावसायिक नियमों की पहचान करें और उनका वर्णन करें। - मौलिक व्यावसायिक नीतियां, बाधाएं या तर्क क्या हैं जिनका सिस्टम पालन करता है? ### प्रमुख लाभ - यह सिस्टम संगठन या इसके उपयोगकर्ताओं को मुख्य लाभ क्या प्रदान करता है? --- ## 2. तकनीकी-स्तरीय दृश्य: प्रौद्योगिकी अवलोकन ### सिस्टम आर्किटेक्चर - कोड विश्लेषण के आधार पर समग्र सिस्टम आर्किटेक्चर का वर्णन करें। - क्या यह किसी विशिष्ट पैटर्न का पालन करता है (जैसे, Monolithic, Microservices, आदि)? - पहचाने गए मुख्य घटक या मॉड्यूल क्या हैं? ### उपयोग की गई प्रौद्योगिकियां (प्रौद्योगिकी स्टैक) - प्रोजेक्ट में उपयोग की गई सभी प्रोग्रामिंग भाषाएं, फ्रेमवर्क, लाइब्रेरी, डेटाबेस और अन्य तकनीकों की सूची बनाएं। ### मुख्य तकनीकी प्रवाह - सिस्टम के भीतर मुख्य डेटा और निष्पादन प्रवाह का विवरण दें। - विभिन्न घटक एक दूसरे के साथ कैसे इंटरैक्ट करते हैं? ### प्रमुख घटक - सबसे महत्वपूर्ण सिस्टम घटकों की पहचान करें और उनका वर्णन करें, आर्किटेक्चर में उनकी भूमिका और जिम्मेदारी स्पष्ट करें। ### कोड जटिलता (अवलोकन) - अपने विश्लेषण के आधार पर, कोड जटिलता के बारे में सामान्य अवलोकन प्रदान करें (जैसे, अच्छी तरह से संरचित, मॉड्यूलराइज़्ड, उच्च स्पष्ट जटिलता वाले क्षेत्र)। ### आरेख - सिस्टम आर्किटेक्चर और व्यवहार को विज़ुअलाइज़ करने के लिए उच्च-स्तरीय आरेख तैयार करें: - घटक आरेख (प्रमुख मॉड्यूल और उनकी इंटरैक्शन पर ध्यान केंद्रित करते हुए) - डेटा प्रवाह आरेख (यह दिखाते हुए कि जानकारी सिस्टम के माध्यम से कैसे चलती है) - क्लास आरेख (प्रमुख क्लासेस और उनके संबंध प्रस्तुत करते हुए, यदि लागू हो) - सरलीकृत डिप्लॉयमेंट आरेख (यह दिखाते हुए कि घटक कहां चलते हैं, यदि पता लगाने योग्य हो) - सरलीकृत इंफ्रास्ट्रक्चर/डिप्लॉयमेंट आरेख (यदि इंफ्रास्ट्रक्चर विवरण स्पष्ट हों) - उपरोक्त आरेखों को Markdown फ़ाइल के भीतर Mermaid सिंटैक्स का उपयोग करके बनाएं। आरेख उच्च-स्तरीय रहने चाहिए और अत्यधिक विस्तृत नहीं होने चाहिए। --- ## 3. उत्पाद दृश्य: उत्पाद सारांश ### सिस्टम क्या करता है (विस्तृत) - सिस्टम की मुख्य कार्यक्षमताओं का विस्तार से वर्णन करें। - उपयोगकर्ता कौन से कार्य या क्रियाएं कर सकते हैं? ### सिस्टम किसके लिए है (उपयोगकर्ता / ग्राहक) - सिस्टम के प्राथमिक लक्षित दर्शकों की पहचान करें। - अंतिम उपयोगकर्ता या ग्राहक कौन हैं जो इससे लाभान्वित होते हैं? ### यह किन समस्याओं का समाधान करता है (संबोधित आवश्यकताएं) - सिस्टम उपयोगकर्ताओं या संगठन के लिए किन विशिष्ट समस्याओं को हल करने में मदद करता है? - यह किन आवश्यकताओं को संबोधित करता है? ### उपयोग के मामले / उपयोगकर्ता यात्राएं (उच्च-स्तर) - सिस्टम के मुख्य उपयोग के मामले क्या हैं? - उपयोगकर्ता अपने लक्ष्यों को प्राप्त करने के लिए सिस्टम के साथ कैसे इंटरैक्ट करते हैं? ### मुख्य विशेषताएं - सबसे महत्वपूर्ण सिस्टम सुविधाओं को स्पष्ट और संक्षिप्त रूप से सूचीबद्ध करें। ### व्यावसायिक डोमेन - सिस्टम द्वारा कवर किए गए मुख्य व्यावसायिक डोमेन की पहचान करें (जैसे, बिक्री, इन्वेंट्री, वित्त)। --- ## विश्लेषण सीमाएं - कोड विश्लेषण के दौरान आने वाली मुख्य सीमाएं क्या थीं? - संक्षेप में वर्णन करें कि कोड की आपकी समझ को किसने बाधित किया। - इन सीमाओं को कम करने या समाप्त करने के लिए सुझाव प्रदान करें। --- ## दस्तावेज़ दिशानिर्देश ### दस्तावेज़ प्रारूप - दस्तावेज़ Markdown में स्वरूपित होना चाहिए, प्रत्येक अनुभाग के लिए स्पष्ट शीर्षक और उपशीर्षक के साथ। - पठनीयता और समझ में सुधार के लिए सूचियों, तालिकाओं और अन्य Markdown तत्वों का उपयोग करें। ### अतिरिक्त निर्देश - प्रासंगिक, उच्च-स्तरीय जानकारी देने पर ध्यान केंद्रित करें, जब तक कि समझने के लिए महत्वपूर्ण न हो, अत्यधिक कार्यान्वयन विवरण से बचें। - कई दर्शकों के लिए उपयुक्त स्पष्ट, संक्षिप्त और सुलभ भाषा का उपयोग करें। - कोड विश्लेषण के आधार पर जितना संभव हो उतना विशिष्ट रहें। - पूर्ण प्रतिक्रिया को एक अच्छी तरह से स्वरूपित Markdown (.md) दस्तावेज़ के रूप में तैयार करें। - स्पष्ट और प्रत्यक्ष भाषा का उपयोग करें। - उपरोक्त अनुभागों के अनुसार शीर्षकों और उपशीर्षकों का उपयोग करें। ### दस्तावेज़ शीर्षक एप्लिकेशन का कार्यकारी और व्यावसायिक विश्लेषण - "<application-name>" ### दस्तावेज़ सारांश यह दस्तावेज़ <system-name> सिस्टम के सोर्स कोड विश्लेषण का परिणाम है और निम्नलिखित क्षेत्रों को कवर करता है: - कार्यकारी-स्तरीय दृश्य: एप्लिकेशन के उद्देश्य, उच्च-स्तरीय संचालन, मुख्य व्यावसायिक नियम और प्रमुख लाभों का सारांश। - तकनीकी-स्तरीय दृश्य: सिस्टम आर्किटेक्चर, उपयोग की गई तकनीकों, मुख्य प्रवाह, प्रमुख घटकों और आरेखों (घटक, डेटा प्रवाह, क्लासेस और डिप्लॉयमेंट) के बारे में विवरण। - उत्पाद दृश्य: सिस्टम कार्यक्षमता, लक्षित उपयोगकर्ताओं, संबोधित समस्याओं, मुख्य उपयोग के मामलों, सुविधाओं और व्यावसायिक डोमेन का विस्तृत विवरण। - विश्लेषण सीमाएं: प्रमुख विश्लेषण बाधाओं की पहचान और उन्हें दूर करने के सुझाव। विश्लेषण उपलब्ध सोर्स कोड फ़ाइलों पर आधारित था। --- ## महत्वपूर्ण विश्लेषण में सभी प्रोजेक्ट फ़ाइलों पर विचार किया जाना चाहिए। कार्य को पूरा करने और सिस्टम की पूरी समझ हासिल करने के लिए आवश्यक सभी फाइलों को पढ़ें और समझें। --- ## कार्रवाई कृपया मेरे वातावरण/वर्कस्पेस में वर्तमान में उपलब्ध सोर्स कोड का विश्लेषण करें और अनुरोधित Markdown दस्तावेज़ तैयार करें। आउटपुट फ़ाइल नाम इस प्रारूप का पालन करना चाहिए: <yyyy-mm-dd-project-name-app-discovery_cursor.md>