نصب

نصب NOVAADMIN به Node.js نیاز دارد. اگر فقط می‌خواهید خروجی آماده را روی هاست بگذارید، نیازی به هیچ ابزاری نیست: پوشه html/ را در بسته محصول مستقیماً آپلود کنید.

پیش‌نیازها

ابزار	نسخه	توضیح
Node.js	۱۸ یا بالاتر	فقط برای ساخت و محیط توسعه
npm	۹ یا بالاتر	مدیریت وابستگی‌ها
مرورگر مدرن	Chrome / Edge / Firefox / Safari	پشتیبانی از CSS Nesting، `:has()` و ES2022

گام‌به‌گام

فایل ZIP محصول را در پوشه پروژه باز کنید:

unzip NOVAADMIN-1.0.0.zip -d novaadmin
cd novaadmin

وابستگی‌ها را نصب کنید:

npm install

محیط توسعه را اجرا کنید:

npm run dev

سپس http://localhost:5173 را باز کنید. صفحه محصول (لندینگ) نمایش داده می‌شود و از آنجا می‌توانید وارد دموها شوید.

خروجی نهایی را بسازید:

npm run build

خروجی در پوشه dist/ ساخته می‌شود؛ پوشه‌ای که باید روی هاست قرار بگیرد همین است.

نکته: npm run build چهار مرحله را پشت سر هم اجرا می‌کند: تولید صفحات از manifest، تولید دارایی‌های گرافیکی، باندل Vite و مرتب‌سازی نهایی خروجی

هیچ‌کدام را دستی اجرا نکنید.

اسکریپت‌های موجود

دستور	کار
`npm run dev`	سرور توسعه با بارگذاری زنده روی پورت ۵۱۷۳
`npm run build`	ساخت کامل خروجی در `dist/`
`npm run preview`	پیش‌نمایش خروجی ساخته‌شده
`npm run gen:pages`	فقط تولید صفحه‌ها از manifest
`npm run gen:assets`	تولید لوگو، آواتارها، تصاویر محصول و لوگو برندها
`npm run gen:nav`	تولید `navigation.js`، `sitemap.xml` و `robots.txt`
`npm run gen:all`	هر سه مرحله تولید بالا
`npm run qa:links`	کنترل کیفیت خروجی (لینک، دارایی، CSS، دسترس‌پذیری)
`npm run qa:smoke`	اجرای واقعی کنترل‌کننده‌ها در یک DOM شبیه‌سازی‌شده
`npm run qa:all`	ساخت + هر دو کنترل کیفیت
`npm run package`	ساخت بسته نهایی قابل ارسال

نصب روی هاست اشتراکی (بدون Node)

پوشه html/ از بسته محصول را کامل آپلود کنید.
مطمئن شوید فایل index.html در ریشه دامنه است.
اگر سایت در زیرپوشه اجرا می‌شود (مثل example.com/admin/)، همه لینک‌ها نسبی هستند و بدون تغییر کار می‌کنند.

هشدار: فایل‌های قالب را مستقیم با FTP ویرایش نکنید

همیشه در پروژه منبع تغییر دهید و دوباره npm run build بگیرید؛ در غیر این صورت تغییرات در ساخت بعدی از دست می‌رود.

عیب‌یابی سریع

پورت ۵۱۷۳ اشغال است: npm run dev -- --port 5180
نصب با خطا متوقف شد: npm cache clean --force و سپس rm -rf node_modules package-lock.json && npm install
فونت‌ها لود نمی‌شوند: وابستگی vazirmatn باید داخل node_modules باشد؛ در خروجی نهایی فونت‌ها به assets/fonts/ منتقل می‌شوند.
سؤالات بیشتر → رفع اشکال

Installation

Installing NOVAADMIN requires Node.js. If you only want to put the ready-made output on a host, you need no tooling at all: upload the html/ folder from the product package directly.

Prerequisites

Tool	Version	Notes
Node.js	18 or later	Only for building and the development environment
npm	9 or later	Dependency management
A modern browser	Chrome / Edge / Firefox / Safari	Supports CSS Nesting, `:has()` and ES2022

Step by step

Extract the product ZIP into your project folder:

unzip NOVAADMIN-1.0.0.zip -d novaadmin
cd novaadmin

Install the dependencies:

npm install

Start the development environment:

npm run dev

Then open http://localhost:5173. The product (landing) page appears and you can enter the demos from there.

Build the final output:

npm run build

The output is written to the dist/ folder; this is the folder that goes on your host.

Tip: npm run build runs four steps back to back: generating pages from the manifest, generating graphic assets, the Vite bundle and a final tidy-up of the output

Do not run any of them by hand.

Available scripts

