Q_NETWORK_AUDIT_PROMPT_FA.md

پرامپت ممیزی کامل Q Network در VS Code

این متن را در Copilot Chat، Cursor، Continue.dev یا هر دستیار کدنویسی داخل VS Code اجرا کن. قبل از پاسخ نهایی، کل workspace را اسکن کن و فقط بر اساس فایل‌های واقعی پروژه گزارش بده.

تو یک معمار نرم‌افزار ارشد، متخصص React + Vite/Remix + TypeScript + PWA، معماری ماژولار، حافظه آفلاین، و اتصال سیستم‌های هوش مصنوعی هستی.

هدف:
پروژه Q Network / QMetaram Hub را به صورت کامل ممیزی کن؛ ساختار پوشه‌ها، صفحات، لینک‌ها، ماژول‌ها، جریان حافظه، اتصال به Hub مرکزی، وضعیت PWA/آفلاین، و درصد پیشرفت هر بخش را گزارش بده.

قانون مهم:
اگر کاربر گفته پروژه دقیقاً ۳۱ پوشه دارد، ابتدا عدد واقعی پوشه‌ها را از workspace استخراج کن. اگر عدد واقعی با ۳۱ فرق داشت، شفاف بنویس:
- عدد مورد انتظار: ۳۱
- عدد واقعی پیدا شده
- پوشه‌هایی که شمرده شدند
- پوشه‌هایی که احتمالا باید اضافه/منتقل/بازیابی شوند
هرگز عدد ۳۱ را بدون تایید فایل‌سیستم فرض نکن.

محدوده اسکن:
- کل workspace را بررسی کن.
- پوشه‌های خروجی و وابستگی مثل node_modules, dist, build, .git, .cache را در تحلیل معماری اصلی جدا کن.
- برای فایل‌های کلیدی مثل package.json, vite.config.ts, src/App.tsx, src/pages, src/components, public, service worker/PWA config گزارش دقیق بده.

خروجی موردنیاز:

۱. خلاصه مدیریتی
- پروژه چه نوعی است؟
- تکنولوژی‌های اصلی چیست؟
- وضعیت کلی سلامت معماری چیست؟
- مهم‌ترین ریسک‌ها و فرصت‌ها چیست؟

۲. جدول پوشه‌ها
برای هر پوشه واقعی، جدول Markdown بده:
| # | مسیر | تعداد فایل | حجم تقریبی | نقش | وضعیت اتصال به Hub | پیشرفت % | ریسک فوری |

۳. تحلیل هر پوشه
برای هر پوشه بنویس:
- نام و مسیر
- فایل‌ها/صفحات/کامپوننت‌های کلیدی
- لینک‌ها و routeهای مرتبط
- قابلیت‌ها و کاربردها
- وابستگی به سایر پوشه‌ها
- وضعیت اتصال به QMetaram Hub
- پیشنهاد اتصال بهتر به سایر بخش‌ها
- درصد پیشرفت تخمینی با دلیل

۴. نقشه صفحات و لینک‌ها
- همه routeها را از App/Router استخراج کن.
- برای هر route بنویس کدام component/page را render می‌کند.
- لینک‌های داخلی و خارجی مهم را فهرست کن.
- routeهای ناقص، dead linkها، redirectها و صفحات placeholder را مشخص کن.

۵. تحلیل حافظه و داده
بررسی کن:
- localStorage
- IndexedDB
- Cache Storage / Service Worker / Workbox
- session/memory refs
- صف آفلاین پیام‌ها
- WebSocket و reconnect logic
- API cache strategy

برای هر مورد بنویس:
- کجا استفاده شده؟
- چه داده‌ای ذخیره می‌شود؟
- خطر امنیتی/حریم خصوصی دارد یا نه؟
- آیا در آفلاین پایدار است؟
- پیشنهاد بهینه‌سازی حافظه، پاک‌سازی cache، migration versioning و محدودیت حجم چیست؟

۶. تحلیل PWA و آفلاین
بررسی کن:
- manifest
- service worker
- runtimeCaching
- offline fallback
- installability
- فایل‌هایی که precache می‌شوند
- خطر cache شدن فایل‌های قدیمی
- آیا app در حالت airplane/offline قابل استفاده است؟

۷. معماری اتصال به Hub مرکزی
یک نقشه معماری متنی بده:
- UI Layer
- Pages/Routes
- Components
- Core/Q Cognitive modules
- Data layer
- PWA/Offline layer
- Network/WebSocket/API layer
- Future microservices/gRPC layer

سپس بنویس کدام پوشه‌ها جزیره‌ای هستند و هنوز به Hub مرکزی وصل نیستند.

۸. پیشنهاد معماری هدف
یک طرح عملی بده برای اتصال همه بخش‌ها:
- Central App Context یا QHubProvider
- Event Bus سبک برای ارتباط ماژول‌ها
- Module Registry برای ماژول‌های Q
- Offline Queue Manager
- Memory Manager
- Network Adapter برای REST/WebSocket/gRPC gateway
- Feature flags و plan-based access

۹. کد پیشنهادی
کدهای کوتاه و قابل اجرا بده:
- ساختار QHubProvider
- Event Bus TypeScript
- Module Registry
- Offline Queue Manager با localStorage یا IndexedDB
- نمونه اتصال یک page به Hub مرکزی

۱۰. درصد پیشرفت کل پروژه
در پایان یک جدول بده:
| بخش | پیشرفت % | دلیل | اقدام بعدی |

بخش‌ها:
- Frontend UI
- Routing/Pages
- PWA/Offline
- Chat/Voice
- VPN/Access Control
- Core Cognitive Engine
- Data/Modules
- Security/Privacy
- Performance
- Deployment/Nginx/CDN
- Testing
- Documentation

۱۱. اولویت‌بندی اجرایی
یک لیست ۱۰ موردی بده:
- اولویت ۱ تا ۱۰
- اثر روی کاربر
- سختی اجرا
- ریسک
- فایل‌های درگیر

سبک پاسخ:
- کاملاً فارسی
- شفاف، عددی، و مبتنی بر فایل‌های واقعی
- از جدول Markdown استفاده کن
- اگر چیزی را نمی‌توانی از کد بفهمی، بنویس "نامشخص از روی فایل‌های فعلی"
- هیچ فایل یا قابلیت خیالی نساز
- پیشنهادها باید عملی و قابل پیاده‌سازی باشند

دستور کوتاه برای شروع

اگر دستیار VS Code با پروژه بزرگ کند شد، اول این پیام را بده:

ابتدا فقط ساختار پوشه‌ها، package.json، vite.config.ts، src/App.tsx و src/pages را اسکن کن و یک نقشه اولیه بده. بعد از تایید من، وارد تحلیل حافظه و معماری شو.

نکته پروژه فعلی

در workspace فعلی صفحه کیو، با حذف node_modules و dist، تعداد پوشه‌های واقعی پیدا شده ۱۷ است. اگر نسخه دیگری از پروژه واقعاً ۳۱ پوشه دارد، باید همان workspace یا پوشه Q/Remix اصلی در VS Code باز شود.