المجتمع · المساعدة

دليل مستخدم Sheetward

حوّل مصنف Excel أو OpenDocument (أو Google Sheet) إلى تطبيق ويب متعدد المستخدمين — نماذج وتحقق وقوائم بحث واستيراد/تصدير والمزيد.

تشغيل تطبيق مستقل

التطبيق المستقل ملف ZIP قائم بذاته يمكنك تشغيله على حاسوب محمول أو جهاز مكتبي أو خادمك الخاص. تصل جاهزة للعمل: واجهة ويب مُجمَّعة، وبرنامج صغير لتشغيلها، وبيانات التطبيق في ملف SQLite محلي واحد. والشخص الذي يشغّلها (مشغّل التطبيق المستقل) لا يبني شيئًا — لا git ولا npm. يشرح ملف README.md في المجلد كل إعداد، ويسجّل manifest.json متى بُنيت واجهة الويب المرفقة — ويعرض التطبيق أثناء تشغيله الختم نفسه على /api/health، وهو مفيد عند إعادة التصدير إلى المجلد نفسه.

البدء السريع — فكّ ضغط الملف، ثم في ذلك المجلد:

  • python -m pip install -r requirements.txt
  • python run.py — ثم افتح http://127.0.0.1:8000 في متصفحك.
  • تحتاج إلى عنوان أو منفذ مختلف؟ PORT=9000 HOST=0.0.0.0 python run.py.

من يمكنه تسجيل الدخول. لا تسجّل التطبيق المستقل حسابات جديدة أبدًا، فتبقى خصوصيتها تمامًا كما كانت يوم نشرتها. كل من كان لديه وصول وقت النشر موجود فيها بالفعل، ويسجّل الدخول بالبريد الإلكتروني وكلمة المرور نفسيهما. إعادة تعيين كلمة المرور غير متاحة في التطبيق المستقل — استخدم تغيير كلمة المرور بعد تسجيل الدخول.

الحقول الحساسة. إذا كان التطبيق يحتوي على حقول مشفّرة، فلا تُفتح قيمها إلا بمفتاح التطبيق. بعد التصدير يعرض Sheetward المفتاح مرة واحدة — ضعه في ملف .env داخل المجلد باسم SHEETAPP_APP_FIELD_KEY قبل تشغيل التطبيق. أو علّم الخيار في نافذة تأكيد التصدير ليُكتب في .env تلقائيًا: خيار مريح، لكن عندها يستطيع كل من يملك ملف ZIP قراءة تلك الحقول. من دون المفتاح يعمل التطبيق، وتبقى تلك الحقول غير قابلة للقراءة.
البيانات والنسخ الاحتياطية. كل شيء موجود بجوار run.py: السجلات في ملف app.db محلي، والمرفقات في مجلد data/. انسخهما إلى مكان آمن بانتظام، وستتمكن دائمًا من استعادة سجلاتك.