vibe-coding-college-specs/chapters/03-workspace-setup/01-lesson-system-prep/spec.md

مشخصات درس‌نامه: آماده‌سازی سیستم (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 با لحن تشویقی و صریح همراه با نکات احتیاطی پوشش داده شود.