feat: add chapter 01-introduction specs

.agents/rules/sdd-workflow.md

@@ -29,15 +29,15 @@
 
 3. **تفکیک مسئولیت پوشه‌ها:**
    هر درس‌نامه یا تمرین در پوشهٔ اختصاصی خود در ساختار زیر قرار می‌گیرد:
-   - **درس‌نامه:** `chapters/ch<XX>-<name>/<YY>-<lesson-slug>/`
+   - **درس‌نامه:** `chapters/<XX>-<name>/<YY>-<lesson-slug>/`
      - `spec.md` (مشخصات و اهداف یادگیری)
      - `README.md` (متن نهایی درس‌نامه کوئرا کالج)
-   - **تمرین داوری:** `chapters/ch<XX>-<name>/<YY>-<exercise-slug>/`
+   - **تمرین داوری:** `chapters/<XX>-<name>/<YY>-<exercise-slug>/`
      - `spec.md` (مشخصات ورودی/خروجی، سناریو، سنجه‌های داوری)
      - `problem.md` (صورت مسئله برای دانشجو)
      - `initial/` (کد و اسکلت اولیه)
      - `solution/` (پاسخ مرجع و بهینه)
      - `tests/` (مجموعه تست‌های داوری خودکار)
-   - **تمرین تستی:** `chapters/ch<XX>-<name>/<YY>-<quiz-slug>/`
+   - **تمرین تستی:** `chapters/<XX>-<name>/<YY>-<quiz-slug>/`
      - `spec.md` (مشخصات مفهومی و توزیع گزینه‌ها)
      - `questions.json` یا `questions.md` (صورت سوال، گزینه‌ها، پاسخ صحیح و تحلیل گزینه‌های گمراه‌کننده)

.agents/skills/course-sdd-planner/SKILL.md

@@ -13,7 +13,7 @@ description: >-
 
 ## ساختار فایل `spec.md` برای درس‌نامه‌ها
 
-هر درس‌نامه باید در مسیر `chapters/ch<XX>-<name>/<YY>-<slug>/spec.md` دارای این قالب باشد:
+هر درس‌نامه باید در مسیر `chapters/<XX>-<name>/<YY>-<slug>/spec.md` دارای این قالب باشد:
 
 ```markdown
 # مشخصات درس‌نامه: [عنوان درس‌نامه]

.agents/skills/quera-lesson-author/SKILL.md

@@ -18,7 +18,7 @@ description: >-
 هر درس‌نامه در پوشهٔ اختصاصی خود درون فصل مربوطه قرار دارد و باید شامل فایل متن درس‌نامه و پوشهٔ تصاویر اختصاصی باشد:
 
 ```text
-chapters/ch<XX>-<name>/<YY>-<lesson-slug>/
+chapters/<XX>-<name>/<YY>-<lesson-slug>/
 ├── spec.md           # سند مشخصات و قرارداد یادگیری درس (ورودی ایجنت)
 ├── README.md         # متن کامل درس‌نامه کوئرا کالج (خروجی نهایی ایجنت)
 └── images/           # پوشهٔ اختصاصی تصاویر، نمودارها و دیاگرام‌های درس

chapters/01-introduction/01-foreword/spec.md

