<?php
if (!defined('PDO_MYSQL')) {
    if (session_status() === PHP_SESSION_NONE) session_start();
    if (!isset($_SESSION['user_id'])) die('Access Denied');
}
?>
<div class="container-fluid py-4">
    <div class="row">
        <!-- Help Navigation Sidebar -->
        <div class="col-md-3 d-none d-md-block">
            <div class="card shadow-sm sticky-top" style="top: 20px;">
                <div class="card-header bg-primary text-white">
                    <i class="bi bi-book me-2"></i> <?= __('help') ?>
                </div>
                <div class="list-group list-group-flush">
                    <a href="#intro" class="list-group-item list-group-item-action">Introduction / مقدمة</a>
                    <a href="#dashboard" class="list-group-item list-group-item-action">Dashboard / لوحة القيادة</a>
                    <a href="#pos" class="list-group-item list-group-item-action">POS Guide / دليل نقطة البيع</a>
                    <a href="#sessions" class="list-group-item list-group-item-action">Sessions & Hardware / الجلسات والأجهزة</a>
                    <a href="#inventory" class="list-group-item list-group-item-action">Inventory / المخزون</a>
                    <a href="#sales" class="list-group-item list-group-item-action">Sales & Purchases / المبيعات والمشتريات</a>
                    <a href="#accounting" class="list-group-item list-group-item-action">Accounting / المحاسبة</a>
                    <a href="#hr" class="list-group-item list-group-item-action">HR & Admin / الموارد البشرية والإدارة</a>
                </div>
            </div>
        </div>

        <!-- Help Content -->
        <div class="col-md-9">
            <div class="card shadow-sm">
                <div class="card-body">
                    <h2 class="border-bottom pb-2 mb-4">Detailed User Guide / دليل المستخدم المفصل</h2>

                    <!-- Introduction -->
                    <section id="intro" class="mb-5">
                        <div class="row">
                            <div class="col-md-6">
                                <h3>1. Introduction</h3>
                                <p>This guide provides step-by-step instructions on how to use the Accounting & Admin Panel. Follow these steps to manage your business operations effectively.</p>
                            </div>
                            <div class="col-md-6 text-end" dir="rtl">
                                <h3>1. مقدمة</h3>
                                <p>يوفر هذا الدليل تعليمات خطوة بخطوة حول كيفية استخدام لوحة تحكم المحاسبة والإدارة. اتبع هذه الخطوات لإدارة عمليات عملك بفعالية.</p>
                            </div>
                        </div>
                    </section>

                    <!-- Dashboard -->
                    <section id="dashboard" class="mb-5">
                        <div class="row">
                            <div class="col-md-6">
                                <h3>2. Using the Dashboard</h3>
                                <p>The dashboard is your central command center.</p>
                                <ul>
                                    <li><strong>Overview:</strong> Monitor total sales, profits, and expenses at a glance.</li>
                                    <li><strong>Stock Alerts:</strong> Look for the "Low Stock" widget to see items that need reordering.</li>
                                    <li><strong>Shortcuts:</strong> Use the quick-action buttons to jump directly to POS or New Invoice.</li>
                                </ul>
                            </div>
                            <div class="col-md-6 text-end" dir="rtl">
                                <h3>2. استخدام لوحة القيادة</h3>
                                <p>لوحة القيادة هي مركز القيادة المركزي الخاص بك.</p>
                                <ul>
                                    <li><strong>نظرة عامة:</strong> مراقبة إجمالي المبيعات والأرباح والمصروفات بلمحة بصر.</li>
                                    <li><strong>تنبيهات المخزون:</strong> ابحث عن أداة "المخزون المنخفض" لرؤية الأصناف التي تحتاج إلى إعادة طلب.</li>
                                    <li><strong>الاختصارات:</strong> استخدم أزرار العمل السريع للانتقال مباشرة إلى نقطة البيع أو فاتورة جديدة.</li>
                                </ul>
                            </div>
                        </div>
                    </section>

                    <!-- POS Guide -->
                    <section id="pos" class="mb-5">
                        <div class="row">
                            <div class="col-md-6">
                                <h3>3. Operating the POS</h3>
                                <p>The Point of Sale is designed for speed. Here is how to operate it efficiently:</p>
                                <ol>
                                    <li><strong>Start Session:</strong> You cannot sell until a register session is open (see Sessions section below).</li>
                                    <li><strong>Identify Items:</strong>
                                        <ul>
                                            <li><strong>Barcode:</strong> Simply scan the item. The system will auto-add it.</li>
                                            <li><strong>Search:</strong> Type the name or SKU in the top bar. Results appear as you type.</li>
                                            <li><strong>Weight Scale:</strong> For items sold by weight (e.g., vegetables), click the <strong>Scale Icon</strong> in the cart to fetch the weight directly from your connected device.</li>
                                        </ul>
                                    </li>
                                    <li><strong>Cart Management:</strong> Adjust quantities, add notes to items, or remove items using the trash icon.</li>
                                    <li><strong>Customer Selection:</strong> Select a customer for loyalty points or credit sales.</li>
                                    <li><strong>Payment:</strong> Click <strong>Pay Now</strong>. If the customer pays more than the total, the system calculates the <strong>Change</strong> automatically.</li>
                                </ol>
                            </div>
                            <div class="col-md-6 text-end" dir="rtl">
                                <h3>3. تشغيل نقطة البيع</h3>
                                <p>تم تصميم نقطة البيع من أجل السرعة. إليك كيفية تشغيلها بفعالية:</p>
                                <ol>
                                    <li><strong>بدء الجلسة:</strong> لا يمكنك البيع حتى يتم فتح جلسة صندوق (راجع قسم الجلسات أدناه).</li>
                                    <li><strong>تحديد الأصناف:</strong>
                                        <ul>
                                            <li><strong>الباركود:</strong> ما عليك سوى مسح الصنف. سيقوم النظام بإضافته تلقائياً.</li>
                                            <li><strong>البحث:</strong> اكتب الاسم أو الرمز في الشريط العلوي. تظهر النتائج أثناء الكتابة.</li>
                                            <li><strong>ميزان الوزن:</strong> للأصناف التي تُباع بالوزن (مثل الخضروات)، انقر فوق <strong>أيقونة الميزان</strong> في السلة لجلب الوزن مباشرة من جهازك المتصل.</li>
                                        </ul>
                                    </li>
                                    <li><strong>إدارة السلة:</strong> تعديل الكميات، إضافة ملاحظات للأصناف، أو إزالة الأصناف باستخدام أيقونة السلة.</li>
                                    <li><strong>اختيار العميل:</strong> اختر عميلاً لنقاط الولاء أو مبيعات الآجل.</li>
                                    <li><strong>الدفع:</strong> انقر فوق <strong>ادفع الآن</strong>. إذا دفع العميل أكثر من الإجمالي، يقوم النظام بحساب <strong>المتبقي (الفكة)</strong> تلقائياً.</li>
                                </ol>
                            </div>
                        </div>
                    </section>

                    <!-- Sessions & Hardware -->
                    <section id="sessions" class="mb-5">
                        <div class="row">
                            <div class="col-md-6">
                                <h3>4. Sessions & Hardware Setup</h3>
                                <h5>Register Sessions:</h5>
                                <p>Sessions track the cash in your drawer from opening to closing.</p>
                                <ul>
                                    <li><strong>To Start:</strong> Go to <strong>Admin > Register Sessions</strong>. Click <strong>Open New Session</strong> and enter your starting cash balance.</li>
                                    <li><strong>To End:</strong> At the end of the shift, click <strong>Close Session</strong>, count your cash, and enter the amount to check for discrepancies.</li>
                                </ul>
                                <h5>Weight Scales:</h5>
                                <ul>
                                    <li><strong>Setup:</strong> Go to <strong>Admin > Scale Devices</strong>. Add your scale (Network or Serial).</li>
                                    <li><strong>Calibration:</strong> 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.</li>
                                </ul>
                                <h5>Biometric Attendance:</h5>
                                <ul>
                                    <li><strong>Setup:</strong> Go to <strong>HR > Biometric Devices</strong>. Register your fingerprint/face device with its IP address.</li>
                                    <li><strong>Usage:</strong> Assign a <strong>Biometric ID</strong> to each employee in their profile. Use <strong>Pull Logs</strong> in the Attendance module to sync data from the device.</li>
                                </ul>
                            </div>
                            <div class="col-md-6 text-end" dir="rtl">
                                <h3>4. إعداد الجلسات والأجهزة</h3>
                                <h5>جلسات الصناديق:</h5>
                                <p>تتبع الجلسات النقود في درجك من الافتتاح حتى الإغلاق.</p>
                                <ul>
                                    <li><strong>للبدء:</strong> انتقل إلى <strong>الإدارة > جلسات الصناديق</strong>. انقر فوق <strong>فتح جلسة جديدة</strong> وأدخل رصيد البداية النقدي.</li>
                                    <li><strong>للإنهاء:</strong> في نهاية الوردية، انقر فوق <strong>إغلاق الجلسة</strong>، وقم بعد نقودك، وأدخل المبلغ للتحقق من أي فروقات.</li>
                                </ul>
                                <h5>موازين الوزن:</h5>
                                <ul>
                                    <li><strong>الإعداد:</strong> انتقل إلى <strong>الإدارة > أجهزة الموازين</strong>. أضف ميزانك (شبكة أو تسلسلي).</li>
                                    <li><strong>المعايرة:</strong> تأكد من ضبط الميزان على معدل نقل بيانات 9600 إذا كنت تستخدم المنفذ التسلسلي. عند الاستخدام في POS، سيطلب المتصفح إذن الوصول.</li>
                                </ul>
                                <h5>الحضور البيومتري (البصمة):</h5>
                                <ul>
                                    <li><strong>الإعداد:</strong> انتقل إلى <strong>الموارد البشرية > أجهزة البصمة</strong>. سجل جهاز البصمة/الوجه باستخدام عنوان IP الخاص به.</li>
                                    <li><strong>الاستخدام:</strong> قم بتعيين <strong>معرف بيومتري</strong> لكل موظف في ملفه الشخصي. استخدم <strong>جلب السجلات</strong> في وحدة الحضور لمزامنة البيانات من الجهاز.</li>
                                </ul>
                            </div>
                        </div>
                    </section>

                    <!-- Inventory Guide -->
                    <section id="inventory" class="mb-5">
                        <div class="row">
                            <div class="col-md-6">
                                <h3>5. Managing Inventory</h3>
                                <h5>Adding New Products:</h5>
                                <ol>
                                    <li>Navigate to <strong>Inventory > Add Item</strong>.</li>
                                    <li>Enter both English and Arabic names for bilingual support.</li>
                                    <li>Set the <strong>SKU</strong> (unique code) and select a <strong>Category</strong> and <strong>Unit</strong>.</li>
                                    <li>Enter the <strong>Sale Price</strong> and <strong>Cost Price</strong>.</li>
                                    <li>Set a <strong>Minimum Stock Level</strong> to receive low-stock alerts.</li>
                                    <li>Click <strong>Save</strong>.</li>
                                </ol>
                                <h5>Managing Stock:</h5>
                                <p>Stock is automatically deducted during POS sales and increased during Purchases. You can also manually adjust stock by editing an item.</p>
                            </div>
                            <div class="col-md-6 text-end" dir="rtl">
                                <h3>5. إدارة المخزون</h3>
                                <h5>إضافة منتجات جديدة:</h5>
                                <ol>
                                    <li>انتقل إلى <strong>المخزون > إضافة صنف</strong>.</li>
                                    <li>أدخل الأسماء باللغتين الإنجليزية والعربية لدعم ثنائية اللغة.</li>
                                    <li>اضبط <strong>SKU</strong> (الرمز الفريد) واختر <strong>الفئة</strong> و <strong>الوحدة</strong>.</li>
                                    <li>أدخل <strong>سعر البيع</strong> و <strong>سعر التكلفة</strong>.</li>
                                    <li>اضبط <strong>حد المخزون الأدنى</strong> لتلقي تنبيهات انخفاض المخزون.</li>
                                    <li>انقر فوق <strong>حفظ</strong>.</li>
                                </ol>
                                <h5>إدارة الكميات:</h5>
                                <p>يتم خصم المخزون تلقائياً أثناء مبيعات نقطة البيع وزيادته أثناء المشتريات. يمكنك أيضاً تعديل المخزون يدوياً عن طريق تحرير الصنف.</p>
                            </div>
                        </div>
                    </section>

                    <!-- Sales & Purchases -->
                    <section id="sales" class="mb-5">
                        <div class="row">
                            <div class="col-md-6">
                                <h3>6. Sales, Purchases & Returns</h3>
                                <h5>Creating an Invoice:</h5>
                                <ol>
                                    <li>Go to <strong>Sales > New Invoice</strong>.</li>
                                    <li>Select a <strong>Customer</strong> (or create a new one).</li>
                                    <li>Add items by searching or choosing from the list.</li>
                                    <li>Set the <strong>Status</strong>: "Paid" records the payment immediately; "Pending" keeps it as a credit/debt.</li>
                                    <li>Click <strong>Save Invoice</strong>.</li>
                                </ol>
                                <h5>Handling Returns:</h5>
                                <p>Go to <strong>Sales > Returns</strong>. Select the original invoice, choose the items being returned, and the system will automatically restock the items and adjust the customer balance.</p>
                            </div>
                            <div class="col-md-6 text-end" dir="rtl">
                                <h3>6. المبيعات والمشتريات والمرتجعات</h3>
                                <h5>إنشاء فاتورة:</h5>
                                <ol>
                                    <li>انتقل إلى <strong>المبيعات > فاتورة جديدة</strong>.</li>
                                    <li>اختر <strong>عميلاً</strong> (أو أنشئ عميلاً جديداً).</li>
                                    <li>أضف الأصناف عن طريق البحث أو الاختيار من القائمة.</li>
                                    <li>اضبط <strong>الحالة</strong>: "مدفوع" يسجل الدفع فوراً؛ "قيد الانتظار" يبقيها كدين/آجل.</li>
                                    <li>انقر فوق <strong>حفظ الفاتورة</strong>.</li>
                                </ol>
                                <h5>التعامل مع المرتجعات:</h5>
                                <p>انتقل إلى <strong>المبيعات > المرتجعات</strong>. اختر الفاتورة الأصلية، وحدد الأصناف المرتجعة، وسيقوم النظام تلقائياً بإعادة تخزين الأصناف وتعديل رصيد العميل.</p>
                            </div>
                        </div>
                    </section>

                    <!-- Accounting Guide -->
                    <section id="accounting" class="mb-5">
                        <div class="row">
                            <div class="col-md-6">
                                <h3>7. Accounting & Reports</h3>
                                <h5>Financial Reports:</h5>
                                <p>The system automatically creates journal entries for every transaction. To view reports:</p>
                                <ol>
                                    <li>Go to <strong>Accounting > Reports</strong>.</li>
                                    <li>Choose from <strong>Profit & Loss</strong>, <strong>Balance Sheet</strong>, or <strong>VAT Report</strong>.</li>
                                    <li>Select the <strong>Date Range</strong> and click <strong>Generate</strong>.</li>
                                    <li>Use the <strong>Print/PDF</strong> button to export your records.</li>
                                </ol>
                            </div>
                            <div class="col-md-6 text-end" dir="rtl">
                                <h3>7. المحاسبة والتقارير</h3>
                                <h5>التقارير المالية:</h5>
                                <p>يقوم النظام تلقائياً بإنشاء قيود اليومية لكل معاملة. لعرض التقارير:</p>
                                <ol>
                                    <li>انتقل إلى <strong>المحاسبة > التقارير</strong>.</li>
                                    <li>اختر من بين <strong>الأرباح والخسائر</strong>، أو <strong>الميزانية العمومية</strong>، أو <strong>تقرير الضريبة</strong>.</li>
                                    <li>حدد <strong>النطاق الزمني</strong> وانقر فوق <strong>توليد</strong>.</li>
                                    <li>استخدم زر <strong>طباعة/PDF</strong> لتصدير سجلاتك.</li>
                                </ol>
                            </div>
                        </div>
                    </section>

                    <!-- HR & Admin -->
                    <section id="hr" class="mb-5">
                        <div class="row">
                            <div class="col-md-6">
                                <h3>8. HR & Administration</h3>
                                <ul>
                                    <li><strong>Employees:</strong> Manage profiles, salaries, and attendance records.</li>
                                    <li><strong>User Roles:</strong> Go to <strong>Settings > Roles</strong> to define what each user can see and do (Permissions).</li>
                                    <li><strong>Backup:</strong> Regularly go to <strong>Settings > Backup</strong> to download a copy of your database for safety.</li>
                                </ul>
                            </div>
                            <div class="col-md-6 text-end" dir="rtl">
                                <h3>8. الموارد البشرية والإدارة</h3>
                                <ul>
                                    <li><strong>الموظفين:</strong> إدارة الملفات الشخصية والرواتب وسجلات الحضور.</li>
                                    <li><strong>أدوار المستخدمين:</strong> انتقل إلى <strong>الإعدادات > الأدوار</strong> لتحديد ما يمكن لكل مستخدم رؤيته وفعله (الصلاحيات).</li>
                                    <li><strong>النسخ الاحتياطي:</strong> انتقل بانتظام إلى <strong>الإعدادات > النسخ الاحتياطي</strong> لتنزيل نسخة من قاعدة بياناتك للأمان.</li>
                                </ul>
                            </div>
                        </div>
                    </section>

                </div>
            </div>
        </div>
    </div>
</div>

<style>
    section { scroll-margin-top: 80px; }
    .sticky-top { z-index: 1020; }
    h3 { color: var(--bs-primary); font-weight: bold; border-bottom: 2px solid #eee; padding-bottom: 10px; margin-bottom: 20px; }
    h5 { color: #555; font-weight: 600; margin-top: 15px; }
    .bg-light { border-style: dashed !important; border-width: 2px !important; background-color: #f8f9fa !important; }
    ol li, ul li { margin-bottom: 8px; }
    [dir="rtl"] p, [dir="rtl"] li { font-size: 1.1rem; line-height: 1.6; }
</style>
