تثبيت النظام على ويندوز

هذه الصفحة لمن يركّب النظام على حاسوب المحل أول مرة: من حاسوب لم يُثبَّت عليه شيء إلى أول فاتورة، خطوة خطوة. التركيب كله يستغرق قرابة نصف ساعة، أكثرها انتظار. اقرأ الصفحة مرة واحدة قبل أن تبدأ.

1 · قبل أن تبدأ: هل الجهاز مناسب؟

النظام لا يحتاج إنترنت أثناء العمل، ولا أثناء التثبيت إن أحضرت ملفات الخطوة التالية معك. وإن وُجد الإنترنت يسأل كل ساعة عن سعر الدولار في السوق لينبّهك إن ابتعد عن سعر محلك؛ الطلب لا يحمل أي معلومة عن المحل، ويُوقف من إدارة النظام ← الإعدادات.

2 · جهّز الفلاشة

3 · تثبيت Docker Desktop مرة واحدة لكل جهاز

النظام يعمل داخل برنامج مجاني اسمه Docker Desktop، وهو مجاني للمحلات الصغيرة. إن كان مثبّتاً على الجهاز من قبل، فانتقل إلى الخطوة 5 من القائمة تحت.

1. ثبّت حزمة WSL أولاً: نقر مزدوج على ملف wsl….x64.msi، وانتظر حتى ينتهي.
2. شغّل Docker Desktop Installer.exe. في شاشة Configuration اترك الخيار Use WSL 2 instead of Hyper-V (recommended) مؤشَّراً، ثم Ok.
3. أعد تشغيل الحاسوب حين ينتهي التثبيت (زر Close and restart إن ظهر).
4. افتح Docker Desktop من سطح المكتب، واقبل الاتفاقية (Accept)، وتخطَّ تسجيل الدخول والأسئلة (Skip أو Continue without signing in).
5. من الإعدادات (رمز الترس في أعلى النافذة) ← General: ضع العلامة على Start Docker Desktop when you sign in to your computer، ثم Apply.
6. انتظر حتى يظهر أسفل النافذة Engine running بنقطة خضراء.

4 · تثبيت النظام

أ) أزل حظر ويندوز عن الملف المضغوط

ويندوز يعلّم كل ملف جاء من جهاز آخر أو من الإنترنت، فيسأل قبل تشغيل ما بداخله أو يحجبه. أزل العلامة قبل فكّ الضغط، فتخرج كل الملفات بلا علامة:

1. زر الفأرة الأيمن على accountant-pos-…zip ← Properties (خصائص).
2. في الأسفل ضع العلامة على Unblock (إلغاء الحظر) ← OK. إن لم يظهر هذا السطر فالملف غير محظور أصلاً.

ب) ضع المجلد في C:\AccountantPOS

1. زر الفأرة الأيمن على الملف المضغوط ← Extract All… (استخراج الكل) ← Extract.
2. داخل ما استُخرج مجلد اسمه Release فيه install.bat وبقية الملفات. انسخ هذا المجلد إلى القرص C: وأعد تسميته AccountantPOS، فيصير الملف في C:\AccountantPOS\install.bat.

ج) شغّل install.bat كمسؤول

1. زر الفأرة الأيمن على install.bat ← Run as administrator (تشغيل كمسؤول).
2. يسأل ويندوز «Do you want to allow this app to make changes…» ← Yes.

د) انتظر حتى تنتهي المراحل الست

تفتح نافذة سوداء تطبع كل مرحلة وهي تمرّ بها. لا تغلقها.

بعدها يفتح المتصفّح وحده على العنوان http://localhost:8800. اضغط Enter لإغلاق النافذة السوداء.

5 · الدخول الأول

1. افتح الملف FIRST-LOGIN.txt في C:\AccountantPOS. فيه كلمة مرور الدخول الأول، وقد ولّدها التثبيت عشوائياً لهذا الجهاز وحده.
2. في المتصفّح اكتب اسم المستخدم admin وكلمة المرور تلك، ثم دخول.
3. يطلب النظام فوراً كلمة مرور جديدة. يختارها صاحب المحل بنفسه ويحفظها في مكان آمن. بعدها احذف الملف FIRST-LOGIN.txt.

ماذا ترى بعد الدخول؟

قبل أول فاتورة، أربعة أمور يضبطها صاحب المحل:

1. اسم المحل وهاتفه وعنوانه. من إدارة النظام ← الإعدادات ← بيانات المحل اكتب اسم المحل كاملاً كما يريده صاحبه على الفواتير، مثل «يامن للاتصالات»، ثم حفظ. النظام لا يضيف إلى الاسم شيئاً.
2. سعر الدولار. اكتبه في خانة «سعر الدولار» أعلى الشاشة (أو F2) ثم Enter، أو اضغط اعتمد في شريط سعر السوق إن كان مناسباً لمحلك. أسعار البضاعة كلها تُحسب منه.
3. أسعار الخدمات. النظام يبدأ بشجرة فئات جاهزة وبـ 27 صنفاً جاهزاً بكمية صفر: رصيد سيرياتيل وMTN (الوحدة 10 ل.س بسعر ثابت)، والشرائح وأدواتها، و21 خدمة وأجرة صيانة بلا سعر. افتح كل خدمة تقدّمها وضع لها سعرها الثابت، وإلا بيعت بصفر لمن لا يملك صلاحية تعديل السعر. التفاصيل في المخزون وأسئلة شائعة.
4. حسابات البائعين. من المستخدمون أنشئ حساباً لكل بائع بصلاحياته، ولا تعطِ حساب admin لأحد غير صاحب المحل.

