इस प्रोजेक्ट के बारे में

यह रिपॉजिटरी वास्तविक संचालन हेतु एक ई-कॉमर्स कार्य मंच है, न कि केवल डेटा डैशबोर्ड। सिस्टम एक साथ घरेलू बिक्री, विदेशी व्यापार, आपूर्ति श्रृंखला, इन्वेंट्री, लॉजिस्टिक्स, वित्त और मासिक समापन को संभालता है, तथा एकीकृत व्यवसाय डेटा और वित्तीय मद आधार के माध्यम से सभी मॉड्यूल को जोड़ता है। मुख्य कार्य प्रवेश तीन भागों में विभाजित हैं: घरेलू बिक्री कार्यक्षेत्र (संचालन अवलोकन, बिक्री केंद्र, आधारभूत माल, इन्वेंट्री केंद्र, आपूर्ति श्रृंखला केंद्र, एक्सप्रेस लॉजिस्टिक्स, वित्त केंद्र), विदेशी व्यापार कार्यक्षेत्र (विदेशी व्यापार अवलोकन, विदेशी व्यापार आदेश, B2B ग्राहक और वितरक, चैनल प्रबंधन, विदेशी SKU मैपिंग, अंतर्राष्ट्रीय शिपमेंट, विदेशी व्यापार वित्त, Alsvid व्यवसाय), तथा स्वतंत्र वित्त केंद्र। वित्त केंद्र कंपनी इकाई को प्रथम आयाम और व्यवसाय क्षेत्र को द्वितीय आयाम मानता है। डिफ़ॉल्ट इकाई झेजियांग कंपनी है, तथा ऑस्ट्रिया, जर्मनी, हांगकांग आदि इकाइयों के विस्तार हेतु आरक्षित है, जिससे वित्तीय प्रणाली को पुनः बनाने की आवश्यकता नहीं होती। मुख्य मॉडल FinanceEntry है, जिसमें कंपनी इकाई, व्यवसाय क्षेत्र, स्रोत मॉड्यूल और क्रमांक, वित्तीय श्रेणी, आय-व्यय, मुद्रा, राशि और कर, अनुमानित और वास्तविक, निपटान स्थिति, चालान स्थिति, लेखा अवधि, तथा नकदी और लाभ पर प्रभाव जैसे आयाम शामिल हैं। नकदी और लाभ को अलग-अलग संभाला जाता है, उदाहरण के लिए कटौती योग्य आयात VAT नकदी को प्रभावित करता है किंतु लाभ को सीधे प्रभावित नहीं करता, तथा Shipment माल लागत लाभ को प्रभावित करती है किंतु खरीद भुगतान नकदी की पुनः गणना नहीं करती। व्यवसाय श्रृंखला में, घरेलू बिक्री बिक्री आदेश, बिक्री-पश्चात धनवापसी, बिक्री लागत, खरीद प्राप्ति देय, एक्सप्रेस लॉजिस्टिक्स अनुमानित और वास्तविक बिल समाधान को एकीकृत रूप से FinanceEntry में समाहित करती है; विदेशी व्यापार विदेशी व्यापार आदेश, Shipment शिपिंग आदेश, चीन निर्यात, अंतर्राष्ट्रीय परिवहन, EU आयात सीमा शुल्क निकासी, विदेशी अंतिम-मील वितरण, वित्तीय मद और मासिक समापन के क्रम में प्रवाहित होता है। Shipment निर्यात और आयात कंपनी इकाई, आयात उत्तरदायित्व पक्ष, बिल ऑफ लैडिंग कंटेनर नंबर Tracking, निर्यात और आयात सीमा शुल्क घोषणा, सामान्य शुल्क, एंटी-डंपिंग शुल्क, प्रतिकारी शुल्क, आयात VAT, सीमा शुल्क निकासी बंदरगाह शुल्क और अंतिम-मील वितरण, निर्यात कर छूट तथा अनुमानित और वास्तविक लागत दर्ज कर सकता है। आयात कर केवल तभी संबंधित इकाई के वित्त में प्रवेश करता है जब हमारी पक्ष इकाई आयात उत्तरदायित्व वहन करती है। मासिक समापन केंद्र कंपनी इकाई के अनुसार स्विच होता है, सीधे व्यवसाय डेटाबेस पढ़ता है, व्यवसाय डेटा पूर्णता जांच, बिक्री राशि और लागत जांच, बैंक लेनदेन विवरण और रसीद, बिना चालान आय, विदेशी व्यापार वित्त सारांश, मासिक ZIP पैकेजिंग, वित्त को ईमेल भेजना और ऐतिहासिक संस्करण संग्रह प्रदान करता है। यदि बिक्री SKU में खरीद प्राप्ति लागत अनुपलब्ध है, तो सिस्टम स्पष्ट रूप से अनुपलब्ध SKU की सूचना देता है, न कि काल्पनिक लागत से गलत लाभ उत्पन्न करता है। बाह्य डेटा स्रोत वर्तमान में जिकेयुन, 1688, झेजियांग ग्रामीण क्रेडिट फ़ाइल आयात, कर चालान सूची, SMTP वित्त ईमेल, तथा विदेशी व्यापार चैनल और Shopify के आगामी एकीकरण का समर्थन या आरक्षण करते हैं; असंरचित बाह्य सिस्टम वास्तविक रूप से असंरचित दिखाए जाते हैं, वास्तविक कनेक्शन को छिपाने हेतु सिम्युलेटेड डेटा का उपयोग नहीं किया जाता। तकनीकी स्टैक बैकएंड में Python 3.12, FastAPI, SQLAlchemy 2, Alembic, Pydantic, PostgreSQL, Celery और Redis; फ्रंटएंड में Next.js 16, React 19, Tailwind CSS 4 है, जो स्थैतिक निर्यात का उपयोग करता है और FastAPI द्वारा समान पोर्ट पर होस्ट किया जाता है। डिफ़ॉल्ट सेवा पोर्ट 127.0.0.1:8000 है, PostgreSQL और Redis सार्वजनिक नेटवर्क के लिए खुले नहीं हैं। वर्तमान मुख्य विकास और स्वीकृति वातावरण Mac स्थानीय मूल निष्पादन है, NAS और जिकोंगजियान परिनियोजन अस्थायी रूप से स्थगित है, कंटेनरीकरण और रिलीज़ कॉन्फ़िगरेशन सुरक्षित रखा गया है। विकास प्रक्रिया प्रत्यक्ष सबमिट मोड अपनाती है, दैनिक परिवर्तन सीधे develop में कमिट और पुश किए जाते हैं, CI push द्वारा ट्रिगर होता है, main आधिकारिक रिलीज़ मुख्य शाखा है। रिपॉजिटरी स्थिति देखने, पुनः आरंभ, फ्रंटएंड पुनर्निर्माण, Alembic माइग्रेशन, बैकएंड परीक्षण, फ्रंटएंड प्रकार जांच, स्थानीय पूर्ण स्वीकृति और बैकअप हेतु make कमांड प्रदान करती है। स्थायित्व सिद्धांत कोड, डेटाबेस, व्यवसाय फ़ाइलें, बैकअप और लॉग को अलग रखने पर बल देता है, PERSIST_ROOT, DATA_DIR, BACKUP_DIR, LOG_DIR कॉन्फ़िगरेशन के माध्यम से, ताकि Git अद्यतन या शाखा स्विच व्यवसाय डेटा को अधिलेखित न करे। सुरक्षा सिद्धांतों में .env को Git में कमिट न करना, डेटाबेस और कैश को सार्वजनिक नेटवर्क पर न खोलना, विकास चरण में पोर्ट 8000 को सार्वजनिक नेटवर्क पर उजागर न करना, 1688 केवल पहले से हुई खरीद को सिंक करता है न कि स्वचालित आदेश भुगतान, मूल वित्तीय सामग्री का संस्करण सुरक्षित रखना, डेटाबेस संरचना परिवर्तन अनिवार्य रूप से Alembic से होना चाहिए, तथा बड़े संरचनात्मक समायोजन से पहले बैकअप लेना शामिल है। सिस्टम अद्यतन मूल मोड और कंटेनर रिलीज़ पहचान का समर्थन करता है, Git शाखा और रिमोट, कार्यक्षेत्र स्थिति, Python और Node वातावरण, Alembic, बैकअप क्षमता, फ्रंटएंड आर्टिफैक्ट, स्वास्थ्य जांच और डिस्क स्थान की जांच करता है।