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