feat: add chapter 01-introduction specs

This commit is contained in:
2026-09-05 21:37:25 +08:00
parent bb01742a6a
commit e16cca93ee
7 changed files with 437 additions and 5 deletions

View 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
| ![کاور درس‌نامهٔ نگاه کلی به دوره](./images/cover.png) |
| :-: |
```
3. **هدف اصلی دوره و دستاوردهای چهارگانه:** تعریف مأموریت دوره و ۴ بالت‌پوینت برجسته از قابلیت‌های دانشجو.
4. **بخش چرایی (`## چرا وایب کدینگ`):** تحلیل عمیق ۳ رکن وایب کدینگ به همراه نمودارهای `value-props.png` و `ecosystem.png`.
5. **باکس بیشتر بدانید کوئرا:**
```html
<details class="violet">
<summary>**بیشتر بدانید: از کدنویسی سنتی تا وایب کدینگ ایجنتیک**</summary>
توضیح تحول مهندسی نرم‌افزار و تفاوت آن با اتوکامپلیت‌های ساده کد...
| ![مقایسهٔ کدنویسی سنتی و وایب کدینگ](./images/traditional-vs-vibe.png) |
| :-: |
</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: قالب کوئرا کالج`) در انتها قید شده باشد.