feat: add chapter 13-product-maintenance specs

This commit is contained in:
2026-09-05 22:36:38 +08:00
parent 18b9a967cf
commit 6e568c95b1
7 changed files with 727 additions and 0 deletions

View File

@@ -0,0 +1,82 @@
# مشخصات درس‌نامه: اهداف فصل سیزدهم (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) به زبان ساده و قابل فهم ارائه شود.