151 lines
3.8 KiB
Markdown
151 lines
3.8 KiB
Markdown
|
# سیستم حسابداری - Vue.js + Vuetify + Symfony
|
||
|
|
|
||
|
|
این پروژه یک سیستم حسابداری کامل است که از Vue.js 3، Vuetify 3 و Symfony 7 استفاده می‌کند.
|
||
|
|
|
||
|
|
## 🏗️ ساختار پروژه
|
||
|
|
|
||
|
|
```
|
||
|
|
/var/www/v2.hesabix.ir/
|
||
|
|
├── core/ # Symfony backend
|
||
|
|
├── frontend/ # Vue.js + Vuetify frontend
|
||
|
|
│ ├── src/
|
||
|
|
│ │ ├── components/ # کامپوننت‌های Vue
|
||
|
|
│ │ ├── views/ # صفحات اصلی
|
||
|
|
│ │ ├── router/ # Vue Router
|
||
|
|
│ │ ├── store/ # Vuex store
|
||
|
|
│ │ └── assets/ # فایل‌های استاتیک
|
||
|
|
│ ├── public/
|
||
|
|
│ ├── package.json
|
||
|
|
│ └── webpack.config.js
|
||
|
|
├── public_html/ # فایل‌های build شده
|
||
|
|
└── vendor/ # PHP dependencies
|
||
|
|
```
|
||
|
|
|
||
|
|
## 🚀 نصب و راه‌اندازی
|
||
|
|
|
||
|
|
### پیش‌نیازها
|
||
|
|
- PHP 8.2+
|
||
|
|
- Node.js 18+
|
||
|
|
- Composer
|
||
|
|
- npm
|
||
|
|
|
||
|
|
### Backend (Symfony)
|
||
|
|
```bash
|
||
|
|
cd core
|
||
|
|
composer install
|
||
|
|
```
|
||
|
|
|
||
|
|
### Frontend (Vue.js)
|
||
|
|
```bash
|
||
|
|
cd frontend
|
||
|
|
npm install
|
||
|
|
```
|
||
|
|
|
||
|
|
## 🔧 دستورات توسعه
|
||
|
|
|
||
|
|
### Development
|
||
|
|
```bash
|
||
|
|
cd frontend
|
||
|
|
npm run dev # Build development
|
||
|
|
npm run watch # Build + watch changes
|
||
|
|
```
|
||
|
|
|
||
|
|
### Production
|
||
|
|
```bash
|
||
|
|
cd frontend
|
||
|
|
npm run build # Build production
|
||
|
|
```
|
||
|
|
|
||
|
|
## 📱 ویژگی‌ها
|
||
|
|
|
||
|
|
### کامپوننت‌های اصلی
|
||
|
|
- **Dashboard**: نمایش خلاصه مالی
|
||
|
|
- **Accounts**: مدیریت حساب‌ها
|
||
|
|
- **Transactions**: مدیریت تراکنش‌ها
|
||
|
|
- **Reports**: گزارشات مالی
|
||
|
|
- **Settings**: تنظیمات سیستم
|
||
|
|
|
||
|
|
### تکنولوژی‌ها
|
||
|
|
- **Vue 3**: Composition API
|
||
|
|
- **Vuetify 3**: Material Design components
|
||
|
|
- **Vue Router 4**: Client-side routing
|
||
|
|
- **Vuex 4**: State management
|
||
|
|
- **Webpack Encore**: Asset compilation
|
||
|
|
|
||
|
|
## 🌐 روتینگ
|
||
|
|
|
||
|
|
### Vue Router (Frontend)
|
||
|
|
- `/` - Dashboard
|
||
|
|
- `/accounts` - مدیریت حساب‌ها
|
||
|
|
- `/transactions` - مدیریت تراکنش‌ها
|
||
|
|
- `/reports` - گزارشات
|
||
|
|
- `/settings` - تنظیمات
|
||
|
|
|
||
|
|
### Symfony Routes (Backend)
|
||
|
|
- `/api/*` - API endpoints
|
||
|
|
|
||
|
|
## 🎨 UI/UX Features
|
||
|
|
|
||
|
|
- **RTL Support**: پشتیبانی کامل از راست به چپ
|
||
|
|
- **Persian Font**: فونت Vazirmatn
|
||
|
|
- **Material Design**: کامپوننت‌های زیبا
|
||
|
|
- **Responsive**: سازگار با همه دستگاه‌ها
|
||
|
|
- **Dark/Light Theme**: تم‌های مختلف
|
||
|
|
|
||
|
|
## 📊 کامپوننت‌های Vuetify
|
||
|
|
|
||
|
|
- **Data Tables**: نمایش داده‌ها
|
||
|
|
- **Cards**: کارت‌های اطلاعاتی
|
||
|
|
- **Forms**: فرم‌های ورودی
|
||
|
|
- **Navigation**: منوهای کاربری
|
||
|
|
- **Charts**: نمودارها (آینده)
|
||
|
|
- **Dialogs**: پنجره‌های تعاملی
|
||
|
|
|
||
|
|
## 🔄 Build Process
|
||
|
|
|
||
|
|
1. **Development**: `npm run dev`
|
||
|
|
2. **Watch Mode**: `npm run watch`
|
||
|
|
3. **Production**: `npm run build`
|
||
|
|
|
||
|
|
فایل‌های build شده در `public_html/build/` قرار می‌گیرند.
|
||
|
|
|
||
|
|
## 🚀 Deployment
|
||
|
|
|
||
|
|
### Development Server
|
||
|
|
```bash
|
||
|
|
cd frontend
|
||
|
|
npm run dev-server
|
||
|
|
```
|
||
|
|
|
||
|
|
### Production Build
|
||
|
|
```bash
|
||
|
|
cd frontend
|
||
|
|
npm run build
|
||
|
|
```
|
||
|
|
|
||
|
|
## 📝 نکات مهم
|
||
|
|
|
||
|
|
- فایل‌های frontend در پوشه جداگانه قرار دارند
|
||
|
|
- Build process کاملاً مستقل است
|
||
|
|
- Symfony به عنوان API backend عمل می‌کند
|
||
|
|
- Vue Router برای client-side routing استفاده می‌شود
|
||
|
|
- فونت فارسی Vazirmatn برای RTL استفاده شده
|
||
|
|
|
||
|
|
## 🐛 عیب‌یابی
|
||
|
|
|
||
|
|
### مشکلات رایج
|
||
|
|
1. **Node modules**: `rm -rf node_modules && npm install`
|
||
|
|
2. **Build errors**: بررسی webpack.config.js
|
||
|
|
3. **Routing issues**: بررسی .htaccess
|
||
|
|
|
||
|
|
### Logs
|
||
|
|
- Symfony: `core/var/log/`
|
||
|
|
- Webpack: `frontend/` console
|
||
|
|
|
||
|
|
## 📞 پشتیبانی
|
||
|
|
|
||
|
|
برای سوالات و مشکلات:
|
||
|
|
- بررسی documentation
|
||
|
|
- بررسی console errors
|
||
|
|
- بررسی network tab
|