| # پرامپت ممیزی کامل Q Network در VS Code |
|
|
| این متن را در Copilot Chat، Cursor، Continue.dev یا هر دستیار کدنویسی داخل VS Code اجرا کن. قبل از پاسخ نهایی، کل workspace را اسکن کن و فقط بر اساس فایل‌های واقعی پروژه گزارش بده. |
|
|
| ```text |
| تو یک معمار نرم‌افزار ارشد، متخصص 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 با پروژه بزرگ کند شد، اول این پیام را بده: |
|
|
| ```text |
| ابتدا فقط ساختار پوشه‌ها، package.json، vite.config.ts، src/App.tsx و src/pages را اسکن کن و یک نقشه اولیه بده. بعد از تایید من، وارد تحلیل حافظه و معماری شو. |
| ``` |
|
|
| ## نکته پروژه فعلی |
|
|
| در workspace فعلی `صفحه کیو`، با حذف `node_modules` و `dist`، تعداد پوشه‌های واقعی پیدا شده ۱۷ است. اگر نسخه دیگری از پروژه واقعاً ۳۱ پوشه دارد، باید همان workspace یا پوشه Q/Remix اصلی در VS Code باز شود. |
|
|
