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