| .idea | ||
| hesabixArchive | ||
| hesabixBackup | ||
| hesabixCore | ||
| public_html | ||
| webUI | ||
| .gitignore | ||
| .project | ||
| CODE_OF_CONDUCT.md | ||
| LICENSE | ||
| README.md | ||
حسابیکس
حسابیکس اولین نرم‌افزار حسابداری متن‌باز به زبان فارسی با رابط کاربری تحت وب است. برای مشاهده نسخه نمایشی پروژه به وب‌سایت https://hesabix.ir مراجعه کنید.
پیش‌نیازهای نصب
برای نصب هسته حسابیکس به ابزارهای زیر نیاز دارید:
- وب سرور: Apache، NginX و...
- پایگاه داده: Mysql، mariaDB، PostgreSql و...
- PHP: نسخه 8.1 به بالا
- افزونه‌های PHP: php-Intl، php-mbstring، php-http، php-raphf، php-zip، php-gd
- composer
نصب
- پروژه را در پوشه وب سرور کپی یا کلون کنید. اگر از کنترل پنل‌های اشتراکی مانند cpanel یا directadmin استفاده می‌کنید، فایل‌ها را در پوشه اصلی کپی کنید و پوشه public_html بازنویسی خواهد شد.
- در سیستم مدیریت پایگاه داده خود یک پایگاه داده ایجاد کنید و فایل .env را در پوشه اصلی پروژه ویرایش کنید.
- وابستگی‌ها را با اجرای این دستور نصب کنید:
composer install
- فایل .env را ویرایش کرده و رشته اتصال پایگاه داده را با نام کاربری، رمز عبور و نام پایگاه داده خود تنظیم کنید.
- فایل محیط محلی را با اجرای این دستور ایجاد کنید:
composer dump-env prod
composer dump-env dev // فقط برای محیط توسعه
- وارد سیستم مدیریت پایگاه داده خود مانند phpmyadmin شوید و فایل موجود در hesabixBackup/databaseFiles/hesabix-db-default.sql را وارد کنید.
- در خط فرمان به پوشه hesabixCore بروید و پایگاه داده را با این دستور به‌روز کنید:
php bin/console doctrine:schema:update --force --complete
آدرس دامنه اصلی را در مرورگر باز کنید، باید صفحه اصلی API حسابیکس را مشاهده کنید.
اتصال به سرویس ایمیل
برای اتصال حسابیکس به سرویس ایمیل خود، فایل .env.local.php را در پوشه hesabixCore ویرایش کنید و رشته اتصال سرور ایمیل خود را در پارامتر MAILER_DSN تنظیم کنید. برای اطلاعات بیشتر درباره رشته‌های اتصال به مستندات symfony mailer مراجعه کنید. اینجا کلیک کنید
پس از تنظیم رشته اتصال، فایل mailer.yaml را در پوشه configs ویرایش کرده و هدر برای ارسال ایمیل‌ها را تنظیم کنید.
به‌روزرسانی نرم‌افزار
برای به‌روزرسانی نرم‌افزار با آخرین تغییرات منتشر شده در پوشه hesabixCore، این دستور را اجرا کنید:
php bin/console hesabix:update
فرآیند ساخت رابط کاربری
راه‌اندازی پروژه
npm install
کامپایل و بارگذاری خودکار برای توسعه
npm run dev
npm run dev -- --host // برای استفاده در شبکه‌های خارجی
پس از اجرای این دستور می‌توانید با آدرس http://localhost:5173 در مرورگر خود دسترسی داشته باشید.
پیکربندی آدرس API در حالت توسعه
به صورت پیش‌فرض، آدرس API در مسیر اصلی (/) و رابط کاربری وب در زیرپوشه /u/ قرار دارد.
مثال:
- آدرس API: https://myaddress.com
- آدرس رابط کاربری وب: https://myaddress.com/u/
اگر شما یک توسعه‌دهنده هستید و می‌خواهید با دستورات npm run dev یا npm run dev --host کار کنید، باید متغیری با نام dev_api_url تعریف کنید که آدرس API خارجی را مشخص می‌کند، مثلاً:
return 'https://next.hesabix.ir';
بررسی نوع، کامپایل و فشرده‌سازی برای تولید
npm run build-only
تمام فایل‌های خروجی در پوشه public_html/u تولید خواهند شد که قابل اجرا روی وب سرور خواهند بود
مشارکت‌کنندگان
حمایت مالی
برای حمایت مالی از توسعه‌دهندگان لطفاً از این لینک استفاده کنید: https://zarinp.al/hesabix.ir