# راهنمای نصب نتا فایل

این نسخه برای نصب روی هاست cPanel آماده شده و شامل بک‌اند Laravel، فرانت‌اند Next.js، پوشه vendor و node_modules است.

در این پکیج نیازی به اجرای Composer Install یا NPM Install روی سرور نیست.

از اعتماد شما سپاسگزاریم

## خرید شما برای ما ارزشمند است

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

با احترام، تیم نتا

## فایل‌های لازم برای آپلود

دو فایل زیر را کنار هم داخل `public_html` آپلود کنید:

- `installer.php`
- `neta-file-v[...].zip`

    https://domain.com/installer.php

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

    public_html/
    public_html/api/
    ../neta-file/
    ../neta-file-node/

- `public_html/api` مسیر اجرای بک‌اند Laravel است.
- `../neta-file` مسیر فایل‌های اصلی بک‌اند و خارج از public_html است.
- `../neta-file-node` مسیر اجرای Next.js با Node.js است.

    مدیریت: https://domain.com/admin
    API: https://domain.com/api

## مراحل installer

1. بررسی پیش‌نیازهای PHP، ZipArchive، PDO، OpenSSL و cURL.
2. انتخاب مسیرهای نصب. مسیرهای پیش‌فرض برای اغلب هاست‌ها مناسب است.
3. استخراج `neta-file-v[...].zip` و انتقال بک‌اند، فرانت و API.
4. ثبت اطلاعات دیتابیس و تست اتصال.
5. ساخت فایل env، اجرای migrate/seed، ساخت APP_KEY و ساخت کاربر مدیر.
6. ساخت مسیر `/api/storage` برای تصاویر و فایل‌های آپلودی.

## تنظیم Node.js در cPanel

1. در cPanel بخش Setup Node.js App یا Node.js Selector را باز کنید.
2. Node نسخه 20 یا 22 را انتخاب کنید.
3. Application Mode را روی `production` بگذارید.
4. Application Root را روی `neta-file-node` قرار دهید.
5. Application URL را روی دامنه اصلی تنظیم کنید.
6. Startup File را `server.js` وارد کنید.
7. برنامه را Restart کنید.

دکمه نصب پکیج‌ها در cPanel لازم نیست؛ node_modules داخل پکیج قرار دارد.

## ورود به مدیریت

بعد از نصب، با اطلاعات مدیریتی که در installer وارد کرده‌اید وارد پنل شوید:

    https://domain.com/admin

مسیر `/api` پنل مدیریت نیست؛ این مسیر فقط برای ارتباط فرانت با بک‌اند استفاده می‌شود.

## نکات خطایابی سریع

- خطای 503: تنظیمات Node.js را بررسی کنید؛ Root باید همان پوشه‌ای باشد که داخل آن `server.js`، `.next` و `node_modules` وجود دارد.
- خطای دیتابیس: نام دیتابیس، نام کاربری، رمز، host و port را دوباره بررسی کنید.
- تصاویر لود نمی‌شوند: مسیر `public_html/api/storage` باید توسط installer ساخته شده باشد.
- نبودن فایل zip: فایل `neta-file-v[...].zip` باید کنار `installer.php` باشد.