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

Topos एक ओपन-सोर्स वेब एप्लिकेशन है जो फ़ाइल फ़ोल्डर, आर्काइव बॉक्स और दराज़ जैसे भौतिक भंडारण तथा उनमें मौजूद वस्तुओं को सूचीबद्ध करने के लिए है। यह चार-इकाई इन्वेंट्री मॉडल प्रदान करता है जिसमें कंटेनर, आइटम, पदानुक्रमित श्रेणियाँ और अनुवर्ती कार्रवाइयाँ शामिल हैं। ऐप एक ऑफ़लाइन-फर्स्ट Progressive Web App के रूप में चलता है जिसमें Dexie रीड-थ्रू कैश है, जो API के विरुद्ध पुनः सत्यापन से पहले IndexedDB से पृष्ठों को तुरंत रेंडर करता है। एक वैकल्पिक FastAPI/SQLite बैकएंड सत्य के एकल स्रोत के रूप में कार्य करता है। एक प्रमुख विशेषता दोषरहित Excel आयात है: उपयोगकर्ता एक विशिष्ट तीन-शीट आकार में कार्यपुस्तिका अपलोड कर सकते हैं, और Topos पूर्वज-श्रृंखला श्रेणियों सहित इन्वेंट्री को मूर्त रूप देता है। आयात कंटेनर बाहरी IDs पर निष्प्रभावी है, इसलिए उसी फ़ाइल को पुनः आयात करने पर कोई डुप्लिकेट उत्पन्न नहीं होता। आयात के समय जर्मन श्रेणी नामों को अंग्रेज़ी स्लग में अनुवादित किया जाता है जबकि मूल जर्मन को प्रदर्शन नामों के रूप में संरक्षित रखा जाता है। यह परियोजना PluginForge पर निर्मित है, जो एक एप्लिकेशन-अज्ञेय प्लगइन फ्रेमवर्क है, और Excel आयातक स्वयं एक प्लगइन के रूप में कार्यान्वित है। यह आर्किटेक्चर भविष्य के आयात, निर्यात, QR लेबल और फोटो संलग्नक का समर्थन करने के लिए अभिप्रेत है। Linux, macOS और Windows के लिए एक क्रॉस-प्लेटफ़ॉर्म डेस्कटॉप लॉन्चर उसी FastAPI और React कोडबेस से PyInstaller का उपयोग करके बनाया गया है। Topos बूटस्ट्रैप चरण में है और अभी तक उत्पादन-स्तर पर सुदृढ़ नहीं है। README रिवर्स प्रॉक्सी के बिना साझा अवसंरचना पर इसे चलाने के विरुद्ध सलाह देता है और डिफ़ॉल्ट गुप्त कुंजी को बदलने की अनुशंसा करता है। रिपॉज़िटरी में pytest के साथ बैकएंड परीक्षण, Vitest के साथ फ्रंटएंड परीक्षण और एक Playwright स्मोक स्पेक शामिल है।