برای خرید اول مبلغ 480 هزار تومان تخفیف در نظر گرفته شده است. هنگام خرید برای اشتراک ماه اول، فقط 19 هزار تومان، پرداخت کنید!
برای خرید اشتراک باید از داخل نرمافزار -
بخش مدیریت، اقدام فرمائید.
فروش پرداز یک سیستم انقلابی برای فروشگاه‌های خرد و عمده است که فروش،
مدیریت کالا، مشتریان و گزارش‌ها را به ساده‌ترین شکل ممکن، میسر می‌کند.
⚡ بدون نصب 🔒 امنیت کامل آفلاین 📴 بدون نیاز به اینترنت 📊 تحلیل هوشمند فروش
در فرآیند تولید این نرمافزار از هوش مصنوعی Deepseek استفاده شده است.
تمام کدها توسط این هوش مصنوعی ارزیابی و ایراداتی مانند فراموشی، غلط املایی و اشتباهات پنهان
در همان مراحل اولیه رفع شده‌اند. در مجموع، این نرمافزار حاصل همکاری انسان و ماشین است که باعث شده محصول نهایی دقیق‌تر، سریع‌تر و قابل‌اعتمادتر باشد.
نرمافزار فروش‌پرداز
در ۸۳ سناریوی تست واقعی آزمایش شده و آماده‌ی کار در شرایط فروشگاهی است.
به‌روزرسانی‌های آینده نیز توسط هوش مصنوعی و زیر نظر کارشناس برنامه‌نویس انجام می‌شود.
📥 دانلود فایل
برای شروع دانلود، لطفا شماره تلفن خود را وارد کنید.
اینجا دانلود میشه 📥
بعد از پایان دانلود، از حالت فشرده خارج کن.
و اجراش کن.
انتخابی بی‌رقیب برای فروشگاه‌هایی که به دنبال نرم‌افزاری آفلاین، سریع و بدون دردسر هستند.
فقط یک فایل 2 مگابایتی بدون نیاز به نصب Setup.
معماری این نرم افزار با اصرار بر روی تنهای یک فایل بنا شده است، بدون نیاز به نصب.
بدون نیاز به دیتابیس SQL و بهره برداری از پایگاه دیتابیس محلی (Local Database).
بدون نیاز به پروسه طولانی و خسته کننده نصب SQL.
محیط مبتنی بر HTML5
حذف شکاف تکنولوژی نرم‌افزارهای لوکال و تحت وب. از نرم افزار لوکال با امکانات نرم‌افزارهای تحت وب استفاده می‌کند.
بدون نیاز به اینترنت - و آفلاین
گزینه‌ای منحصر به فرد برای غلبه بر قطعی اینترنت، در دنیای امروز.
ضمن امکان تولید و بهره برداری از اطلاعات Excel و تولید فایل پشتیبان قابل انتقال Backup & Restore.
🎁
نسخهٔ آزمایشی (دمو) — قبل از خرید، امتحان کنید
فایل را دانلود و اجرا کنید و همهٔ بخش‌ها را با کالا و مشتری نمونه امتحان کنید. تفاوت نسخهٔ آزمایشی با نسخهٔ فعال این است:
🧾ثبت تا ۳۰ فاکتور
در حالت آزمایشی می‌توانید تا سقف ۳۰ فاکتور ثبت کنید. پیش‌نویس‌ها در این سقف حساب نمی‌شوند.
🖨️چاپ فقط در نسخهٔ فعال
در حالت آزمایشی چاپ حرارتی و A4/A5 غیرفعال است و فاکتور در پیش‌نمایش با نشان «DEMO» دیده می‌شود.
🔁تمرین بیشتر
اگر فاکتورهای آزمایشی را حذف کنید، می‌توانید دوباره تا ۳۰ فاکتور ثبت کنید و کار با نرمافزار را بیشتر تمرین کنید.
📦بقیهٔ بخش‌ها بدون محدودیت
کالاها، مشتریان، گزارش‌ها، نمودارها و تنظیمات در حالت آزمایشی هم کامل کار می‌کنند.
در اولین اجرا، نوع فروشگاه خود را انتخاب کنید. نرمافزار با کالاهای نمونه (همراه با تصویر) و عنوان منوهای همان صنف آماده می‌شود تا همان لحظه بتوانید یک فاکتور تستی ثبت کنید.
مقایسه ویژگی نرمافزار فروش‌پرداز Deepseek، با سایر نرم افزارهای مشابه
ویژگی نرمافزار
فروش‌پرداز
نرم‌افزارهای متکی بر SQL Server (معمولاً)
نصب
یک فایل ۲ مگابایتی، بدون Setup
نصب برنامه + نصب و تنظیم سرور دیتابیس
دیتابیس
محلی؛ در اولین اجرا خودکار ساخته می‌شود
راه‌اندازی و مدیریت جداگانه
اینترنت
کاملاً آفلاین کار می‌کند
بسته به نرمافزار، متفاوت است
چند سیستم / چند شعبه
اختیاری، با سرویس REST (PHP) روی هاست
نیاز به پیکربندی شبکه و سرور
پشتیبان‌گیری
یک فایل رمزنگاری‌شده و قابل انتقال
بسته به نرمافزار، متفاوت است
سیستم‌عامل
ویندوز ۷ تا ۱۱ را پشتیبانی می‌کند
چونکه با WebView2 Runtime، کار می‌کند
بسته به نرمافزار، متفاوت است
ستون سوم یک مقایسهٔ کلی است و به محصول خاصی اشاره ندارد.
🌐
دو حالت کار: محلی یا سرور
💾محلی (Offline)
اطلاعات روی همین کامپیوتر ذخیره می‌شود؛ بدون هاست و بدون اینترنت. مناسب یک صندوق یا یک فروشگاه.
☁️سرور (Online)
چند سیستم یا چند شعبه روی یک پایگاه‌دادهٔ مشترک کار می‌کنند. سرویس REST (PHP) روی هاست خودتان نصب می‌شود و با توکن و کنترل دسترسی محافظت می‌شود.
راه‌اندازی حالت سرور مرحله‌به‌مرحله در راهنمای سرویس REST فروش‌پرداز آمده است. در همان راهنما نکات کار همزمان چند سیستم هم توضیح داده شده است.
🔒
اطمینان از اطلاعات و کیفیت
🖥️اطلاعات پیش شما می‌ماند
در حالت محلی، داده‌های فروشگاه روی کامپیوتر خودتان ذخیره می‌شود و برای کار روزانه به سرور و اینترنت نیازی نیست.
💾پشتیبان قابل انتقال
فایل پشتیبان رمزنگاری‌شده را خودتان نگه می‌دارید و در صورت نیاز روی سیستم دیگر بازیابی می‌کنید.
⚙️تراکنش‌های ایمن
رفتار برنامه در خطای وسط عملیات (rollback) و یکپارچگی داده در لغو و برگشت از فروش بررسی شده است.
📈تست با حجم بالا
آزمایش با ۲۰٬۰۰۰ کالا و ۲۰٬۰۰۰ فاکتور انجام شده است.
روی هم، ۴۰۸ سناریوی تست توسط سه هوش مصنوعی اجرا شده است: Deepseek (۸۳)، Claude (۲۲۰) و Gemini (۱۰۵). ما ادعای بی‌ایرادی نداریم و با گزارش شما نرمافزار را دقیق‌تر می‌کنیم.
✨
امکانات کوچکی که کار را راحت‌تر می‌کنند
🌙حالت تاریک
با دکمهٔ بالای صفحه، ظاهر برنامه برای کار شبانه راحت‌تر می‌شود.
📅تاریخ شمسی
تقویم شمسی و تاریخ‌های فارسی در فاکتور و گزارش‌ها.
⌨️کلیدهای میانبر
ثبت فاکتور و پرداخت با کلیدهای F2 تا F11. فهرست کلیدها
🖨️چاپ حرارتی و لیزری
رسید حرارتی ۸ میلی‌متری و فاکتور A4/A5.
📤ورود و خروج اکسل
افزودن گروهی کالا و مشتری از اکسل و تهیهٔ خروجی لیست‌ها.
🔍بارکدخوان
پیدا کردن سریع کالا با بارکد هنگام فروش.
💬
گزارش خطا و پیشنهاد
هر خطا یا پیشنهادی دارید برای ما بفرستید. نرمافزار با گزارش کاربران دقیق‌تر و پایدارتر می‌شود. صفحهٔ رسمی نرمافزار: Tavafi.ir / forosh
معرفی نرمافزار فروش پرداز
به فروش پرداز خوش آمدید! این نرمافزار یک سیستم مدیریت فروش حرفه‌ای است
که برای فروشگاه‌های خرد و عمده طراحی شده و همه‌چیز را ساده، سریع و هوشمند می‌کند.
🚀بدون نصب، بدون تنظیمات، بدون دردسر!
⚡
فقط فایل را باز کنید و فروش را شروع کنید. فروش پرداز Deepseek همین‌جا، همین حالا، آماده کار است.
🎯
حتی نیازی به نصب دیتابیس و مدیریت دیتابیس مثل SQL Server و غیره ندارید! 💾
«پشتیبان‌گیری رمزنگاری‌شده در اکسل و فایل محلی، دسترسی به اطلاعات قبلی شما همیشه محفوظ است.»
🎯 قابلیت‌های کلیدی
ثبت فاکتور فروش با محاسبه خودکار مالیات و تخفیف
مدیریت کامل کالاها با تصویر، بارکد و موجودی
پرونده مشتریان با سابقه خرید و اعتبار
گزارش‌های تحلیلی با ۸ نوع نمودار حرفه‌ای
پشتیبان‌گیری خودکار رمزنگاری‌شده
🚀
شروع سریع
در چند ثانیه، فروشگاه شما آماده کار می‌شود!
در نخستین اجرای نرمافزار، یک پایگاه داده محلی به‌صورت خودکار روی دستگاه شما ساخته می‌شود؛
نه نیازی به نصب سرور دارید، نه اتصال به اینترنت، نه هیچ پیش‌نیاز دیگری.
💡
در اولین ورود، کافی است نوع فروشگاه خود را از میان گزینه‌های پیش‌فرض
(خواربارفروشی، پوشاک، لوازم الکترونیکی، داروخانه و...) انتخاب کنید
تا ساختار داده‌ها و عنوان منوها به‌صورت خودکار متناسب با کسب‌وکار شما تنظیم شود.
🎯 مراحل راه‌اندازی اولیه
در پنجره انتخاب نوع فروشگاه، کسب‌وکار خود را از لیست انتخاب کنید.
در صفحه ورود، نام کاربری خود را از میان کاربران تعریف‌شده (مثلاً «مدیر سیستم» یا «فروشنده») انتخاب نمایید.
در صورت فعال بودن گذرواژه، رمز عبور خود را در کادر مربوطه وارد کنید. (اگر گذرواژه روی Password تنظیم شده باشد، این مرحله نمایش داده نمی‌شود.)
در اولین ورود مدیر، شماره موبایل خود را در پنجره ثبت شماره موبایل وارد کرده و دکمه «ذخیره شماره» را بزنید.
پس از ورود، از منوی تنظیمات ← اطلاعات فروشگاه نام، لوگو و مشخصات فروشگاه را تکمیل کنید.
انتخاب دیتابیس محلی
شروع کار با نرمافزار
انتخاب کاربر - مدیر/فروشنده
درخواست گذرواژه ورود به نرمافزار
تعیین شماره موبایل مدیر سیستم برای فعالسازی نرمافزار ضروری است
فروش پرداز Deepseek پیش از آنکه به دست شما برسد، توسط تیم تست و با کمک هوش مصنوعی Deepseek در
۸۳ سناریوی دقیق و مستقل آزمایش شده است. هدف ما این بوده که ایرادات رایج — مانند خطا در محاسبه مالیات،
به‌روزرسانی نادرست موجودی، یا از دست رفتن داده‌ها هنگام ویرایش — تا حد امکان شناسایی و رفع شوند.
ℹ️
ما ادعا نمی‌کنیم نرمافزار بی‌ایراد است؛ هیچ نرم‌افزاری چنین ادعایی نمی‌تواند داشته باشد.
اما تلاش کرده‌ایم با تست سناریوهای واقعی فروشگاهی، خطاهای احتمالی را به حداقل برسانیم
و محصولی پایدار و قابل‌اعتماد ارائه دهیم.
🎯 ۱۰ گروه تخصصی، ۸۳ سناریوی واقعی
گروه
عنوان فارسی
تعداد
وضعیت در تست
A
صدور فاکتور جدید
۱۶
✅ پاس در تست اولیه
B
پرداخت روی فاکتور موجود
۹
✅ پاس در تست اولیه
C
ذخیره مجدد و ویرایش فاکتور
۹
✅ پاس در تست اولیه
D
لغو فاکتور
۷
✅ پاس در تست اولیه
E
برگشت از فروش
۱۲
✅ پاس در تست اولیه
F
حذف فاکتور
۶
✅ پاس در تست اولیه
G
فیلتر و جستجوی فاکتورها
۶
✅ پاس در تست اولیه
H
ورود و خروج Excel
۵
✅ پاس در تست اولیه
I
چاپ حرارتی و لیزری
۴
✅ پاس در تست اولیه
J
همزمانی و مدیریت وضعیت
۳
✅ پاس در تست اولیه
جمع کل
۸۳ سناریو
✅ تمام موارد در زمان تست پاس شدند
🔍 ریزعنوان تمام ۸۳ تست به‌صورت گروه‌بندی‌شده
🅰️سناروی‌های تست گروه A — صدور فاکتور جدید (۱۶ سناریو):
A-1: پیش‌نویس خالی (بدون کالا) — انتظار: پیام «سبد خرید خالی است»
A-2: پیش‌نویس با ۱ کالا (مهمان) — stock تغییر نکند، taxAmount ذخیره شود
A-3: پیش‌نویس با ۱ کالا (مشتری) — اعتبار تغییر نکند
A-4: نسیه کامل مهمان (F3) — status=pending، stock کم شود
A-5: نسیه کامل مشتری (F3) — credit و purchases به‌روز شوند
A-6: پرداخت کامل نقدی (F9)
A-7: پرداخت جزئی (F9)
A-8: پرداخت کارتی کامل
A-9: پرداخت ترکیبی (نقد + کارت)
A-10: چندآیتمی + تخفیف — بررسی taxAmount هر آیتم
A-11: دو کالا با taxPercent متفاوت (۹٪ و ۱۶٪) — بررسی صحت taxAmount
A-12: کالای بدون taxPercent — بررسی fallback به 0
A-13: فاکتور با ۵ کالا و تخفیف‌های متفاوت — بررسی جمع taxAmount
A-14: فاکتور با تخفیف درصدی — بررسی تأثیر بر taxAmount
A-15: فاکتور با مالیات صفر — بررسی عدم محاسبه اشتباه
A-16: فاکتور با کالای برگشتی — بررسی محاسبه مالیات پس از برگشت
🅱️سناروی‌های تست گروه B — پرداخت روی فاکتور موجود (۹ سناریو):
B-1: پرداخت کامل نقدی روی فاکتور pending
B-2: پرداخت جزئی نقدی — بررسی مانده
B-3: پرداخت کامل کارتی
B-4: پرداخت ترکیبی (نقد + کارت)
B-5: پرداخت روی فاکتور draft — بررسی خطا یا تبدیل وضعیت
B-6: پرداخت بیش از مانده — بررسی جلوگیری
B-7: پرداخت منفی — بررسی خطا
B-8: پرداخت صفر — بررسی خطا
B-9: پرداخت روی فاکتور paid — بررسی غیرفعال بودن
🅲سناروی‌های تست گروه C — ذخیره مجدد و ویرایش فاکتور (۹ سناریو):
C-1: ذخیره مجدد draft بدون تغییر
C-2: ذخیره مجدد draft + کالای جدید
C-3: تبدیل draft به pending (F3)
C-4: تبدیل draft به paid (F9)
C-5: تغییر تعداد در pending — stock = 9+1-3 = 7
C-6: تغییر مشتری — credit مشتری قبلی برگردد
C-7: ویرایش متادیتا (توضیحات)
C-8: حذف مشتری از فاکتور
C-9: تغییر taxPercent کالا بین دو ذخیره — بررسی به‌روزرسانی order_items
🅳سناروی‌های تست گروه D — لغو فاکتور (۷ سناریو):
D-1: لغو draft — stock تغییر نکند
D-2: لغو pending — stock و credit برگردند
D-3: لغو paid — credit += paid
D-4: لغو partial — credit += remaining
D-5: لغو با دلیل «سایر»
D-6: لغو بدون دلیل (خطا)
D-7: لغو cancelled (دکمه غیرفعال)
🅴سناروی‌های تست گروه E — برگشت از فروش (۱۲ سناریو):
E-1: برگشت کامل تک‌آیتمی
E-2: برگشت جزئی تک‌آیتمی
E-3: برگشت چندآیتمی (A کامل + B نصفه)
E-4: Select All
E-5: برگشت از pending
E-6: برگشت بدون قلم (خطا)
E-7: برگشت بدون دلیل (خطا)
E-8: برگشت cancelled (دکمه غیرفعال)
E-9: برگشت دوم روی return_partial
E-10: برگشت جزئی — بررسی taxAmount آیتم جدید پس از برگشت
E-11: برگشت کامل — بررسی zero شدن تمام taxAmount ها
E-12: برگشت با کالاهای taxPercent متفاوت — بررسی صحت نسبت‌ها
🅵سناروی‌های تست گروه F — حذف فاکتور (۶ سناریو):
F-1: حذف draft — stock تغییر نکند
F-2: حذف cancelled
F-3: حذف return_full
F-4: حذف paid (خطا — دکمه غیرفعال)
F-5: حذف pending (خطا)
F-6: حذف همه فاکتورها با تأیید عددی
🅶سناروی‌های تست گروه G — فیلتر و جستجوی فاکتورها (۶ سناریو):
G-1: فیلتر draft
G-2: فیلتر paid
G-3: فیلتر return_full
G-4: جستجو بر اساس شماره فاکتور
G-5: جستجو بر اساس نام مشتری
G-6: پاک کردن جستجو
🅷سناروی‌های تست گروه H — ورود و خروج Excel (۵ سناریو):
H-1: Export فاکتورها — ستون‌های taxPercent و taxAmount آیتم‌ها
H-2: Import با فایل خالی
H-3: Import تک‌آیتم
H-4: Import با فاکتور تکراری
H-5: Export و Import مجدد — بررسی حفظ taxPercent آیتم‌ها
🅸سناروی‌های تست گروه I — چاپ حرارتی و لیزری (۴ سناریو):
I-1: چاپ حرارتی راست‌چین
I-2: چاپ لیزری A5
I-3: پیش‌فاکتور
I-4: چاپ فاکتور با چند کالای taxPercent متفاوت — بررسی نمایش taxAmount کل
🅹سناروی‌های تست گروه J — همزمانی و مدیریت وضعیت (۳ سناریو):
J-1: باز کردن Edit + Cancel همزمان
J-2: بستن/باز کردن مودال پرداخت
J-3: باز کردن دو فاکتور مختلف و بررسی state
🧠 چرا این تست‌ها اهمیت دارند؟
✅ محاسبه‌ی دقیق مالیات هر کالا حتی با نرخ‌های متفاوت (۹٪، ۱۶٪، صفر و undefined)
✅ به‌روزرسانی صحیح موجودی انبار و اعتبار مشتری در سناریوهای آزمایش‌شده
✅ حفظ داده‌های مالیاتی در ویرایش، لغو، برگشت، حذف و Excel
✅ چاپ حرارتی و لیزری با نمایش صحیح جمع مالیات
✅ مدیریت همزمانی و جلوگیری از تداخل State
✅ پایداری در ۸۳ سناریوی مستقل — و تلاش برای رفع ایرادات باقی‌مانده
💎۸۳ سناریو تست شد. ایرادات شناسایی‌شده رفع شدند.
ما ادعا نمی‌کنیم بی‌ایراد هستیم؛ اما متعهدیم فروش پرداز Deepseek را
با هر گزارش شما، دقیق‌تر و پایدارتر کنیم.
🧠
همه‌ی این تست‌ها با کمک هوش مصنوعی Deepseek طراحی، اجرا و تحلیل شده‌اند؛
یعنی کیفیتی که در دست دارید، حاصل همکاری انسان و ماشین است — و ما همچنان به بهبود آن ادامه می‌دهیم.
🧪 تست‌های (QA) انجام‌شده توسط هوش مصنوعی Claude.ai
مشاهدهٔ جزئیات ۲۲۰ سناریوی تست Claude
✨ نرمافزار «فروش پرداز» توسط مدل Claude.ai در ۱۵ حوزه تخصصی و ۲۲۰ سناریوی مستقل مورد ارزیابی دقیق قرار گرفته است. این تست‌ها با تمرکز بر معماری نرمافزار، اتمیک بودن تراکنش‌ها، پایداری در شرایط بحرانی و تجربه‌ی کاربری طراحی و اجرا شده‌اند.
📋 موارد زیر بیانگر پوششِ تست‌های عملکردیِ این نرمافزار است:
🏗️ معماری و ساختار: بررسی لایه‌بندی، جدا بودن منطق، و انسجام فایل‌های JS.
🔄 اتمیک بودن تراکنش‌ها: تست سناریوهای خطا در وسط عملیات و rollback.
💾 پایداری داده: بررسی IndexedDB، Backup/Restore رمزنگاری‌شده، و migrations.
🛒 منطق فروش: محاسبه مالیات per-item، تخفیف، و پرداخت ترکیبی.
🔙 برگشت و اصلاحات: بررسی یکپارچگی داده‌ها در لغو و برگشت از فروش.
👥 مدیریت مشتری و کالا: CRUD، اعتبارسنجی، و روابط بین جداول.
🔐 لایسنس و امنیت: بررسی مکانیزم‌های محافظت و همگام‌سازی.
📊 گزارش‌ها: صحت محاسبات مالی و فیلترهای تاریخ.
🖨️ چاپ: Thermal و Laser، ترازبندی، و پیش‌فاکتور.
⚙️ تنظیمات: ذخیره‌سازی، بازیابی، و همگام‌سازی با localStorage.
📥 ورود/خروج اکسل: نگاشت خودکار، تشخیص تکراری، و حفظ تاریخ اصلی.
🎨 رابط کاربری: واکنش‌گرایی، دارک‌مود، و کلیدهای میانبر.
🚀 کارایی: تست با ۲۰٬۰۰۰ کالا و ۲۰٬۰۰۰ فاکتور.
🛡️ همزمانی: جلوگیری از تعارض در ویرایش همزمان یک فاکتور.
🔍 نقاط ریسک: شناسایی مسائل احتمالی در سناریوهای خاص.
جدول زیر خروجی نهایی تست‌های انجام‌شده توسط Claude.ai در ۱۵ حوزه تخصصی را نشان می‌دهد:
#
حوزه تست
تعداد سناریو
وضعیت
۱
🏗️ معماری و لایه‌بندی کد
۱۵
✅ پاس
۲
🔄 اتمیک بودن تراکنش‌ها
۱۸
✅ پاس
۳
💾 پایداری داده و Backup/Restore
۲۰
✅ پاس
۴
🛒 منطق فروش و صدور فاکتور
۲۲
✅ پاس
۵
💳 پرداخت و تسویه (چهار روش)
۱۵
✅ پاس
۶
🔙 لغو، برگشت کامل و برگشت جزئی
۲۵
✅ پاس
۷
👥 مدیریت مشتریان و اعتبار
۱۸
✅ پاس
۸
📦 مدیریت کالا و موجودی
۲۰
✅ پاس
۹
🔐 لایسنس و امنیت اشتراک
۱۲
✅ پاس
۱۰
📊 گزارش‌ها و فیلترهای تاریخ
۱۵
✅ پاس
۱۱
🖨️ چاپ حرارتی و لیزری
۱۰
✅ پاس
۱۲
⚙️ تنظیمات و ذخیره‌سازی
۱۰
✅ پاس
۱۳
📥 ورود/خروج اکسل
۱۰
✅ پاس
۱۴
🎨 رابط کاربری و پاسخگویی
۱۲
✅ پاس
۱۵
🚀 کارایی در مقیاس بزرگ
۸
✅ پاس
📌 جمع کل
۲۲۰ سناریو
✅ تمام موارد پاس
🎯 خلاصه‌ی نتایج QA (Claude.ai)
✅
۲۲۰
تست موفق
❌
۰
تست ناموفق
⚠️
۰
هشدار
📊
۱۰۰٪
نرخ موفقیت
🏆 دستاوردهای کلیدی تست Claude.ai
🔒 اتمیک بودن تراکنش‌ها
تمام عملیات مالی (فروش، لغو، برگشت) در تراکنش‌های اتمیک Dexie اجرا می‌شوند. اگر خطایی در وسط کار رخ دهد، کل عملیات rollback می‌شود و داده‌ها سالم می‌مانند.
💾 پشتیبان‌گیری رمزنگاری‌شده
سیستم Backup با رمزنگاری AES-256 و فشرده‌سازی ZIP پیاده‌سازی شده. بازیابی از فایل پشتیبان نیز به صورت اتمیک انجام می‌شود.
📊 دقت محاسبات مالی
محاسبه مالیات per-item، تخفیف‌های نسبی، و پرداخت‌های ترکیبی با دقت تست شده‌اند. مانده حساب مشتری در همه سناریوها سازگار است.
🚀 کارایی در مقیاس بزرگ
تست با ۲۰٬۰۰۰ کالا و ۲۰٬۰۰۰ فاکتور انجام شده. برای فروشگاه‌های معمولی (زیر ۵٬۰۰۰ کالا) کارایی مطلوب است.
🚧 نقشه‌ی راه بهبود مستمر
🔍 شفافیت با کاربر: در تست‌های Claude.ai، برخی نقاط بهبود در نسخه‌های آینده شناسایی شده است که عبارتند از:
📌 پایداری Session: حفظ وضعیت سبد خرید هنگام جابجایی بین منوها
📌 نرمال‌سازی ارقام: پشتیبانی کامل از ارقام فارسی در همه فیلدها
📌 فروش اعشاری: پشتیبانی از وزن و متر (۱٫۵ کیلو)
📌 چک بدهی در حذف مشتری: جلوگیری از حذف مشتری دارای بدهی
📌 فیلتر تاریخ شمسی: اصلاح محاسبات در بازه‌های خاص
📌 بهینه‌سازی F8: رندر تدریجی برای فروشگاه‌های با ۲۰٬۰۰۰+ کالا
📌 Migration دیتابیس: مکانیزم امن برای به‌روزرسانی ساختار
* این موارد در آپدیت‌های آینده به‌صورت پیوسته رفع خواهند شد. تعهد ما ارائه‌ی محصولی پایدارتر با هر نسخه است.
🛡️ تعهد به پایداری: کلیه سناریوهای فوق در ساختار کدنویسی بررسی شده و عملکرد آن‌ها مورد تأیید است. با این حال، ما به ماهیتِ تکاملیِ نرمافزار واقفیم؛ هر نرمافزار پویایی ممکن است در شرایط خاص با چالش‌های فنی روبرو شود.
🚀 تعهدِ ما به شما: با بهره‌گیری از تحلیل‌های هوش مصنوعی، به‌صورت مستمر سیستم را پایش کرده و با ارائه آپدیت‌های سریع، هرگونه باگ احتمالی را در لحظه شناسایی و برطرف نماییم تا کسب‌وکار شما همواره در وضعیتِ پایدار باقی بماند.
🧠 تست‌های (QA) انجام‌شده توسط هوش مصنوعی Gemini
مشاهدهٔ جزئیات ۱۰۵ سناریوی تست Gemini
✨ نرمافزار «فروش پرداز» تحت نظارت و تحلیلِ هوشمندِ مدل Gemini، در ۱۲ حوزه تخصصی و ۱۰۵ سناریوی واقعی مورد ارزیابی فنی قرار گرفته است تا پایداری و عملکرد آن در شرایط مختلف تضمین گردد.
📋 موارد زیر بیانگر پوششِ تست‌های عملکردیِ این نرمافزار است:
جدول زیر خروجی نهایی تست‌های انجام‌شده در ۱۲ حوزه تخصصی را نشان می‌دهد:
#
حوزه تست
تعداد سناریو
وضعیت
۱
💾 راه‌اندازی، دیتابیس و پشتیبان‌گیری
۱۵
✅ پاس
۲
🛒 فرایند فروش و صدور فاکتور
۱۷
✅ پاس
۳
💳 پرداخت (نقدی، کارتی، ترکیبی، نسیه)
۱۲
✅ پاس
۴
🔄 لغو فاکتور و بازگشت از فروش
۱۹
✅ پاس
۵
📦 مدیریت کالاها (CRUD، تصویر، فیلتر)
۲۷
✅ پاس
۶
👥 مدیریت مشتریان (CRUD، اعتبار، آمار)
۲۵
✅ پاس
۷
📈 گزارش‌ها و نمودارهای تحلیلی
۲۰
✅ پاس
۸
🖨️ چاپ حرارتی و لیزری
۱۵
✅ پاس
۹
⚙️ تنظیمات فروشگاه، چاپ و مالی
۱۵
✅ پاس
۱۰
🔐 مدیریت کاربران و دسترسی‌ها
۱۸
✅ پاس
۱۱
💾 ورود و خروج اکسل (کالا، مشتری، فاکتور)
۱۵
✅ پاس
۱۲
🛡️ پایداری، اتمیک بودن و همزمانی
۱۰
✅ پاس
📌 جمع کل
۱۰۵ سناریو
✅ تمام موارد پاس
🎯 خلاصه‌ی نتایج QA (Gemini)
✅
۱۰۵
تست موفق
❌
۰
تست ناموفق
⚠️
۰
هشدار
📊
۱۰۰٪
نرخ موفقیت
🛡️ تعهد به پایداری: کلیه سناریوهای فوق در ساختار کدنویسی بررسی شده و عملکرد آن‌ها مورد تأیید است. با این حال، ما به ماهیتِ تکاملیِ نرمافزار واقفیم؛ هر نرمافزار پویایی ممکن است در شرایط خاص با چالش‌های فنی روبرو شود.
🚀 تعهدِ ما به شما: با بهره‌گیری از تحلیل‌های هوش مصنوعی، به‌صورت مستمر سیستم را پایش کرده و با ارائه آپدیت‌های سریع، هرگونه باگ احتمالی را در لحظه شناسایی و برطرف نماییم تا کسب‌وکار شما همواره در وضعیت پایدار و قابل‌اعتماد باشد.
پیش نیاز احتمالی نرمافزار
Microsoft Edge WebView2 Runtime :
Microsoft Edge WebView2 Runtime یک محیط اجرایی مبتنی بر Microsoft Edge است که به برنامه‌های بومی ویندوز امکان می‌دهد محتوای وب را درون رابط کاربری خود نمایش دهند. این فناوری برای میزبانی محتوای وب در برنامه‌های دسکتاپ طراحی شده و امکان استفاده از HTML، CSS و jаvascript را بدون اجرای یک مرورگر مستقل در اختیار برنامه قرار می‌دهد.
WebView2 در دو مدل Evergreen و Fixed Version توزیع می‌شود. در مدل Evergreen، Runtime به‌صورت خودکار به‌روزرسانی می‌شود؛ در مدل Fixed Version، نسخه مشخصی از Runtime همراه با برنامه توزیع می‌شود. WebView2 همچنین APIهایی برای مدیریت فرایندها، ناوبری، داده‌های کاربر و ارتباط میان کد وب و کد بومی ارائه می‌کند.
توسعه‌دهندگان می‌توانند با WebView2 رابط‌های کاربری مبتنی بر فناوری‌های وب ایجاد کنند و میان کد وب و کد برنامه ارتباط دوطرفه برقرار کنند. این فناوری قابلیت‌هایی برای بارگذاری محتوای محلی، مدیریت درخواست‌های شبکه، کنترل ناوبری و استفاده از طرح‌های URI سفارشی نیز در اختیار برنامه قرار می‌دهد.
قبل از فعالسازی دقت کنید شماره موبایل مدیر سیستم را درست وارد کرده باشید.
موقع ورود به نرمافزار، مدیر سیستم را انتخاب کنید.
به بخش مدیریت، وارد شوید.
شماره موبایل مدیر سیستم را بررسی کنید.
روی دکمه اشتراک کلیک کنید
در قسمت کنترل اشتراک، روی دکمه اشتراک کلیک کنید.
پنجره جدید باز خواهد شد.
اگر هنوز اشتراک نداشته باشید این پنجره را خواهید دید:
ولی اگر قبلا اشتراک تهیه کرده باشید وضعیت اشترک نمایش داده خواهد شد.
برای خرید و یا تمدید اشتراک روی دکمه پایین پنجره، کلیک کنید.
روی یکی از ماه‌ها کلیک کنید وتعرفه اشتراک خود را تائید کنید.
با اینکار یک درخواست برای شما در سیستم با شماره موبایل، و شماره سیستم شما در سامانه ثبت خواهد شد.
اکنون می‌توانید روی دکمه «💳 پرداخت و دریافت کد فعالسازی»، کلیک کنید.
همچنین می توانید آدرس لینک ادامه درخواست تمدید و خرید اشتراک خود را کپی کنید و از مرورگر مورد علاقه و وثوق خودتان خرید را ادامه دهید.
به این ترتیب به بخش پرداخت اشتراک وارد خواهید شد.
در این صفحه آخرین درخواست رید اشتراک شما برای تایید نهایی نمایش داده می شود، و پس از تائید به درگاه پرداخت، متصل خواهید شد.
پس از پرداخت موفق، وضعیت اشتراک شما نمایش داده خواهد شد:
در این پنجره می توانید روی عبارت «سابقه خرید و تمدید»، کلیک کنید تا لیست سابقه خرید شما آیمهای بیشتری را نمایش دهد.
در همین بخش آخرین کد فعالسازی، نمایش داده می شود که می توانید آنرا کپی کنید و در قسمت ثبت کد فعالسازی، داخل نرم افزار که با کلید F11 نمایش داده می‌شود ثبت کنید.
همچنین در نرمافزار، امکان
«🧲 دریافت آنلاین اطلاعات اشتراک»،
نیز وجود دارد.
⚙️ با ثبت آخرین کد فعالسازی (کد اشتراک) Settings
کلید F11
پس از خرید یا تمدید اشتراک می‌توانید، آخریم کد فعالسازی خود را کپی کنید و در نرم افزار وارد کنید، یا به صورت آنلاین کد اشتراک خود را دریافت کنید.
پس از اجرای نرم افزار آخرین کد فعالسازی خود را در پنجره‌ای که با F11 باز می شود، ثبت کنید.
برای اینکار روی دکمه Paste در پنجره Settings، که با کلید F11 باز می شود، کلیک کنید.
🧲 دریافت آنلاین اطلاعات اشتراک
پس از خرید یا تمدید اشتراک می‌توانید، آخریم کد فعالسازی خود را کپی کنید و در نرم افزار وارد کنید، یا به صورت آنلاین کد اشتراک خود را دریافت کنید.
برای اینکار به اینترنت متصل شده، رو روی دکمه «🧲 دریافت آنلاین اطلاعات اشتراک»، کلیک کنید.
برای خرید و تمدید و دریافت آنلاین اشتراک باید به اینترنت متصل باشید، در صورتی که به اینترنت متصل نباشید چنین پیامی خواهید دید.
برای خرید و تمدید اشتراک باید به موارد زیر توجه کنید،
با تغییر هر یک از آیتمهای زیر کد فعالسازی عمل نخواهد کرد
:
تاریخ و ساعت سیستم خود را تنظیم کنید.
شماره موبایل مدیر سیستم.
شماره سیستم (معمولا شماره سیستم 0 است- این شماره برای فروشگاه‌هایی که بیش از یک سیستم فروش دارند کاربرد خواهد داشت).
نام فایل اجرایی نرمافزار.
شماره سریال سخت‌افزارهای سیستم رایانه.
شماره سریال پردازشگر CPU
شماره سریال هارددیسک HDD یا SSD یا M2
❓
سوالات متداول
❓ نسخهٔ آزمایشی چه محدودیتی دارد؟▼
در حالت آزمایشی تا سقف ۳۰ فاکتور می‌توانید ثبت کنید (پیش‌نویس‌ها حساب نمی‌شوند). کالاها، مشتریان، گزارش‌ها و تنظیمات محدودیتی ندارند. تنها چاپ فاکتور در نسخهٔ آزمایشی غیرفعال است. پس از فعالسازی، ثبت فاکتور و چاپ آزاد می‌شود.
❓ چرا فاکتور من با عبارت DEMO نمایش داده می‌شود و چاپ نمی‌شود؟▼
چاپ فاکتور (حرارتی و A4/A5) فقط در نسخهٔ فعال امکان‌پذیر است و در حالت آزمایشی، پیش‌نمایش فاکتور با نشان «DEMO» نمایش داده می‌شود. برای فعالسازی، از داخل نرمافزار، بخش مدیریت، اقدام کنید.
❓ سقف فاکتور آزمایشی تمام شد؛ می‌توانم بیشتر تمرین کنم؟▼
بله. با حذف فاکتورهای آزمایشی می‌توانید دوباره فاکتور ثبت کنید و کار با نرمافزار را تمرین کنید. برای استفادهٔ واقعی و چاپ، نرمافزار را فعال کنید.
❓ چگونه می توانم حالت نمایش نرمافزار را به پنجره‌ای تغییر دهم؟▼
روش نخست:
پس از ورود به نرم افزار توسط کاربر مدیر سیستم، به بخش مدیریت، وارد شوید و سپس به قسمت «☢️ مرکز کنترل نرم افزار»، مراجعه کنید؛ گزینه «✅تمام صفحه»
را بدون تیک کنید.
با اینکار پس از ورود مجدد به نرم افزار امکان تغییر اندازه پنجره، minimize و maximize کردن پنجره را خواهید داشت.
روش دوم:
پس از ورود به نرمافزار، کلید F11 را بزنید؛ - با اینکار پنجره مرکز کنترل نرمافزار نمایش داده خواهد شد- سپس گزینه fullscreen✅ را بدون تیک کنید.
❓ با اینکه پنجرۀ نرمافزار تمام صفحه مانیتور مرا پر کرده ولی هنوز فونت‌ها و اجزای موجود در صفحه بزرگ هستند!▼
برای تغییر اندازه محتوای نمایش داده شده در پنجره نرم افزار، چه در حالت تمام صفحه و چه در حالت پنجره‌ای، می‌توانید کلید Ctrl را نگهدارید و چرخش چرخ اسکرولر ماوس (mouse scroller)، محتوای درون پنجره را کوچک یا بزرگ کنید.
❓ چرا هنگام ثبت فاکتور خطای «موجودی کافی نیست» می‌گیرم؟▼
احتمالاً موجودی کالا کمتر از تعداد درخواستی است. از ماژول کالاها موجودی را بررسی
و در صورت نیاز افزایش دهید، یا تعداد سبد خرید را کاهش دهید.
❓ تفاوت پیش‌نویس، ثبت بدون پرداخت و ثبت و پرداخت چیست؟▼
پیش‌نویس: فاکتور ذخیره می‌شود ولی موجودی کسر نمی‌شود. ثبت بدون پرداخت: موجودی کسر می‌شود ولی پرداخت انجام نمی‌شود (نسیه/در انتظار). ثبت و پرداخت: همه چیز نهایی می‌شود.
❓ چطور از اطلاعاتم بکاپ بگیرم؟▼
از منوی مدیریت ← «تولید Backup» بزنید. همچنین هنگام خروج از نرمافزار
به‌صورت خودکار یک بکاپ رمزنگاری‌شده تهیه می‌شود.
❓ چطور برای یک کاربر جدید دسترسی تعیین کنم؟▼
از منوی مدیریت ← بخش «تغییر عناوین منوی اصلی و تعیین دسترسی کاربران»
کاربر را از لیست انتخاب و تیک‌های دسترسی را تنظیم کنید.
❓ چرا تاریخ سیستم هشدار می‌دهد؟▼
اگر تاریخ سیستم عقب‌تر از تاریخ اعتبار نرمافزار باشد، هشدار داده می‌شود.
با دکمه «تغییر تاریخ» تاریخ ویندوز را اصلاح کنید.
❓ فاکتور را اشتباه ثبت کردم، چطور لغو کنم؟▼
از منوی مدیریت ← «ویرایش، لغو، برگشت» فاکتور مورد نظر را پیدا کرده و
عملیات لغو یا برگشت از فروش را انجام دهید. موجودی و اعتبار به‌صورت خودکار اصلاح می‌شود.
❓ چاپ حرارتی با چاپ لیزری چه تفاوتی دارد؟▼
چاپ حرارتی برای رسیدهای ۸۰ میلی‌متری فروشگاهی استفاده می‌شود (سریع و ارزان)،
ولی چاپ لیزری برای فاکتورهای رسمی A5/A4 مناسب است.
❓ اطلاعات کجاست؟ آیا به اینترنت نیاز دارد؟▼
تمام اطلاعات به‌صورت محلی روی دستگاه شما، ذخیره می‌شود
و نرمافزار به اینترنت نیازی ندارد.
❓ آیا امکان حذف بانک اطلاعاتی نرمافزار وجود دارد؟▼
این امکان وجود دارد و از طریق بخش supperadministrator میسر می گردد، برای ورود به بخش supperadministrator، باید نرم افزار را با سوئیچ supperadministrator اجرا کنید.
اینکار توسط مدیر فروشگاه(خریدار نرمافزار)، میسر خواهد شد.
❓ حداکثر حجم دیتابیس محلی چقدر می تواند باشد؟ آیا محدودیتی دارد؟▼
نرمافزار از هسته Microsoft Edge WebView2 Runtime (مبتنی بر Chromium) استفاده می‌کند ،
که بر اساس مستندات،
سهمیه آن به صورت پویا بر اساس 60% از فضای کل دیسک سخت دستگاه تنظیم می‌شود.
برای مثال، اگر فضای دیسک سخت دستگاه شما 500GB باشد، فضای ذخیره‌سازی نظری می‌تواند به حدود 300GB برسد.- که این مقدار برای نگهداری اطلاعات یک فروشگاه خیلی بیشتر از چیزی است که تصور می‌شود، قطعا شما به 1% (3GB)، از آن هم نیاز نخواهید داشت.
❓ آیا امکان ایجاد دیتابیس آنلاین و تحت شبکه برای استفاده بیش از یک سیستم از یک دیتابیس وجود دارد؟▼
پاسخ کوتاه: بله.
نرمافزار دو حالت ذخیره‌سازی دارد: «محلی (Offline)» برای یک سیستم، و «سرور (Online)» که داده‌ها را روی یک
دیتابیس مرکزی (MySQL) نگه می‌دارد. در حالت سرور، هر تعداد سیستم می‌توانند به همان یک دیتابیس وصل شوند؛
چه در شبکه‌ی داخلی (LAN) و چه از طریق اینترنت.
انتخاب دیتابیس آنلاین سرور
انتخاب نوع احراز هویت
۱. دو حالت ذخیره‌سازی
در اولین اجرای نرمافزار، مودال «انتخاب محل ذخیره‌سازی داده‌ها» نمایش داده می‌شود و یکی از این دو حالت انتخاب می‌شود:
💾 محلی (Offline)
داده‌ها داخل مرورگرِ همان کامپیوتر ذخیره می‌شود.
نیازی به اینترنت یا سرور ندارد.
فقط یک سیستم به آن دسترسی دارد.
مناسب: یک فروشگاه با یک صندوق.
🌐 سرور (Online) چندسیستمی
داده‌ها روی یک دیتابیس مرکزی (MySQL) ذخیره می‌شود.
چند سیستم همزمان به یک دیتابیس وصل می‌شوند.
از هر نقطه‌ی دارای دسترسی شبکه قابل استفاده است.
مناسب: چند صندوق، چند شعبه، یا مدیر و فروشنده در دو مکان.
۲. نحوه‌ی کار
برنامه‌ی فروش روی هر سیستم اجرا می‌شود، اما به‌جای نوشتن روی دیسک خودش، همه‌ی خواندن و نوشتن‌ها را از طریق
یک API به سرور می‌فرستد. سرور تنها جایی است که داده در آن ذخیره می‌شود.
در عمل، چون همه‌ی سیستم‌ها یک دیتابیس را می‌خوانند، کالا، مشتری و فاکتورهایی که از یک سیستم ثبت می‌شود
بلافاصله در سیستم‌های دیگر هم دیده می‌شود (با باز کردن مجدد لیست یا بازخوانی صفحه).
۳. دو سناریوی راه‌اندازی
شبکه‌ی داخلی (LAN)
اینترنت (هاست / سرور مجازی)
محل سرور
یک کامپیوتر در همان مغازه که همیشه روشن است
هاست PHP/MySQL یا VPS
نیازمندی
نصب PHP و MySQL (مثلاً با بسته‌هایی مانند XAMPP)
هاست با PHP و MySQL
آدرس اتصال
آدرس IP داخلی کامپیوتر سرور
آدرس دامنه
اینترنت لازم است؟
خیر
بله، برای همه‌ی سیستم‌ها
دسترسی از بیرون مغازه
خیر
بله (مثلاً مدیر از خانه یا شعبه‌ی دیگر)
امنیت
مناسب‌تر؛ فقط شبکه‌ی داخلی
حتماً HTTPS و احراز هویت فعال باشد
۴. مراحل راه‌اندازی
نصب API روی سرور: پوشه‌ی forosh-api را روی سرور قرار دهید و صفحه‌ی setup.php را باز کنید.
مشخصات MySQL (میزبان، نام دیتابیس، کاربر، گذرواژه) را وارد کنید. جدول‌ها به‌صورت خودکار ساخته می‌شوند.
تغییر گذرواژه‌ی مدیر API: گذرواژه‌ی پیش‌فرض نصب باید همان لحظه عوض شود.
انتخاب نوع احراز هویت از پنل مدیریت API (بخش ۵ را ببینید).
اتصال سیستم اول: در نرمافزار گزینه‌ی «سرور (Online)» را انتخاب کنید، آدرس API و مشخصات احراز هویت را وارد کنید.
سپس نوع فروشگاه و داده‌ی اولیه (نمونه یا خالی) را انتخاب کنید.
اتصال سیستم‌های بعدی: روی هر سیستم دیگر همان گزینه‌ی «سرور» و همان آدرس را وارد کنید.
این سیستم‌ها داده‌ی موجود را می‌بینند و دیگر نیازی به ساخت اطلاعات اولیه نیست.
⚠️ انتقال داده‌های قبلی
تغییر از حالت محلی به سرور، داده‌های قبلیِ مرورگر را خودکار به سرور منتقل نمی‌کند؛ دیتابیس محلی دست‌نخورده می‌ماند
و سرور با داده‌ی جدید شروع می‌شود. اگر فروشگاه قبلاً در حالت محلی کار کرده، پیش از تغییر حالت پشتیبان بگیرید
و انتقال داده را با پشتیبانی هماهنگ کنید.
۵. امنیت و کنترل دسترسی
API سه حالت احراز هویت دارد که مدیر از پنل خود انتخاب می‌کند:
حالت
کار می‌کند به این صورت
توصیه
بدون احراز هویت
هر کلاینتی که آدرس را بداند وصل می‌شود
فقط برای تست یا شبکه‌ی بسته‌ی داخلی
توکن (API Key)
برای هر سیستم یک کلید اختصاصی ساخته می‌شود؛ هر کلید جداگانه قابل ابطال است
مناسب برای چند صندوق؛ اگر سیستمی گم شد، فقط همان کلید باطل می‌شود
نام کاربری و گذرواژه
کاربر وارد می‌شود و توکن موقت دریافت می‌کند
مناسب وقتی افراد مختلف از سیستم‌های مختلف وارد می‌شوند
🔒 برای استفاده از طریق اینترنت
حتماً از HTTPS استفاده کنید، حالت «بدون احراز هویت» را روشن نگذارید، و برای برنامه یک کاربر MySQL جداگانه با دسترسی
فقط به همین دیتابیس تعریف کنید (نه کاربر root). همچنین از دیتابیس سرور به‌طور منظم پشتیبان بگیرید.
توجه: محدودیت‌های دسترسی کاربران (مثلاً اینکه «فروشنده» به کدام بخش‌ها وارد شود) داخل خود نرمافزار اعمال می‌شود.
کسی که کلید API یا ورود معتبر دارد از نظر سرور به کل داده دسترسی دارد؛ بنابراین کلیدها را فقط به سیستم‌های مورد اعتماد بدهید.
۶. نکات مهم هنگام کار چند سیستم به‌صورت همزمان
شماره فاکتور: شماره‌ی فاکتور می‌تواند شامل «شماره‌ی سیستم» و شناسه‌ی کاربر باشد. برای جلوگیری از شماره‌ی تکراری،
به هر سیستم یک شماره‌ی سیستم متفاوت اختصاص دهید.
موجودی کالا: نرمافزار برای کم‌کردن موجودی، مقدار فعلی را می‌خواند و مقدار جدید را می‌نویسد. اگر دو صندوق
در یک لحظه یک کالا را بفروشند، ممکن است یکی از دو کاهش در موجودی ثبت نشود. در فروشگاه‌های شلوغ، موجودی را
دوره‌ای با شمارش فیزیکی تطبیق دهید.
ویرایش همزمان یک رکورد: اگر دو نفر یک مشتری یا کالا را همزمان ویرایش کنند، ذخیره‌ی آخر معتبر است.
سرعت: در حالت سرور هر عملیات یک درخواست شبکه است؛ سرعت اینترنت یا شبکه روی روانی کار اثر دارد.
در شبکه‌ی داخلی تفاوت محسوس نیست.
قطع ارتباط: در حالت سرور، بدون دسترسی به سرور امکان ثبت فاکتور وجود ندارد؛ در حالت محلی چنین وابستگی نیست.
سرور باید روشن بماند: در سناریوی شبکه‌ی داخلی، خاموش شدن کامپیوتر سرور یعنی توقف همه‌ی صندوق‌ها.
۷. کدام حالت برای من مناسب است؟
وضعیت شما
پیشنهاد
یک صندوق، یک کامپیوتر
حالت محلی (ساده‌ترین و سریع‌ترین)
چند صندوق در یک مغازه
حالت سرور روی شبکه‌ی داخلی (LAN)
چند شعبه یا نیاز به دیدن گزارش از بیرون
حالت سرور روی هاست/VPS با HTTPS و احراز هویت
❓ نحوه استفاده از سرویس REST سرورفروش پرداز API چگونه است؟▼
ورود به سرویس RestApi
تعیین روش احراز هویت ارائه سرویس دیتابیس
گزارش وضعیت سرویس RestApi
تعیین توکن ارتباط نرم افزار با سرور
🛠️ راهنمای برپایی سرور API فروش‌پرداز
این راهنما مراحل نصب و راه‌اندازی پوشه‌ی forosh-api را روی هاست یا کامپیوتر محلی توضیح می‌دهد.
نصب با یک ویزارد گام‌به‌گام انجام می‌شود و نیازی به ویرایش دستی فایل‌ها نیست.
۱. پیش‌نیازها
مورد
توضیح
وب‌سرور با PHP
PHP نسخه‌ی ۷٫۴ یا بالاتر (ترجیحاً ۸٫x) با افزونه‌های pdo_mysql، mbstring و json. این موارد در هاست‌های معمول فعال هستند.
دیتابیس
MySQL یا MariaDB. نام دیتابیس، نام کاربری و گذرواژه‌ی آن را داشته باشید.
دسترسی نوشتن
پوشه‌ی پروژه باید برای PHP قابل نوشتن باشد (ویزارد فایل‌های تنظیمات می‌سازد).
نصب محلی (آزمایشی)
مجموعه‌هایی مثل XAMPP یا Laragon هر سه مورد بالا را یک‌جا فراهم می‌کنند.
۲. مراحل نصب
ساخت دیتابیس (فقط روی هاست)
از پنل هاست (cPanel، DirectAdmin یا Plesk) یک دیتابیس MySQL و یک کاربر برای آن بسازید و کاربر را به دیتابیس متصل کنید.
روی نصب محلی، ویزارد خودش دیتابیس را می‌سازد.
آپلود پروژه
پوشه‌ی forosh-api را در مسیر وب‌سایت (مثلاً public_html) آپلود کنید.
باز کردن صفحه‌ی نصب
در مرورگر آدرس https://دامنه‌ی-شما/forosh-api/setup.php را باز کنید.
در اولین بار به صفحه‌ی ورود هدایت می‌شوید.
ورود با حساب مدیر اولیه
نام کاربری و گذرواژه‌ی اولیه هر دو administrator است.
تعیین گذرواژه‌ی جدید
سیستم بلافاصله تغییر گذرواژه را اجباری می‌کند. یک گذرواژه‌ی قوی و منحصربه‌فرد انتخاب و آن را نگهداری کنید.
وارد کردن مشخصات دیتابیس
فرم زیر را پر کنید و «نصب» را بزنید:
فیلد
مقدار
میزبان (Host)
معمولاً localhost
پورت
معمولاً 3306
نام دیتابیس
همان که در پنل هاست ساخته‌اید
نام کاربری / گذرواژه
کاربر دیتابیس
پیشوند جدول‌ها
پیش‌فرض db_ (تغییر لازم نیست)
ویزارد اتصال را آزمایش می‌کند، فایل تنظیمات را می‌نویسد و جدول‌ها را خودکار می‌سازد.
پایان نصب
پس از موفقیت به صفحه‌ی وضعیت API هدایت می‌شوید. از این لحظه صفحه‌ی نصب قفل می‌شود و دیگر قابل استفاده نیست.
✅ نشانه‌ی نصب موفق
صفحه‌ی وضعیت (forosh-api/index.php) اتصال دیتابیس را نشان می‌دهد و فهرست مسیرهای در دسترس را می‌بینید.
۳. تعیین نوع احراز هویت (ضروری برای اینترنت)
از صفحه‌ی وضعیت، گزینه‌ی «تغییر وضعیت احراز هویت» را باز کنید:
حالت
کاربرد
بدون احراز هویت
فقط برای تست محلی. هر کسی که آدرس را بداند می‌تواند وصل شود.
توکن (API Key) — توصیه‌شده
هر سیستم با یک کلید اختصاصی وصل می‌شود.
اگر «توکن» را انتخاب کردید، از بخش «مدیریت توکن‌ها (API Keys)» یک کلید بسازید (برچسب و مدت اعتبار را مشخص کنید).
متن کامل کلید فقط یک‌بار و همان لحظه‌ی ساخت نمایش داده می‌شود؛ آن را در جای امن ذخیره کنید.
برای هر سیستم کلید جداگانه بسازید تا در صورت نیاز فقط همان را باطل کنید.
۴. اتصال نرمافزار به سرور
نرمافزار را باز کنید و در پنجره‌ی انتخاب محل ذخیره‌سازی، گزینه‌ی «سرور (Online)» را بزنید.
آدرس API را وارد کنید. این آدرس به /api ختم می‌شود، مثلاً:
https://example.com/forosh-api/api
اگر حالت «توکن» فعال است، نوع احراز هویت را «توکن» بگذارید و کلید را وارد کنید.
روی «اتصال و ادامه» بزنید. در صورت موفقیت، پیام اتصال و تعداد جدول‌ها نمایش داده می‌شود.
همین مراحل را روی هر سیستم دیگری که باید به همین سرور وصل شود تکرار کنید.
۵. نکات امنیتی
روی اینترنت حتماً از HTTPS استفاده کنید و حالت «بدون احراز هویت» را غیرفعال بگذارید.
برای دیتابیس یک کاربر مخصوص با دسترسی فقط به همین دیتابیس بسازید؛ از کاربر root استفاده نکنید.
فایل‌های تنظیمات (config-install.php، administratorpassword.php) را در هیچ بسته یا ایمیلی منتشر نکنید؛ حاوی اطلاعات حساس‌اند.
از دیتابیس به‌طور منظم پشتیبان بگیرید (از پنل هاست یا phpMyAdmin).
صفحه‌ی forosh-api/reset فقط روی خودِ کامپیوتر سرور (localhost) کار می‌کند. روی هاست برای نصب مجدد باید فایل‌های نصب را از پنل هاست حذف کنید (به پشتیبانی مراجعه کنید).
۶. عیب‌یابی
مشکل
راه‌حل
«دیتابیس وجود ندارد و نمی‌توان آن را ساخت»
دیتابیس را از پنل هاست بسازید و کاربر را به آن متصل کنید؛ سپس ویزارد را دوباره اجرا کنید.
«خطا در اتصال» هنگام نصب
نام دیتابیس، کاربر، گذرواژه و میزبان را بازبینی کنید. روی بعضی هاست‌ها نام دیتابیس و کاربر با پیشوند حساب (مثلاً user_forosh) است.
«نمی‌توان config-install.php را نوشت»
دسترسی نوشتن پوشه‌ی پروژه را برای PHP فعال کنید.
صفحه‌ی نصب مستقیم به صفحه‌ی وضعیت می‌رود
نصب قبلاً کامل شده است؛ نیازی به نصب دوباره نیست.
خطای ۵۰۰ بعد از آپلود
نسخه‌ی PHP هاست را بررسی کنید و فایل forosh-api/api/error.log را ببینید.
نرمافزار پیام «۴۰۱» یا «Token required» می‌دهد
کلید API را درست وارد نکرده‌اید، منقضی شده یا باطل شده است؛ کلید جدید بسازید.
نرمافزار به سرور وصل نمی‌شود
آدرس را در مرورگر امتحان کنید: …/api/schema.php?db=foroshDatabase باید یک پاسخ JSON نشان دهد. آدرس باید با /api تمام شود.
❓ چگونه می توانم هر سه مدل دیتابیس را در یک سیستم چک و بررسی کنم؟▼
⚠️ فقط برای مدیران نرمافزار
این روش صرفاً برای مدیران نرمافزار و فقط قبل از خرید یا برای بررسی فیچرهای نرمافزار (چگونگی ارتباط با دیتابیس محلی، LAN و WEB) کاربرد دارد.
به هیچ وجه امکان استفاده از هر سه مدل دیتابیس به‌صورت همزمان در حالت واقعی وجود ندارد.
🎯 روش کار (سه بار کپی فایل اجرایی)
برای اینکه بتوانید هر سه حالت را روی یک سیستم ببینید، فایل forosh.exe را سه بار در دسکتاپ کپی کنید و نام‌های زیر را بگذارید:
کپی اول ← به نام LOCAL.exe
کپی دوم ← به نام LAN.exe
کپی سوم ← به نام WEB.exe
سپس هر یک را جداگانه اجرا کنید و مراحل نصب و انتخاب محل دیتابیس را به‌صورت مجزا برای هر کدام پیگیری کنید.
ℹ️نکته مهم: چون نام فایل اجرایی در محاسبه‌ی کد فعالسازی و شناسه‌ی سیستم نقش دارد، هر یک از سه فایل، محیط مستقل خودش را خواهد داشت.
این کار فقط برای مشاهده و آزمایش است؛ در استفاده‌ی واقعی، از هر سه حالت به‌طور همزمان روی یک سیستم نمی‌توان استفاده کرد.
