# سند جامع طراحی بازی و محصول (Game Design Document - GDD) ## عنوان پروژه: AI Odyssey: Royal Match (Enterprise Edition) **مخاطب سند:** ایجنت‌های هوش مصنوعی، معماران نرم‌افزار، طراحان محصول و توسعه‌دهندگان Full-Stack --- ## ۱. بیانیه هدف و متدولوژی محصول (Executive Summary & Core Mission) ### ۱.۱. صورت مسئله سازمان‌های مقیاس بزرگ (مانند اسنپ و دیجی‌کالا با ۱۰۰۰+ پرسنل دفتری) در پذیرش هوش مصنوعی با ۳ مانع روبرو هستند: 1. **ترس از جایگزینی:** تصور اینکه AI شغل آن‌ها را تهدید می‌کند. 2. **کمبود وقت:** عدم امکان تخصیص دوره‌های آموزشی طولانی در تقویم کاری فشرده. 3. **عدم کاربردپذیری مستقیم:** آموزش‌های تئوری به مهارت عملی روزمره در اکسل، ایمیل، گزارشات و تحلیل قرارداد تبدیل نمی‌شود. ### ۱.۲. راهکار محصول (Core Solution) یک پلتفرم وب‌اپلیکیشن گیمیفیکیشن شرکتی با ساختار **Saga Map (کندی‌کراش / رویال‌مچ)** که در قالب یک سیزن **۶ هفته‌ای (هفته‌ای دقیقاً ۱ ساعت = ۶ ساعت کل سیزن)**، پرسنل را از طریق حل چالش‌های روزمره دپارتمان خود به «معماران هوش مصنوعی» تبدیل می‌کند. ### ۱.۳. فلسفه بنیادین (The Golden Rule) > **«هوش مصنوعی جایگزین انسان نمی‌شود؛ بلکه نقش یک Exoskeleton (اسکلت تقویتی) را دارد که سرعت و کیفیت خروجی کارمند را ۱۰ برابر می‌کند.»** --- ## ۲. چارچوب گیمیفیکیشن اکتاکتلیس (Yu-kai Chou Octalysis Mapping) | درایور اکتاکتلیس | پیاده‌سازی در بازی | اثر روانی بر کارمند | |---|---|---| | **۱. Epic Meaning (رسالت بزرگ)** | ویدیوی داستانی شروع بازی؛ پرسنل «هسته هوش مصنوعی شرکت» را برای نجات از بحران داده‌ها در سال ۲۰۲۸ بازسازی می‌کنند. | احساس اثرگذاری سازمانی و ماموریت فراتر از کار روتین | | **۲. Accomplishment (رشد و پیشرفت)** | نقشه ۱۰ نودی Saga Map، دریافت ۱ تا ۳ ستاره، لول‌آپ و آنلاک شدن نودهای نقشه. | ارضای حس تکمیل‌گرایی و بازخورد پیوسته | | **۳. Empowerment (خلاقیت و سندباکس)** | سندباکس پرامپت‌نویسی زنده + داور هوش مصنوعی (LLM-as-a-Judge) + امکان تکرار نامحدود مراحل برای ارتقای نمره. | یادگیری از طریق آزمون و خطا بدون ترس از شکست | | **۴. Ownership (مالکیت و آواتار)** | ساخت آواتار سایبرپانک در مرحله صفر + جمع‌آوری کارت‌های جادویی پرامپت (Prompt Vault). | دلبستگی به هویت درون‌برنامه‌ای و ابزارهای ساخته‌شده | | **۵. Social Influence (هم‌افزایی و قبیله)** | سیستم Squads دپارتمانی (ارسال جان/قلب و اسکیل به هم‌تیمی‌ها) + لیدربورد منصفانه تیمی و فردی. | فشار مثبت همتایان (Peer Support) به جای اصطکاک فردی | | **۶. Scarcity (کمیابی و زمان محدود)** | مینی‌گیم‌های سرعتی ۲ دقیقه‌ای + شمارشگر معکوس ۶ ساعته کل سیزن. | تمرکز عمیق و جلوگیری از اهمال‌کاری | | **۷. Unpredictability (کنجکاوی و طنز)** | ربات همراه و شوخ‌طبع «هپی (Happy AI)» + رویدادهای بحرانی غیرمنتظره (مثل نجات مدیر). | حفظ هیجان و رفع خشکی محیط‌های اداری | | **۸. Loss Avoidance (ترس از باخت و Streak)** | حفظ زنجیره هفتگی (Streak) + سیستم **Catch-up (ضریب ۲X)** برای افراد ملحق‌شده از هفته‌های بعد. | حفظ انگیزه و عدم احساس جاماندگی | --- ## ۳. معماری سیستم پیشروی (Saga Map & Stage Breakdown) ### ۳.۱. بودجه‌بندی زمانی (۱ ساعت در هفته = ۴ بلاک ۱۵ دقیقه‌ای) * **بلاک ۱ (مفاهیم و تله‌ها):** سناریوی تئوری-عملی + مهندسی معکوس پرامپت (۱۵ دقیقه). * **بلاک ۲ (سندباکس عملی دپارتمان):** حل تسک کثیف سازمانی در ادیتور زنده (۱۵ دقیقه). * **بلاک ۳ (مینی‌گیم کمکی / پازل سرعتی):** مینی‌گیم‌های سبُک سبک رویال‌مچ برای کسب اسکیل و جان (۱۵ دقیقه). * **بلاک ۴ (باس‌فایت / ابزارسازی سازمانی):** ساخت یک ایجنت/فرمول قابل استفاده مجدد در شرکت (۱۵ دقیقه). ### ۳.۲. ماتریس ۱۰ مرحله اصلی (برگرفته از کاتالوگ چالش‌های اسنپ/دیجی‌کالا) | نود | عنوان چالش | تسک کاربر | روش داوری سیستم | خروجی مهارتی روزمره | |---|---|---|---|---| | **۰** | **The Avatar Genesis** | تولید پرامپت تصویری ساخت آواتار شخصی پرسنل با استایل سازمانی | Vision LLM (CLIP Matcher) | درک نحوه توصیف بصری دقیق به هوش مصنوعی | | **۱** | **Reverse Prompt Matcher** | مهندسی معکوس پرامپت یک بنر تبلیغاتی/محصولی موفق در ۳ دقیقه | Vision/Embedding Similarity | توانایی بازتولید دیزاین رقبا با پرامپت متنی | | **۲** | **Token Golf Duel** | کوتاه کردن پرامپت ۵۰۰ کلمه‌ای شلوغ به زیر ۵۰ کلمه با حفظ ۱۰۰٪ معنا | Token Counter + LLM Verifier | کاهش هزینه‌های API و نگارش پرامپت موجز | | **۳** | **Dirty Data to JSON** | تبدیل ۲۰ کامنت آشفته با غلط املایی به جدول تمیز JSON | JSON Schema Validator + Regex | دسته‌بندی خودکار هزاران تیکت بدون کار دستی | | **۴** | **Hallucination Hunter** | کشف ۳ خطای خطرناک و فکت جعلی در خلاصه آیین‌نامه انضباطی | Ground Truth Diff Checker | یادگیری حلقه اعتبارسنجی (Verification Loop) | | **۵** | **Angry Customer Sim** | آرام کردن مسافر شاکی در حداکثر ۴ پیام (کاهش خشم به زیر ۲۰٪) | Sentiment Analyzer LLM | نگارش مکاتبات محترمانه و استاندارد با مشتریان | | **۶** | **Spreadsheet Wizard** | تولید فرمول ترکیبی اکسل/پایتون برای محاسبه پورسانت پلکانی | Sandboxed Python/Excel Runner | اتوماسیون ساعت‌ها کار دستی در اکسل و شیت‌ها | | **۷** | **PII Privacy Shield** | ماسک کردن شماره ملی، شبا و موبایل در دیتاست قبل ارسال به AI | Regex Zero-Leakage Test | حفظ امنیت داده‌های محرمانه و عدم نشت اطلاعات | | **۸** | **Multi-Persona Duel** | نگارش ۵ پیام پوش‌نوتیفیکیشن برای ۵ پرسونای رفتاری متفاوت | Persona Simulation Agents | شخصی‌سازی کمپین‌های بازاریابی و فروش | | **۹** | **Workflow Domino** | اتصال ۳ ایجنت متوالی (تمیزکننده داده -> تحلیل علت -> نگارش ایمیل) | Pipeline Integration Test | طراحی فرایندهای اتوماسیون بدون کد (No-Code) | | **۱۰** | **Grand Custom Agent (Boss)** | ساخت یک دستیار تخصصی دپارتمانی با System Prompt و داکیومنت مرجع | Benchmark Suite + Peer Voting | انتشار ابزار عملیاتی دائمی در شرکت | --- ## ۴. مکانیزم‌های بازی سبک رویال‌مچ (Royal Match Mechanics) ``` ┌─────────────────────────────────────────────────────────┐ │ اتاق همکاری قبیله (Squad Room) │ │ - ارسال و دریافت قلب/جان (Lives) │ │ - اشتراک‌گذاری کارت‌های اسکیل (Skill Exchange) │ │ - باز کردن مشترک صندوق هفتگی قبیله (Squad Chest) │ └────────────────────────────┬────────────────────────────┘ │ ▼ ┌─────────────────────────────────────────────────────────┐ │ مینی‌گیم‌های چالشی سرعتی (Side Arenas) │ │ ۱. نجات مدیرعامل از توهم (Save The Boss - ۳۰ ثانیه) │ │ ۲. جورچین ۳تایی بلوک پرامپت (Token Match-3) │ │ ۳. برش سریع کلمات زائد (Rapid Word Golf) │ └────────────────────────────┬────────────────────────────┘ │ ▼ ┌─────────────────────────────────────────────────────────┐ │ ارتقای اتاق فرماندهی دپارتمان (HQ Renovation) │ │ - خرج ستاره‌های طلایی (★) برای تجهیز سرورهای هوش مصنوعی│ └─────────────────────────────────────────────────────────┘ ``` ### ۴.۱. اتاق قبیله و سیستم اهدای جان (Squad Social System) * هر کارمند عضو قبیله دپارتمان خود است (مارکتینگ، فنی، عملیات، مالی، HR). * **ظرفیت جان (Hearts):** ۵ قلب. با باخت در هر چالش ۱ قلب کم می‌شود. * **درخواست کمک:** کارمند می‌تواند در چت اسکواد دکمه `درخواست جان` بزند؛ همکاران با یک کلیک برای او قلب می‌فرستند و خودشان **۱۰ XP مشارکت تیمی** دریافت می‌کنند. * **صندوق هفتگی قبیله (Squad Chest):** هدف جمع‌آوری ۳۰۰ ستاره تیمی در هفته؛ با رسیدن به تارگت، تمام اعضا ۵۰۰ سکه و ۱ بوستر طلایی دریافت می‌کنند. ### ۴.۲. مینی‌گیم‌های جانبی (Fast Side-Puzzles) 1. **Save The Boss (نجات مدیر):** تایمر معکوس ۳۰ ثانیه‌ای با آلارم قرمز؛ مدیر در جلسه زنده هیئت مدیره است و کاربر باید با چیدن ۳ بلوک پرامپت، جلوی ارائه عدد توهمی را بگیرد. (پاداش: ۲ جان + ۱ بوستر). 2. **Token Match-3 (جورچین پرامپت):** ترکیب ۳ تکه منطقی (نقش + فیلتر + فرمت خروجی) در کمتر از ۶۰ ثانیه. 3. **Word Golf (برش کلمات):** حذف کلیکی کلمات زائد متن برای کاهش طول پرامپت. --- ## ۵. راهکارهای ویژه حل چالش‌های سازمانی ### ۵.۱. سیستم جبران عقب‌ماندگی (Catch-up Mechanism for Late Joiners) * **مسئله:** کارمندی که از هفته ۳ وارد بازی می‌شود فکر می‌کند هیچ شانسی برای رقابت ندارد. * **راهکار:** فعال شدن خودکار نشان **«Catch-up Boost»**؛ تمامی مراحل هفته‌های قبل برای این کاربر با **ضریب ۲X امتیاز (Double XP)** محاسبه می‌شود و زمان مراحل اول کوتاه‌تر شده تا در کمتر از ۴۵ دقیقه به هفته جاری برسد. ### ۵.۲. سیستم رتبه‌بندی دو لایه‌ای (Fair Dual-Leaderboard) 1. **لیدربورد هفتگی دپارتمانی (Weekly League):** ریست هفتگی؛ هر دپارتمان شانس برنده شدن در همان هفته را دارد. $$\text{Department Score} = \frac{\sum \text{XP of Department Members}}{\text{Active Department Headcount}}$$ *(تقسیم بر تعداد نفرات فعال باعث می‌شود دپارتمان‌های کم‌جمعیت مثل مالی با دپارتمان‌های پرجمعیت مثل پشتیبانی رقابت کاملاً برابر و عادلانه داشته باشند).* 2. **لیدربورد کل سیزن (Hall of Fame):** رده‌بندی انفرادی پرسنل بر اساس مهارت، سرعت و تعداد اهدای اسکیل به دیگران. ### ۵.۳. ربات همراه هوشمند و شوخ‌طبع (Happy AI Companion) * ایجنت شناور درون برنامه با کاراکتر دوستانه و لحن خودمانی. * **وظایف:** * پاسخ به سوالات پرامپت‌نویسی بدون افشای جواب مستقیم. * روحیه دادن و تعریف جوک‌های مربوط به هوش مصنوعی برای شکستن یخ پرسنل. * یادآوری زنجیره روزانه (Streak) به زبان فان. --- ## ۶. تفکیک سناریوهای اختصاصی ۶ دپارتمان سازمانی | دپارتمان | سناریوی داده‌ای مراحل | ارزش افزوده عملیاتی برای شرکت | |---|---|---| | **مارکتینگ و محتوا** | مهندسی معکوس بنرهای کمپین، تولید ۵ کپی تبلیغاتی پرسونامحور، تحلیل هشتگ‌ها | افزایش ۵ برابری سرعت ایده‌پردازی و تدوین تقویم محتوایی | | **فنی و محصول** | کاهش توکن پرامپت‌های سیستمی، تولید مستندات Swagger و تبدیل لاگ‌ها به باگ | صرفه‌جویی شدید در هزینه‌های توکن API و تسریع داکیومنت‌نویسی | | **عملیات و پشتیبانی** | استخراج داده‌های آشفته کنسلی، پاسخ‌دهی به مشتریان خشمگین با هوش هیجانی | خودکارسازی دسته‌بندی تیکت‌ها و کاهش میانگین زمان پاسخ (FRT) | | **مالی و حقوقی** | شکار توهم در آیین‌نامه‌ها، فرمول‌نویسی محاسبه مالیات، ممیزی بندهای پرریسک قرارداد | به صفر رساندن خطای انسانی در گزارشات مالی و بررسی قراردادها | | **منابع انسانی (HR)** | نگارش ایمیل‌های فیدبک مصاحبه، تحلیل نیازسنجی آموزش و تدوین شرح شغل | ایجاد لحن استاندارد و همدلانه در ارتباطات سازمانی و استخدام | --- ## ۷. سیستم نشان‌ها و نشانگرهای افتخار (Custom Badges) * **Prompt Master:** کسب ۳ ستاره در ۳ چالش متوالی (نمایش تاج طلایی روی آواتار). * **Squad Lifesaver:** اهدای ۱۰ جان یا اسکیل به همکاران دپارتمان. * **Token Assassin:** فشرده‌سازی پرامپت تا ۵۰٪ بدون افت کیفیت خروجی. * **Streak Legend:** حضور پیوسته در تمام ۶ هفته بدون استفاده از Freeze. * **Custom GPT Hero:** ساخت ایجنتی که توسط بیش از ۲۰ همکار در شرکت استفاده شود. --- ## ۸. معماری فنی پیشنهادی برای پیاده‌سازی (Full-Stack Tech Blueprint) ``` [ Frontend: Next.js 14 / Tailwind CSS / Vazirmatn / Lucide Icons / Canvas-Confetti ] │ ▼ [ API Gateway & Auth: FastAPI (Python) / SSO OAuth2 (Google/Slack/LDAP) ] │ ┌─────────────────┴─────────────────┐ ▼ ▼ [ PostgreSQL (User, State, XP, Squads) ] [ Redis (Real-time Leaderboard & Rate Limit) ] │ ▼ [ Multi-Judge AI Engine ] ├── 1. LLM-as-a-Judge (LiteLLM / OpenAI / Claude) ──► داوری کیفیت پرامپت و لحن ├── 2. Vision Matcher (CLIP / Gemini Flash) ──► مقایسه شباهت تصاویر بنرها ├── 3. JSON Schema & Regex Validator ──► سنجش ساختار دیتا و تست PII └── 4. Sandboxed Code Runner (Python/Excel) ──► اعتبارسنجی فرمول‌های ریاضی ``` --- ## ۹. پروتکل ارزیابی و تعریف موفقیت (Success Metrics & KPIs) 1. **نرخ مشارکت هفتگی (Weekly Active Users):** بالای ۸۵٪ در تمام ۶ هفته. 2. **پذیرش ابزارهای AI در کار واقعی:** ساخته شدن حداقل ۵۰ ایجنت شرکتی در هفته ششم در مارکت‌پلیس داخلی. 3. **شاخص رضایت پرسنل (eNPS):** افزایش حس امنیت شغلی و انگیزه کارمندان در مواجهه با ابزارهای هوش مصنوعی. 4. **زمان صرف‌شده:** حداکثر ۶۰ دقیقه در هفته برای هر پرسنل با پایبندی کامل به زمان‌بندی اداری. --- > **نکته برای ایجنت پیاده‌ساز:** دموهای تعاملی کامل این سند در فایل‌های HTML زیر در دایرکتوری جاری در دسترس و تست‌شده هستند: > * `ai_odyssey_royal_grandmaster.html` (نسخه نهایی یکپارچه با ویدیو، ربات هپی، اسکوادها و سگا مپ) > * `royal_match_ai_demo.html` (نسخه اختصاصی مینی‌گیم‌ها و اتاق همکاری) > * `executive_gamification_demo.html` (نسخه سندباکس و سوییچ دپارتمان)