From 9f50c8c2ab3be26ebcd110b5a2fb315ff374ae13 Mon Sep 17 00:00:00 2001 From: Flatlogic Bot Date: Thu, 26 Feb 2026 18:21:28 +0000 Subject: [PATCH] adding help file --- help.php | 254 +++++++++++++++++++++++++++++++++--------------- login_debug.log | 4 + post_debug.log | 5 + 3 files changed, 182 insertions(+), 81 deletions(-) create mode 100644 login_debug.log diff --git a/help.php b/help.php index 48569b0..8eec8ff 100644 --- a/help.php +++ b/help.php @@ -1,5 +1,5 @@ Introduction / مقدمة Dashboard / لوحة القيادة - POS / نقطة البيع + POS Guide / دليل نقطة البيع + Sessions & Hardware / الجلسات والأجهزة Inventory / المخزون Sales & Purchases / المبيعات والمشتريات Accounting / المحاسبة HR & Admin / الموارد البشرية والإدارة - Settings / الإعدادات @@ -29,18 +29,18 @@ if (!defined('PDO_MYSQL')) { // Simple check to prevent direct access if needed,
-

User Manual / دليل المستخدم

+

Detailed User Guide / دليل المستخدم المفصل

1. Introduction

-

Welcome to the Accounting & Admin Panel. This system is designed to help you manage your retail business, inventory, and finances efficiently. It supports multiple outlets, bilingual entries (English/Arabic), and full accounting cycles.

+

This guide provides step-by-step instructions on how to use the Accounting & Admin Panel. Follow these steps to manage your business operations effectively.

1. مقدمة

-

مرحباً بك في لوحة تحكم المحاسبة والإدارة. تم تصميم هذا النظام لمساعدتك في إدارة أعمال التجزئة والمخزون والشؤون المالية بكفاءة. يدعم النظام منافذ بيع متعددة، وإدخالات ثنائية اللغة (الإنجليزية/العربية)، ودورات محاسبية كاملة.

+

يوفر هذا الدليل تعليمات خطوة بخطوة حول كيفية استخدام لوحة تحكم المحاسبة والإدارة. اتبع هذه الخطوات لإدارة عمليات عملك بفعالية.

@@ -49,104 +49,200 @@ if (!defined('PDO_MYSQL')) { // Simple check to prevent direct access if needed,
-

2. Dashboard

-

The dashboard provides a real-time overview of your business performance, including total sales, stock alerts, and financial charts.

+

2. Using the Dashboard

+

The dashboard is your central command center.

    -
  • Total Sales: Sum of all sales in the selected period.
    • -
  • Alerts: Notifications for low stock or expired items.
    • +
  • Overview: Monitor total sales, profits, and expenses at a glance.
    • +
  • Stock Alerts: Look for the "Low Stock" widget to see items that need reordering.
    • +
  • Shortcuts: Use the quick-action buttons to jump directly to POS or New Invoice.
-

2. لوحة القيادة

-

توفر لوحة القيادة نظرة عامة فورية على أداء عملك، بما في ذلك إجمالي المبيعات وتنبيهات المخزون والرسوم البيانية المالية.

+

2. استخدام لوحة القيادة

+

لوحة القيادة هي مركز القيادة المركزي الخاص بك.

    -
  • إجمالي المبيعات: مجموع جميع المبيعات في الفترة المختارة.
    • -
  • التنبيهات: إشعارات للمخزون المنخفض أو الأصناف منتهية الصلاحية.
    • +
  • نظرة عامة: مراقبة إجمالي المبيعات والأرباح والمصروفات بلمحة بصر.
    • +
  • تنبيهات المخزون: ابحث عن أداة "المخزون المنخفض" لرؤية الأصناف التي تحتاج إلى إعادة طلب.
    • +
  • الاختصارات: استخدم أزرار العمل السريع للانتقال مباشرة إلى نقطة البيع أو فاتورة جديدة.
-
- -

[Screenshot: Dashboard Overview / لقطة شاشة: نظرة عامة على لوحة القيادة]

-
- +
-

3. Point of Sale (POS)

-

The POS interface is optimized for fast transactions. You can search for items by name or SKU, apply discounts, and handle multiple payment methods.

-
    -
  • Search: Type in the search box to find items.
    • -
  • Payments: Choose between Cash, Card, or Credit.
    • -
+

3. Operating the POS

+

The Point of Sale is designed for speed. Here is how to operate it efficiently:

+
    +
  1. Start Session: You cannot sell until a register session is open (see Sessions section below).
    2. +
  2. Identify Items: +
      +
    • Barcode: Simply scan the item. The system will auto-add it.
      • +
    • Search: Type the name or SKU in the top bar. Results appear as you type.
      • +
    • Weight Scale: For items sold by weight (e.g., vegetables), click the Scale Icon in the cart to fetch the weight directly from your connected device.
      • +
    +
    3. +
  3. Cart Management: Adjust quantities, add notes to items, or remove items using the trash icon.
    4. +
  4. Customer Selection: Select a customer for loyalty points or credit sales.
    5. +
  5. Payment: Click Pay Now. If the customer pays more than the total, the system calculates the Change automatically.
    6. +
-

3. نقطة البيع (POS)

-

واجهة نقطة البيع محسنة للمعاملات السريعة. يمكنك البحث عن الأصناف بالاسم أو الرمز (SKU)، وتطبيق الخصومات، والتعامل مع طرق دفع متعددة.

-
    -
  • البحث: اكتب في صندوق البحث للعثور على الأصناف.
    • -
  • المدفوعات: اختر بين النقدي أو البطاقة أو الآجل.
    • -
+

3. تشغيل نقطة البيع

+

تم تصميم نقطة البيع من أجل السرعة. إليك كيفية تشغيلها بفعالية:

+
    +
  1. بدء الجلسة: لا يمكنك البيع حتى يتم فتح جلسة صندوق (راجع قسم الجلسات أدناه).
    2. +
  2. تحديد الأصناف: +
      +
    • الباركود: ما عليك سوى مسح الصنف. سيقوم النظام بإضافته تلقائياً.
      • +
    • البحث: اكتب الاسم أو الرمز في الشريط العلوي. تظهر النتائج أثناء الكتابة.
      • +
    • ميزان الوزن: للأصناف التي تُباع بالوزن (مثل الخضروات)، انقر فوق أيقونة الميزان في السلة لجلب الوزن مباشرة من جهازك المتصل.
      • +
    +
    3. +
  3. إدارة السلة: تعديل الكميات، إضافة ملاحظات للأصناف، أو إزالة الأصناف باستخدام أيقونة السلة.
    4. +
  4. اختيار العميل: اختر عميلاً لنقاط الولاء أو مبيعات الآجل.
    5. +
  5. الدفع: انقر فوق ادفع الآن. إذا دفع العميل أكثر من الإجمالي، يقوم النظام بحساب المتبقي (الفكة) تلقائياً.
    6. +
-
- -

[Screenshot: POS Interface / لقطة شاشة: واجهة نقطة البيع]

-
- + +
+
+
+

4. Sessions & Hardware Setup

+
Register Sessions:
+

Sessions track the cash in your drawer from opening to closing.

+
    +
  • To Start: Go to Admin > Register Sessions. Click Open New Session and enter your starting cash balance.
    • +
  • To End: At the end of the shift, click Close Session, count your cash, and enter the amount to check for discrepancies.
    • +
+
Weight Scales:
+
    +
  • Setup: Go to Admin > Scale Devices. Add your scale (Network or Serial).
    • +
  • Calibration: Ensure your scale is set to 9600 baud rate if using serial. When using in POS, the browser will ask for permission to access the serial port.
    • +
+
Biometric Attendance:
+
    +
  • Setup: Go to HR > Biometric Devices. Register your fingerprint/face device with its IP address.
    • +
  • Usage: Assign a Biometric ID to each employee in their profile. Use Pull Logs in the Attendance module to sync data from the device.
    • +
+
+
+

4. إعداد الجلسات والأجهزة

+
جلسات الصناديق:
+

تتبع الجلسات النقود في درجك من الافتتاح حتى الإغلاق.

+
    +
  • للبدء: انتقل إلى الإدارة > جلسات الصناديق. انقر فوق فتح جلسة جديدة وأدخل رصيد البداية النقدي.
    • +
  • للإنهاء: في نهاية الوردية، انقر فوق إغلاق الجلسة، وقم بعد نقودك، وأدخل المبلغ للتحقق من أي فروقات.
    • +
+
موازين الوزن:
+
    +
  • الإعداد: انتقل إلى الإدارة > أجهزة الموازين. أضف ميزانك (شبكة أو تسلسلي).
    • +
  • المعايرة: تأكد من ضبط الميزان على معدل نقل بيانات 9600 إذا كنت تستخدم المنفذ التسلسلي. عند الاستخدام في POS، سيطلب المتصفح إذن الوصول.
    • +
+
الحضور البيومتري (البصمة):
+
    +
  • الإعداد: انتقل إلى الموارد البشرية > أجهزة البصمة. سجل جهاز البصمة/الوجه باستخدام عنوان IP الخاص به.
    • +
  • الاستخدام: قم بتعيين معرف بيومتري لكل موظف في ملفه الشخصي. استخدم جلب السجلات في وحدة الحضور لمزامنة البيانات من الجهاز.
    • +
+
+
+
+ +
-

4. Inventory Management

-

Manage your products, categories, and units. You can track stock levels and set minimum alerts.

+

5. Managing Inventory

+
Adding New Products:
+
    +
  1. Navigate to Inventory > Add Item.
    2. +
  2. Enter both English and Arabic names for bilingual support.
    3. +
  3. Set the SKU (unique code) and select a Category and Unit.
    4. +
  4. Enter the Sale Price and Cost Price.
    5. +
  5. Set a Minimum Stock Level to receive low-stock alerts.
    6. +
  6. Click Save.
    7. +
+
Managing Stock:
+

Stock is automatically deducted during POS sales and increased during Purchases. You can also manually adjust stock by editing an item.

-

4. إدارة المخزون

-

إدارة منتجاتك وفئاتك ووحداتك. يمكنك تتبع مستويات المخزون وضبط تنبيهات الحد الأدنى.

+

5. إدارة المخزون

+
إضافة منتجات جديدة:
+
    +
  1. انتقل إلى المخزون > إضافة صنف.
    2. +
  2. أدخل الأسماء باللغتين الإنجليزية والعربية لدعم ثنائية اللغة.
    3. +
  3. اضبط SKU (الرمز الفريد) واختر الفئة و الوحدة.
    4. +
  4. أدخل سعر البيع و سعر التكلفة.
    5. +
  5. اضبط حد المخزون الأدنى لتلقي تنبيهات انخفاض المخزون.
    6. +
  6. انقر فوق حفظ.
    7. +
+
إدارة الكميات:
+

يتم خصم المخزون تلقائياً أثناء مبيعات نقطة البيع وزيادته أثناء المشتريات. يمكنك أيضاً تعديل المخزون يدوياً عن طريق تحرير الصنف.

-
- -

[Screenshot: Item List / لقطة شاشة: قائمة الأصناف]

-
- +
-

5. Sales & Purchases

-

Record detailed tax invoices, quotations, and purchase orders. The system automatically updates inventory and records journal entries.

+

6. Sales, Purchases & Returns

+
Creating an Invoice:
+
    +
  1. Go to Sales > New Invoice.
    2. +
  2. Select a Customer (or create a new one).
    3. +
  3. Add items by searching or choosing from the list.
    4. +
  4. Set the Status: "Paid" records the payment immediately; "Pending" keeps it as a credit/debt.
    5. +
  5. Click Save Invoice.
    6. +
+
Handling Returns:
+

Go to Sales > Returns. Select the original invoice, choose the items being returned, and the system will automatically restock the items and adjust the customer balance.

-

5. المبيعات والمشتريات

-

تسجيل الفواتير الضريبية المفصلة وعروض الأسعار وأوامر الشراء. يقوم النظام تلقائياً بتحديث المخزون وتسجيل قيود اليومية.

+

6. المبيعات والمشتريات والمرتجعات

+
إنشاء فاتورة:
+
    +
  1. انتقل إلى المبيعات > فاتورة جديدة.
    2. +
  2. اختر عميلاً (أو أنشئ عميلاً جديداً).
    3. +
  3. أضف الأصناف عن طريق البحث أو الاختيار من القائمة.
    4. +
  4. اضبط الحالة: "مدفوع" يسجل الدفع فوراً؛ "قيد الانتظار" يبقيها كدين/آجل.
    5. +
  5. انقر فوق حفظ الفاتورة.
    6. +
+
التعامل مع المرتجعات:
+

انتقل إلى المبيعات > المرتجعات. اختر الفاتورة الأصلية، وحدد الأصناف المرتجعة، وسيقوم النظام تلقائياً بإعادة تخزين الأصناف وتعديل رصيد العميل.

- +
-

6. Accounting & Reports

-

Access financial statements like Trial Balance, Profit & Loss, and Balance Sheet. VAT reports are also available for tax compliance.

-
    -
  • Reports: Various reports like Expiry Report, Low Stock, and Customer Statements.
    • -
  • Accounting: Journal entries are automatically created for sales and purchases.
    • -
+

7. Accounting & Reports

+
Financial Reports:
+

The system automatically creates journal entries for every transaction. To view reports:

+
    +
  1. Go to Accounting > Reports.
    2. +
  2. Choose from Profit & Loss, Balance Sheet, or VAT Report.
    3. +
  3. Select the Date Range and click Generate.
    4. +
  4. Use the Print/PDF button to export your records.
    5. +
-

6. المحاسبة والتقارير

-

الوصول إلى البيانات المالية مثل ميزان المراجعة، والأرباح والخسائر، والميزانية العمومية. تتوفر أيضاً تقارير ضريبة القيمة المضافة للامتثال الضريبي.

-
    -
  • التقارير: تقارير متنوعة مثل تقرير الصلاحية، ونواقص المخزون، وكشوفات حساب العملاء.
    • -
  • المحاسبة: يتم إنشاء قيود اليومية تلقائياً للمبيعات والمشتريات.
    • -
+

7. المحاسبة والتقارير

+
التقارير المالية:
+

يقوم النظام تلقائياً بإنشاء قيود اليومية لكل معاملة. لعرض التقارير:

+
    +
  1. انتقل إلى المحاسبة > التقارير.
    2. +
  2. اختر من بين الأرباح والخسائر، أو الميزانية العمومية، أو تقرير الضريبة.
    3. +
  3. حدد النطاق الزمني وانقر فوق توليد.
    4. +
  4. استخدم زر طباعة/PDF لتصدير سجلاتك.
    5. +
@@ -156,25 +252,19 @@ if (!defined('PDO_MYSQL')) { // Simple check to prevent direct access if needed,

8. HR & Administration

-

Manage employees, departments, attendance, and payroll in the HR section. Use the Admin section to manage users, roles, and system backups.

+
    +
  • Employees: Manage profiles, salaries, and attendance records.
    • +
  • User Roles: Go to Settings > Roles to define what each user can see and do (Permissions).
    • +
  • Backup: Regularly go to Settings > Backup to download a copy of your database for safety.
    • +

8. الموارد البشرية والإدارة

-

إدارة الموظفين والأقسام والحضور والرواتب في قسم الموارد البشرية. استخدم قسم الإدارة لإدارة المستخدمين والأدوار والنسخ الاحتياطي للنظام.

-
-
- - - -
-
-
-

7. Settings & Administration

-

Configure your company details, manage users and roles, and setup backup schedules.

-
-
-

7. الإعدادات والإدارة

-

تهيئة تفاصيل شركتك، وإدارة المستخدمين والأدوار، وضبط جداول النسخ الاحتياطي.

+
    +
  • الموظفين: إدارة الملفات الشخصية والرواتب وسجلات الحضور.
    • +
  • أدوار المستخدمين: انتقل إلى الإعدادات > الأدوار لتحديد ما يمكن لكل مستخدم رؤيته وفعله (الصلاحيات).
    • +
  • النسخ الاحتياطي: انتقل بانتظام إلى الإعدادات > النسخ الاحتياطي لتنزيل نسخة من قاعدة بياناتك للأمان.
    • +
@@ -188,7 +278,9 @@ if (!defined('PDO_MYSQL')) { // Simple check to prevent direct access if needed, diff --git a/login_debug.log b/login_debug.log new file mode 100644 index 0000000..1ba92df --- /dev/null +++ b/login_debug.log @@ -0,0 +1,4 @@ +2026-02-26 17:58:24 - Failed login for 'admin'. Reason: Password mismatch +2026-02-26 17:58:40 - Failed login for 'admin'. Reason: Password mismatch +2026-02-26 17:58:46 - Failed login for 'admin'. Reason: Password mismatch +2026-02-26 17:59:03 - Failed login for 'admin'. Reason: Password mismatch diff --git a/post_debug.log b/post_debug.log index 4480530..6de0d00 100644 --- a/post_debug.log +++ b/post_debug.log @@ -27,3 +27,8 @@ 2026-02-26 08:16:37 - POST: {"id":"1","name":"Main Branch","phone":"99359472","ctr_number":"514899","vat_number":"OM99888","address":"AL Hamra\r\n","status":"active","edit_outlet":""} 2026-02-26 08:17:31 - POST: {"name":"Counter1","add_cash_register":""} 2026-02-26 08:17:56 - POST: {"open_register":"1","register_id":"4","opening_balance":"0"} +2026-02-26 17:58:24 - POST: {"username":"admin","password":"admin123","login":""} +2026-02-26 17:58:40 - POST: {"username":"admin","password":"admin123","login":""} +2026-02-26 17:58:46 - POST: {"username":"admin","password":"admin123","login":""} +2026-02-26 17:59:03 - POST: {"username":"admin","password":"admin123","login":""} +2026-02-26 17:59:14 - POST: {"username":"admin","password":"admin","login":""}