82 lines
2.6 KiB
Markdown
82 lines
2.6 KiB
Markdown
|
# 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 منتشر شده است.
|