feat: add chapter 01-introduction specs
This commit is contained in:
@@ -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` (صورت سوال، گزینه‌ها، پاسخ صحیح و تحلیل گزینه‌های گمراه‌کننده)
|
||||
|
||||
@@ -13,7 +13,7 @@ description: >-
|
||||
|
||||
## ساختار فایل `spec.md` برای درس‌نامه‌ها
|
||||
|
||||
هر درس‌نامه باید در مسیر `chapters/ch<XX>-<name>/<YY>-<slug>/spec.md` دارای این قالب باشد:
|
||||
هر درس‌نامه باید در مسیر `chapters/<XX>-<name>/<YY>-<slug>/spec.md` دارای این قالب باشد:
|
||||
|
||||
```markdown
|
||||
# مشخصات درس‌نامه: [عنوان درس‌نامه]
|
||||
|
||||
@@ -18,7 +18,7 @@ description: >-
|
||||
هر درس‌نامه در پوشهٔ اختصاصی خود درون فصل مربوطه قرار دارد و باید شامل فایل متن درس‌نامه و پوشهٔ تصاویر اختصاصی باشد:
|
||||
|
||||
```text
|
||||
chapters/ch<XX>-<name>/<YY>-<lesson-slug>/
|
||||
chapters/<XX>-<name>/<YY>-<lesson-slug>/
|
||||
├── spec.md # سند مشخصات و قرارداد یادگیری درس (ورودی ایجنت)
|
||||
├── README.md # متن کامل درس‌نامه کوئرا کالج (خروجی نهایی ایجنت)
|
||||
└── images/ # پوشهٔ اختصاصی تصاویر، نمودارها و دیاگرام‌های درس
|
||||
|
||||
93
chapters/01-introduction/01-foreword/spec.md
Normal file
93
chapters/01-introduction/01-foreword/spec.md
Normal file
@@ -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
|
||||
|  |
|
||||
| :-: |
|
||||
```
|
||||
4. **توضیح مأموریت دوره:** وایب کدینگ به عنوان راهکاری برای تبدیل سریع ایده به واقعیت بدون موانع یادگیری سال‌ها سینتکس کدنویسی.
|
||||
5. **پرسش‌های کلیدی پیش از شروع:**
|
||||
* وایب کدینگ دقیقاً چگونه کار می‌کند و آیا واقعاً بدون کدنویسی می‌توان محصول ساخت؟
|
||||
* فرق یک پروتوتایپ مقوایی با یک نرم‌افزار واقعی و ایمن چیست؟
|
||||
* بازار کار و استارتاپ‌ها چگونه از این افراد استقبال می‌کنند؟
|
||||
6. **بخش مخاطبان (`## این دوره برای چه کسانی است`):** همراه با نمودار `audience.png`.
|
||||
7. **بخش شیوه یادگیری (`## چطور یاد می‌گیرید`):** یادگیری مبتنی بر ساختن، نه تئوری خشک + نمودار `learning-journey.png`.
|
||||
8. **نمونه کوتاه تعامل با ایجنت:** نمایش یک نمونه پرامپت و خروجی سریع برای درک حس روانی کار با ایجنت.
|
||||
9. **بخش دستاوردهای پایانی (`## در پایان چه چیزی در دست دارید`):** همراه با نمودار `what-you-build.png`.
|
||||
10. **پاراگراف پایانی و پل انتقال به درس‌نامه بعدی:** دعوت به مشاهده درس‌نامه «نگاه کلی به دوره».
|
||||
|
||||
---
|
||||
|
||||
## ۶. معیارهای پذیرش درس‌نامه (Acceptance Criteria Checklist)
|
||||
- [ ] لحن متن پرانرژی، تشویق‌کننده، صمیمی و بدون تکلف‌های فنی پیچیده باشد.
|
||||
- [ ] جدول کاور و تمام ۵ نمودار متناظر در پوشهٔ `images/` تولید و در جدول‌های وسط‌چین درج شده باشند.
|
||||
- [ ] اصطلاحات انگلیسی به همراه معادل فارسی مصوب آورده شوند (`**فارسی (*English*)**`).
|
||||
- [ ] تمام نیم‌فاصله‌ها و گیومه‌های فارسی (« ») رعایت شده باشند.
|
||||
- [ ] در پایان درس‌نامه، پل ارتباطی شفاف به درس دوم (`L1.2: نگاه کلی به دوره`) برقرار شده باشد.
|
||||
125
chapters/01-introduction/02-course-overview/spec.md
Normal file
125
chapters/01-introduction/02-course-overview/spec.md
Normal file
@@ -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
|
||||
|  |
|
||||
| :-: |
|
||||
```
|
||||
3. **هدف اصلی دوره و دستاوردهای چهارگانه:** تعریف مأموریت دوره و ۴ بالت‌پوینت برجسته از قابلیت‌های دانشجو.
|
||||
4. **بخش چرایی (`## چرا وایب کدینگ`):** تحلیل عمیق ۳ رکن وایب کدینگ به همراه نمودارهای `value-props.png` و `ecosystem.png`.
|
||||
5. **باکس بیشتر بدانید کوئرا:**
|
||||
```html
|
||||
<details class="violet">
|
||||
<summary>**بیشتر بدانید: از کدنویسی سنتی تا وایب کدینگ ایجنتیک**</summary>
|
||||
|
||||
توضیح تحول مهندسی نرم‌افزار و تفاوت آن با اتوکامپلیت‌های ساده کد...
|
||||
|  |
|
||||
| :-: |
|
||||
|
||||
</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: قالب کوئرا کالج`) در انتها قید شده باشد.
|
||||
103
chapters/01-introduction/03-quera-college-format/spec.md
Normal file
103
chapters/01-introduction/03-quera-college-format/spec.md
Normal file
@@ -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
|
||||
|  |
|
||||
| :-: |
|
||||
```
|
||||
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: گواهی کوئرا کالج`) برقرار شده باشد.
|
||||
111
chapters/01-introduction/04-certificate/spec.md
Normal file
111
chapters/01-introduction/04-certificate/spec.md
Normal file
@@ -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
|
||||
|  |
|
||||
| :-: |
|
||||
```
|
||||
4. **جعبه نکته کوئرا:**
|
||||
```html
|
||||
<details class="green">
|
||||
<summary>**نکته: تفاوت ثبت درس‌نامه و کسب امتیاز از آزمون‌ها**</summary>
|
||||
|
||||
خواندن درس‌نامه‌ها شرط لازم برای باز شدن مسیر است، اما سطح گواهی شما را نمراتی تعیین می‌کند که از آزمون‌های تستی و تکمیل پروژه‌ها کسب می‌کنید...
|
||||
|
||||
</details>
|
||||
```
|
||||
5. **بخش سطوح گواهی (`## سطوح گواهی`):**
|
||||
* توضیح سازوکار محاسبه نمره از ۲۰۰ امتیاز کل دوره.
|
||||
* جدول سطوح گواهی:
|
||||
| سطح گواهی | مجموع امتیاز |
|
||||
| :-: | :-: |
|
||||
| $\textbf{Perfect}$ | ۱۹۰ تا ۲۰۰ |
|
||||
| $\textbf{Very Good}$ | ۱۷۰ تا ۱۸۹ |
|
||||
| $\textbf{Good}$ | ۱۴۰ تا ۱۶۹ |
|
||||
| $\textbf{Fair}$ | ۱۰۰ تا ۱۳۹ |
|
||||
* همراه با نمودار `certificate-tiers.png`.
|
||||
6. **تاکید بر قانون صدور یک‌باره:** پیش از صدور نهایی، فرصت دارید امتیاز خود را در کوییزها به حداکثر برسانید.
|
||||
7. **بخش نمونه گواهی و اعتبار شغلی:**
|
||||
```markdown
|
||||
|  |
|
||||
| :-: |
|
||||
| نمونهٔ گواهی رسمی و معتبر کوئرا کالج با شناسهٔ اعتبارسنجی آنلاین. |
|
||||
```
|
||||
8. **راهنمای استفاده در رزومه و لینکدین:** اشتراک‌گذاری در شبکه لینکدین و رزومه‌های بین‌المللی.
|
||||
9. **جمع‌بندی فصل مقدمه و ورود به فصل ۲:** تبریک پایان فصل اول و اعلام ورود به **«فصل ۲: شروع مسیر Vibe Coding»**.
|
||||
|
||||
---
|
||||
|
||||
## ۶. معیارهای پذیرش درس‌نامه (Acceptance Criteria Checklist)
|
||||
- [ ] بازه‌های امتیازی جدول دقیقاً بر اساس ۲۰۰ امتیاز کل دورهٔ وایب کدینگ تنظیم شده باشد.
|
||||
- [ ] جدول کاور و تصاویر سطوح و نمونه گواهی در `images/` قرار گرفته و در جدول‌های وسط‌چین درج شوند.
|
||||
- [ ] باکس `<details class="green">` برای تبیین شرایط امتیازگیری و ثبت درس‌نامه‌ها استفاده شود.
|
||||
- [ ] قانون صدور یک‌بارهٔ گواهی به وضوح توضیح داده شود.
|
||||
- [ ] در پایان درس، جمع‌بندی فصل اول و انتقال به فصل دوم (`فصل ۲: شروع مسیر Vibe Coding`) درج شده باشد.
|
||||
Reference in New Issue
Block a user