منصوبے کے بارے میں

Design Oracle ایک MIT-لائسنس شدہ ٹول ہے جو کسی ویب سائٹ کا تجزیہ کرنے اور اس کے مکمل ڈیزائن سسٹم کو نکالنے کے لیے استعمال ہوتا ہے۔ یہ Next.js فرنٹ اینڈ، FastAPI بیک اینڈ، ARQ ورکر، Redis، SQLite، اور Playwright/Chromium اینالیسس پائپ لائن کا مجموعہ ہے۔ اس کی بنیادی صلاحیتوں میں Playwright کے ذریعے پورے صفحے کی کیپچرنگ، ویژول اسکور اور heuristics کے ساتھ ڈیزائن DNA کی درجہ بندی، ہیرو، پرائسنگ، نیو (nav)، اور FAQ جیسے عناصر کے لیے باؤنڈنگ باکسز کے ساتھ کمپوننٹ ڈیٹیکشن، SSE اور Redis pub/sub کے ذریعے لائیو پروگریس، اور Tailwind v4 کنفیگ، React JSX کمپوننٹس، JSON ڈیزائن ٹوکنز، اور Markdown DESIGN.md رپورٹ کی صورت میں ایکسپورٹ شامل ہیں۔ یہ AI ورک فلو کے لیے MCP کے ذریعے تجزیاتی ٹولز بھی فراہم کرتا ہے۔ سیٹ اپ کے لیے Docker Compose کی سفارش کی جاتی ہے: ریپوزٹری میں .env.example کو .env میں کاپی کرنے اور docker compose up --build -d چلانے، پھر http://localhost:3000 کھولنے کی ہدایت دی گئی ہے۔ مقامی start.sh آپشن کے لیے Python 3.12+، Node.js 20+، اور Redis 7+ کی ضرورت ہے، جو ورچوئل انوائرمنٹ، Playwright Chromium، Redis، ARQ ورکر، پورٹ 3000 پر Next.js، اور پورٹ 5000 پر FastAPI کو لانچ کرتا ہے۔ API میں ہیلتھ، اینالائز، اسٹیٹس، رزلٹ، SSE ایونٹس، اسکرین شاٹ، ڈیلیٹ، ڈیزائنز لسٹ، اور Tailwind، کمپوننٹس، design.md، اور ٹوکنز کے لیے ایکسپورٹ اینڈ پوائنٹس شامل ہیں۔ ہر تجزیہ analyses/{id}/ میں لکھا جاتا ہے جس میں screenshot.png، screenshot-overlay.png، result.json، DESIGN.md، tailwind.config.js، components.jsx، اور design-tokens.json شامل ہوتے ہیں۔ MCP سرور http://localhost:5000/mcp پر HTTP SSE کے ذریعے یا stdio موڈ میں اسٹینڈ الون دستیاب ہے۔ ایک ہلکا پھلکا uvx CLI، design-oracle-mcp، Playwright/Chromium کی ضرورت کے بغیر HTTP کے ذریعے بیک اینڈ کو کال کرتا ہے۔ ٹول اسنیپٹس opencode، Cursor، اور Claude Code کے لیے دستاویزی ہیں۔ ایک Cloudflare Tunnel اسکرپٹ، start-public.sh، ایپ کو عارضی پبلک HTTPS URL کے ذریعے ظاہر کر سکتا ہے۔ معروف حدود: تجزیہ فی الحال ایک واحد 1440x900 ویو پورٹ استعمال کرتا ہے؛ بوٹ-پروٹیکٹڈ سائٹس Playwright کو بلاک کر سکتی ہیں، جس کے لیے بنیادی اور درمیانی پروٹیکشن کے لیے اختیاری STEALTH_MODE موجود ہے، حالانکہ انٹرپرائز پروٹیکشن کے لیے اب بھی CAPTCHA یا پیڈ پراکسیز کی ضرورت ہو سکتی ہے؛ کمپوننٹ ڈیٹیکشن ML/ویژن پر مبنی ہونے کے بجائے heuristic ہے؛ اور SQLite اسٹوریج مقامی یا سنگل یوزر استعمال کے لیے موزوں ہے، ملٹی ٹیننٹ تعینات کرنے کے لیے نہیں۔