@@ -0,0 +1,93 @@
+# مشخصات درس‌نامه: پیش‌گفتار (Foreword)
+- **شناسه در سیلابس:** `L1.1`
+- **فصل:** فصل ۱: مقدمه (Ch 1)
+- **نوع محتوا:** 📘 درس‌نامه متنی
+- **زمان تقریبی مطالعه:** ۸ دقیقه
+- **پیش‌نیازهای مستقیم:** ندارد (نقطهٔ ورود به دوره)
+
+---
+
+## ۱. اهداف یادگیری (Learning Objectives - Bloom's Taxonomy)
+دانشجو پس از مطالعهٔ این درس‌نامه باید بتواند:
+- [ ] **درک کند (Understand):** پارادایم وایب کدینگ چیست و چگونه امکان ساخت نرم‌افزارهای واقعی را بدون نیاز به دانش قبلی برنامه‌نویسی فراهم می‌کند.
+- [ ] **درک کند (Understand):** مخاطبان هدف دوره چه کسانی هستند (طراحان، مدیران محصول، کارآفرینان و افراد نوآور) و این دوره چه نیازی از آن‌ها را برطرف می‌کند.
+- [ ] **به‌کار ببندد (Apply):** ذهنیت هدایت هوش مصنوعی (مدیر پروژه / پروداکت اونر) را در برابر کدنویسی دستی سنتی درک و اتخاذ کند.
+- [ ] **تحلیل/ارزیابی کند (Evaluate):** تمایز بین خروجی اسباب‌بازی (Toy Project) و یک محصول واقعی و قابل‌انتشار (Deployable MVP) که هدف این دوره است را ارزیابی کند.
+
+---
+
+## ۲. محدوده و مرزهای محتوا (Scope & Boundaries)
+
+### آنچه باید پوشش داده شود (In-Scope):
+1. **قلاب داستانی (Hook):** مقایسه تجربه روزمره استفاده از محصولات نرم‌افزاری با امکان ساخت واقعی آن‌ها در عصر هوش مصنوعی.
+2. **معرفی وایب کدینگ:** تعریف ساده و الهام‌بخش ساخت محصول با کمک ایجنت‌های هوش مصنوعی (توصیف، هدایت، مشاهده، بازخورد).
+3. **مخاطبان دوره:** تفکیک روشن گروه‌های مخاطب (طراحان UI/UX، مدیران محصول، کارآفرینان، بازاریاب‌ها و علاقه‌مندان بدون پیش‌زمینه فنی).
+4. **روش یادگیری پلکانی:** یادگیری از طریق ساختن و دیدن خروجی زنده در هر گام، نه حفظ تئوری‌ها.
+5. **یک نمونه ملموس از حس وایب کدینگ:** تشریح سادهٔ اینکه چگونه با یک توصیف به زبان طبیعی (پرامپت)، یک وب‌اپلیکیشن یا صفحهٔ زنده تولید می‌شود.
+6. **دستاوردهای نهایی:** در پایان دوره چه چیزی در دست دانشجو خواهد بود (MVP کامل، دیتابیس متصل، دیپلوی روی دامنه اینترنتی، قابلیت‌های هوش مصنوعی).
+
+### آنچه نباید وارد آن شویم (Out-of-Scope):
+- وارد شدن به نصب نرم‌افزارها یا ابزارهای خاص (این مبحث در فصل ۳ است).
+- ورود به جزئیات فنی مدل‌های زبانی مانند توکن‌ها، پرامپت مهندسی عمیق یا توهم (در فصل ۲ تدریس می‌شود).
+- مقایسه تخصصی ابزارها نظیر Cursor در برابر Lovable (مربوط به درس‌های ۲.۴ و ۳.۳).
+
+---
+
+## ۳. مفاهیم کلیدی و کلمات تخصصی (Key Concepts & Terms)
+
+| اصطلاح انگلیسی | معادل فارسی مصوب | توضیح یک‌خطی ساده |
+| :--- | :--- | :--- |
+| Vibe Coding | وایب کدینگ | سبک توسعه نرم‌افزار که در آن کاربر با هدایت، حس و زبان طبیعی به هوش مصنوعی محصول می‌سازد |
+| MVP (Minimum Viable Product) | کمینه محصول پذیرفتنی | نسخهٔ اولیه و کاربردی از یک محصول که ارزش اصلی را به کاربر ارائه می‌دهد |
+| AI Agent | ایجنت هوش مصنوعی | ابزار هوشمندی که می‌تواند کدهای برنامه را بنویسد، تغییر دهد و دستورات سیستمی را اجرا کند |
+| Deployment | استقرار / انتشار | قرار دادن نرم‌افزار روی سرورهای آنلاین تا در سراسر اینترنت با آدرس وب در دسترس باشد |
+
+---
+
+## ۴. جایگاه‌های تصاویر و نمودارها (Visual & Diagram Placeholders)
+> **راهنمای ایجنت نویسنده:** تمام تصاویر باید در پوشهٔ `images/` قرار گرفته و در قالب جدول تک‌خانه‌ای وسط‌چین با کپشن تفصیلی درج شوند:
+
+1. **تصویر کاور درس:** `images/cover.png`
+   * **موضوع:** کاور جذاب و مدرن درس‌نامه پیش‌گفتار وایب کدینگ با تم تیره و هویت بصری کوئرا کالج.
+2. **نمودار پارادایم وایب کدینگ:** `images/vibe-coding-paradigm.png`
+   * **موضوع:** مقایسه مدل سنتی (برنامه‌نویس صدها خط کد می‌نویسد) در برابر وایب کدینگ (کاربر ایده و الزامات را بیان می‌کند، ایجنت کد و ساختار را می‌چیند و خروجی قابل مشاهده تحویل می‌دهد).
+3. **نمودار گروه‌های مخاطبان:** `images/audience.png`
+   * **موضوع:** نمایش چهار گروه مخاطب اصلی دوره در قالب کارت‌های جذاب (مدیران محصول، طراحان، ایده‌پردازان/کارآفرینان، متخصصان بدون دانش کدنویسی).
+4. **مسیر یادگیری دوره:** `images/learning-journey.png`
+   * **موضوع:** نمایش پلکانی مسیر از ایده، محیط کار، ظاهر فرانت‌اند، داده، امنیت تا انتشار جهانی.
+5. **آناتومی نخستین تجربه:** `images/first-experience.png`
+   * **موضوع:** تشریح تصویری فرآیند: توصیف متنی ایده $\rightarrow$ تولید ساختار توسط ایجنت $\rightarrow$ نمایش صفحهٔ زنده و تعاملی.
+6. **شش مهارت نهایی:** `images/what-you-build.png`
+   * **موضوع:** اینفوگرافیک شش دستاورد کلیدی دانشجو در پایان دوره (طراحی محصول، رابط کاربری با AI، بک‌اند و دیتابیس ابری، دیباگ با ایجنت، اتصال سرویس‌ها و انتشار زنده).
+
+---
+
+## ۵. بخش‌بندی و ساختار محتوایی پیشنهادی درس‌نامه (`README.md`)
+
+مطابق با الگوی درس پیش‌گفتار در دوره FastAPI:
+1. **تیتر اصلی:** `# پیش‌گفتار`
+2. **پاراگراف قلاب:** داستان خلق نرم‌افزار و تحولی که هوش مصنوعی در ساخت محصول رقم زده است.
+3. **جدول کاور:**
+   ```markdown
+   | ![کاور دورهٔ وایب کدینگ در کوئرا کالج](./images/cover.png) |
+   | :-: |
+   ```
+4. **توضیح مأموریت دوره:** وایب کدینگ به عنوان راهکاری برای تبدیل سریع ایده به واقعیت بدون موانع یادگیری سال‌ها سینتکس کدنویسی.
+5. **پرسش‌های کلیدی پیش از شروع:**
+   * وایب کدینگ دقیقاً چگونه کار می‌کند و آیا واقعاً بدون کدنویسی می‌توان محصول ساخت؟
+   * فرق یک پروتوتایپ مقوایی با یک نرم‌افزار واقعی و ایمن چیست؟
+   * بازار کار و استارتاپ‌ها چگونه از این افراد استقبال می‌کنند؟
+6. **بخش مخاطبان (`## این دوره برای چه کسانی است`):** همراه با نمودار `audience.png`.
+7. **بخش شیوه یادگیری (`## چطور یاد می‌گیرید`):** یادگیری مبتنی بر ساختن، نه تئوری خشک + نمودار `learning-journey.png`.
+8. **نمونه کوتاه تعامل با ایجنت:** نمایش یک نمونه پرامپت و خروجی سریع برای درک حس روانی کار با ایجنت.
+9. **بخش دستاوردهای پایانی (`## در پایان چه چیزی در دست دارید`):** همراه با نمودار `what-you-build.png`.
+10. **پاراگراف پایانی و پل انتقال به درس‌نامه بعدی:** دعوت به مشاهده درس‌نامه «نگاه کلی به دوره».
+
+---
+
+## ۶. معیارهای پذیرش درس‌نامه (Acceptance Criteria Checklist)
+- [ ] لحن متن پرانرژی، تشویق‌کننده، صمیمی و بدون تکلف‌های فنی پیچیده باشد.
+- [ ] جدول کاور و تمام ۵ نمودار متناظر در پوشهٔ `images/` تولید و در جدول‌های وسط‌چین درج شده باشند.
+- [ ] اصطلاحات انگلیسی به همراه معادل فارسی مصوب آورده شوند (`**فارسی (*English*)**`).
+- [ ] تمام نیم‌فاصله‌ها و گیومه‌های فارسی (« ») رعایت شده باشند.
+- [ ] در پایان درس‌نامه، پل ارتباطی شفاف به درس دوم (`L1.2: نگاه کلی به دوره`) برقرار شده باشد.

