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