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

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