chapters/01-introduction/02-course-overview/spec.md

@@ -0,0 +1,125 @@
+# مشخصات درس‌نامه: نگاه کلی به دوره (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: قالب کوئرا کالج`) در انتها قید شده باشد.

chapters/01-introduction/03-quera-college-format/spec.md

@@ -0,0 +1,103 @@
+# مشخصات درس‌نامه: قالب کوئرا کالج (Quera College Format)
+- **شناسه در سیلابس:** `L1.3`
+- **فصل:** فصل ۱: مقدمه (Ch 1)
+- **نوع محتوا:** 📘 درس‌نامه متنی
+- **زمان تقریبی مطالعه:** ۱۰ دقیقه
+- **پیش‌نیازهای مستقیم:** `L1.2` (نگاه کلی به دوره)
+
+---
+
+## ۱. اهداف یادگیری (Learning Objectives - Bloom's Taxonomy)
+دانشجو پس از مطالعهٔ این درس‌نامه باید بتواند:
+- [ ] **درک کند (Understand):** اجزای مختلف سامانه کوئرا کالج (درس‌نامه‌ها، دکمهٔ «خواندم»، آزمون‌های تستی، نقاط عطف پروژه و سیستم پشتیبانی) چگونه کار می‌کنند.
+- [ ] **درک کند (Understand):** سیستم ارزیابی دوره وایب کدینگ مبتنی بر آزمون‌های مفهومی خودکار (۲۰۰ امتیاز در فصل‌های ۲ و ۳) و دو پروژهٔ عملی اصلی است.
+- [ ] **به‌کار ببندد (Apply):** چرخهٔ استاندارد مطالعه، ثبت پیشرفت با دکمهٔ «خواندم»، مشارکت در بخش گفت‌وگو و درخواست کمک از مربیان یا هوش مصنوعی کای را اجرا کند.
+- [ ] **درک کند (Understand):** شرایط باز شدن فصل‌های بعدی بر اساس درصد پیشرفت و ثبت درس‌نامه‌ها چگونه است.
+
+---
+
+## ۲. محدوده و مرزهای محتوا (Scope & Boundaries)
+
+### آنچه باید پوشش داده شود (In-Scope):
+1. **مزیت قالب کوئرا کالج:** ترکیب یادگیری انعطاف‌پذیر آنلاین با ساختار منظم، پروژه‌محور و بازخورد لحظه‌ای.
+2. **بخش درس‌نامه‌ها (`## 📖 درس‌نامه‌ها`):**
+   * نحوهٔ تدوین مرحله‌به‌مرحلهٔ متون همراه با تصاویر و قطعات کد.
+   * لزوم ثبت پیشرفت با زدن دکمهٔ «خواندم» در انتهای هر درس‌نامه.
+   * توصیهٔ طلایی: دست به ابزار شدن و اجرای پرامپت‌ها و ساخت پروژه‌ها هم‌گام با درس.
+3. **بخش سنجش و ارزیابی (`## 📝 آزمون‌های تستی و پروژه‌ها`):**
+   * آزمون‌های تستی خودکار (فصل ۲ و ۳) برای سنجش تثبیت تعاریف و ذهنیت وایب کدینگ.
+   * نقاط عطف پروژه (پروژه ۱ در فصل ۸ و پروژه ۲ در فصل ۱۴) برای ساخت نرم‌افزار کامل و انتشار آنلاین.
+4. **جعبهٔ نکتهٔ کوئرا (`<details class="green">`):** اهمیت همگامی با درس‌ها و تست مداوم کارهای انجام شده توسط ایجنت.
+5. **بخش تعامل و ارتباطات:**
+   * `## 🗣️ گفت‌وگو`: تبادل نظر با سایر دانشجویان در زیر هر درس‌نامه و بررسی توسط مربیان.
+   * `## 👍🏻 دریافت بازخورد`: امتیازدهی و ارسال نظر در پایان هر درس برای ارتقای دوره.
+   * `## 💬 پشتیبانی و مربی‌گری`: استفاده از بخش «سؤال خصوصی» برای ارتباط مستقیم با مربیان یا ربات هوش مصنوعی «کای» (پاسخ‌گویی زیر ۲۴ ساعت).
+6. **بخش پیشروی و قفل فصل‌ها (`## پیشروی در دوره و باز شدن فصل‌ها`):** تشریح سازوکار باز شدن قفل فصل‌های بعدی با زدن دکمه «خواندم» و حل کوییزها.
+
+### آنچه نباید وارد آن شویم (Out-of-Scope):
+- ارائهٔ سوالات یا جزییات آزمون تستی فصل ۲ (مربوط به درس ۲.۸).
+- ورود به جزئیات سطوح نمرات گواهی (موضوع اختصاصی درس ۱.۴).
+
+---
+
+## ۳. مفاهیم کلیدی و کلمات تخصصی (Key Concepts & Terms)
+
+| اصطلاح انگلیسی | معادل فارسی مصوب | توضیح یک‌خطی ساده |
+| :--- | :--- | :--- |
+| Mark as Read | خواندم (ثبت مطالعه) | دکمهٔ تایید پایان مطالعه درس‌نامه که پیشرفت دانشجو را در سامانه ثبت می‌کند |
+| Project Milestone | نقطهٔ عطف پروژه | ایستگاه‌های اصلی در دوره که در آن‌ها یک نسخهٔ کامل و کاربردی از نرم‌افزار ساخته می‌شود |
+| Kai AI Assistant | دستیار هوش مصنوعی کای | ربات پاسخ‌گوی هوشمند کوئرا که به سوالات درسی دانشجویان به صورت لحظه‌ای پاسخ می‌دهد |
+| Mentorship | پشتیبانی و مربی‌گری | هدایت و رفع اشکال دانشجویان توسط مربیان مجرب کوئرا کالج |
+
+---
+
+## ۴. جایگاه‌های تصاویر و نمودارها (Visual & Diagram Placeholders)
+> **راهنمای ایجنت نویسنده:** تمام تصاویر باید در پوشهٔ `images/` قرار گرفته و در قالب جدول تک‌خانه‌ای وسط‌چین با کپشن تفصیلی درج شوند:
+
+1. **تصویر کاور درس:** `images/cover.png`
+   * **موضوع:** کاور مدرن قالب کوئرا کالج با نمایش المان‌های آموزشی، دکمه خواندم، گفت‌وگو و نماد کالج.
+2. **مقایسه درس‌نامه و یادگیری عملی:** `images/lesson-vs-action.png`
+   * **موضوع:** مقایسه دو ستونه: مطالعهٔ درس‌نامه (درک و یادگیری مفاهیم) در برابر کار با ایجنت (خلق محصول و خروجی زنده).
+3. **فرآیند ارزیابی و سنجش در دوره:** `images/assessment-flow.png`
+   * **موضوع:** فلوچارت ارزیابی دوره: مطالعه درس‌نامه‌ها $\rightarrow$ آزمون‌های تستی خودکار (فصل ۲ و ۳) $\rightarrow$ ساخت و تکمیل پروژه ۱ (فصل ۸) $\rightarrow$ انتشار و تکمیل پروژه ۲ (فصل ۱۴).
+4. **چرخهٔ تعاملی یادگیری در کالج:** `images/college-loop.png`
+   * **موضوع:** چرخه ۴ گام یادگیری دانشجو: مطالعه درس $\rightarrow$ هدایت ایجنت و ساخت $\rightarrow$ ثبت «خواندم» و کوییز $\rightarrow$ دریافت بازخورد و تعامل در گفت‌وگو.
+
+---
+
+## ۵. بخش‌بندی و ساختار محتوایی پیشنهادی درس‌نامه (`README.md`)
+
+مطابق با الگوی درس قالب کوئرا کالج در FastAPI:
+1. **تیتر اصلی:** `# قالب کوئرا کالج`
+2. **پاراگراف قلاب:** ترکیب آزادی یادگیری آنلاین با ساختار منظم و همراهی مربیان در کوئرا کالج.
+3. **جدول کاور:**
+   ```markdown
+   | ![کاور درس‌نامهٔ قالب کوئرا کالج](./images/cover.png) |
+   | :-: |
+   ```
+4. **معرفی اجزای فصل‌ها:**
+5. **بخش درس‌نامه‌ها (`## 📖 درس‌نامه‌ها`):** همراه با نمودار `lesson-vs-action.png` و توصیه اکید به اجرای هم‌زمان با ایجنت‌ها.
+6. **بخش سنجش (`## 📝 آزمون‌های تستی و پروژه‌ها`):** تشریح سازوکار آزمون‌های مفهومی و پروژه‌های دونقطهٔ عطفی به همراه نمودار `assessment-flow.png`.
+7. **جعبه نکته کوئرا:**
+   ```html
+   <details class="green">
+   <summary>**نکته: یادگیری فعال و ساختن هم‌گام با دوره**</summary>
+
+   تنها خواندن درس‌نامه‌ها کافی نیست؛ هر تکنیک یا پرامپت آموزش‌داده‌شده را بلافاصله در ادیتور خود با هوش مصنوعی امتحان کنید تا مهارت ارکستراسیون در شما نهادینه شود...
+
+   </details>
+   ```
+8. **بخش گفت‌وگو (`## 🗣️ گفت‌وگو`):** اهمیت همفکری با هم‌دوره‌ای‌ها.
+9. **بخش بازخورد (`## 👍🏻 دریافت بازخورد`):** نقش نظرات در تکامل دوره‌ها.
+10. **بخش مربی‌گری (`## 💬 پشتیبانی و مربی‌گری`):** راهنمای استفاده از تیکت مربیان و دستیار کای.
+11. **بخش پیشروی در دوره (`## پیشروی در دوره و باز شدن فصل‌ها`):** نقش زدن دکمه «خواندم» و حل کوییزها در باز شدن فصل‌های بعدی + نمودار `college-loop.png`.
+12. **پاراگراف پایانی:** ارجاع به درس‌نامه بعدی («گواهی کوئرا کالج»).
+
+---
+
+## ۶. معیارهای پذیرش درس‌نامه (Acceptance Criteria Checklist)
+- [ ] سیستم ارزیابی دوره منطبق با سیلابس نهایی (آزمون‌های تستی و دو پروژه اصلی به جای سیستم داوری سنتی کد) به درستی تشریح شده باشد.
+- [ ] جدول کاور و تمام ۳ نمودار متناظر در `images/` قرار گرفته و در جدول‌های وسط‌چین درج شوند.
+- [ ] باکس `<details class="green">` برای توصیه به یادگیری فعال تعبیه شده باشد.
+- [ ] لحن متن راهنما، شفاف، صمیمی و هدایت‌کننده باشد.
+- [ ] در انتها پل پیوند به درس پایانی فصل (`L1.4: گواهی کوئرا کالج`) برقرار شده باشد.