Command	What it does
`npm run dev`	Development server with live reload on port 5173
`npm run build`	Full build of the output into `dist/`
`npm run preview`	Preview the built output
`npm run gen:pages`	Only generate pages from the manifest
`npm run gen:assets`	Generate the logo, avatars, product images and brand logos
`npm run gen:nav`	Generate `navigation.js`, `sitemap.xml` and `robots.txt`
`npm run gen:all`	All three generation steps above
`npm run qa:links`	Output quality control (links, assets, CSS, accessibility)
`npm run qa:smoke`	Runs the real controllers inside a simulated DOM
`npm run qa:all`	Build + both quality checks
`npm run package`	Build the final, shippable package

Installing on shared hosting (no Node)

Upload the whole html/ folder from the product package.
Make sure index.html is at the domain root.
If the site runs in a subfolder (such as example.com/admin/), all links are relative and work unchanged.

Warning: do not edit the template files directly over FTP

Always change the source project and run npm run build again; otherwise your changes are lost on the next build.

Quick troubleshooting

Port 5173 is in use: npm run dev -- --port 5180
Installation stopped with an error: npm cache clean --force, then rm -rf node_modules package-lock.json && npm install
Fonts do not load: the vazirmatn dependency must be inside node_modules; in the final output the fonts are moved to assets/fonts/.
More questions → Troubleshooting

التثبيت

يتطلب تثبيت NOVAADMIN وجود Node.js. إذا كنت تريد فقط وضع المخرجات الجاهزة على الاستضافة، فلا تحتاج إلى أي أداة: ارفع مجلد html/ من حزمة المنتج مباشرة.

المتطلبات المسبقة

الأداة	الإصدار	ملاحظات
Node.js	١٨ أو أحدث	للبناء وبيئة التطوير فقط
npm	٩ أو أحدث	إدارة الاعتماديات
متصفح حديث	Chrome / Edge / Firefox / Safari	يدعم CSS Nesting و`:has()` وES2022

خطوة بخطوة

فكّ ضغط ملف ZIP الخاص بالمنتج في مجلد المشروع:

unzip NOVAADMIN-1.0.0.zip -d novaadmin
cd novaadmin

ثبّت الاعتماديات:

npm install

شغّل بيئة التطوير:

npm run dev

ثم افتح http://localhost:5173. ستظهر صفحة المنتج (صفحة الهبوط) ويمكنك الدخول إلى العروض التجريبية منها.

ابنِ المخرجات النهائية:

npm run build

تُنشأ المخرجات في مجلد dist/؛ وهو المجلد الذي يجب وضعه على الاستضافة.

ملاحظة: ينفّذ npm run build أربع مراحل متتالية: توليد الصفحات من manifest، وتوليد الأصول الرسومية، وحزمة Vite، والترتيب النهائي للمخرجات

لا تشغّل أياً منها يدوياً.

السكربتات المتاحة

الأمر	الوظيفة
`npm run dev`	خادم التطوير مع إعادة التحميل المباشر على المنفذ ٥١٧٣
`npm run build`	بناء كامل للمخرجات في `dist/`
`npm run preview`	معاينة المخرجات المبنية
`npm run gen:pages`	توليد الصفحات من manifest فقط
`npm run gen:assets`	توليد الشعار والصور الرمزية وصور المنتجات وشعارات العلامات
`npm run gen:nav`	توليد `navigation.js` و`sitemap.xml` و`robots.txt`
`npm run gen:all`	مراحل التوليد الثلاث أعلاه
`npm run qa:links`	ضبط جودة المخرجات (الروابط، الأصول، CSS، إمكانية الوصول)
`npm run qa:smoke`	تشغيل فعلي للمتحكمات داخل DOM محاكى
`npm run qa:all`	البناء + فحصا الجودة
`npm run package`	بناء الحزمة النهائية القابلة للتسليم

التثبيت على استضافة مشتركة (دون Node)

ارفع مجلد html/ من حزمة المنتج كاملاً.
تأكد من أن الملف index.html في جذر النطاق.
إذا كان الموقع يعمل في مجلد فرعي (مثل example.com/admin/)، فجميع الروابط نسبية وتعمل دون تغيير.

تحذير: لا تعدّل ملفات القالب مباشرة عبر FTP

عدّل دائماً في مشروع المصدر وشغّل npm run build مجدداً؛ وإلا ستضيع تغييراتك في البناء التالي.

استكشاف الأخطاء السريع

المنفذ ٥١٧٣ مشغول: npm run dev -- --port 5180
توقف التثبيت بخطأ: npm cache clean --force ثم rm -rf node_modules package-lock.json && npm install
الخطوط لا تُحمّل: يجب أن تكون الاعتمادية vazirmatn داخل node_modules؛ وفي المخرجات النهائية تُنقل الخطوط إلى assets/fonts/.
مزيد من الأسئلة ← استكشاف الأخطاء