# مشخصات درس‌نامه: انتظارات واقع‌بینانه و هزینه (Realistic Expectations & Costs)
- **شناسه در سیلابس:** `L2.5`
- **فصل:** فصل ۲: شروع مسیر Vibe Coding (Ch 2)
- **نوع محتوا:** 📘 درس‌نامه متنی
- **زمان تقریبی مطالعه:** ۱۰ دقیقه
- **پیش‌نیازهای مستقیم:** `L2.4` (ابزارها: Cursor, Claude Code, Codex, Lovable & Bolt)

---

## ۱. اهداف یادگیری (Learning Objectives - Bloom's Taxonomy)
دانشجو پس از مطالعهٔ این درس‌نامه باید بتواند:
- [ ] **تحلیل/ارزیابی کند (Evaluate):** نقاط قوت خارق‌العاده هوش مصنوعی (سرعت ساخت، تولید کدهای پایه، رفع باگ‌های متداول) را از تله‌ها و نقاط کور آن (فراموشی معماری کلی، باگ‌های منطقی پنهان، خطاهای امنیتی) تفکیک کند.
- [ ] **درک کند (Understand):** ساختار مدل‌های قیمت‌گذاری جهانی ابزارهای وایب کدینگ (پلن‌های رایگان محدود، اشتراک‌های ماهانه ثابت ۲۰ دلاری، و هزینه‌های بر پایه مصرف API) چگونه کار می‌کند.
- [ ] **به‌کار ببندد (Apply):** راهکارهای اقتصادی و بهینه‌سازی هزینه را برای یادگیری و ساخت پروژه‌ها در شرایط ایران به کار بگیرد (مدیریت بهینه سهمیه‌های رایگان، استفاده از کلیدهای API مصرف‌محور، پلتفرم‌های واسط تجمیع‌کننده مثل OpenRouter).
- [ ] **به‌کار ببندد (Apply):** نکات احتیاطی در تعامل با سرویس‌های بین‌المللی هوش مصنوعی (مدیریت آی‌پی ثابت و تحریم‌شکن‌ها جهت پیشگیری از مسدودی حساب) را رعایت کند.

---

## ۲. محدوده و مرزهای محتوا (Scope & Boundaries)

### آنچه باید پوشش داده شود (In-Scope):
1. **تنظیم انتظارات: هوش مصنوعی کجاست که می‌درخشد؟ (Superpowers):**
   * تبدیل طرح ذهنی و پرامپت متنی به کامپوننت‌های فرانت‌اند در چند ثانیه.
   * تولید کدهای خسته‌کننده تکراری (Boilerplate).
   * ترجمه مفاهیم به استانداردهای مدرن وب.
   * توضیح خطاهای نامفهوم ترمینال و دیتابیس به زبان فارسی و ساده.
2. **نقاط کور و تله‌های پنهان (Blindspots & Traps):**
   * توهم تسلط: هوش مصنوعی ممکن است کدی بنویسد که در نگاه اول زیباست اما دکمه‌ها کار نمی‌کنند یا داده در پایگاه ذخیره نمی‌شود.
   * باگ‌های پنهان لبه‌ای (Edge Cases): نادیده گرفتن سناریوهای خاص کاربری (مثل ورودی خالی، قطعی اینترنت، داده تکراری).
   * آسیب‌پذیری‌های امنیتی: نشت کلیدهای محرمانه و عدم اعتبارسنجی ورودی‌ها در صورت غفلت کاربر.
3. **مدل‌های قیمت‌گذاری ابزارها (The Economics of AI Tools):**
   * **پلن‌های رایگان (Free Tiers):** سهمیه‌های روزانه یا ماهانه در Cursor و Lovable که برای شروع و یادگیری کافی است.
   * **اشتراک‌های ماهانه ثابت (The $20/mo Flat Rate):** مدل استاندارد جهانی (مانند Cursor Pro یا Claude Pro) با دسترسی نامحدودتر به مدل‌های برتر (Claude 3.5 Sonnet / GPT-4o).
   * **مدل مصرف‌محور (Pay-As-You-Go API):** پرداخت تنها به ازای توکن‌های مصرف‌شده، بسیار به‌صرفه برای پروژه‌های با حجم متوسط یا مقطعی.