6 · التفعيل

بعد التثبيت يعمل النظام نسخة تجريبية كاملة 14 يوماً. إن انتهت قبل التفعيل لا يضيع شيء: يدخل النظام وضع «القراءة فقط»، فتبقى البيانات ظاهرة والطباعة والتقارير والنسخ الاحتياطي تعمل، ويتوقف البيع والتعديل حتى التفعيل. والتفعيل يعيد كل شيء فوراً دون إعادة تشغيل.

1. ادخل بحساب admin ← إدارة النظام ← تبويب الترخيص (أو زر التفعيل في الشريط الأصفر).
2. اضغط نسخ الرمز بجانب «رمز الطلب»: خمس مجموعات من أربعة أحرف.
3. أرسل إلى البائع (واتساب مثلاً): رمز الطلب، واسم المحل تماماً كما تريده أن يُطبع على الفواتير (الاسم نفسه الذي كتبته في «بيانات المحل»)، واسم صاحب المحل ورقم هاتفه.
4. يرسل لك البائع نص الترخيص (يبدأ بـ ACC1.) أو ملفاً ينتهي بـ .lic.
5. الصقه في خانة «نص الترخيص» — أو اضغط فتح ملف ترخيص — ثم تفعيل.

7 · ما بعد التثبيت

بقية أجهزة المحل اختياري

يُفتح النظام من أي حاسوب أو جهاز لوحي على شبكة المحل نفسها:

1. على الحاسوب الذي ثُبّت عليه النظام افتح «موجّه الأوامر» (cmd) واكتب ipconfig ثم Enter.
2. خذ الرقم بجانب IPv4 Address، مثل 192.168.1.20.
3. على الجهاز الآخر افتح المتصفّح على http://192.168.1.20:8800.

إن لم يفتح: شغّل install.bat كمسؤول مرة أخرى (يضيف قاعدة جدار الحماية)، وتأكّد أن شبكة ويندوز مضبوطة على Private (خاصة). ويُفضَّل تثبيت عنوان هذا الحاسوب من إعدادات الراوتر كي لا يتغيّر.

كل صباح

• عند فتح الحاسوب يعمل Docker Desktop ثم النظام وحده خلال دقيقة أو دقيقتين. افتح الاختصار (1).
• إن لم يفتح النظام: شغّل start.bat من C:\AccountantPOS — يشغّل Docker إن لزم، ثم النظام، ويفتح المتصفّح.
• إطفاء الحاسوب بالطريقة العادية آمن. أما stop.bat فنادراً ما يلزم.

النسخ الاحتياطي — اقرأه مع صاحب المحل

• يأخذ النظام نسخة تلقائية كل يوم بعد الساعة 2 ظهراً (أو فور فتح الحاسوب إن مضى يوم على آخر نسخة)، ويحتفظ بآخر 30 يوماً.
• النسخ في C:\AccountantPOS\backups — على القرص نفسه: إن تعطّل القرص ضاعت معه. انسخ مجلد backups إلى فلاشة مرة في الأسبوع على الأقل.
• النسخة تحمل الترخيص معها: بعد إعادة تثبيت ويندوز على الحاسوب نفسه، ثبّت النظام من جديد ثم استعد آخر نسخة، فيعود مفعّلاً دون ترخيص جديد. الاستعادة من إدارة النظام ← النسخ الاحتياطي.

التحديث إلى إصدار جديد

1. انسخ محتويات مجلد الإصدار الجديد فوق C:\AccountantPOS ووافق على الاستبدال. ملفات .env وconfig وbackups ليست في الإصدار، فلا تُستبدل.
2. احذف من مجلد images ملف الإصدار القديم فقط (accountant-pos-الرقم القديم.tar.gz).
3. شغّل update.bat: يأخذ نسخة احتياطية أولاً، ثم يحمّل الإصدار الجديد ويشغّله. إن فشلت النسخة يتوقف دون أن يغيّر شيئاً.
4. إن جاء الإصدار بشاشة جديدة يراها مدير النظام فوراً؛ أما البائعون فامنحهم صلاحيتها من المستخدمون ← «الصلاحيات».

8 · إن ظهرت مشكلة

لطلب الدعم الفني: في C:\AccountantPOS افتح PowerShell واكتب docker compose logs --tail 200 app > support-log.txt، وأرسل الملف support-log.txt إلى البائع.