feat: add chapter 01-introduction specs

This commit is contained in:
2026-09-05 21:37:25 +08:00
parent bb01742a6a
commit e16cca93ee
7 changed files with 437 additions and 5 deletions

View File

@@ -0,0 +1,111 @@
# مشخصات درس‌نامه: گواهی کوئرا کالج (Quera College Certificate)
- **شناسه در سیلابس:** `L1.4`
- **فصل:** فصل ۱: مقدمه (Ch 1)
- **نوع محتوا:** 📘 درس‌نامه متنی
- **زمان تقریبی مطالعه:** ۶ دقیقه
- **پیش‌نیازهای مستقیم:** `L1.3` (قالب کوئرا کالج)
---
## ۱. اهداف یادگیری (Learning Objectives - Bloom's Taxonomy)
دانشجو پس از مطالعهٔ این درس‌نامه باید بتواند:
- [ ] **درک کند (Understand):** شرایط لازم برای صدور گواهی پایان دورهٔ کوئرا کالج (خواندن ۱۰۰٪ درس‌نامه‌ها و کسب حداقل نمره در ارزیابی‌ها).
- [ ] **درک کند (Understand):** سطوح چهارگانهٔ گواهی (Perfect، Very Good، Good، Fair) بر اساس امتیاز نهایی چگونه محاسبه می‌شوند.
- [ ] **به‌کار ببندد (Apply):** قاعدهٔ صدور یک‌بارهٔ گواهی را بداند و قبل از درخواست صدور نهایی، امتیازات خود را به سطح مورد نظر ارتقا دهد.
- [ ] **به‌کار ببندد (Apply):** شیوهٔ اعتبارسنجی آنلاین گواهی و اشتراک‌گذاری حرفه‌ای آن در لینکدین (LinkedIn) و رزومه را بشناسد.
---
## ۲. محدوده و مرزهای محتوا (Scope & Boundaries)
### آنچه باید پوشش داده شود (In-Scope):
1. **ارزش گواهی کوئرا کالج:** گواهی رسمی دو زبانه با شناسه اعتبارسنجی اختصاصی آنلاین قابل استعلام برای کارفرمایان.
2. **شرایط احراز گواهی:**
* ثبت مطالعهٔ تمام درس‌نامه‌ها با دکمه «خواندم».
* شرکت در آزمون‌های تستی و کسب حداقل امتیاز لازم (حداقل ۵۰٪ یا ۱۰۰ امتیاز از ۲۰۰ امتیاز کل).
* انجام و تحویل پروژه‌های نقطهٔ عطف دوره.
3. **جعبهٔ نکتهٔ کوئرا (`<details class="green">`):** تفاوت بین مطالعه درس‌نامه (پیش‌نیاز تکمیل) و کسب امتیاز از آزمون‌ها برای ارتقای سطح گواهی.
4. **جدول سطوح چهارگانه گواهی:** تفکیک دقیق بازه‌های امتیازی بر اساس ۲۰۰ امتیاز کل دوره:
* **Perfect:** ۱۹۰ تا ۲۰۰ امتیاز
* **Very Good:** ۱۷۰ تا ۱۸۹ امتیاز
* **Good:** ۱۴۰ تا ۱۶۹ امتیاز
* **Fair:** ۱۰۰ تا ۱۳۹ امتیاز
5. **قانون صدور یک‌باره:** تاکید بر اینکه گواهی فقط یک بار صادر می‌شود و باید قبل از فشردن دکمه درخواست، بالاترین نمره ممکن را کسب کرد.
6. **نمونه گواهی و کاربرد شغلی:** درج تصویر نمونه گواهی + راهنمای افزودن به بخش Licenses & Certifications در لینکدین و رزومه‌های بین‌المللی.
7. **جمع‌بندی فصل اول:** مرور پایان مقدمات و اعلام آمادگی برای ورود به فصل دوم («شروع مسیر Vibe Coding»).
### آنچه نباید وارد آن شویم (Out-of-Scope):
- مباحث فنی فصل دوم یا تعاریف هوش مصنوعی.
- نحوه ثبت سفارش پروژه‌ها در خارج از کوئرا.
---
## ۳. مفاهیم کلیدی و کلمات تخصصی (Key Concepts & Terms)
| اصطلاح انگلیسی | معادل فارسی مصوب | توضیح یک‌خطی ساده |
| :--- | :--- | :--- |
| Certificate of Completion | گواهی پایان دوره | مدرک رسمی معتبر که نشان‌دهندهٔ تسلط بر مهارت‌های وایب کدینگ است |
| Certificate Levels | سطوح گواهی | چهار درجه کیفی (Perfect, Very Good, Good, Fair) بر اساس امتیاز نهایی |
| Verification URL | لینک اعتبارسنجی | آدرس اختصاصی اینترنتی برای استعلام صحت مدرک توسط شرکت‌ها و کارفرمایان |
---
## ۴. جایگاه‌های تصاویر و نمودارها (Visual & Diagram Placeholders)
> **راهنمای ایجنت نویسنده:** تمام تصاویر باید در پوشهٔ `images/` قرار گرفته و در قالب جدول تک‌خانه‌ای وسط‌چین با کپشن تفصیلی درج شوند:
1. **تصویر کاور درس:** `images/cover.png`
* **موضوع:** کاور جذاب گواهی رسمی کوئرا کالج با نماد مدرک، نشان اعتبار، تم تیره و ستاره‌های رتبه‌بندی.
2. **نمودار پلکان سطوح گواهی:** `images/certificate-tiers.png`
* **موضوع:** نمایش پلکانی چهار سطح گواهی کوئرا کالج (Fair $\rightarrow$ Good $\rightarrow$ Very Good $\rightarrow$ Perfect) به همراه بازه امتیازی هر سطح.
3. **تصویر نمونه گواهی:** `images/sample-certificate.png` (یا لینک تصویر باکیفیت کوئرا)
* **موضوع:** نمونه واقعی گواهی پایان دوره دو زبانه با شناسه رهگیری، کیوآرکد و امضای رسمی کوئرا کالج.
---
## ۵. بخش‌بندی و ساختار محتوایی پیشنهادی درس‌نامه (`README.md`)
مطابق با الگوی درس گواهی کوئرا کالج در FastAPI:
1. **تیتر اصلی:** `# گواهی کوئرا کالج`
2. **پاراگراف مقدمه:** تشریح گواهی پایان دوره (*Certificate of Completion*) و شرایط کلی دریافت آن.
3. **جدول کاور:**
```markdown
| ![کاور درس‌نامهٔ گواهی کوئرا کالج](./images/cover.png) |
| :-: |
```
4. **جعبه نکته کوئرا:**
```html
<details class="green">
<summary>**نکته: تفاوت ثبت درس‌نامه و کسب امتیاز از آزمون‌ها**</summary>
خواندن درس‌نامه‌ها شرط لازم برای باز شدن مسیر است، اما سطح گواهی شما را نمراتی تعیین می‌کند که از آزمون‌های تستی و تکمیل پروژه‌ها کسب می‌کنید...
</details>
```
5. **بخش سطوح گواهی (`## سطوح گواهی`):**
* توضیح سازوکار محاسبه نمره از ۲۰۰ امتیاز کل دوره.
* جدول سطوح گواهی:
| سطح گواهی | مجموع امتیاز |
| :-: | :-: |
| $\textbf{Perfect}$ | ۱۹۰ تا ۲۰۰ |
| $\textbf{Very Good}$ | ۱۷۰ تا ۱۸۹ |
| $\textbf{Good}$ | ۱۴۰ تا ۱۶۹ |
| $\textbf{Fair}$ | ۱۰۰ تا ۱۳۹ |
* همراه با نمودار `certificate-tiers.png`.
6. **تاکید بر قانون صدور یک‌باره:** پیش از صدور نهایی، فرصت دارید امتیاز خود را در کوییزها به حداکثر برسانید.
7. **بخش نمونه گواهی و اعتبار شغلی:**
```markdown
| ![نمونه گواهی کوئرا کالج](./images/sample-certificate.png) |
| :-: |
| نمونهٔ گواهی رسمی و معتبر کوئرا کالج با شناسهٔ اعتبارسنجی آنلاین. |
```
8. **راهنمای استفاده در رزومه و لینکدین:** اشتراک‌گذاری در شبکه لینکدین و رزومه‌های بین‌المللی.
9. **جمع‌بندی فصل مقدمه و ورود به فصل ۲:** تبریک پایان فصل اول و اعلام ورود به **«فصل ۲: شروع مسیر Vibe Coding»**.
---
## ۶. معیارهای پذیرش درس‌نامه (Acceptance Criteria Checklist)
- [ ] بازه‌های امتیازی جدول دقیقاً بر اساس ۲۰۰ امتیاز کل دورهٔ وایب کدینگ تنظیم شده باشد.
- [ ] جدول کاور و تصاویر سطوح و نمونه گواهی در `images/` قرار گرفته و در جدول‌های وسط‌چین درج شوند.
- [ ] باکس `<details class="green">` برای تبیین شرایط امتیازگیری و ثبت درس‌نامه‌ها استفاده شود.
- [ ] قانون صدور یک‌بارهٔ گواهی به وضوح توضیح داده شود.
- [ ] در پایان درس، جمع‌بندی فصل اول و انتقال به فصل دوم (`فصل ۲: شروع مسیر Vibe Coding`) درج شده باشد.