# مشخصات درس‌نامه: نگاه کلی به دوره (Course Overview)
- **شناسه در سیلابس:** `L1.2`
- **فصل:** فصل ۱: مقدمه (Ch 1)
- **نوع محتوا:** 📘 درس‌نامه متنی
- **زمان تقریبی مطالعه:** ۱۲ دقیقه
- **پیش‌نیازهای مستقیم:** `L1.1` (پیش‌گفتار)

---

## ۱. اهداف یادگیری (Learning Objectives - Bloom's Taxonomy)
دانشجو پس از مطالعهٔ این درس‌نامه باید بتواند:
- [ ] **درک کند (Understand):** چهار ستون توانمندی که در طول این ۱۶ فصل به دست می‌آورد چه هستند.
- [ ] **درک کند (Understand):** چرا وایب کدینگ یک تغییر پارادایم واقعی در مهندسی نرم‌افزار است (سه ستون سرعت، دموکراتیزه شدن توسعه، و متدولوژی مشخصات‌محور SDD).
- [ ] **تحلیل/ارزیابی کند (Evaluate):** تفاوت بین کدنویسی سنتی، کدنویسی کمکی با AI (Copilot-style) و وایب کدینگ ایجنتیک (Agentic Vibe Coding) را درک و تحلیل کند.
- [ ] **درک کند (Understand):** ساختار کلی ۱۶ فصل دوره در قالب ۵ فاز طبیعی، و نقش پروژه‌های نقطهٔ عطف (فصل‌های ۸ و ۱۴) در تثبیت یادگیری چیست.
- [ ] **به‌کار ببندد (Apply):** پیش‌نیازهای دوره و ریتم زمانی مناسب برای پیشروی بدون افت یادگیری را تنظیم کند.

---

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

### آنچه باید پوشش داده شود (In-Scope):
1. **هدف کلان دوره:** تبدیل دانشجو به یک ارکستراتور و سازندهٔ محصول که می‌تواند ایده را تا انتشار زنده اینترنتی هدایت کند.
2. **چهار توانمندی خروجی:**
   * درک بنیادین وب و ساختار محصول بدون کدنویسی خط‌به‌خط.
   * طراحی فرانت‌اند و تجربه کاربری شیک با هدایت AI.
   * مدیریت داده، اتصال پایگاه داده ابری و سرویس‌های کاربردی.
   * دیباگ، تست، امنیت و انتشار پایدار مانند یک تیم استارتاپی.
3. **چرا وایب کدینگ (Why Vibe Coding):** بررسی سه رکن اساسی تحول (سرعت ساخت، کنترل کیفیت با مشخصات، و تمرکز روی مسئله به‌جای جزئیات نحوی).
4. **جعبهٔ کال‌اوت Quera (`<details class="violet">`):** بیشتر بدانید در مورد تفاوت کدنویسی سنتی، کدنویسی با هوش مصنوعی و وایب کدینگ ایجنتیک.
5. **نقشهٔ ۱۶ فصل در ۵ فاز کلی:**
   * فاز ۱: ذهنیت و محیط کار (فصل‌های ۲ و ۳)
   * فاز ۲: از ایده تا پروتوتایپ کاربری (فصل‌های ۴ تا ۶)
   * فاز ۳: داده، بک‌اند و نقطهٔ عطف پروژه ۱ (فصل‌های ۷ و ۸)
   * فاز ۴: کیفیت، سرویس‌ها و امنیت (فصل‌های ۹ تا ۱۱)
   * فاز ۵: انتشار، نگهداری، تکامل محصول و آینده (فصل‌های ۱۲ تا ۱۶)
6. **مرور فشرده و جذاب تک‌تک فصول (فصل ۲ تا فصل ۱۶):** خلاصه یک‌بنده‌ای از آنچه در هر ایستگاه فراگرفته می‌شود.
7. **پیش‌نیازها و ریتم یادگیری:** کامپیوتر، مرورگر مدرن، اکانت AI و توصیه به پرهیز از وقفهٔ طولانی بین فصل‌ها.

### آنچه نباید وارد آن شویم (Out-of-Scope):
- ورود به آموزش نحوه نوشتن پرامپت یا قواعد آن (مربوط به درس ۲.۶).
- راه‌اندازی ادیتور یا ساخت اکانت در ابزارها (مربوط به فصل ۳).
- جزئیات فرمت آزمون‌های تستی یا گواهی دوره (در درس‌های ۱.۳ و ۱.۴ پوشش داده می‌شود).

---

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

| اصطلاح انگلیسی | معادل فارسی مصوب | توضیح یک‌خطی ساده |
| :--- | :--- | :--- |
| Spec-Driven Development (SDD) | توسعهٔ مشخصات‌محور | متدولوژی مهندسی که در آن پیش از تولید کد توسط AI، مشخصات دقیق مکتوب و تایید می‌شود |
| Orchestrator | ارکستراتور / هماهنگ‌کننده | نقش جدید انسان در هدایت هم‌زمان چند ایجنت هوش مصنوعی برای خلق محصول |
| Prototype | پروتوتایپ / پیش‌نمونه | نمونهٔ اولیه از محصول برای بررسی ظاهر و کارکرد قبل از تکمیل نهایی |
| Full-Stack Product | محصول فول‌استک | محصولی شامل رابط کاربری (فرانت‌اند)، منطق سرور (بک‌اند) و پایگاه داده |

---

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

1. **تصویر کاور درس:** `images/cover.png`
   * **موضوع:** کاور باکیفیت و جذاب نگاه کلی به نقشهٔ راه دوره وایب کدینگ با تم تیرهٔ کوئرا.
