Files
vibe-coding-college-specs/chapters/13-product-maintenance/00-lesson-chapter-goals/spec.md

83 lines
9.1 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# مشخصات درس‌نامه: اهداف فصل سیزدهم (Chapter Goals)
- **شناسه در سیلابس:** `L13.1`
- **فصل:** فصل ۱۳: نگهداری محصول (Ch 13)
- **نوع محتوا:** 📘 درس‌نامه متنی
- **زمان تقریبی مطالعه:** ۵ دقیقه
- **پیش‌نیازهای مستقیم:** `L12.7` (اتصال دامنه اختصاصی، DNS و SSL)
---
## ۱. اهداف یادگیری (Learning Objectives - Bloom's Taxonomy)
دانشجو پس از مطالعهٔ این درس‌نامه باید بتواند:
- [ ] **درک کند (Understand):** چرا انتشار نرم‌افزار پایان کار نیست بلکه آغاز زندگی واقعی آن است و تفاوت یک کدنویس موقت با یک مالک محصول حرفه‌ای در هنر «نگهداری و پایش پایدار» (Product Maintenance & Observability) نهفته است.
- [ ] **درک کند (Understand):** نقشه راه ۷ درس‌نامه تخصصی فصل سیزدهم شامل: مشاهده‌پذیری و سلامت منابع (Monitoring)، هشدارهای زنده آپتایم با UptimeRobot، ثبت و ردگیری خطاهای سرور زنده با Sentry و لاگ‌های لیارا/ورسل، به‌روزرسانی امنیتی پکیج‌ها، سئو تکنیکال و تحلیل رفتار کاربر با Google Search Console و Microsoft Clarity، و مستندسازی حرفه‌ای پروژه را بشناسد.
- [ ] **تحلیل/ارزیابی کند (Evaluate):** ارزش آگاهی پیش‌دستانه از خرابی سیستم (باخبر شدن سازنده قبل از گلایه کاربران) را در برابر نادیده گرفتن وضعیت پس از انتشار ارزیابی نماید.
- [ ] **به‌کار ببندد (Apply):** ابزارهای مانیتورینگ سلامت، داشبوردهای رصد باگ، و تحلیل‌گرهای رفتار کاربر را روی پورتفولیوی زنده خود مستقر سازد.
---
## ۲. محدوده و مرزهای محتوا (Scope & Boundaries)
### آنچه باید پوشش داده شود (In-Scope):
1. **ورود به فاز حیات و مراقبت از محصول زنده:**
* خودرویی که ساخته شده نیاز به کیلومترشمار، نشانگر بنزین و هشدارهای تعویض روغن دارد؛ پورتفولیو و نرم‌افزار شما نیز به همین ابزارها نیاز دارد.
2. **مرور سرفصل‌های تخصصی فصل ۱۳:**
* درس ۱۳.۲: مشاهده‌پذیری و مانیتورینگ (Observability)؛ بررسی مصرف رم، پردازنده، پهنای باند و نرخ درخواست‌ها در داشبورد لیارا و Vercel.
* درس ۱۳.۳: سامانه‌های آپتایم و اعلان خطر (Alerting)؛ پایش وضعیت ۲۴ ساعته با UptimeRobot و ارسال هشدار فوری تلگرام و ایمیل در صورت قطعی سرور.
* درس ۱۳.۴: ثبت لاگ‌ها و ردگیری خطاهای پروداکشن (Error Tracking)؛ عیب‌یابی خطاهای زنده کاربران با Sentry و اتصال لاگ‌های سرور.
* درس ۱۳.۵: به‌روزرسانی امنیتی و نگهداری دوره‌ای؛ روش ایمن آپدیت کتابخانه‌ها با `npm update` و مدیریت آسیب‌پذیری‌ها بدون شکستن پروژه.
* درس ۱۳.۶: سئو تکنیکال و تحلیل رفتار کاربر؛ ثبت سایت در Google Search Console، تولید داینامیک نقشه سایت (`sitemap.ts`)، و مشاهده فیلم تعامل کاربران با Microsoft Clarity.
* درس ۱۳.۷: مستندسازی و کتابچه راهنمای نگهداری (Playbooks)؛ تدوین `README.md` فاخر، راهنمای مشارکت و سناریوهای رفع بحران با کمک ایجنت‌های هوش مصنوعی.
3. **هم‌راستایی با پروژه پورتفولیو:**
* تجهیز پورتفولیو به سنسورهای هوشمند برای رصد اینکه کارفرمایان چه بخش‌هایی از رزومه را بیشتر نگاه می‌کنند و آیا در ثبت پیام با خطایی روبرو می‌شوند یا خیر.
4. **کال‌اوت‌های کوئرا:**
* کال‌اوت سبز (`<details class="green">`): خواب راحت شبانه با داشتن سیستم هشدار تلگرامی که در صورت هرگونه نقص فنی به شما پیام می‌دهد.
### آنچه نباید وارد آن شویم (Out-of-Scope):
- توسعه فیچرهای بنیادین جدید یا بازنویسی معماری با هوش مصنوعی (فصل ۱۵).
- ساخت پایپ‌لاین‌های اتوماسیون CI/CD سازمانی پیچیده.
---
## ۳. مفاهیم کلیدی و کلمات تخصصی (Key Concepts & Terms)
| اصطلاح انگلیسی | معادل فارسی مصوب | توضیح یک‌خطی ساده |
| :--- | :--- | :--- |
| Observability | مشاهده‌پذیری سیستم | توانایی درک و استنتاج وضعیت درونی و سلامت نرم‌افزار از روی خروجی‌ها و داده‌های بیرونی آن |
| Uptime Monitoring | پایش پایداری و در دسترس بودن | بررسی مستمر و خودکار آنلاین بودن سایت در فواصل زمانی کوتاه (مثلاً هر ۵ دقیقه) |
| Error Tracking | ردگیری و تله‌گذاری خطاها | ثبت خودکار استک‌تریس و جزئیات خطاهای رخ داده در مرورگر یا سرور کاربران بدون نیاز به گزارش آن‌ها |
| Technical SEO | سئوی تکنیکال و فنی | بهینه‌سازی ساختار کدها، متاتگ‌ها و نقشه سایت برای فهم آسان صفحات توسط خزنده‌های موتور جستجو |
| Heatmap & Session Replay | نقشه حرارتی و بازپخش نشست | ابزار بصری ثبت محل کلیک‌ها، اسکرول‌ها و تماشای ویدیویی نحوه گشت‌وگذار کاربر در صفحات سایت |
---
## ۴. جایگاه‌های تصاویر و نمودارها (Visual & Diagram Placeholders)
> **راهنمای ایجنت نویسنده:** تمام تصاویر باید در پوشهٔ `images/` ذخیره شده و در جدول تک‌خانه‌ای وسط‌چین درج شوند:
1. **تصویر کاور درس:** `images/cover.png`
* **موضوع:** اتاق کنترل دیجیتال مدرن و تاریک با نمودارهای زنده مانیتورینگ ضربان قلب سرور، نقشه‌های حرارتی سایت و زنگ هشدارهای امنیتی.
2. **نقشه راه جامع فصل ۱۳:** `images/chapter-13-roadmap.png`
* **موضوع:** اینفوگرافیک ۷ مرحله‌ای فصل ۱۳ با نمادهای سلامت سرور، UptimeRobot، سنتری، آپدیت وابستگی‌ها، سرچ کنسول، کلاریتی و مستندات گیت‌هاب.
3. **مثلث مراقبت از محصول پس از عرضه:** `images/product-maintenance-triangle.png`
* **موضوع:** دیاگرام مثلثی: ۱) مشاهده‌پذیری و آپتایم $\rightarrow$ ۲) کشف باگ و لاگینگ $\rightarrow$ ۳) بهینه‌سازی بر اساس رفتار واقعی کاربر.
---
## ۵. بخش‌بندی و ساختار محتوایی پیشنهادی درس‌نامه (`README.md`)
1. **تیتر اصلی:** `# اهداف فصل سیزدهم: نگهداری محصول؛ اتاق کنترل سلامت، پایداری و رشد`
2. **مقدمه کوتاه:** چرا بزرگ‌ترین اشتباه یک توسعه‌دهنده، رها کردن سایت به حال خود پس از انتشار است؟
3. **جدول کاور درس**
4. **سرفصل‌های طلایی فصل در یک نگاه:** مرور ۷ ایستگاه مراقبت و مانیتورینگ محصول.
5. **جدول نقشه راه یادگیری فصل**
6. **سه‌گانه طلایی مراقبت: آپتایم، عیب‌یابی با سنتری و تحلیل رفتار با مایکروسافت کلاریتی.**
7. **پورتفولیوی شخصی به عنوان یک سیستم هوشمند و پویا:** دیدن اینکه چه کارفرمایی رزومه شما را دانلود کرده یا روی کدام پروژه کلیک کرده است.
8. **کال‌اوت روحیه‌بخش Quera (`<details class="green">`):** وقتی باگ‌ها قبل از باخبر شدن کارفرما در جیب شما آلارم بزنند، به اوج پرستیژ مهندسی دست یافته‌اید!
---
## ۶. معیارهای پذیرش (Acceptance Criteria for Reviewer)
- [ ] اهداف کلان فصل ۱۳ و لزوم مراقبت پس از استقرار تبیین شود.
- [ ] سرفصل‌های ۷ درس‌نامه بعدی با ذکر ابزارهای مصوب (Sentry, UptimeRobot, Clarity, Search Console) معرفی گردند.
- [ ] مفهوم مشاهده‌پذیری (Observability) به زبان ساده و قابل فهم ارائه شود.