# گزارش بررسی استقرار — ۲۰۲۶-۱۰-۱۷

## نتیجه

علت نمایش Index of / در تصاویر، ارائهٔ پوشهٔ سورس توسط وب‌سرور به‌جای اجرای سرور Node است. در ZIP خروجی سرور از قبل موجود بود؛ نبودن فایل PHP مشکل اصلی نیست. برنامه به Node.js 24 و reverse proxy سازگار نیاز دارد.

## تغییرات این تحویل

- حفظ سورس و قابلیت‌های موجود؛ بدون ادعای بازنویسی Enterprise.
- ساخت مجدد `.output` از سورس با وابستگی‌های قفل‌شده.
- افزودن `app.cjs` بدون وابستگی خارجی: تعیین پوشهٔ کاری، خواندن .env خصوصی با تقدم متغیرهای پنل، الزام Node 24، حالت production، کنترل پورت و اجرای doctor پیش از شروع سرور.
- تغییر npm start، Dockerfile و سرویس systemd برای استفاده از همین راه‌انداز.
- تنظیم نمونهٔ دامنه و bind محلی در .env.example؛ بدون اطلاعات ورود واقعی.
- راهنمای فارسی نصب cPanel/Passenger مشروط به پشتیبانی میزبان و مسیر VPS، هشدار انتشار سورس و نمونهٔ انسداد موقت Apache.
- تست HTTP مستقل برای خروجی آماده بدون node_modules، با دیتابیس و اعتبارنامهٔ تصادفی موقت و پاک‌سازی پس از تست.
- به‌روزرسانی فهرست SHA-256 بسته.

## تست‌های اجراشده در این بررسی

محیط: Linux، Node.js 24.14.1. مستندات آزمون قبلی در بسته حفظ شده‌اند؛ این جدول فقط بررسی مجدد حاضر است.

| بررسی | نتیجه |
| --- | --- |
| npm ci --ignore-scripts با package-lock | موفق؛ build و تست پس از نصب اجرا شدند |
| TypeScript | موفق |
| تست‌های Vitest | ۴۲۸ موفق، ۴ skipped به‌علت fixture خارج از بسته |
| تست‌های enterprise موجود | ۲۰ موفق، صفر شکست |
| build عملیاتی | موفق؛ warningهای ابزارهای build وجود دارند |
| ESLint پس از اصلاحات | صفر خطا، ۹ warning موجود React Hooks/Fast Refresh |
| npm audit --omit=dev | صفر آسیب‌پذیری شناخته‌شدهٔ گزارش‌شده در زمان بررسی؛ فقط وابستگی‌های production |
| تست جدید نصب مستقل | موفق: ۱ سناریوی چندمرحله‌ای، بدون node_modules |

سناریوی جدید شامل رد راه‌اندازی با تنظیمات نامعتبر، health و readiness، جلوگیری از API بدون نشست، Origin نامعتبر، کوکی HttpOnly/Secure/SameSite، SSR صفحهٔ workspace و فایل‌های مرجع آن، ایجاد پروژه و سند، پرسش آفلاین، گزارش، بازبینی، خروج و ابطال نشست، snapshot بکاپ و خواندن گزارش پس از راه‌اندازی مجدد بود. آزمون روی loopback با درخواست HTTP و Origin HTTPS آزمایشی انجام شد؛ TLS یا reverse proxy واقعی را تأیید نمی‌کند. آزمون جدید، تست مرورگر/تعامل کامل نیست.

جمع تست‌های موفق این بررسی: **۴۴۹** (۴۴۸ موجود + ۱ سناریوی نصب). چهار تست اجرا نشده‌اند و موفق محسوب نمی‌شوند.

لاگ‌های این بررسی: `docs/qa/deployment-2026-10-17/`.

## موارد خارج از تأیید

- هاست cPanel کاربر، قابلیت Node 24/Passenger آن، Document Root و نگاشت دامنه، DNS، گواهی و reverse proxy واقعی.
- Docker build، اجرای systemd روی سرور واقعی و ارتقای عملیاتی دادهٔ موجود.
- مدل ابری واقعی، مدل محلی واقعی، کیفیت پاسخ حقوقی و OCR فارسی واقعی. نبود کلید، حالت بازیابی آفلاین را به مدل مولد هوش مصنوعی تبدیل نمی‌کند.
- تست بار، چندسروری، HA، SSO/MFA، جداسازی مستاجرها، تست نفوذ مستقل و انطباق سازمانی.
- تمام تعاملات مرورگر، تمام قالب‌های فایل واقعی و تمرین بازیابی کامل روی هاست.

SQLite داخلی Node در این محیط هشدار Experimental دارد و Nitro مورد استفاده beta است؛ این موارد در تصمیم بهره‌برداری و نگهداری باید ارزیابی شوند. صفر نتیجهٔ npm audit تضمین امنیت نیست. نام Enterprise نسخهٔ قبلی به معنی گواهی یا تضمین محصول نیست.