این راهنما برای کسی است که روی کامپیوتر کافه نصب انجام می‌دهد: خود مدیر کافه یا تکنسین. برنامه ویندوز «برنامه اصلی» کامپیوتر کافه است: همه پنل کافه را دارد و فروش‌های صندوق را خودکار می‌خواند. هر فروش چند ثانیه بعد، طبق رسپی، از موجودی همان شعبه کم می‌شود، بدون تغییر در نرم‌افزار صندوق.
این بخش را از اول تا آخر دنبال کن. حدود ۳۰ دقیقه طول می‌کشد. بقیه این راهنما (بخش ۱ به بعد) فقط وقتی لازم است که جایی گیر کنی.
DepoSmart.exe را در پوشه C:\DepoSmart بگذار و رویش دو بار کلیک کن.BIXOLON SRP-E300). اگر مطمئن نیستی: در ویندوز Settings ← Bluetooth & devices ← Printers را باز کن؛ چاپگر فیش همان است که اسم مدلش روی خود دستگاه هم نوشته شده.اگر برنامه صندوق پایگاه داده یا خروجی اکسل دارد و ترجیح می‌دهی از آن بخوانی، بخش ۷ همین راهنما را ببین.
دو حالت دارد و هر دو حلّ شده است:
| چه شد؟ | چه کار کنم؟ |
|---|---|
| پیغام آبی «Windows protected your PC» | More info ← Run anyway |
| ویندوز اجازه مدیر خواست | Yes را بزن. فقط همین یک بار لازم است (برای ساختن واسط چاپگر). |
| فیش آزمایشی چاپ نشد | چاپگر روشن و کابلش وصل باشد و کاغذ داشته باشد. بعد دوباره «آزمایش و پیش‌نمایش». |
| فیش چاپ شد ولی چیزی خوانده نشد | اسم آیتم‌های منو در پنل باید مثل روی فیش باشد و قیمتشان وارد شده باشد. بعد دوباره آزمایش کن. |
| می‌خواهم چاپگر را به حالت اول برگردانم | تنظیمات صندوق ← مرحله ۲ ← «برگرداندن چاپگر به حالت قبل». |
| بعد از «بررسی کلید» تیک سبز نیامد | اینترنت کامپیوتر را چک کن. اگر وصل است، در پنل یک «سیستم» جدید بساز و دوباره «راه‌اندازی روی همین کامپیوتر» را بزن. |
| «فهرست پایگاه‌ها» چیزی نشان نداد | صندوق احتمالاً SQL Server ندارد یا رمز می‌خواهد. راه «فایل اکسل» را برو یا از تکنسین/شرکت صندوق کمک بگیر. |
| اسم آیتم‌ها در پیش‌نمایش به‌هم‌ریخته است | در همان صفحه، «رمزگذاری متن» را روی windows-1256 بگذار. |
| فروش رفت ولی موجودی کم نشد | در پنل «اتصال صندوق»، بخش «منتظر تطبیق» را ببین و آیتم را به منو وصل کن؛ یا برای آن آیتم رسپی بگذار. |
| پایین برنامه نوشته «اینترنت در دسترس نیست» | کاری لازم نیست؛ فروش‌ها گم نمی‌شوند و وقتی اینترنت برگشت خودشان فرستاده می‌شوند. |
برای هر مشکل دیگر: آیکون دپوسمارت کنار ساعت ← راست‌کلیک ← «گزارش‌ها (لاگ)» و فایل امروز را برای پشتیبانی بفرست.
| کجا | چه کاری |
|---|---|
| برنامه ویندوز (کامپیوتر کافه) | همه پنل کافه (موجودی، خرید، سفارش، منو و رسپی، تیم، گزارش‌ها، روزهای شلوغ) به‌اضافه خواندن فروش صندوق. کنار ساعت ویندوز می‌ماند و هر ۲۰ ثانیه فروش جدید را می‌فرستد. |
| گوشی (اپ موبایل) | همه پنل کافه برای مالک و مدیران، به‌جز راه‌اندازی اتصال صندوق. |
| مرورگر کامپیوتر | فقط سایت، نسخه نمایشی و دانلود برنامه. حساب کافه در مرورگر کامپیوتر به صفحه دانلود برنامه ویندوز می‌رود. |
این‌ها را آماده کن؛ بدون آن‌ها فروش‌ها می‌رسند ولی موجودی درست کم نمی‌شود. همه این کارها از گوشی هم انجام می‌شود:
قانون ساده: برنامه را روی هر کامپیوتری که به داده فروش صندوق دسترسی دارد نصب کن، و برای هر کدام یک «سیستم» (کلید) در پنل بساز. هر کلید به یک شعبه وصل است، پس فروش همیشه از انبار همان شعبه کم می‌شود.
یک نصب روی کامپیوتر صندوق، یک کلید.
رایج‌ترین حالت: همه صندوق‌ها روی پایگاه داده یک کامپیوتر اصلی ثبت می‌کنند. فقط روی همان کامپیوتر اصلی اتصال را راه بینداز. روی بقیه کامپیوترها هم می‌توانی برنامه را برای دیدن پنل نصب کنی، بدون راه‌اندازی صندوق.
روی هر صندوق نصب کن و برای هر کدام کلید جدا بساز، همه با شعبه یکسان.
در هر شعبه نصب کن و موقع ساخت کلید، شعبه درست را انتخاب کن.
DepoSmart.exe را در یک پوشه ثابت بگذار، مثلاً C:\DepoSmart، و با راست‌کلیک ← Send to ← Desktop (create shortcut) یک میان‌بر روی دسکتاپ بساز.پیوندهای بیرونی (درگاه پرداخت، راهنما، پشتیبانی) در مرورگر معمولی کامپیوتر باز می‌شوند.
فیشی که برای مشتری چاپ می‌شود، همان چیزی است که مشتری سفارش داده. دپوسمارت خودش را بین برنامه صندوق و چاپگر می‌گذارد:
BIXOLON SRP-E300) به درگاه دپوسمارت (127.0.0.1:9100) منتقل می‌شود و یک کپی از همان چاپگر با همان درایور، به اسم DepoSmart Out - …، روی درگاه واقعی (USB001) می‌نشیند.در مرحله ۲ مشخص می‌کنی صندوق فروش‌ها را کجا نگه می‌دارد. این کار برای هر برند نرم‌افزار صندوق فقط یک بار سخت است؛ بعد از آن، برای کافه‌های دیگری که همان صندوق را دارند، همان کوئری را استفاده می‌کنی.
localhost\SQLEXPRESS).:after در آن باشد. نمونه آماده در کادر هست؛ نام جدول‌ها و ستون‌ها را با صندوق خودت عوض کن.| ستون | معنی | لازم؟ |
|---|---|---|
id | شماره ردیف اقلام فاکتور؛ عددی که با هر فروش بزرگ‌تر می‌شود | بله |
name | نام آیتم (همان که روی فیش چاپ می‌شود) | بله |
qty | تعداد؛ منفی یعنی مرجوعی | بله |
receipt_id | شماره فاکتور | بهتر است |
code | کد کالا (اگر باشد، تطبیق با کد انجام می‌شود) | بهتر است |
sold_at | زمان فروش (تاریخ شمسی هم پشتیبانی می‌شود) | بهتر است |
voided | ۱ یعنی ابطال شده، ۰ یعنی معتبر | بهتر است |
SELECT d.ID AS id, d.FactorID AS receipt_id, d.KalaCode AS code, k.Name AS name,
d.Count AS qty, f.Date AS sold_at, f.IsCanceled AS voided
FROM FactorDetail d
JOIN Factor f ON f.ID = d.FactorID
JOIN Kala k ON k.Code = d.KalaCode
WHERE d.ID > :after
ORDER BY d.IDساخت کاربر فقط‌خواندنی (در SQL Server Management Studio، روی پایگاه داده صندوق، New Query؛ PosDb را با نام پایگاه داده و STRONG-PASSWORD-HERE را با یک رمز قوی عوض کن):
CREATE LOGIN deposmart_reader WITH PASSWORD = 'STRONG-PASSWORD-HERE'; USE PosDb; CREATE USER deposmart_reader FOR LOGIN deposmart_reader; ALTER ROLE db_datareader ADD MEMBER deposmart_reader;
بعضی صندوق‌های ساده‌تر فروش را در فایلی با پسوند .db، .sqlite یا .sqlite3 نگه می‌دارند (معمولاً در پوشه نصب صندوق یا C:\ProgramData). «فایل SQLite» را انتخاب کن، با «انتخاب…» فایل را پیدا کن؛ بقیه مثل SQL Server است («جدول‌ها و تعداد ردیف»، کوئری، آزمایش).
اگر به پایگاه داده دسترسی نیست ولی صندوق می‌تواند گزارش فروش را خروجی بگیرد (یا خودکار در یک پوشه ذخیره کند):
C:\POS\exports.نام کالا، تعداد: تعداد). اگر ستون «ردیف» یکتا دارد، حتماً برای شماره ردیف (id) بگذار.auto بگذار: UTF-8، Unicode و رمزگذاری قدیمی فارسی ویندوز (Windows-1256) خودکار تشخیص داده می‌شوند.۱۴۰۵/۰۷/۳۰ ۱۴:۲۰) و مرجوعی با منفی پشت عدد (2-) درست خوانده می‌شوند.sent منتقل می‌شود.«ذخیره و شروع» را بزن. نوار وضعیت پایین پنجره باید «صندوق …: وصل است» شود.
برای تکنسین: همین آزمایش از خط فرمان هم انجام می‌شود (در پوشه برنامه):
.\DepoSmart.exe --pos-check
OK — connected as "صندوق ۱" · کافه نمونه · شعبه ونک (source mssql-2cac54d06f402898)
.\DepoSmart.exe --pos-once
| در خروجی | یعنی |
|---|---|
applied | تطبیق داده شد و از موجودی کم شد |
waiting for match | آیتم در منو پیدا نشد؛ منتظر تطبیق (بخش ۱۲) |
voided | ابطال‌هایی که موجودی را برگرداندند |
already sent | قبلاً رسیده بود؛ دوباره حساب نشد (عادی است) |
| نوار وضعیت می‌گوید | یعنی | کار لازم |
|---|---|---|
| وصل است / … فروش جدید فرستاده شد | همه‌چیز درست است | — |
| اینترنت یا سرور در دسترس نیست | اینترنت قطع است | هیچ؛ فروش‌ها در صندوق می‌مانند و بعداً خودکار فرستاده می‌شوند |
| اشتراک تمام شده | اشتراک کافه منقضی شده | تمدید کن؛ فروش‌های صف‌شده خودکار فرستاده می‌شوند |
| حساب کافه معلق است | حساب از طرف پشتیبانی معلق شده | با پشتیبانی تماس بگیر؛ فروش‌ها در صندوق می‌مانند و بعد از رفع تعلیق خودکار فرستاده می‌شوند |
| این شعبه فعلاً فعال نیست | شعبه هنوز تأیید نشده یا از طرف پشتیبانی غیرفعال شده | صبر کن تا تأیید شود یا با پشتیبانی تماس بگیر؛ فروش‌ها گم نمی‌شوند |
| کلید اتصال رد شد | کلید لغو یا اشتباه است | در پنل کلید جدید بساز و از «تنظیمات صندوق» وارد کن |
| خواندن صندوق ناموفق: … | پایگاه داده صندوق در دسترس نیست (صندوق خاموش، رمز عوض شده، …) | پیغام را بخوان؛ معمولاً با روشن شدن صندوق خودش درست می‌شود |
| هنوز راه‌اندازی نشده | این کامپیوتر صندوق ندارد یا وصل نشده | اگر صندوق اینجاست، بخش ۶ |
آیکون دپوسمارت کنار ساعت ویندوز (اگر نیست، روی فلش ^ کنار ساعت بزن). با راست‌کلیک:
اگر برنامه را دوباره از میان‌بر اجرا کنی، همان پنجره قبلی جلو می‌آید؛ دو نسخه هم‌زمان اجرا نمی‌شود.
:after).| اتفاق | رفتار سیستم |
|---|---|
| اینترنت قطع شد | فروش‌ها در خود صندوق می‌مانند و بعد از وصل شدن فرستاده می‌شوند. |
| کامپیوتر خاموش شد | بعد از روشن شدن، از همان جایی که مانده بود ادامه می‌دهد. |
| فروش ابطال شد (حتی بعد از ارسال) | موجودی برمی‌گردد؛ ۲۰۰۰ ردیف آخر مدام برای ابطال دیرهنگام چک می‌شوند. |
| مرجوعی (تعداد منفی) | موجودی برمی‌گردد. |
| یک خط دو بار فرستاده شد | فقط یک بار حساب می‌شود. |
| آیتم در منو نیست | «منتظر تطبیق» می‌ماند؛ بعد از تطبیق، فروش‌های قبلی‌اش هم اعمال می‌شوند. |
| تاریخ در صندوق شمسی یا بدون منطقه زمانی است | به وقت همین کامپیوتر (تهران) خوانده می‌شود؛ فروش ساعت ۲۳:۵۰ در همان روز ثبت می‌شود. |
| موجودی به صفر رسید | منفی نمی‌شود؛ اپ هشدار کمبود و پیشنهاد خرید می‌دهد. |
اپ گوشی (از سایت، «افزودن به صفحه اصلی» در آیفون و اندروید، یا اپ اندروید) همه پنل کافه را دارد: موجودی هر شعبه، پیشنهاد خرید، سفارش‌ها، روزهای شلوغ، منو و رسپی، تیم، گزارش فعالیت، اعلان‌ها. نتیجه کسر خودکار از فروش هم همان لحظه در گوشی دیده می‌شود.
فقط راه‌اندازی و تنظیم اتصال صندوق (ساخت کلید، تطبیق آیتم‌ها) در گوشی نیست و آنجا پیغام «این بخش در برنامه ویندوز است» دیده می‌شود، چون خواندن صندوق روی کامپیوتر کافه انجام می‌شود.
| پیام یا مشکل | علت | راه حل |
|---|---|---|
| Windows protected your PC | برنامه تازه منتشر شده است | More info ← Run anyway |
| Microsoft Edge WebView2 لازم است | جزء نمایش پنل نصب نیست | «بله» را بزن، نصب کن، برنامه را دوباره باز کن |
| سرور دپوسمارت در دسترس نیست (در پنجره) | اینترنت کامپیوتر | اینترنت را درست کن و «تلاش دوباره»؛ فروش‌ها گم نمی‌شوند |
| در مرورگر کامپیوتر به صفحه دانلود می‌روم | پنل کافه روی کامپیوتر فقط در برنامه ویندوز است | برنامه را دانلود و اجرا کن |
| منوی «اتصال صندوق» را نمی‌بینم | روی گوشی هستی، یا با حساب مدیر شعبه وارد شده‌ای | در برنامه ویندوز با حساب مالک وارد شو |
| این کلید معتبر نیست یا لغو شده | کلید اشتباه، ناقص یا لغو شده | کلید جدید بساز |
| ورود به SQL Server ناموفق بود | نام کاربری یا رمز SQL اشتباه است | رمز کاربر فقط‌خواندنی را بررسی کن یا «ورود ویندوز» را امتحان کن |
| به SQL Server وصل نشد | نام سرور اشتباه یا سرویس خاموش است | در services.msc سرویس SQL Server (…) روشن باشد؛ نام سرور را از فهرست انتخاب کن |
| پایگاه داده پیدا نشد یا این کاربر به آن دسترسی ندارد | نام پایگاه داده یا دسترسی کاربر | «فهرست پایگاه‌ها» را بزن؛ به کاربر نقش db_datareader بده |
| جدول/ستون در کوئری پیدا نشد | نام جدول یا ستون اشتباه است | «جدول‌ها و تعداد ردیف» را ببین و کوئری را اصلاح کن |
| کوئری اجرا شد ولی این ستون‌ها را ندارد: … | نام ستون‌ها مطابق جدول بخش ۷ نیست | با AS id، AS name، AS qty نام‌گذاری کن |
| نام‌ها در پیش‌نمایش به‌هم‌ریخته‌اند | رمزگذاری فایل خروجی | «رمزگذاری متن» را windows-1256 بگذار |
| همه آیتم‌ها «منتظر تطبیق»اند | نام‌ها در صندوق و منو فرق دارند | یک بار تطبیق بده (بخش ۱۲) |
| فروش می‌رسد ولی موجودی کم نمی‌شود | آیتم منو رسپی ندارد | در منوی هوشمند رسپی ثبت کن |
| شعبه در فهرست «افزودن سیستم» نیست | شعبه هنوز تأیید نشده یا غیرفعال است | در تنظیمات ← شعبه‌ها وضعیتش را ببین؛ بعد از تأیید پشتیبانی در فهرست می‌آید |
| نمی‌توانم شعبه دوم بسازم | در دوره آزمایشی فقط یک شعبه مجاز است | اشتراک را با تعداد شعبه‌هایت بخر (اشتراک ← تعداد شعبه‌ها) |
| موجودی شعبه اشتباهی کم می‌شود | کلید برای شعبه دیگری ساخته شده | در مرحله ۱ «بررسی کلید» شعبه را نشان می‌دهد؛ کلید درست بساز |
| بعد از روشن کردن کامپیوتر فروش‌ها نمی‌روند | «با روشن شدن ویندوز اجرا شود» خاموش است | «تنظیمات صندوق» ← مرحله ۳ ← تیک آن را بزن |
برای جزئیات بیشتر: آیکون کنار ساعت ← گزارش‌ها (لاگ). پوشه برنامه: %LOCALAPPDATA%\DepoSmart.