hesabixBox/README.md

HesabixBox - Windows Service

توضیحات پروژه

حسابیکس باکس یک سرویس تحت ویندوز است که برای مدیریت چاپ فاکتورها و ارتباط با API حسابیکس طراحی شده است.

مشخصات فنی

• Framework: .NET Framework 4.5.2
• زبان: Visual Basic .NET
• IDE: Visual Studio 2015+
• نوع پروژه: Windows Forms Application

ویژگی‌ها

• مدیریت چاپگرها
• ارتباط با API حسابیکس
• چاپ خودکار فاکتورها
• رابط کاربری فارسی
• پشتیبانی از چندین نوع فاکتور

پیش‌نیازها

• Visual Studio 2015 یا بالاتر
• .NET Framework 4.5.2
• Adobe Acrobat Reader (برای چاپ PDF)

نحوه نصب و راه‌اندازی

1. نصب Visual Studio

• Visual Studio 2015 یا بالاتر را نصب کنید
• اطمینان حاصل کنید که .NET Framework 4.5.2 نصب است

2. باز کردن پروژه

• فایل HesabixBox.sln را در Visual Studio باز کنید
• NuGet packages را restore کنید:

  Tools > NuGet Package Manager > Package Manager Console
  Update-Package -reinstall
  

3. Build پروژه

• Build > Clean Solution
• Build > Rebuild Solution

تنظیمات اولیه

1. تنظیم چاپگرها

• در منوی اصلی روی "چاپگرها" کلیک کنید
• چاپگرهای مورد نظر را انتخاب کنید
• مسیر Adobe Acrobat Reader را مشخص کنید

2. تنظیم API

• توکن API خود را از حسابیکس دریافت کنید
• در فرم لاگین توکن را وارد کنید

ساختار پروژه

فایل‌های اصلی

• Form1.vb - فرم اصلی برنامه
• ApiInterface.vb - کلاس ارتباط با API
• FrmLogin.vb - فرم ورود
• FrmPrinters.vb - تنظیمات چاپگر
• clsMsg.vb - کلاس پیام‌ها

تنظیمات

• App.config - تنظیمات برنامه
• packages.config - NuGet packages
• My Project/Settings.settings - تنظیمات کاربر

عیب‌یابی

مشکلات رایج

1. خطای Build: اطمینان حاصل کنید که .NET Framework 4.5.2 نصب است
2. خطای NuGet: packages را دوباره restore کنید
3. خطای چاپ: مسیر Adobe Acrobat را بررسی کنید

لاگ‌ها

• لاگ‌های برنامه در %AppData%\HesabixBox\ ذخیره می‌شوند

پشتیبانی

• وب‌سایت: https://hesabix.ir
• ایمیل: support@hesabix.ir

مجوز

این پروژه تحت مجوز GNU GPL V3 منتشر شده است.