منصوبے کے بارے میں

Topos ایک اوپن سورس ویب ایپلیکیشن ہے جو فزیکل اسٹوریج جیسے فائل فولڈرز، آرکائیو بکس، اور درازوں کے ساتھ ساتھ ان میں موجود اشیاء کی فہرست سازی کے لیے ہے۔ یہ چار اداروں پر مشتمل انوینٹری ماڈل فراہم کرتا ہے جس میں کنٹینرز، اشیاء، درجہ بندی کے لحاظ سے کیٹیگریز، اور فالو اپ ایکشنز شامل ہیں۔ یہ ایپ آف لائن فرسٹ پروگریسو ویب ایپ کے طور پر چلتی ہے جس میں Dexie ریڈ تھرو کیش ہے، جو IndexedDB سے صفحات فوری طور پر رینڈر کرتی ہے اور پھر API کے خلاف دوبارہ توثیق کرتی ہے۔ ایک اختیاری FastAPI/SQLite بیک اینڈ واحد سورس آف ٹروتھ کے طور پر کام کرتا ہے۔ ایک اہم خصوصیت بغیر نقصان کے ایکسل امپورٹ ہے: صارفین ایک مخصوص تین شیٹ کی شکل میں ورک بک اپ لوڈ کر سکتے ہیں، اور Topos انوینٹری کو بشمول آبائی سلسلے کی کیٹیگریز کے مواد بناتا ہے۔ امپورٹ کنٹینر ایکسٹرنل IDs پر idempotent ہے، لہذا ایک ہی فائل کو دوبارہ امپورٹ کرنے سے کوئی ڈپلیکیٹ نہیں بنتا۔ جرمن کیٹیگری کے نام امپورٹ کے وقت انگریزی slugs میں ترجمہ کیے جاتے ہیں جبکہ اصل جرمن کو ڈسپلے ناموں کے طور پر محفوظ رکھا جاتا ہے۔ یہ پروجیکٹ PluginForge پر بنایا گیا ہے، جو ایک ایپلیکیشن سے آزاد پلگ ان فریم ورک ہے، اور ایکسل امپورٹر خود ایک پلگ ان کے طور پر نافذ کیا گیا ہے۔ اس آرکیٹیکچر کا مقصد مستقبل میں امپورٹس، ایکسپورٹس، QR لیبلز، اور فوٹو اٹیچمنٹس کی سپورٹ کرنا ہے۔ Linux، macOS، اور Windows کے لیے ایک کراس پلیٹ فارم ڈیسک ٹاپ لانچر اسی FastAPI اور React کوڈ بیس سے PyInstaller کا استعمال کرتے ہوئے بنایا گیا ہے۔ Topos بوٹ اسٹریپ مرحلے میں ہے اور ابھی پروڈکشن کے لیے مضبوط نہیں ہے۔ README مشورہ دیتا ہے کہ اسے ریورس پراکسی کے بغیر مشترکہ انفراسٹرکچر پر نہ چلائیں اور ڈیفالٹ سیکرٹ کی کو تبدیل کرنے کی سفارش کرتا ہے۔ ریپوزٹری میں pytest کے ساتھ بیک اینڈ ٹیسٹس، Vitest کے ساتھ فرنٹ اینڈ ٹیسٹس، اور ایک Playwright اسموک اسپیک شامل ہیں۔