feat: add chapter 02-vibe-coding-mindset specs

chapters/02-vibe-coding-mindset/04-lesson-expectations-and-costs/spec.md

@@ -0,0 +1,97 @@
+# مشخصات درس‌نامه: انتظارات واقع‌بینانه و هزینه (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 و محدودیت‌های آن شفاف و بدون غلو ترسیم شده باشد.
+- [ ] مدل‌های مالی اشتراکی، مصرفی و رایگان بدون ابهام تفکیک شده باشند.
+- [ ] راهکارهای بومی و قابل اجرا برای مخاطب ایرانی بدون توصیه به روش‌های پرخطر ارائه شده باشد.
+- [ ] چک‌لیست عملی برای صرفه‌جویی در درخواست‌ها و جلوگیری از هدررفت توکن‌ها در متن وجود داشته باشد.