feat: add chapter 03-workspace-setup specs

This commit is contained in:
2026-09-05 21:50:11 +08:00
parent 652dba5bc4
commit 5a2b30cad0
9 changed files with 997 additions and 0 deletions

View File

@@ -0,0 +1,80 @@
# مشخصات درس‌نامه: اهداف فصل سوم (Chapter Goals)
- **شناسه در سیلابس:** `L3.1`
- **فصل:** فصل ۳: راه‌اندازی محیط کار (Ch 3)
- **نوع محتوا:** 📘 درس‌نامه متنی
- **زمان تقریبی مطالعه:** ۵ دقیقه
- **پیش‌نیازهای مستقیم:** `L2.7` و آزمون `Q2.1`
---
## ۱. اهداف یادگیری (Learning Objectives - Bloom's Taxonomy)
دانشجو پس از مطالعهٔ این درس‌نامه باید بتواند:
- [ ] **درک کند (Understand):** چرا راه‌اندازی یک محیط کار حرفه‌ای و آماده، تفاوت میان توسعه‌دهنده سردرگم و وایب کدر توانمند و پرسرعت را رقم می‌زند.
- [ ] **درک کند (Understand):** نقشه راه ۸ درس‌نامه کاربردی این فصل (از ابزارهای پایه و ادیتورها تا ایجنت‌های ترمینال، ابزارهای وب، Git، پروتکل MCP و آناتومی پروژه) چگونه چیده شده است.
- [ ] **به‌کار ببندد (Apply):** شیوه استفاده از راهنماهای چندسکویی (Cross-Platform) دوره را بشناسد و بر اساس سیستم‌عامل خود (ویندوز، مک یا لینوکس) دستورالعمل‌های کشویی اختصاصی را دنبال کند.
- [ ] **درک کند (Understand):** ساختار آزمون تستی ۱۰۰ امتیازی پایانی فصل (`Q3.1`) که تسلط عملی او بر ابزارها را می‌سنجد چیست.
---
## ۲. محدوده و مرزهای محتوا (Scope & Boundaries)
### آنچه باید پوشش داده شود (In-Scope):
1. **خوش‌آمدگویی به فاز عملیاتی دوره:** گذر از تئوری‌های فصل ۲ به آماده‌سازی واقعی کامپیوتر برای خلق نرم‌افزار.
2. **مرور سرفصل‌های فصل ۳:**
* درس ۳.۲: آماده‌سازی سیستم، مرورگر مدرن، Node.js، اکانت‌ها و رفع موانع اتصال.
* درس ۳.۳: ویرایشگرهای هوشمند دسکتاپ (Cursor، Antigravity و اپ‌های دسکتاپ).
* درس ۳.۴: ایجنت‌های پیشرو ترمینال (Claude Code، Codex CLI و ابزارهای خط فرمان).
* درس ۳.۵: ابزارهای وب و مرورگری بدون نیاز به نصب (Lovable و Bolt).
* درس ۳.۶: سیستم کنترل نسخه Git و گیت‌هاب به زبان ساده (ماشین زمان کدها).
* درس ۳.۷: اتصال سوپرپاورها به هوش مصنوعی با Skillها و پروتکل فراگیر MCP.
* درس ۳.۸: کالبدشکافی ساختار فایل‌ها و پوشه‌های یک پروژه نرم‌افزاری مدرن.
3. **قاعده استاندارد چندسکویی (Cross-Platform Rule):**
* توضیح اینکه تمام آموزش‌های نصب و اجرای دستورات در سراسر این فصل در قالب زبانه‌های کشویی مجزا (`<details>`) برای سه سیستم‌عامل Windows، macOS و Linux ارائه شده است.
4. **معرفی آزمون تستی فصل (`Q3.1`):** آزمون تستی ۱۰ سوالی ۱۰۰ امتیازی برای تثبیت مهارت‌های محیط کار.
5. **کال‌اوت نکته کوئرا (`<details class="green">`):** لزوم انجام عملی تک‌تک مراحل هم‌زمان با مطالعه درس‌نامه‌ها.
### آنچه نباید وارد آن شویم (Out-of-Scope):
- ورود به جزئیات نصب ابزارهای خاص در این درس مقدماتی (در درس‌های ۳.۲ تا ۳.۷ ارائه می‌شود).
---
## ۳. مفاهیم کلیدی و کلمات تخصصی (Key Concepts & Terms)
| اصطلاح انگلیسی | معادل فارسی مصوب | توضیح یک‌خطی ساده |
| :--- | :--- | :--- |
| Workspace / Environment | محیط کار توسعه | مجموعه نرم‌افزارها، ابزارها و ترمینال نصب‌شده روی رایانه برای ساخت پروژه |
| Cross-Platform | چندسکویی | سازگاری نرم‌افزارها و دستورالعمل‌ها با سیستم‌عامل‌های مختلف (ویندوز، مک، لینوکس) |
| CLI (Command Line Interface) | رابط خط فرمان | محیط متنی ترمینال برای اجرای مستقیم دستورات سیستمی |
| MCP (Model Context Protocol) | پروتکل کانتکست مدل | استاندارد اتصال مدل هوش مصنوعی به منابع داده و ابزارهای بیرونی |
---
## ۴. جایگاه‌های تصاویر و نمودارها (Visual & Diagram Placeholders)
> **راهنمای ایجنت نویسنده:** تمام تصاویر باید در پوشهٔ `images/` قرار گرفته و در قالب جدول تک‌خانه‌ای وسط‌چین با کپشن تفصیلی درج شوند:
1. **تصویر کاور درس:** `images/cover.png`
* **موضوع:** کاور مدرن با تم تیره که میز کار توسعه‌دهنده مدرن را با مانیتورهای فعال، محیط‌های کدنویسی هوشمند و ابزارهای متصل نشان می‌دهد.
2. **نقشه راه فصل ۳:** `images/chapter-3-roadmap.png`
* **موضوع:** اینفوگرافیک گام‌به‌گام از آماده‌سازی سیستم $\rightarrow$ ادیتورهای دسکتاپ $\rightarrow$ ایجنت‌های ترمینال $\rightarrow$ ابزارهای وب $\rightarrow$ گیت $\rightarrow$ MCP $\rightarrow$ آناتومی پروژه $\rightarrow$ آزمون تستی ۱۰۰ امتیازی.
3. **جعبه‌ابزار نهایی دانشجو در پایان فصل:** `images/final-workspace-stack.png`
* **موضوع:** نمایش هماهنگ و یکپارچه ابزارهایی که تا پایان فصل روی سیستم کاربر آماده به کار خواهند بود.
---
## ۵. بخش‌بندی و ساختار محتوایی پیشنهادی درس‌نامه (`README.md`)
1. **تیتر اصلی:** `# اهداف فصل سوم: راه‌اندازی محیط کار`
2. **مقدمه کوتاه:** چرا داشتن یک جعبه‌ابزار مهیا، کلید روانی و سرعت بالای وایب کدینگ است؟
3. **جدول کاور درس**
4. **سرفصل‌های فصل سوم در یک نگاه:** معرفی کوتاه ابزارها و مفاهیم پیش رو.
5. **جدول نقشه راه فصل**
6. **راهنمای سیستم‌عامل‌ها (Cross-Platform Guide):** توضیح شیوه دسترسی به دستورات مخصوص ویندوز، مک و لینوکس با منوهای کشویی.
7. **آزمون تستی ۱۰۰ امتیازی فصل:** یادآوری هدف‌گذاری برای کسب حداکثر امتیاز.
8. **کال‌اوت کوئرا (`<details class="green">`):** ثبت دکمه «خواندم» و آغاز تجهیز سیستم.
---
## ۶. معیارهای پذیرش (Acceptance Criteria for Reviewer)
- [ ] لحن متن پرانرژی، راهنما و شفاف باشد.
- [ ] راهنمای ساختار چندسکویی (پشتیبانی از ویندوز، مک و لینوکس با کشوهای اختصاصی) تاکید شده باشد.
- [ ] مسیر تمام درس‌های فصل به همراه آزمون پایانی با وضوح بیان شده باشد.