عن المشروع

ستاش هو نظام مخزون منزلي ذاتي الاستضافة للمنازل، يعامل العناصر بشكل أساسي كأشياء تحمل رموزًا شريطية أو رموز QR. بدلاً من كونه أداة للوصفات أو التخطيط للوجبات، يركز على تدفقات التزود بالمخزون/الاستهلاك السريعة، وتتبع انخفاض المخزون وتواريخ الانتهاء، والملصقات القابلة للطباعة، والأتمتة الاختيارية عبر واجهات الويب الخارجية. القدرات الرئيسية: - مسح مستمر بالكاميرا في وضعي التزويد (إضافة +1) والاستهلاك (إنقاص -1) مع تلميحات التنسيق، ودقة أعلى، وتركيز تلقائي، وسماع نغمة التنبيه، واهتزاز هاتفي، وزر تبديل الوميض للإضاءة المنخفضة. يتم إنشاء عنصر جديد تلقائيًا للباركود المجهول وفتح ورقة سريعة لتحديد الموقع والحد. - نموذج موحد للعنصر والباركود يدعم UPC/EAN، ورموز QR الداخلية الصادرة (ربط عميق بالعنصر)، ورموز pairing Matter، وأرقام التسلسل اليدوية. زر طباعة واحد يرسل رمز الباركود المحدد فقط، وهو أمر مهم عندما يحمل العنصر عدة رموز. - وضع الأصول للأجهزة الفردية، مع تتبع الحالة، وإدخال رمز تسلسلي للباركود، وسجل تاريخ الصيانة. يتم استبعاد عناصر الأصول من قائمة التسوق ومنطق انخفاض المخزون. - مواقع وفئات متداخلة معروضة كشجرة منسوبة، مع بحث، وفلاتر، وترتيب، ترقيم صفحات، والاحتفاظ بحالة الفلتر والترتيب المستخدمة آخر مرة. عمليات الكتلة تتيح تحريك أو حذف العناصر المحددة دفعة واحدة. - تفاصيل العنصر تتضمن الكمية، حد انخفاض المخزون، وتواريخ الانتهاء/الضمان، والسعر مع عملة افتراضية، وتعديل اسم/وحدة مدمج، ومرفقات، وسجلات التعديل/الصيانة. - مرفقات الملفات للفواتير، والكتيبات، وضمانات، والصور. يمكن أن تصبح أي صورة الصورة الرمزية التمثيلية للعنصر؛ يتم تعديل الصور المرفوعة تلقائيًا. - لوحة تحكم تبرز إجمالي قيمة المخزون، والعناصر منخفضة المخزون، والعناصر التي تنتهي قريباً، والعناصر المضافة مؤخراً، بالإضافة إلى قائمة مهام بدء التشغيل للمواقع، والإشعارات، والواجهة العامة. - قائمة التسوق مبنية من العناصر منخفضة المخزون أو الإصدارات المضافة يدوياً، مع ملاحظات ووضع علامة "تم الشراء"؛ تنخفض العناصر تلقائيًا بمجرد ارتفاع المخزون فوق عتبة الحد. - استعلامات منتج قابلة للتوصيل (Open Food Facts، UPCItemDB، Naver Shopping) لكل مسح، أو تعطيلها بالكامل. - استيراد/تصدير CSV، بما في ذلك قيم الباركود، لإدخال الدفعات وجداول الجرد. - طباعة الملصقات كصورة PNG مفردة أو PDF ورقة ملصقات A4، مع مربع بحث في المنتقي؛ يدعم الطباعة الكورية عبر مجموعة Noto Sans KR. - إشعارات Web Push لأحداث انتهاء الصلاحية/الضمان وملخص أسبوعي لانخفاض المخزون. - حذف ناعم مع Toast undo، واستعادة، وإزالة تلقائية بعد 30 يومًا. - PWA ملائم للوضع غير المتصل: غلاف تطبيق محفوظ مؤقتًا، استجابات عنصر محفوظة مؤقتًا، وطابور مسح غير متصل يتم مزامنته عند استعادة الاتصال. - ويب هوك خارجي للمخزون لطابعات أو أتمتة Home Assistant، مع ظهور فشل التسليم الأخير في الإعدادات والتحقق الاختياري من التوقيع HMAC-SHA256. - حسابات عائلية متعددة المستخدمين مع أدوار المسؤول/عام، إعداد المسؤول الأول، إعادة تعيين كلمة مرور المسؤول لمرة واحدة، تسجيل الخروج من كل مكان، backup/restore، والتعريب الكوري/الإنجليزي مع سمة فاتحة/داكنة. ليس ضمن النطاق: التخطيط للوصفات/الوجبات، تعدد المستأجرين داخل عملية واحدة. الإتاح: متاح كـ Docker Compose أو مثبت Proxmox LXC بنقرة واحدة. إعداد التطوير المحلي يستخدم PostgreSQL، هجرات Prisma، وخوادم API/web منفصلة. يتم نشر الصور إلى GitHub Container Registry، وتشمل ملاحظات الإنتاج خدمة المسار الفرعي، وفحص الصحة، وإدارة الأسرار.