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