diff --git a/.agents/rules/sdd-workflow.md b/.agents/rules/sdd-workflow.md index 6dd83bc..c2adb71 100644 --- a/.agents/rules/sdd-workflow.md +++ b/.agents/rules/sdd-workflow.md @@ -29,15 +29,15 @@ 3. **تفکیک مسئولیت پوشه‌ها:** هر درس‌نامه یا تمرین در پوشهٔ اختصاصی خود در ساختار زیر قرار می‌گیرد: - - **درس‌نامه:** `chapters/ch-/-/` + - **درس‌نامه:** `chapters/-/-/` - `spec.md` (مشخصات و اهداف یادگیری) - `README.md` (متن نهایی درس‌نامه کوئرا کالج) - - **تمرین داوری:** `chapters/ch-/-/` + - **تمرین داوری:** `chapters/-/-/` - `spec.md` (مشخصات ورودی/خروجی، سناریو، سنجه‌های داوری) - `problem.md` (صورت مسئله برای دانشجو) - `initial/` (کد و اسکلت اولیه) - `solution/` (پاسخ مرجع و بهینه) - `tests/` (مجموعه تست‌های داوری خودکار) - - **تمرین تستی:** `chapters/ch-/-/` + - **تمرین تستی:** `chapters/-/-/` - `spec.md` (مشخصات مفهومی و توزیع گزینه‌ها) - `questions.json` یا `questions.md` (صورت سوال، گزینه‌ها، پاسخ صحیح و تحلیل گزینه‌های گمراه‌کننده) diff --git a/.agents/skills/course-sdd-planner/SKILL.md b/.agents/skills/course-sdd-planner/SKILL.md index 2672c91..de54f2f 100644 --- a/.agents/skills/course-sdd-planner/SKILL.md +++ b/.agents/skills/course-sdd-planner/SKILL.md @@ -13,7 +13,7 @@ description: >- ## ساختار فایل `spec.md` برای درس‌نامه‌ها -هر درس‌نامه باید در مسیر `chapters/ch-/-/spec.md` دارای این قالب باشد: +هر درس‌نامه باید در مسیر `chapters/-/-/spec.md` دارای این قالب باشد: ```markdown # مشخصات درس‌نامه: [عنوان درس‌نامه] diff --git a/.agents/skills/quera-lesson-author/SKILL.md b/.agents/skills/quera-lesson-author/SKILL.md index 56e2ffe..fbd1950 100644 --- a/.agents/skills/quera-lesson-author/SKILL.md +++ b/.agents/skills/quera-lesson-author/SKILL.md @@ -18,7 +18,7 @@ description: >- هر درس‌نامه در پوشهٔ اختصاصی خود درون فصل مربوطه قرار دارد و باید شامل فایل متن درس‌نامه و پوشهٔ تصاویر اختصاصی باشد: ```text -chapters/ch-/-/ +chapters/-/-/ ├── spec.md # سند مشخصات و قرارداد یادگیری درس (ورودی ایجنت) ├── README.md # متن کامل درس‌نامه کوئرا کالج (خروجی نهایی ایجنت) └── images/ # پوشهٔ اختصاصی تصاویر، نمودارها و دیاگرام‌های درس diff --git a/chapters/01-introduction/01-foreword/spec.md b/chapters/01-introduction/01-foreword/spec.md new file mode 100644 index 0000000..cab33df --- /dev/null +++ b/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: نگاه کلی به دوره`) برقرار شده باشد. diff --git a/chapters/01-introduction/02-course-overview/spec.md b/chapters/01-introduction/02-course-overview/spec.md new file mode 100644 index 0000000..4e15699 --- /dev/null +++ b/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 (`
`):** بیشتر بدانید در مورد تفاوت کدنویسی سنتی، کدنویسی با هوش مصنوعی و وایب کدینگ ایجنتیک. +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 +
+ **بیشتر بدانید: از کدنویسی سنتی تا وایب کدینگ ایجنتیک** + + توضیح تحول مهندسی نرم‌افزار و تفاوت آن با اتوکامپلیت‌های ساده کد... + | ![مقایسهٔ کدنویسی سنتی و وایب کدینگ](./images/traditional-vs-vibe.png) | + | :-: | + +
+ ``` +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/` قرار گرفته و در جدول‌های وسط‌چین درج شوند. +- [ ] باکس `
` برای مقایسه پارادایم‌های برنامه‌نویسی استفاده شود. +- [ ] لحن متن منسجم، هدایت‌کننده و متناسب با استانداردهای نگارشی کوئرا باشد. +- [ ] پل انتقال به درس‌نامهٔ بعدی (`L1.3: قالب کوئرا کالج`) در انتها قید شده باشد. diff --git a/chapters/01-introduction/03-quera-college-format/spec.md b/chapters/01-introduction/03-quera-college-format/spec.md new file mode 100644 index 0000000..d6867b8 --- /dev/null +++ b/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. **جعبهٔ نکتهٔ کوئرا (`
`):** اهمیت همگامی با درس‌ها و تست مداوم کارهای انجام شده توسط ایجنت. +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 +
+ **نکته: یادگیری فعال و ساختن هم‌گام با دوره** + + تنها خواندن درس‌نامه‌ها کافی نیست؛ هر تکنیک یا پرامپت آموزش‌داده‌شده را بلافاصله در ادیتور خود با هوش مصنوعی امتحان کنید تا مهارت ارکستراسیون در شما نهادینه شود... + +
+ ``` +8. **بخش گفت‌وگو (`## 🗣️ گفت‌وگو`):** اهمیت همفکری با هم‌دوره‌ای‌ها. +9. **بخش بازخورد (`## 👍🏻 دریافت بازخورد`):** نقش نظرات در تکامل دوره‌ها. +10. **بخش مربی‌گری (`## 💬 پشتیبانی و مربی‌گری`):** راهنمای استفاده از تیکت مربیان و دستیار کای. +11. **بخش پیشروی در دوره (`## پیشروی در دوره و باز شدن فصل‌ها`):** نقش زدن دکمه «خواندم» و حل کوییزها در باز شدن فصل‌های بعدی + نمودار `college-loop.png`. +12. **پاراگراف پایانی:** ارجاع به درس‌نامه بعدی («گواهی کوئرا کالج»). + +--- + +## ۶. معیارهای پذیرش درس‌نامه (Acceptance Criteria Checklist) +- [ ] سیستم ارزیابی دوره منطبق با سیلابس نهایی (آزمون‌های تستی و دو پروژه اصلی به جای سیستم داوری سنتی کد) به درستی تشریح شده باشد. +- [ ] جدول کاور و تمام ۳ نمودار متناظر در `images/` قرار گرفته و در جدول‌های وسط‌چین درج شوند. +- [ ] باکس `
` برای توصیه به یادگیری فعال تعبیه شده باشد. +- [ ] لحن متن راهنما، شفاف، صمیمی و هدایت‌کننده باشد. +- [ ] در انتها پل پیوند به درس پایانی فصل (`L1.4: گواهی کوئرا کالج`) برقرار شده باشد. diff --git a/chapters/01-introduction/04-certificate/spec.md b/chapters/01-introduction/04-certificate/spec.md new file mode 100644 index 0000000..18caa3d --- /dev/null +++ b/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. **جعبهٔ نکتهٔ کوئرا (`
`):** تفاوت بین مطالعه درس‌نامه (پیش‌نیاز تکمیل) و کسب امتیاز از آزمون‌ها برای ارتقای سطح گواهی. +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 +
+ **نکته: تفاوت ثبت درس‌نامه و کسب امتیاز از آزمون‌ها** + + خواندن درس‌نامه‌ها شرط لازم برای باز شدن مسیر است، اما سطح گواهی شما را نمراتی تعیین می‌کند که از آزمون‌های تستی و تکمیل پروژه‌ها کسب می‌کنید... + +
+ ``` +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/` قرار گرفته و در جدول‌های وسط‌چین درج شوند. +- [ ] باکس `
` برای تبیین شرایط امتیازگیری و ثبت درس‌نامه‌ها استفاده شود. +- [ ] قانون صدور یک‌بارهٔ گواهی به وضوح توضیح داده شود. +- [ ] در پایان درس، جمع‌بندی فصل اول و انتقال به فصل دوم (`فصل ۲: شروع مسیر Vibe Coding`) درج شده باشد.