init project

README.md

@@ -0,0 +1,98 @@
+# نرم‌افزار حسابداری هلو-مانند
+
+یک نرم‌افزار حسابداری کامل با ویژگی‌های مشابه هلو، با رابط کاربری فارسی و طراحی مدرن.
+
+## ویژگی‌های اصلی
+
+### مدیریت پایه
+- **تعریف شخص**: مدیریت مشتریان و تامین‌کنندگان
+- **تعریف کالا**: مدیریت کالاها و محصولات با کد و قیمت
+- **خرید**: ثبت و مدیریت خریدها با وضعیت‌های مختلف
+- **فروش**: ثبت و مدیریت فروش‌ها با محاسبه درآمد
+- **انبارداری**: مدیریت موجودی، تنظیم موجودی و هشدار کمبود
+
+### ویژگی‌های پیشرفته (مشابه هلو)
+- **نمودار حساب‌ها**: سیستم کامل حساب‌های کل و تفصیلی
+- **گزارش‌های مالی**: ترازنامه، صورت سود و زیان، تراز آزمایشی
+- **سیستم فاکتور**: ایجاد و مدیریت فاکتورها با محاسبه مالیات
+- **پشتیبانی از چندین نوع حساب**: دارایی، بدهی، حقوق صاحبان سهام، درآمد، هزینه
+
+## تکنولوژی‌های استفاده شده
+
+- React 18
+- React Router DOM
+- Tailwind CSS
+- فونت فارسی Vazir
+
+## نصب و راه‌اندازی
+
+1. نصب وابستگی‌ها:
+```bash
+npm install
+```
+
+2. اجرای پروژه:
+```bash
+npm start
+```
+
+3. باز کردن مرورگر در آدرس:
+```
+http://localhost:3000
+```
+
+## ساختار پروژه
+
+```
+src/
+├── components/
+│   ├── Dashboard.js          # داشبورد اصلی
+│   ├── PersonManagement.js   # مدیریت اشخاص
+│   ├── ProductManagement.js  # مدیریت کالاها
+│   ├── PurchaseManagement.js # مدیریت خرید
+│   ├── SalesManagement.js    # مدیریت فروش
+│   ├── InventoryManagement.js # مدیریت انبار
+│   ├── ChartOfAccounts.js    # نمودار حساب‌ها
+│   ├── FinancialReports.js   # گزارش‌های مالی
+│   └── InvoiceSystem.js      # سیستم فاکتور
+├── App.js                    # کامپوننت اصلی
+├── App.css                   # استایل‌های سفارشی
+├── index.js                  # نقطه ورود
+└── index.css                 # استایل‌های اصلی
+```
+
+## ویژگی‌های رابط کاربری
+
+- طراحی ریسپانسیو (Responsive)
+- پشتیبانی کامل از زبان فارسی
+- جهت متن راست به چپ (RTL)
+- استفاده از فونت فارسی Vazir
+- طراحی مدرن با Tailwind CSS
+
+## نحوه استفاده
+
+### بخش‌های اصلی
+1. **داشبورد**: نمای کلی از آمار و عملیات سریع
+2. **تعریف شخص**: افزودن، ویرایش و حذف مشتریان و تامین‌کنندگان
+3. **تعریف کالا**: مدیریت کالاها با قیمت، موجودی و کد
+4. **خرید**: ثبت خریدهای جدید و مدیریت وضعیت آن‌ها
+5. **فروش**: ثبت فروش‌ها و محاسبه درآمد
+6. **انبارداری**: نظارت بر موجودی و تنظیم آن
+
+### ویژگی‌های پیشرفته (مشابه هلو)
+7. **نمودار حساب‌ها**: ایجاد و مدیریت ساختار حساب‌های کل و تفصیلی
+8. **گزارش‌های مالی**: 
+   - ترازنامه با بررسی تعادل
+   - صورت سود و زیان با محاسبه سود/زیان خالص
+   - تراز آزمایشی با مانده‌های بدهکار و بستانکار
+9. **سیستم فاکتور**: 
+   - ایجاد فاکتورهای چندقلمی
+   - محاسبه خودکار مالیات
+   - مدیریت وضعیت پرداخت
+
+## نکات مهم
+
+- تمام داده‌ها در حافظه مرورگر ذخیره می‌شوند
+- برای ذخیره دائمی داده‌ها، نیاز به اتصال به پایگاه داده است
+- قیمت‌ها به ریال نمایش داده می‌شوند
+- تاریخ‌ها به تقویم شمسی نمایش داده می‌شوند