chapters/01-introduction/04-certificate/spec.md

@@ -0,0 +1,111 @@
+# مشخصات درس‌نامه: گواهی کوئرا کالج (Quera College Certificate)
+- **شناسه در سیلابس:** `L1.4`
+- **فصل:** فصل ۱: مقدمه (Ch 1)
+- **نوع محتوا:** 📘 درس‌نامه متنی
+- **زمان تقریبی مطالعه:** ۶ دقیقه
+- **پیش‌نیازهای مستقیم:** `L1.3` (قالب کوئرا کالج)
+
+---
+
+## ۱. اهداف یادگیری (Learning Objectives - Bloom's Taxonomy)
+دانشجو پس از مطالعهٔ این درس‌نامه باید بتواند:
+- [ ] **درک کند (Understand):** شرایط لازم برای صدور گواهی پایان دورهٔ کوئرا کالج (خواندن ۱۰۰٪ درس‌نامه‌ها و کسب حداقل نمره در ارزیابی‌ها).
+- [ ] **درک کند (Understand):** سطوح چهارگانهٔ گواهی (Perfect، Very Good، Good، Fair) بر اساس امتیاز نهایی چگونه محاسبه می‌شوند.
+- [ ] **به‌کار ببندد (Apply):** قاعدهٔ صدور یک‌بارهٔ گواهی را بداند و قبل از درخواست صدور نهایی، امتیازات خود را به سطح مورد نظر ارتقا دهد.
+- [ ] **به‌کار ببندد (Apply):** شیوهٔ اعتبارسنجی آنلاین گواهی و اشتراک‌گذاری حرفه‌ای آن در لینکدین (LinkedIn) و رزومه را بشناسد.
+
+---
+
+## ۲. محدوده و مرزهای محتوا (Scope & Boundaries)
+
+### آنچه باید پوشش داده شود (In-Scope):
+1. **ارزش گواهی کوئرا کالج:** گواهی رسمی دو زبانه با شناسه اعتبارسنجی اختصاصی آنلاین قابل استعلام برای کارفرمایان.
+2. **شرایط احراز گواهی:**
+   * ثبت مطالعهٔ تمام درس‌نامه‌ها با دکمه «خواندم».
+   * شرکت در آزمون‌های تستی و کسب حداقل امتیاز لازم (حداقل ۵۰٪ یا ۱۰۰ امتیاز از ۲۰۰ امتیاز کل).
+   * انجام و تحویل پروژه‌های نقطهٔ عطف دوره.
+3. **جعبهٔ نکتهٔ کوئرا (`<details class="green">`):** تفاوت بین مطالعه درس‌نامه (پیش‌نیاز تکمیل) و کسب امتیاز از آزمون‌ها برای ارتقای سطح گواهی.
+4. **جدول سطوح چهارگانه گواهی:** تفکیک دقیق بازه‌های امتیازی بر اساس ۲۰۰ امتیاز کل دوره:
+   * **Perfect:** ۱۹۰ تا ۲۰۰ امتیاز
+   * **Very Good:** ۱۷۰ تا ۱۸۹ امتیاز
+   * **Good:** ۱۴۰ تا ۱۶۹ امتیاز
+   * **Fair:** ۱۰۰ تا ۱۳۹ امتیاز
+5. **قانون صدور یک‌باره:** تاکید بر اینکه گواهی فقط یک بار صادر می‌شود و باید قبل از فشردن دکمه درخواست، بالاترین نمره ممکن را کسب کرد.
+6. **نمونه گواهی و کاربرد شغلی:** درج تصویر نمونه گواهی + راهنمای افزودن به بخش Licenses & Certifications در لینکدین و رزومه‌های بین‌المللی.
+7. **جمع‌بندی فصل اول:** مرور پایان مقدمات و اعلام آمادگی برای ورود به فصل دوم («شروع مسیر Vibe Coding»).
+
+### آنچه نباید وارد آن شویم (Out-of-Scope):
+- مباحث فنی فصل دوم یا تعاریف هوش مصنوعی.
+- نحوه ثبت سفارش پروژه‌ها در خارج از کوئرا.
+
+---
+
+## ۳. مفاهیم کلیدی و کلمات تخصصی (Key Concepts & Terms)
+
+| اصطلاح انگلیسی | معادل فارسی مصوب | توضیح یک‌خطی ساده |
+| :--- | :--- | :--- |
+| Certificate of Completion | گواهی پایان دوره | مدرک رسمی معتبر که نشان‌دهندهٔ تسلط بر مهارت‌های وایب کدینگ است |
+| Certificate Levels | سطوح گواهی | چهار درجه کیفی (Perfect, Very Good, Good, Fair) بر اساس امتیاز نهایی |
+| Verification URL | لینک اعتبارسنجی | آدرس اختصاصی اینترنتی برای استعلام صحت مدرک توسط شرکت‌ها و کارفرمایان |
+
+---
+
+## ۴. جایگاه‌های تصاویر و نمودارها (Visual & Diagram Placeholders)
+> **راهنمای ایجنت نویسنده:** تمام تصاویر باید در پوشهٔ `images/` قرار گرفته و در قالب جدول تک‌خانه‌ای وسط‌چین با کپشن تفصیلی درج شوند:
+
+1. **تصویر کاور درس:** `images/cover.png`
+   * **موضوع:** کاور جذاب گواهی رسمی کوئرا کالج با نماد مدرک، نشان اعتبار، تم تیره و ستاره‌های رتبه‌بندی.
+2. **نمودار پلکان سطوح گواهی:** `images/certificate-tiers.png`
+   * **موضوع:** نمایش پلکانی چهار سطح گواهی کوئرا کالج (Fair $\rightarrow$ Good $\rightarrow$ Very Good $\rightarrow$ Perfect) به همراه بازه امتیازی هر سطح.
+3. **تصویر نمونه گواهی:** `images/sample-certificate.png` (یا لینک تصویر باکیفیت کوئرا)
+   * **موضوع:** نمونه واقعی گواهی پایان دوره دو زبانه با شناسه رهگیری، کیوآرکد و امضای رسمی کوئرا کالج.
+
+---
+
+## ۵. بخش‌بندی و ساختار محتوایی پیشنهادی درس‌نامه (`README.md`)
+
+مطابق با الگوی درس گواهی کوئرا کالج در FastAPI:
+1. **تیتر اصلی:** `# گواهی کوئرا کالج`
+2. **پاراگراف مقدمه:** تشریح گواهی پایان دوره (*Certificate of Completion*) و شرایط کلی دریافت آن.
+3. **جدول کاور:**
+   ```markdown
+   | ![کاور درس‌نامهٔ گواهی کوئرا کالج](./images/cover.png) |
+   | :-: |
+   ```
+4. **جعبه نکته کوئرا:**
+   ```html
+   <details class="green">
+   <summary>**نکته: تفاوت ثبت درس‌نامه و کسب امتیاز از آزمون‌ها**</summary>
+
+   خواندن درس‌نامه‌ها شرط لازم برای باز شدن مسیر است، اما سطح گواهی شما را نمراتی تعیین می‌کند که از آزمون‌های تستی و تکمیل پروژه‌ها کسب می‌کنید...
+
+   </details>
+   ```
+5. **بخش سطوح گواهی (`## سطوح گواهی`):**
+   * توضیح سازوکار محاسبه نمره از ۲۰۰ امتیاز کل دوره.
+   * جدول سطوح گواهی:
+     | سطح گواهی | مجموع امتیاز |
+     | :-: | :-: |
+     | $\textbf{Perfect}$ | ۱۹۰ تا ۲۰۰ |
+     | $\textbf{Very Good}$ | ۱۷۰ تا ۱۸۹ |
+     | $\textbf{Good}$ | ۱۴۰ تا ۱۶۹ |
+     | $\textbf{Fair}$ | ۱۰۰ تا ۱۳۹ |
+   * همراه با نمودار `certificate-tiers.png`.
+6. **تاکید بر قانون صدور یک‌باره:** پیش از صدور نهایی، فرصت دارید امتیاز خود را در کوییزها به حداکثر برسانید.
+7. **بخش نمونه گواهی و اعتبار شغلی:**
+   ```markdown
+   | ![نمونه گواهی کوئرا کالج](./images/sample-certificate.png) |
+   | :-: |
+   | نمونهٔ گواهی رسمی و معتبر کوئرا کالج با شناسهٔ اعتبارسنجی آنلاین. |
+   ```
+8. **راهنمای استفاده در رزومه و لینکدین:** اشتراک‌گذاری در شبکه لینکدین و رزومه‌های بین‌المللی.
+9. **جمع‌بندی فصل مقدمه و ورود به فصل ۲:** تبریک پایان فصل اول و اعلام ورود به **«فصل ۲: شروع مسیر Vibe Coding»**.
+
+---
+
+## ۶. معیارهای پذیرش درس‌نامه (Acceptance Criteria Checklist)
+- [ ] بازه‌های امتیازی جدول دقیقاً بر اساس ۲۰۰ امتیاز کل دورهٔ وایب کدینگ تنظیم شده باشد.
+- [ ] جدول کاور و تصاویر سطوح و نمونه گواهی در `images/` قرار گرفته و در جدول‌های وسط‌چین درج شوند.
+- [ ] باکس `<details class="green">` برای تبیین شرایط امتیازگیری و ثبت درس‌نامه‌ها استفاده شود.
+- [ ] قانون صدور یک‌بارهٔ گواهی به وضوح توضیح داده شود.
+- [ ] در پایان درس، جمع‌بندی فصل اول و انتقال به فصل دوم (`فصل ۲: شروع مسیر Vibe Coding`) درج شده باشد.