2. **ارزش‌ها و ارکان وایب کدینگ:** `images/value-props.png`
   * **موضوع:** اینفوگرافیک سه‌بخشی یا شش کارته از ستون‌های قدرت وایب کدینگ (سرعت ساخت، حذف بن‌بست‌های کدنویسی، تکرار سریع، تمرکز بر محصول).
3. **اکوسیستم ابزارهای دوره:** `images/ecosystem.png`
   * **موضوع:** نمایش ابزارهای کلیدی که در طول دوره با آن‌ها کار می‌شود (Cursor, Claude Code, Lovable, GitHub, Supabase, Vercel).
4. **مقایسه پارادایم‌های برنامه‌نویسی:** `images/traditional-vs-vibe.png` (داخل جعبه violet)
   * **موضوع:** مقایسهٔ ۳ ستونه: کدنویسی سنتی (دستی) | برنامه‌نویسی کمکی با AI (Copilot) | وایب کدینگ ایجنتیک (هدایت مشخصات‌محور).
5. **نقشهٔ راه کلان دوره در ۵ فاز:** `images/roadmap.png`
   * **موضوع:** فلوچارت بزرگ و افقی ۵ مرحله‌ای مسیر یادگیری از مبانی تا استقرار کامل پروژه نهایی.
6. **پیش‌نیازهای دوره:** `images/prerequisites.png`
   * **موضوع:** نمایش ساده دو پیش‌نیاز اصلی دوره: مهارت کار با کامپیوتر و اینترنت + ذهنیت حل مسئله (بدون نیاز به کدنویسی).

---

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

مطابق با الگوی درس نگاه کلی به دوره در FastAPI:
1. **تیتر اصلی:** `# نگاه کلی به دوره`
2. **جدول کاور:**
   ```markdown
   | ![کاور درس‌نامهٔ نگاه کلی به دوره](./images/cover.png) |
   | :-: |
   ```
3. **هدف اصلی دوره و دستاوردهای چهارگانه:** تعریف مأموریت دوره و ۴ بالت‌پوینت برجسته از قابلیت‌های دانشجو.
4. **بخش چرایی (`## چرا وایب کدینگ`):** تحلیل عمیق ۳ رکن وایب کدینگ به همراه نمودارهای `value-props.png` و `ecosystem.png`.
5. **باکس بیشتر بدانید کوئرا:**
   ```html
   <details class="violet">
   <summary>**بیشتر بدانید: از کدنویسی سنتی تا وایب کدینگ ایجنتیک**</summary>

   توضیح تحول مهندسی نرم‌افزار و تفاوت آن با اتوکامپلیت‌های ساده کد...
   | ![مقایسهٔ کدنویسی سنتی و وایب کدینگ](./images/traditional-vs-vibe.png) |
   | :-: |

   </details>
   ```
6. **بخش نقشهٔ راه کلان (`## مسیر دوره در یک قاب`):** همراه با نمودار `roadmap.png` و تفکیک ۵ فاز آموزشی.
7. **معرفی سرفصل‌های فصول (فصل ۲ تا فصل ۱۶):**
   * `## شروع مسیر Vibe Coding` (فصل ۲)
   * `## راه‌اندازی محیط کار` (فصل ۳)
   * `## از ایده تا محصول` (فصل ۴)
   * `## طراحی تجربه و هویت محصول` (فصل ۵)
   * `## آماده‌سازی Prototype` (فصل ۶)
   * `## داده و بک‌اند` (فصل ۷)
   * `## پروژه ۱: ساخت پروتوتایپ و اتصال دیتابیس` (فصل ۸ - نقطهٔ عطف ۱)
   * `## تست و Debugging` (فصل ۹)
   * `## اتصال سرویس‌های بیرونی` (فصل ۱۰)
   * `## امنیت و استفاده مسئولانه` (فصل ۱۱)
   * `## انتشار روی اینترنت` (فصل ۱۲)
   * `## نگهداری محصول` (فصل ۱۳)
   * `## پروژه ۲: استقرار محصول واقعی و امن` (فصل ۱۴ - نقطهٔ عطف ۲)
   * `## تکامل محصول با AI` (فصل ۱۵)
   * `## ادامه راه و مهندسی ایجنتیک` (فصل ۱۶)
8. **بخش پیش‌نیازها و ریتم یادگیری:** همراه با نمودار `prerequisites.png` و تاکید بر تمرین پیوسته.
9. **پاراگراف پایانی:** انتقال به درس‌نامه بعدی («قالب کوئرا کالج»).

---

## ۶. معیارهای پذیرش درس‌نامه (Acceptance Criteria Checklist)
- [ ] ساختار ۱۶ فصل و ۵ فاز کلان دوره با فایل نهایی سیلابس [curriculum/syllabus.md](file:///d:/Quera%20College/Vibe%20Coding/curriculum/syllabus.md) انطباق ۱۰۰٪ داشته باشد.
- [ ] جدول کاور و تمام ۵ نمودار متناظر به زیبایی در `images/` قرار گرفته و در جدول‌های وسط‌چین درج شوند.
- [ ] باکس `<details class="violet">` برای مقایسه پارادایم‌های برنامه‌نویسی استفاده شود.
- [ ] لحن متن منسجم، هدایت‌کننده و متناسب با استانداردهای نگارشی کوئرا باشد.
- [ ] پل انتقال به درس‌نامهٔ بعدی (`L1.3: قالب کوئرا کالج`) در انتها قید شده باشد.