ehsan-dashboards/dashboards/old_hermes/AI_GAMIFICATION_GDD.md

179 lines
19 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# سند جامع طراحی بازی و محصول (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` (نسخه سندباکس و سوییچ دپارتمان)