docs: add Magic Wallet spec & implementation plan

- New folder: roadmap/ for upcoming features
- MAGIC-WALLET-SPEC: full business rules, state machine, x2.5 multiplier,
  100M deposit cap, API flow, data model changes, transaction logging
- MAGIC-WALLET-PLAN: 6-phase implementation, checklist, time estimates
- Note: ChargeDiscountWallet completion is independent (not Magic Wallet)
- Note: WalletChangeLog is mandatory (not optional)
- Updated master index with roadmap section

overview/OVERVIEW-02-INDEX.md

@@ -3,7 +3,7 @@
 > **فهرست کامل ۱۵ فایل مستند پروژه FourSat (کارا بازار سلامت)**  
 > **تاریخ تجمیع:** اسفند ۱۴۰۴  
 > **تعداد فایل‌های مبدأ:** ۵۳ فایل (~۳۲,۰۰۰ خط)  
-> **تعداد فایل‌های نهایی:** ۱۵ فایل
+> **تعداد فایل‌های نهایی:** ۱۷ فایل (۱۵ اصلی + ۲ roadmap)
 
 ---
 
@@ -25,12 +25,16 @@ totalDoc/
 │   ├── TECH-04-MIGRATION.md                مهاجرت داده
 │   └── TECH-05-API-INTEGRATION.md          API و یکپارچه‌سازی
 │
-└── 📁 overview/   (نمای کلان — ۵ فایل)
-    ├── OVERVIEW-01-FLOWCHARTS.md           فلوچارت‌ها و دیاگرام‌ها
-    ├── OVERVIEW-02-INDEX.md                ← همین فایل
-    ├── OVERVIEW-03-CHANGELOG.md            تاریخچه و درصد تکمیل
-    ├── OVERVIEW-04-GLOSSARY.md             واژه‌نامه و استانداردها
-    └── OVERVIEW-05-ROADMAP.md              نقشه راه و ریسک‌ها
+├── 📁 overview/   (نمای کلان — ۵ فایل)
+│   ├── OVERVIEW-01-FLOWCHARTS.md           فلوچارت‌ها و دیاگرام‌ها
+│   ├── OVERVIEW-02-INDEX.md                ← همین فایل
+│   ├── OVERVIEW-03-CHANGELOG.md            تاریخچه و درصد تکمیل
+│   ├── OVERVIEW-04-GLOSSARY.md             واژه‌نامه و استانداردها
+│   └── OVERVIEW-05-ROADMAP.md              نقشه راه و ریسک‌ها
+│
+└── 📁 roadmap/    (فیچرهای جدید — در حال توسعه)
+    ├── MAGIC-WALLET-SPEC.md                مشخصات کیف‌پول جادویی
+    └── MAGIC-WALLET-PLAN.md                پلن پیاده‌سازی + checklist
 ```
 
 ---
@@ -67,6 +71,13 @@ totalDoc/
 | O4 | [OVERVIEW-04-GLOSSARY](OVERVIEW-04-GLOSSARY.md) | واژه‌نامه | اصطلاحات فارسی/انگلیسی، استانداردهای کد |
 | O5 | [OVERVIEW-05-ROADMAP](OVERVIEW-05-ROADMAP.md) | نقشه راه | ریسک‌ها، وابستگی‌ها، کارهای باقیمانده، اولویت‌ها |
 
+### 🪄 Roadmap (فیچرهای جدید)
+
+| # | فایل | موضوع | خلاصه |
+|---|------|--------|--------|
+| R1 | [MAGIC-WALLET-SPEC](../roadmap/MAGIC-WALLET-SPEC.md) | کیف‌پول جادویی — مشخصات | State Machine، ضریب ×2.5، سقف 100M، قوانین، API، مدل داده |
+| R2 | [MAGIC-WALLET-PLAN](../roadmap/MAGIC-WALLET-PLAN.md) | کیف‌پول جادویی — پلن | ۶ فاز، checklist، تخمین زمان، وابستگی ChargeDiscountWallet |
+
 ---
 
 ## نقشه ارتباط فایل‌ها