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

> ویراوان — مجموعه پنل مدیریت فارسی، نسخه ۱.۰  
> این سند برای توسعه‌دهنده‌ای نوشته شده که می‌خواهد بدون تغییر غیرضروری در هسته، پنل را شخصی‌سازی یا برای یک صنف تازه آماده کند.

## پیش‌نیاز

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

## روش سریع

```bash
cd ariya-admin-suite-v1.0
python -m http.server 8080
```

سپس نشانی `http://localhost:8080/` را باز کنید.

## مسیرهای مهم

- `index.html` — صفحه معرفی محصول.
- `demos.html` — فهرست دموها.
- `industries/01-ecommerce/index.html` — داشبورد اصلی فروشگاهی.
- `docs/index.html` — مرکز مستندات توسعه.

## اجرای بدون وب‌سرور

صفحات HTML اصلی با بازکردن مستقیم فایل نیز نمایش داده می‌شوند، اما سرویس‌ورکر و پی‌دبلیوای در `file://` فعال نمی‌شوند. برای تست نهایی همیشه از HTTP یا HTTPS استفاده کنید.

## ترتیب بارگذاری استاندارد یک صفحه صنفی

```html
<link rel="stylesheet" href="../../../core/css/fonts-icons.css">
<link rel="stylesheet" href="../../../core/css/base.css">
<link rel="stylesheet" href="../../../core/css/suite.css">
<link rel="stylesheet" href="../assets/css/industry.css">

<script src="../config/industry.js"></script>
<script src="../config/menu.js"></script>
<script src="../../../core/js/app.js"></script>
```

فایل‌های ویژه هر ماژول فقط در همان صفحه بارگذاری شوند؛ برای نمونه `phase7.css` و `phase7.js` در صفحات داده، نمودار و نقشه.

## کنترل اولیه پس از نصب

1. صفحه معرفی را باز کنید.
2. پنل فروشگاهی را باز کنید.
3. منوی موبایل را در عرض کمتر از ۹۹۲ پیکسل بررسی کنید.
4. تم روشن و تاریک را تغییر دهید.
5. میانبر `Ctrl + K` را آزمایش کنید.
6. کنسول مرورگر نباید خطای اجرایی داشته باشد.
7. ابزار `tools/qa_static.py` را برای کنترل لینک‌ها اجرا کنید.