feat: add chapter 03-workspace-setup specs

chapters/03-workspace-setup/01-lesson-system-prep/spec.md

@@ -0,0 +1,101 @@
+# مشخصات درس‌نامه: آماده‌سازی سیستم (System Preparation)
+- **شناسه در سیلابس:** `L3.2`
+- **فصل:** فصل ۳: راه‌اندازی محیط کار (Ch 3)
+- **نوع محتوا:** 📘 درس‌نامه متنی
+- **زمان تقریبی مطالعه:** ۱۵ دقیقه
+- **پیش‌نیازهای مستقیم:** `L3.1` (اهداف فصل سوم)
+
+---
+
+## ۱. اهداف یادگیری (Learning Objectives - Bloom's Taxonomy)
+دانشجو پس از مطالعهٔ این درس‌نامه باید بتواند:
+- [ ] **به‌کار ببندد (Apply):** ابزارهای پایه موتور اجرایی وب (Node.js نسخه پایدار LTS و مدیر پکیج npm) را روی سیستم‌عامل خود (ویندوز، مک یا لینوکس) با استفاده از راهنمای اختصاصی کشویی نصب و بررسی کند.
+- [ ] **به‌کار ببندد (Apply):** ترمینال مدرن و بهینه‌سازی‌شده را روی سیستم خود راه‌اندازی کند و فرمان‌های پایه‌ای بررسی نسخه (`node -v` و `npm -v`) را به درستی اجرا نماید.
+- [ ] **تحلیل/ارزیابی کند (Evaluate):** خطای متداول محدودیت اجرای اسکریپت‌ها در پاورشل ویندوز (PowerShell Execution Policy) را شناسایی و با دستور مجاز رفع کند.
+- [ ] **به‌کار ببندد (Apply):** حساب‌های کاربری ضروری توسعه (GitHub، سرویس‌های هوش مصنوعی و پلتفرم‌های ابری) را با رعایت نکات پایداری آی‌پی و ایمن ایجاد کند.
+- [ ] **به‌کار ببندد (Apply):** مرورگر استاندارد توسعه وب (گوگل کروم یا بریو) را برای بازرسی و مشاهده زنده پروژه‌ها آماده سازد.
+
+---
+
+## ۲. محدوده و مرزهای محتوا (Scope & Boundaries)
+
+### آنچه باید پوشش داده شود (In-Scope):
+1. **چک‌لیست نیازمندی‌های پایه سیستم:**
+   * سیستم‌عامل به‌روز (ویندوز ۱۰/۱۱، مک‌اواس یا توزیع‌های لینوکس).
+   * حداقل حافظه رم پیشنهادی (۸ گیگابایت به بالا) و اتصال اینترنت پایدار.
+2. **نصب Node.js (موتور اجرای جاوااسکریپت و وب مدرن):**
+   * انتخاب نسخه پایدار (LTS - Long Term Support) و چرایی پرهیز از نسخه Current برای نوآموزان.
+   * **راهنمای نصب چندسکویی در قالب ۳ منوی کشویی مجزا:**
+     * `<details><summary>راهنمای نصب در ویندوز (Windows)</summary> ... </details>`: دانلود اینستالر رسمی MSI و تنظیم پیش‌فرض‌ها.
+     * `<details><summary>راهنمای نصب در مک‌اواس (macOS)</summary> ... </details>`: استفاده از پکیج رسمی یا دستور Homebrew (`brew install node`).
+     * `<details><summary>راهنمای نصب در لینوکس (Linux - Ubuntu/Debian)</summary> ... </details>`: استفاده از مخازن NodeSource یا دستور `apt install nodejs npm`.
+3. **تست و بررسی درستی نصب در ترمینال:**
+   * ارائه دستورات بررسی سلامت با منوهای کشویی متناظر سیستم‌عامل‌ها (`node -v` و `npm -v`).
+4. **تنظیمات حیاتی ترمینال در ویندوز (رفع خطای اسکریپت):**
+   * حل خطای معروف `PSSecurityException` و `running scripts is disabled` با اجرای دستور ایمن:  
+     `Set-ExecutionPolicy RemoteSigned -Scope CurrentUser`
+5. **مرورگر وب مدرن برای توسعه‌دهندگان:**
+   * نصب Google Chrome یا Brave و آشنایی بسیار اولیه با کلید `F12` یا راست‌کلیک و گزینه `Inspect` (ابزار بازرسی عناصر).
+6. **ساخت حساب‌های کاربری حیاتی:**
+   * ثبت‌نام در **GitHub** (خانه پروژه‌های نرم‌افزاری).
+   * ساخت حساب در پلتفرم‌های هوش مصنوعی (Anthropic Claude یا OpenAI / OpenRouter).
+7. **کال‌اوت‌های Quera:**
+   * `<details class="red">`: حل خطای دسترسی اسکریپت در ویندوز (رفع باگ PowerShell).
+   * `<details class="violet">`: پایداری آی‌پی حین ساخت اکانت‌های خارجی جهت جلوگیری از بلاک شدن خودکار.
+
+### آنچه نباید وارد آن شویم (Out-of-Scope):
+- نصب ادیتور Cursor (در درس ۳.۳ پوشش داده می‌شود).
+- نصب ایجنت‌های ترمینال مثل Claude Code (در درس ۳.۴ ارائه می‌شود).
+- آموزش تخصصی دستورات گیت (درس ۳.۶).
+
+---
+
+## ۳. مفاهیم کلیدی و کلمات تخصصی (Key Concepts & Terms)
+
+| اصطلاح انگلیسی | معادل فارسی مصوب | توضیح یک‌خطی ساده |
+| :--- | :--- | :--- |
+| Node.js LTS | نسخه پایدار نود جی‌اس | محیط اجرای جاوااسکریپت در خارج از مرورگر با حداکثر سازگاری و کمترین باگ |
+| npm (Node Package Manager) | مدیر بسته‌های نود | مخزن و ابزار دانلود و مدیریت ابزارها و کتابخانه‌های نرم‌افزاری |
+| Execution Policy | سیاست اجرای اسکریپت | لایه امنیتی ویندوز برای کنترل امکان اجرای اسکریپت‌های خط فرمان |
+| DevTools / Inspect | ابزارهای توسعه مرورگر | پنل داخلی مرورگر برای دیدن ظاهر، کدهای صفحه و خطاهای بصری وب |
+| Single IP Consistency | ثبات آدرس اینترنتی | استفاده از لوکیشن مشخص جهت پیشگیری از هشدارهای تقلب سرویس‌های خارجی |
+
+---
+
+## ۴. جایگاه‌های تصاویر و نمودارها (Visual & Diagram Placeholders)
+> **راهنمای ایجنت نویسنده:** تمام تصاویر باید در پوشهٔ `images/` قرار گرفته و در قالب جدول تک‌خانه‌ای وسط‌چین با کپشن تفصیلی درج شوند:
+
+1. **تصویر کاور درس:** `images/cover.png`
+   * **موضوع:** کاور با تم تیره و لوگوهای Node.js، GitHub، ترمینال و ویندوز/مک که آماده‌سازی موتور محرک سیستم را تداعی می‌کند.
+2. **چک‌لیست آماده‌سازی سیستم:** `images/system-prep-checklist.png`
+   * **موضوع:** اینفوگرافیک ۴ تیک سبز طلایی: ۱. مرورگر بهینه $\rightarrow$ ۲. Node.js LTS $\rightarrow$ ۳. اکانت GitHub $\rightarrow$ ۴. محیط ترمینال سالم.
+3. **تست سلامت نود و npm در ترمینال:** `images/terminal-version-check.png`
+   * **موضوع:** اسکرین‌شات تمیز از خروجی دستورات `node -v` و `npm -v` با کادر تایید سبز.
+4. **حل خطای PowerShell در ویندوز:** `images/powershell-execution-fix.png`
+   * **موضوع:** اسکرین‌شات قبل و بعد: خطای قرمزرنگ اسکریپت در برابر حل آن با دستور `Set-ExecutionPolicy`.
+
+---
+
+## ۵. بخش‌بندی و ساختار محتوایی پیشنهادی درس‌نامه (`README.md`)
+
+1. **تیتر اصلی:** `# آماده‌سازی سیستم: گام اول تجهیز محیط کار`
+2. **مقدمه:** چرا به این ابزارهای پیش‌نیاز احتیاج داریم؟
+3. **جدول کاور درس**
+4. **چک‌لیست پیش‌نیازهای سخت‌افزاری و نرم‌افزاری:** مشخصات حداقلی و ایده‌آل سیستم.
+5. **نصب Node.js (نسخه LTS):**
+   * چرایی اهمیت Node.js در توسعه مدرن.
+   * ۳ زبانه کشویی برای Windows، macOS و Linux.
+6. **بررسی صحت نصب در ترمینال:** تست نسخه‌ها با منوهای کشویی سیستم‌عامل‌ها.
+7. **باکس هشدار و رفع خطای Quera (`<details class="red">`):** تنظیم Execution Policy در PowerShell ویندوز.
+8. **مرورگر استاندارد توسعه و نگاهی به DevTools:** معرفی Chrome/Brave و پنجره Inspect.
+9. **ساخت حساب‌های کاربری ضروری (GitHub و سرویس‌های AI):** گام‌های عضویت امن.
+10. **باکس نکته Quera (`<details class="violet">`):** نکات پایداری آی‌پی حین ساخت حساب‌ها.
+11. **جمع‌بندی درس‌نامه:** اعلام سبز شدن تمام چراغ‌های پایه سیستم برای ورود به ابزارهای هوش مصنوعی.
+
+---
+
+## ۶. معیارهای پذیرش (Acceptance Criteria for Reviewer)
+- [ ] برای تمامی مراحل نصب و بررسی، منوهای کشویی جداگانه برای Windows، macOS و Linux وجود داشته باشد.
+- [ ] راهکار حل خطای اسکریپت در PowerShell ویندوز با دستور دقیق و امن ارائه شده باشد.
+- [ ] نسخه پیشنهادی Node.js حتماً LTS باشد و دلیل پرهیز از نسخه آزمایشی ذکر شده باشد.
+- [ ] راهنمای ساخت حساب‌های GitHub با لحن تشویقی و صریح همراه با نکات احتیاطی پوشش داده شود.