1. ورود به سیستم
برای استفاده از سیستم، ابتدا باید وارد پنل مدیریت شوید:
- به صفحه ورود بروید
- نام کاربری:
admin - رمز عبور:
samn0866 - روی دکمه "ورود" کلیک کنید
نکته: پس از ورود، توکن احراز هویت در مرورگر ذخیره میشود و تا زمانی که خارج نشوید، نیازی به ورود مجدد نیست.
2. تعریف فروشنده
قبل از ثبت فاکتور و کالا، باید فروشنده را تعریف کنید:
- به بخش "مدیریت فروشندگان" بروید
- روی دکمه "افزودن فروشنده" کلیک کنید
- اطلاعات فروشنده را وارد کنید (نام الزامی است، بقیه اختیاری)
- روی "ثبت" کلیک کنید
نکته: میتوانید فروشنده را ویرایش یا حذف کنید. حذف، soft delete است و دادهها پاک نمیشوند.
3. تعریف کالا
برای ثبت فاکتور، ابتدا باید کالاها را تعریف کنید:
- به بخش "کالاها" بروید
- روی دکمه "افزودن کالا" کلیک کنید
- اطلاعات کالا را وارد کنید:
- نام کالا: الزامی
- SKU: اختیاری
- قیمت: الزامی (به ریال)
- فروشنده: اختیاری (کالا را به فروشنده متصل میکند)
- روی "ثبت" کلیک کنید
نکته: کالاها باید به یک فروشنده متصل باشند تا در هنگام ثبت فاکتور برای آن فروشنده نمایش داده شوند.
4. تعریف مشتری
قبل از ثبت فاکتور، باید مشتری را تعریف کنید:
- به بخش "مشتریان" بروید
- روی دکمه "افزودن مشتری" کلیک کنید
- اطلاعات مشتری را وارد کنید (نام الزامی است، بقیه اختیاری)
- روی "ثبت" کلیک کنید
نکته مهم: هر مشتری یک UUID یکتا دریافت میکند که میتواند با آن فاکتورهای خود را مشاهده کند. این UUID در ستون "لینک مشاهده" نمایش داده میشود.
5. ثبت فاکتور
برای ثبت فاکتور جدید:
- به بخش "ثبت فاکتور" بروید
- فروشنده را انتخاب کنید: این انتخاب کالاها را فیلتر میکند
- مشتری را انتخاب کنید
- کالا را انتخاب کنید: فقط کالاهای فروشنده انتخاب شده نمایش داده میشوند
- تعداد و تخفیف (اختیاری) را وارد کنید
- روی "افزودن" کلیک کنید
- میتوانید چندین کالا اضافه کنید
- تخفیف کل (اختیاری) را وارد کنید
- روی "ثبت فاکتور" کلیک کنید
نکته مهم: فاکتور تا زمانی که روی دکمه "ثبت فاکتور" کلیک نشود، در دیتابیس ذخیره نمیشود. میتوانید ردیفها را ویرایش یا حذف کنید.
ویرایش ردیف: در جدول آیتمها، میتوانید روی "ویرایش" کلیک کنید تا تعداد یا تخفیف یک ردیف را تغییر دهید.
6. مشاهده فاکتورهای ثبت شده
فاکتورهای ثبت شده را میتوانید در بخش "فاکتورهای ثبت شده" مشاهده کنید:
- لیست تمام فاکتورها با جزئیات نمایش داده میشود
- میتوانید با pagination بین صفحات جابهجا شوید
- روی "پیشنمایش" کلیک کنید تا فاکتور را در صفحه جدید ببینید
- روی "حذف" کلیک کنید تا فاکتور حذف شود (soft delete)
- روی "مشاهده فاکتور" کلیک کنید تا لینک عمومی فاکتور را باز کنید
7. مشاهده فاکتور توسط مشتری
مشتری میتواند با UUID خود فاکتورهایش را مشاهده کند:
- دریافت UUID: در جدول مشتریان، UUID هر مشتری در ستون "لینک مشاهده" نمایش داده میشود. روی "مشاهده فاکتورها" کلیک کنید.
- یا: میتوانید UUID را از جدول مشتریان کپی کنید و لینک زیر را بسازید:
/customer-view.html?uuid=UUID_MOSHTARI - مشتری در این صفحه میتواند:
- لیست تمام فاکتورهای خود را ببیند
- روی "مشاهده" کلیک کند تا جزئیات یک فاکتور را ببیند
- فاکتور را چاپ یا به PDF تبدیل کند
8. ویرایش و حذف
برای ویرایش یا حذف:
- ویرایش: روی دکمه "ویرایش" در جدول مربوطه کلیک کنید و اطلاعات را تغییر دهید
- حذف: روی دکمه "حذف" کلیک کنید (این عمل soft delete است و دادهها پاک نمیشوند)
- میتوانید کالاها، مشتریان، فروشندگان و فاکتورها را ویرایش یا حذف کنید
9. نکات مهم
⚠️ حذف Soft Delete: حذف در این سیستم به معنی پاک شدن کامل داده نیست. دادهها فقط با فلگ is_deleted علامتگذاری میشوند و دیگر نمایش داده نمیشوند.
⚠️ هر کالا یکبار: هر کالا فقط یکبار در هر فاکتور میتواند ثبت شود.
⚠️ فیلتر کالاها: در فرم ثبت فاکتور، فقط کالاهای فروشنده انتخاب شده نمایش داده میشوند.
⚠️ مالیات: مالیات ارزش افزوده به صورت ثابت 10% بر روی مبلغ پس از تخفیف محاسبه میشود.
⚠️ UUID: UUID مشتری برای مشاهده فاکتورها استفاده میشود. این UUID را به مشتری بدهید تا بتواند فاکتورهایش را ببیند.
10. ساختار سیستم
سیستم شامل بخشهای زیر است:
📦 کالاها
تعریف، ویرایش و حذف کالاها
👥 مشتریان
تعریف، ویرایش و حذف مشتریان
🏪 فروشندگان
تعریف، ویرایش و حذف فروشندگان
📄 فاکتورها
ثبت، مشاهده و مدیریت فاکتورها
11. پشتیبانی
در صورت بروز مشکل یا سوال، لطفاً با تیم پشتیبانی تماس بگیرید.