# راهنمای راه‌اندازی پنل مدیریت

## مراحل راه‌اندازی
1. نصب و پیکربندی
2. تنظیم دیتابیس
3. ایجاد کاربران
4. تنظیم نقش‌ها و مجوزها
5. تست عملکرد

## تنظیمات اولیه
```bash
# نصب dependencies
composer install

# تنظیم environment
cp .env.example .env
php artisan key:generate

# تنظیم دیتابیس
php artisan migrate
php artisan db:seed --class=CreateSuperAdminSeeder

# تنظیم storage
php artisan storage:link
```

## تست عملکرد
- ورود به سیستم
- بررسی داشبورد
- تست ماژول‌های مختلف
- بررسی مجوزها



# راهنمای راه‌اندازی کاربران

## ایجاد کاربران اولیه

### 1. کاربر سوپر ادمین
```bash
php artisan db:seed --class=CreateSuperAdminSeeder
```

### 2. نقش‌ها و مجوزها
```bash
php artisan db:seed --class=RolesAndAdminSeeder
```

### 3. کش مجوزها
```bash
php artisan permission:cache-reset
```

## نقش‌های موجود
- **سوپر ادمین**: دسترسی کامل به تمام بخش‌ها
- **ادمین**: دسترسی مدیریتی به بخش‌های مختلف
- **مسئول خرید**: مدیریت فرایندهای خرید
- **کارشناس فروش**: مدیریت فروش و نمونه‌ها

## مجوزهای اصلی
- `dashboard.view` - مشاهده داشبورد
- `users.*` - مدیریت کاربران
- `suppliers.*` - مدیریت تامین‌کنندگان
- `products.*` - مدیریت محصولات
- `samples.*` - مدیریت نمونه‌ها
- `purchase_requests.*` - مدیریت درخواست‌های خرید
- `purchase_orders.*` - مدیریت سفارش‌های خرید

## تست دسترسی
1. ورود با نقش‌های مختلف
2. بررسی منوی سایدبار
3. تست دسترسی به بخش‌های مختلف
4. بررسی مجوزهای عملیات


# راهنمای نصب و راه‌اندازی پنل مدیریت

## پیش‌نیازها
- Windows + XAMPP (PHP 7.4/8)
- MySQL
- Composer
- Node.js/NPM

## مراحل نصب
1. Clone پروژه
2. نصب dependencies
3. تنظیم دیتابیس
4. اجرای migrations
5. ایجاد کاربر ادمین
6. تنظیم storage
7. ساخت frontend assets

## تنظیمات دیتابیس
```env
DB_CONNECTION=mysql
DB_PORT=3306
DB_DATABASE=crminome
DB_USERNAME=root
DB_PASSWORD=
```

## دستورات نصب
```bash
composer install
php artisan key:generate
php artisan migrate
php artisan db:seed --class=CreateSuperAdminSeeder
php artisan storage:link
npm install
npm run dev
```



# راهنمای نصب سیستم

## نصب روی سرور

### 1. نصب وابستگی‌ها
```bash
composer install --optimize-autoloader --no-dev
```

### 2. تنظیم محیط
```bash
cp .env.example .env
# ویرایش فایل .env و تنظیم دیتابیس
```

### 3. تولید کلید اپلیکیشن
```bash
php artisan key:generate
```

### 4. اجرای مایگریشن‌ها
```bash
php artisan migrate --force
```

### 5. اجرای Seeder ها (ایجاد نقش‌ها، مجوزها و کاربران)
```bash
php artisan db:seed --force
```

### 6. بهینه‌سازی
```bash
php artisan config:cache
php artisan route:cache
php artisan view:cache
```

## اطلاعات ورود پیش‌فرض

### کاربران سوپر ادمین

#### کاربر 1 (وحید)
- **ایمیل:** `senior.analizor@gmail.com`
- **رمز عبور:** `password`

#### کاربر 2 (سارا)
- **ایمیل:** `Sara.sedaghat.irchem@gmail.com`
- **رمز عبور:** `password`

### نقش‌های موجود
1. **سوپر ادمین** - دسترسی کامل به تمام بخش‌ها
2. **ادمین** - دسترسی به مدیریت سیستم
3. **کارشناس خرید** - دسترسی به بخش خرید
4. **کارشناس فروش** - دسترسی به بخش فروش
5. **مسئول انبار** - دسترسی به بخش انبار
6. **حسابداری** - دسترسی به گزارش‌ها
7. **مدیریت** - دسترسی محدود به گزارش‌ها

## ساختار سیستم

### URL های اصلی
- **داشبورد اصلی:** `/`
- **پنل ادمین:** `/admin`
- **کارشناس خرید:** `/purchase`
- **کارشناس فروش:** `/sales`

### مجوزها
سیستم از 80 مجوز مختلف استفاده می‌کند که شامل:
- مدیریت کاربران
- مدیریت تامین‌کنندگان
- مدیریت محصولات
- مدیریت درخواست‌های خرید
- مدیریت نمونه‌ها
- مدیریت انبار
- مدیریت گزارش‌ها
- مدیریت تنظیمات
- مدیریت یادآوری‌ها

## عیب‌یابی

### مشکل: سایدبار نمایش داده نمی‌شود
**راه حل:** مطمئن شوید که کاربر نقش و مجوزهای مناسب دارد.

### مشکل: خطای 403 Forbidden
**راه حل:** بررسی کنید که کاربر مجوز دسترسی به صفحه مورد نظر را دارد.

### مشکل: خطای 404 Not Found
**راه حل:** مطمئن شوید که route ها درست تعریف شده‌اند.

## پشتیبانی
در صورت بروز مشکل، لطفاً با تیم توسعه تماس بگیرید.