راهنمای استفاده

این صفحه قدم‌به‌قدم بهت کمک می‌کنه سریع فاکتور بسازی، مخاطب‌ها رو ذخیره کنی، از کاتالوگ استفاده کنی، خروجی PDF بگیری و از دیتابیس بکاپ/ریستور انجام بدی.

01

شروع سریع (۳ دقیقه)

  1. وارد invoice.html شو و در تب تنظیمات، واحد پول و مالیات را تنظیم کن.
  2. از بخش مخاطبین یک فروشنده و یک خریدار بساز و انتخابشون کن.
  3. چند آیتم اضافه کن (محصول/خدمت)، سپس پیش‌نمایش رو ببین.
  4. روی دانلود PDF بزن و در نهایت ذخیره فاکتور رو انجام بده.
02

مخاطبین (Seller / Buyer)

مخاطبین (فروشنده و خریدار) یکبار ذخیره می‌شن و هر بار فقط انتخاب می‌کنی. داخل هر فاکتور هم یک Snapshot ذخیره می‌شه تا اگر بعداً مخاطب رو تغییر دادی، فاکتورهای قبلی خراب نشن.

  • افزودن: دکمه «افزودن فروشنده/خریدار»
  • ویرایش/حذف: بعد از انتخاب مخاطب، دکمه‌های ویرایش/حذف فعال می‌شن
  • اطلاعات پیشنهادی: نام، تلفن، ایمیل، آدرس، شناسه/کد اقتصادی (در صورت نیاز)
03

کاتالوگ محصولات/خدمات

اگر آیتم‌هایی داری که همیشه تکرار می‌شن (مثلاً «مشاوره»، «طراحی سایت»، «سرویس ماهانه»)، اون‌ها رو داخل کاتالوگ ذخیره کن تا با یک انتخاب، فرم آیتم پر بشه.

  • «افزودن به کاتالوگ» → نام، واحد، توضیحات، قیمت پیش‌فرض
  • از Dropdown کاتالوگ انتخاب کن تا فرم «افزودن آیتم» سریع پر بشه
04

مدیریت آیتم‌ها

آیتم‌ها شامل نام، توضیحات، تعداد، واحد و قیمت هستن. جمع کل به صورت خودکار محاسبه می‌شه.

افزودن
دکمه «افزودن محصول» → تکمیل فرم → افزودن
ویرایش
کنار هر ردیف «ویرایش» → تغییر → ثبت تغییرات
05

پیش‌نمایش و خروجی PDF

در تب «پیش‌نمایش» می‌تونی نتیجه نهایی رو ببینی و با یک کلیک PDF بگیری. برای خروجی بهتر، اول لوگو رو انتخاب کن و اطلاعات مخاطبین رو کامل داشته باش.

  • دانلود PDF: دکمه «دانلود PDF»
  • پرینت: دکمه «پرینت» (در صورت نیاز)
06

بکاپ و انتقال (JSON)

برای انتقال به سیستم دیگر یا نگهداری بکاپ، می‌تونی از کل دیتابیس خروجی بگیری و بعداً وارد کنی.

  • خروجی کل دیتابیس: «خروجی کل دیتابیس» → فایل invoice-db-export.json
  • ورودی کل دیتابیس: «ورودی کل دیتابیس» → انتخاب فایل JSON
  • خروجی فاکتور: «خروجی JSON فاکتور» برای یک فاکتور خاص
نکته: اگر روی یک مرورگر دیگر import می‌کنی، بهتره قبلش یکبار صفحه را باز کرده باشی تا دیتابیس ساخته شود.
07

آفلاین و PWA

اگر Service Worker فعال باشد و صفحه‌ها یکبار باز شده باشند، در حالت آفلاین هم می‌تونی استفاده کنی. برای تجربه بهتر، روی HTTPS یا localhost اجرا کن.

  • برای تست آفلاین: DevTools → Network → Offline
  • برای نصب: مرورگرهای موبایل معمولاً گزینه «Add to Home Screen» دارند
08

رفع خطاهای رایج

خطا: invoiceApp is not defined
یعنی فایل js/app.js درست لود نشده یا قبل از Alpine اجرا نشده. مطمئن شو در head این وجود دارد:
<script type="module" src="js/app.js" defer></script>
خطا: Failed to execute 'add' on 'Cache'
معمولاً مسیر فایل‌ها 404 است یا Service Worker قدیمی کش دارد. راه‌حل: Application → Service Workers → Unregister و سپس Clear site data و Hard Reload.
PDF خوب نیست / فونت بهم ریخته
گاهی html2canvas با بعضی فونت‌ها مشکل دارد. بهتره یکبار صفحه کامل لود شود، سپس در تب پیش‌نمایش PDF بگیرید. (و لوگو را سبک انتخاب کنید)

FAQ

داخل مرورگر (IndexedDB). می‌توانید خروجی کل دیتابیس بگیرید و در جای دیگر وارد کنید.

مشکلی ایجاد نمی‌شود چون داخل هر فاکتور Snapshot ذخیره می‌شود.

«خروجی کل دیتابیس» را بزنید و فایل JSON را در جای امن نگه دارید.