امیر: نرم افزار آزاد حسابداری لاراول

English Version

توجه مهم: امیر در حال حاضر در مرحله توسعه فعال است و هنوز برای استفاده در محیط عملیاتی آماده نیست. ما به زودی تاریخ انتشار رسمی را اعلام خواهیم کرد. با ما همراه باشید!

معرفی:

امیر یک نرم افزار حسابداری رایگان و آزاد است که با لاراول نوشته شده و به طور خاص برای کسب و کارها و افراد ایرانی طراحی شده است. این نرم افزار با هدف ارائه یک راهکار جامع و کاربرپسند برای مدیریت امور مالی، با ویژگی هایی که مطابق با نیازهای خاص کاربران ایرانی است، از جمله پشتیبانی از قوانین مالیاتی ایران، ساخته شده است.

ویژگی ها:

• رابط کاربری بصری: استفاده آسان برای کسب و کارها با هر اندازه و دانش فنی.
• چند زبانه: در حال حاضر از فارسی پشتیبانی می‌کند (با قابلیت اضافه شدن زبان‌های دیگر در آینده).
• کارکردهای حسابداری:
  • مدیریت درآمد و هزینه
  • پیگیری فاکتورها و رسیدها
  • تهیه گزارشات مالی
  • پشتیبانی از قوانین مالیاتی ایران
  • (سامانه مودیان - در حال توسعه)
• آزاد (متن باز): استفاده، اصلاح و مشارکت در آن رایگان است.

نصب:

به عنوان جایگزین، می‌توانید از Laravel Sail برای نصب استفاده کنید. اگر Sail را انتخاب می‌کنید:

• پس از مرحله ۳ (نصب وابستگی‌های Composer)، دستور نصب Composer را دوباره در داخل Sail اجرا کنید (sail composer install).
• برای مراحل بعدی (۵-۷، ۱۰)، پیشوند sail را به دستورات php artisan اضافه کنید (مثلاً sail artisan key:generate).
• به همین ترتیب، پیشوند sail را به دستورات npm (۸-۹) اضافه کنید (مثلاً sail npm install).
• برای جزئیات بیشتر به مستندات رسمی Sail مراجعه کنید.

1. پیش نیازها:
   • PHP >= 8.2
   • Composer
   • MySQL database
   • Node.js >= 18.0.0
2. دریافت فایل ها (کلون کردن مخزن):

git clone https://github.com/Jooyeshgar/FreeAmir.git
cd FreeAmir

3. نصب وابستگی ها:

composer install

4. فایل .env.example را به .env کپی کرده و اطلاعات مربوط به پایگاه داده را تنظیم کنید.

5. ساخت کلید برنامه:

php artisan key:generate

6. اجرای مایگریشن‌های پایگاه داده:

php artisan migrate

7. پر کردن پایگاه داده با داده‌های نمونه:

php artisan db:seed

اختیاری: پر کردن داده‌های نمایشی

php artisan db:seed --class DemoSeeder

8. نصب بسته‌های npm:

npm install

9. اجرای سرور توسعه Vite:

npm run dev

10. اجرای سرور توسعه:

php artisan serve

مهاجرت پایگاه داده:

اگر در حال مهاجرت از نسخه قدیمی‌تر امیر (مبتنی بر SQLite) هستید، لطفاً برای دستورالعمل‌های دقیق به راهنمای مهاجرت پایگاه داده مراجعه کنید.

استفاده:

1. با مرورگر وب خود به برنامه در http://localhost:8000 (یا پورتی که در فایل .env شما مشخص شده است) دسترسی پیدا کنید.
2. با نام کاربری پیش فرض وارد شوید (ایمیل: admin@example.com، رمز عبور: password).
3. ویژگی ها و کارکردهای برنامه را بررسی کنید.

دستورات آرتيزان سفارشی:

این پروژه شامل چندین دستور آرتيزان سفارشی برای تسهیل کارهای رایج است.

مدیریت سال مالی: برای جزئیات بیشتر به FiscalYearExportImport.md مراجعه کنید. * fiscal-year:export: داده‌های یک سال مالی مشخص را به یک فایل JSON صادر می‌کند. * fiscal-year:import: داده‌های سال مالی را از یک فایل JSON به یک سال مالی جدید وارد می‌کند.

مشارکت:

ما از مشارکت در پروژه امیر استقبال می کنیم! لطفاً برای دستورالعمل های مربوط به ارسال گزارش باگ، درخواست ویژگی و درخواست های pull به فایل CONTRIBUTING.md مراجعه کنید.

لایسنس:

این پروژه تحت لایسنس GPL-3 منتشر شده است. برای جزئیات به فایل LICENSE مراجعه کنید.

پشتیبانی:

برای هر گونه سوال یا مشکلی، لطفاً در مخزن گیت هاب یک issue ایجاد کنید.