feat: add chapter 01-introduction specs

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: گواهی کوئرا کالج`) برقرار شده باشد.