4. **واقعیت‌های بومی و راهکارهای کاربردی برای مخاطب ایرانی:**
   * چگونه بدون هزینه‌های دلاری سنگین کل دوره را با سهمیه‌های رایگان و بهینه طی کنیم.
   * سرویس‌های تجمیع‌کننده API (نظیر OpenRouter یا ارائه‌دهندگان معتبر محلی) برای دسترسی شارژی و خرد بدون نیاز به کردیت‌کارت خارجی.
   * مدیریت IP پایدار: ضرورت پرهیز از سوییچ مداوم لوکیشن‌های مختلف VPN حین کار با سرویس‌هایی چون Anthropic Claude جهت جلوگیری از فریز شدن اکانت.
5. **کال‌اوت‌های Quera:**
   * `<details class="violet">`: مقایسه مدل اشتراک ثابت در برابر مدل شارژی API؛ کدام در شروع یادگیری برای شما اقتصادی‌تر است؟
   * `<details class="red">`: هشدار بسیار مهم درباره پایداری شبکه و IP هنگام کار با ایجنت‌ها برای محافظت از اطلاعات و حساب‌ها.

### آنچه نباید وارد آن شویم (Out-of-Scope):
- آموزش خرید ارز دیجیتال یا راه‌اندازی کارت‌های مجازی و صرافی‌ها.
- محاسبات دقیق ریاضی هزینه‌های تجاری در مقیاس‌های انترپرایز میلیونی.

---

## ۳. مفاهیم کلیدی و کلمات تخصصی (Key Concepts & Terms)

| اصطلاح انگلیسی | معادل فارسی مصوب | توضیح یک‌خطی ساده |
| :--- | :--- | :--- |
| Free Tier Quota | سهمیه رایگان دوره‌ای | تعداد مشخصی از درخواست‌ها و پرامپت‌ها که سرویس‌ها به رایگان در اختیار کاربر قرار می‌دهند |
| Pay-As-You-Go | پرداخت بر پایه مصرف | مدلی که در آن فقط هزینه توکن‌های واقعی مصرف‌شده توسط کاربر کسر می‌شود |
| Edge Case | حالت مرزی و استثنایی | شرایط غیرمعمول یا خطایی در نرم‌افزار که معمولاً توسط هوش مصنوعی نادیده گرفته می‌شود |
| IP Consistency | ثبات آدرس اینترنتی | حفظ یک لوکیشن پایدار برای ممانعت از ایجاد حساسیت و بلاک شدن توسط سیستم‌های امنیتی هوش مصنوعی |
| API Aggregator | تجمیع‌کننده واسط مدل‌ها | پلتفرم‌هایی (مانند OpenRouter) که دسترسی متمرکز به ده‌ها مدل مختلف را با یک موجودی واحد فراهم می‌کنند |

---

## ۴. جایگاه‌های تصاویر و نمودارها (Visual & Diagram Placeholders)
> **راهنمای ایجنت نویسنده:** تمام تصاویر باید در پوشهٔ `images/` قرار گرفته و در قالب جدول تک‌خانه‌ای وسط‌چین با کپشن تفصیلی درج شوند:

1. **تصویر کاور درس:** `images/cover.png`
   * **موضوع:** کاور با تم تیره و مینیمال که ترازوی دیجیتالی را نشان می‌دهد؛ یک کفه سرعت خارق‌العاده و کفه دیگر انتظارات واقع‌بینانه و مدیریت هزینه.
2. **نقاط قوت در برابر تله‌های پنهان هوش مصنوعی:** `images/superpowers-vs-traps.png`
   * **موضوع:** اینفوگرافیک مقایسه‌ای دورنگ؛ ستون سبز (کجا هوش مصنوعی جادو می‌کند) در برابر ستون زرد/قرمز (کجا هوش مصنوعی بدون ناظر انسان لغزش دارد).
3. **مثلث مقایسه مدل‌های مالی:** `images/pricing-models.png`
   * **موضوع:** تصویر شماتیک سه رویکرد اقتصادی: پلن‌های رایگان (Free Tier)، اشتراک ثابت ماهیانه ($20 Flat Rate)، و پرداخت به ازای مصرف (API Tokens).
4. **راهنمای هوشمندانه برای کاربر ایرانی:** `images/iran-accessibility-toolkit.png`
   * **موضوع:** اینفوگرافیک گام‌های طلایی: استفاده هوشمند از سهمیه‌های رایگان، اکانت‌های تجمیعی API، و پایداری آی‌پی برای جلوگیری از بن شدن.
5. **تکنیک‌های بهینه‌سازی مصرف توکن و هزینه:** `images/token-optimization.png`
   * **موضوع:** چرخه چک‌لیست کاربر برای جلوگیری از هدررفت درخواست‌ها: پرامپت شفاف $\rightarrow$ ریست به موقع سشن $\rightarrow$ عدم ارسال فایل‌های غیرمرتبط.

---

## ۵. بخش‌بندی و ساختار محتوایی پیشنهادی درس‌نامه (`README.md`)

1. **تیتر اصلی:** `# انتظارات واقع‌بینانه و هزینه`
2. **مقدمه ملموس:** گذر از هیاهوی تبلیغاتی (Hype) به دنیای واقعی مهندسی محصول با هوش مصنوعی.
3. **جدول کاور درس**
4. **نقاط قوت خیره‌کننده: هوش مصنوعی کجا شگفت‌انگیز است؟:** ۴ کارکرد طلایی که سرعت شما را ۱۰ برابر می‌کند.
5. **نقاط کور و پرتگاه‌ها: مراقب چه چیزهایی باشیم؟:** خطاهای پنهان، شکست‌های منطقی و مسئولیت نهایی سازنده.
6. **مدل‌های قیمت‌گذاری جهانی ابزارها:** تشریح مدل ۲۰ دلاری، سهمیه‌های رایگان و توکن‌های بر پایه مصرف.
7. **باکس نکته Quera (`<details class="violet">`):** کدام مدل پرداختی برای شروع یادگیری شما مناسب‌تر و اقتصادی‌تر است؟
8. **جعبه‌ابزار کاربر ایرانی: یادگیری هوشمندانه و بدون دغدغه:** راهکارهای مدیریت سهمیه‌ها و دسترسی پایدار.
9. **باکس هشدار Quera (`<details class="red">`):** ریسک‌های تغییر آی‌پی و راهکارهای جلوگیری از بسته شدن دسترسی ابزارها.
10. **چک‌لیست کاهش مصرف و صرفه‌جویی:** ۵ ترفند طلایی برای استفاده حداکثری از امکانات رایگان.
11. **جمع‌بندی درس‌نامه:** مدیریت هوشمندانه منابع و ابزارها برای ساخت پایدار پروژه‌ها.

---

## ۶. معیارهای پذیرش (Acceptance Criteria for Reviewer)
- [ ] مرز بین توانایی‌های واقعی AI و محدودیت‌های آن شفاف و بدون غلو ترسیم شده باشد.
- [ ] مدل‌های مالی اشتراکی، مصرفی و رایگان بدون ابهام تفکیک شده باشند.
- [ ] راهکارهای بومی و قابل اجرا برای مخاطب ایرانی بدون توصیه به روش‌های پرخطر ارائه شده باشد.
- [ ] چک‌لیست عملی برای صرفه‌جویی در درخواست‌ها و جلوگیری از هدررفت توکن‌ها در متن وجود داشته باشد.