initial commit

This commit is contained in:
2026-09-05 14:55:48 +03:30
parent e96254b831
commit 0528ace58b
9 changed files with 556 additions and 0 deletions

View File

@@ -0,0 +1,37 @@
# شیوه‌نامهٔ نگارش فنی و استانداردهای کوئرا کالج
## دورهٔ وایب کدینگ (Vibe Coding)
این شیوه‌نامه استانداردهای زبانی، ساختاری و بصری درس‌نامه‌های متنی و تمرین‌های دوره را مشخص می‌کند.
---
## ۱. لحن و زبان نگارش (Tone & Voice)
* **مخاطب دوره:** افراد بدون پیش‌زمینهٔ کدنویسی (طراحان، مدیران محصول، کارآفرینان، بازاریاب‌ها و علاقه‌مندان).
* **لحن:** صمیمی، حرفه‌ای، تشویق‌کننده، شفاف و بدون اصطلاحات پیچیدهٔ غیرضروری.
* **رعایت نیم‌فاصله‌ها:** در تمام متون فارسی، نیم‌فاصله برای پیشوندها و پسوندها (مانند «می‌شود»، «درس‌نامه»، «ایجنت‌ها»، «راه‌اندازی») الزامی است.
* **اصطلاحات فنی:** اصطلاحات کلیدی (مثل Token, Context Window, Prompt, Agent, Git, Repository, PRD, MVP, Mock Data, Supabase) در اولین اشاره به همراه معادل انگلیسی درون پرانتز یا پاورقی آورده شوند.
---
## ۲. ساختار استاندارد درس‌نامه‌های کوئرا (Lesson Anatomy)
هر درس‌نامه متنی باید ساختار زیر را رعایت کند:
1. **مقدمه و قلاب (Hook):** یک موقعیت واقعی، مسئله یا چالش روزمره که ضرورت این موضوع را نشان می‌دهد.
2. **شرح مفهوم به زبان ساده (Core Concept):** توضیح اصل موضوع بدون پرداختن به جزییات زائد. استفاده از استعاره‌ها و نمودارهای بصری (Mermaid).
3. **جعبه‌های راهنما و هشدار (Admonitions):**
- `> [!NOTE]` برای نکات تکمیلی و پس‌زمینه
- `> [!TIP]` برای ترفندها و پرامپت‌های طلایی
- `> [!IMPORTANT]` برای ملزومات کلیدی
- `> [!WARNING]` برای اشتباهات رایج و توهم‌های هوش مصنوعی (AI Hallucinations)
4. **جعبه پرامپت نمونه (Ready-to-Use Prompt):** پرامپت‌های کپی-پیست آماده برای ادیتورهایی مثل Cursor/Claude Code.
5. **جمع‌بندی و گام بعدی (Summary & Action Item):** خلاصه در ۳-۴ بالت پوینت کوتاه به همراه پیش‌نمایش درس بعدی.
---
## ۳. استاندارد تمرین‌های داوری خودکار (Judge Problems)
* **داستان‌پردازی بومی (Iranian Startup Scenarios):** تمرین‌ها حول مسائل واقعی استارتاپ‌ها (اسنپ‌فود، دیوار، طاقچه، دیجی‌کالا، فیلیمو، علی‌بابا، تپسی، شیپور، پونیشا، والکس، بازار، ویرگول، آپارات، جابینجا) طراحی می‌شوند.
* **وضوح خروجی:** دانشجو باید دقیقاً بداند چه فایل‌هایی با چه ساختاری و چه فرمتی از او خواسته شده است.
* **پیام‌های خطای آموزشی:** تست‌های داور خودکار باید خطاهای شفاف تولید کنند تا دانشجو با ارائهٔ همان خطا به هوش مصنوعی بتواند کد را دیباگ کند.

View File

@@ -0,0 +1,43 @@
# راهنمای گردش‌کار توسعهٔ مبتنی بر مشخصات (Spec-Driven Development — SDD)
## دورهٔ وایب کدینگ — کوئرا کالج
در این مخزن، تمام محتواها، درس‌نامه‌ها، تمرین‌های داوری خودکار و آزمون‌های تستی **باید** بر اساس متدولوژی **Spec-Driven Development (SDD)** تولید شوند.
---
## اصول کلیدی SDD در این مخزن
1. **قانون طلایی (No Spec, No Content):**
هیچ درس‌نامه (`lesson.md`)، هیچ کد مسئله‌ای (`problem.md`, `solution/`, `tests/`) و هیچ سوال تستی بدون داشتن یک فایل مشخصات (`spec.md`) تایید شده، نباید نوشته شود.
2. **سلسله‌مراتب توسعه:**
```
[Syllabus / Spreadsheet]
│
▼
[Phase 1: Lesson / Exercise Spec (spec.md)]
│
▼ (User Review & Approval)
[Phase 2: Reference Implementation / Content Draft]
│
▼
[Phase 3: Automated Test Matrix & Verification]
│
▼
[Phase 4: Final Publish-Ready Review]
```
3. **تفکیک مسئولیت پوشه‌ها:**
هر درس‌نامه یا تمرین در پوشهٔ اختصاصی خود در ساختار زیر قرار می‌گیرد:
- **درس‌نامه:** `chapters/ch<XX>-<name>/<YY>-<lesson-slug>/`
- `spec.md` (مشخصات و اهداف یادگیری)
- `lesson.md` (متن نهایی درس‌نامه کوئرا)
- **تمرین داوری:** `chapters/ch<XX>-<name>/<YY>-<exercise-slug>/`
- `spec.md` (مشخصات ورودی/خروجی، سناریو، سنجه‌های داوری)
- `problem.md` (صورت مسئله برای دانشجو)
- `initial/` (کد و اسکلت اولیه)
- `solution/` (پاسخ مرجع و بهینه)
- `tests/` (مجموعه تست‌های داوری خودکار)
- **تمرین تستی:** `chapters/ch<XX>-<name>/<YY>-<quiz-slug>/`
- `spec.md` (مشخصات مفهومی و توزیع گزینه‌ها)
- `questions.json` یا `questions.md` (صورت سوال، گزینه‌ها، پاسخ صحیح و تحلیل گزینه‌های گمراه‌کننده)

View File

@@ -0,0 +1,69 @@
---
name: course-sdd-planner
description: >-
Use this skill when planning, structuring, or generating specification documents (spec.md)
for chapters and lessons in the Vibe Coding course for Quera College.
---
# Course SDD Planner (طراحی و تدوین مشخصات درس‌نامه‌ها)
این مهارت راهنمای تدوین سند مشخصات (`spec.md`) برای هر درس‌نامه در متدولوژی Spec-Driven Development است. قبل از نوشتن هرگونه محتوای متنی، باید این سند ایجاد و تایید شود.
---
## ساختار فایل `spec.md` برای درس‌نامه‌ها
هر درس‌نامه باید در مسیر `chapters/ch<XX>-<name>/<YY>-<slug>/spec.md` دارای این قالب باشد:
```markdown
# مشخصات درس‌نامه: [عنوان درس‌نامه]
- **شناسه در سیلابس:** L<X>.<Y>
- **فصل:** [شماره و نام فصل]
- **نوع محتوا:** 📘 درس‌نامه متنی
- **زمان تقریبی مطالعه:** [مثلاً ۱۰ دقیقه]
- **پیش‌نیازهای مستقیم:** [شناسه درس‌های قبلی یا "ندارد"]
---
## ۱. اهداف یادگیری (Learning Objectives - Bloom's Taxonomy)
دانشجو پس از مطالعهٔ این درس باید بتواند:
- [ ] **درک کند (Understand):** [مفهوم کلیدی ۱]
- [ ] **به‌کار ببندد (Apply):** [مهارت یا پرامپت عملی ۱]
- [ ] **تحلیل/ارزیابی کند (Evaluate):** [تشخیص خروجی صحیح از خطای هوش مصنوعی]
---
## ۲. محدوده و مرزهای محتوا (Scope & Boundaries)
- **آنچه باید پوشش داده شود (In-Scope):**
- نکته الف
- نکته ب
- **آنچه نباید وارد آن شویم (Out-of-Scope - جلوگیری از سردرگمی):**
- مباحث پیچیده و نامرتبط که جلوتر تدریس می‌شوند.
---
## ۳. مفاهیم کلیدی و کلمات تخصصی (Key Concepts & Terms)
| اصطلاح انگلیسی | معادل فارسی مصوب | توضیح یک‌خطی ساده |
| :--- | :--- | :--- |
| Prompt | پرامپت (درخواست/دستور) | پیامی که به هوش مصنوعی می‌دهیم تا خروجی تولید کند |
---
## ۴. استعاره‌ها، سناریوهای ملموس و دیاگرام‌ها (Pedagogy & Visuals)
- **داستان/استعاره ملموس:** [تشبیه موضوع به یک کار روزمره برای درک بدون پیش‌نیاز فنی]
- **دیاگرام پیشنهادی (Mermaid):** [شرح فلوچارت یا نمودار مورد نیاز]
---
## ۵. پرامپت‌ها و ابزارهای مورد استفاده در درس
- **ابزار هدف:** (Cursor / Claude Code / Lovable / Supabase / ...)
- **پرامپت طلایی نمونه:** [متن پرامپت پیشنهادی که در درس آموزش داده می‌شود]
---
## ۶. معیارهای پذیرش درس‌نامه (Acceptance Criteria)
- [ ] آیا لحن صمیمی و ساده برای غیربرنامه‌نویسان رعایت شده است؟
- [ ] آیا اصطلاحات انگلیسی به همراه معادل فارسی آورده شده‌اند؟
- [ ] آیا حداقل یک باکس هشدار توهم هوش مصنوعی یا نکته طلایی وجود دارد؟
- [ ] آیا پرامپت نمونه تست‌شده و بدون خطا کار می‌کند؟
```

View File

@@ -0,0 +1,9 @@
---
name: quera-judge-problem-spec
description: >-
Use this skill when defining specifications, starter code, test suites, and judge rubrics
for automated judge exercises (coding, configuration, or LLM-judged problems) for Quera College.
---
# Quera Judge Problem Specifier (طراحی تمرین‌های داوری خودکار)

View File

@@ -0,0 +1,73 @@
---
name: quera-lesson-author
description: >-
Use this skill when drafting or refining full document-based lessons (lesson.md)
from an approved spec.md file, following Quera College pedagogical and formatting rules.
---
# Quera Lesson Author (نگارش درس‌نامه‌های متنی کوئرا کالج)
این مهارت راهنمای تبدیل یک سند مشخصات تایید شده (`spec.md`) به متن نهایی و جذاب درس‌نامه (`lesson.md`) است.
---
## چک‌لیست قبل از نگارش
1. آیا فایل `spec.md` در پوشهٔ درس وجود دارد و اهداف آن مشخص است؟
2. آیا شیوه‌نامه نگارش فارسی کوئرا (`.agents/rules/quera-styleguide.md`) بررسی شده است؟
---
## ساختار نگارشی درس‌نامه (`lesson.md`)
```markdown
# [عنوان درس‌نامه]
[مقدمه جذاب و قلاب داستانی: چرا این موضوع برای کسی که می‌خواهد با هوش مصنوعی محصول بسازد حیاتی است؟]
---
## [عنوان بخش اول: مفهوم اصلی به زبان ساده]
[توضیح شفاف همراه با استعاره‌های روزمره و مقایسه‌های ملموس]
```mermaid
flowchart LR
A[ایده اولیه] --> B[پرامپت ساختاریافته]
B --> C[کد تولید شده با AI]
C --> D[بررسی و تست خروجی]
```
> [!NOTE]
> [نکته تکمیلی درباره عملکرد هوش مصنوعی یا پیش‌زمینه مورد نیاز]
---
## [عنوان بخش دوم: پیاده‌سازی عملی و کار با ابزار]
[گام‌های عملی استفاده از ادیتور/ابزار به همراه تصویرسازی ذهنی]
> [!TIP]
> **پرامپت پیشنهادی برای ادیتور:**
> ```text
> [متن دقیق و تمیز پرامپت آماده استفاده]
> ```
---
## [عنوان بخش سوم: خطرات و توهم‌های رایج هوش مصنوعی]
> [!WARNING]
> **مراقب این تله باشید:**
> [توضیح خطایی که ایجنت‌ها ممکن است در این مرحله مرتکب شوند و نحوه هدایت مجدد آن‌ها]
---
## جمع‌بندی و گام بعدی
در این درس یاد گرفتیم که:
- **نکته ۱:** [خلاصه نکته کلیدی]
- **نکته ۲:** [خلاصه نکته کلیدی]
- **نکته ۳:** [خلاصه نکته کلیدی]
> در درس بعدی به سراغ **[عنوان درس بعد]** می‌رویم تا یاد بگیریم چگونه ...
```

View File

@@ -0,0 +1,9 @@
---
name: quera-quiz-spec
description: >-
Use this skill when designing theoretical, conceptual, and multiple-choice quiz questions
for the Vibe Coding course on Quera College.
---
# Quera Quiz Specifier (طراحی آزمون‌های تستی و مفهومی)

49
.gitattributes vendored Normal file
View File

@@ -0,0 +1,49 @@
# Set default behavior: auto-detect text files and normalize line endings to LF
* text=auto eol=lf
# Markdown and documentation
*.md text eol=lf
*.txt text eol=lf
# Web & Programming languages
*.js text eol=lf
*.jsx text eol=lf
*.ts text eol=lf
*.tsx text eol=lf
*.html text eol=lf
*.css text eol=lf
*.scss text eol=lf
*.json text eol=lf
*.py text eol=lf
*.sql text eol=lf
# Configuration & data
*.yml text eol=lf
*.yaml text eol=lf
*.toml text eol=lf
*.xml text eol=lf
*.env* text eol=lf
# Shell scripts must strictly use LF
*.sh text eol=lf
*.bash text eol=lf
# Windows scripts require CRLF
*.bat text eol=crlf
*.cmd text eol=crlf
*.ps1 text eol=crlf
# Binary formats (prevent line ending conversion and diff corruption)
*.png binary
*.jpg binary
*.jpeg binary
*.gif binary
*.webp binary
*.ico binary
*.pdf binary
*.zip binary
*.tar.gz binary
*.woff binary
*.woff2 binary
*.ttf binary
*.eot binary

15
.gitignore vendored Normal file
View File

@@ -0,0 +1,15 @@
# Operating System Files
.DS_Store
Thumbs.db
desktop.ini
# IDE & Editor files
.vscode/
.idea/
*.swp
*.swo
*~
# Temporary files & logs
*.tmp
*.log

252
curriculum/syllabus.md Normal file
View File

@@ -0,0 +1,252 @@
# نقشهٔ راه و سیلابس تفصیلی دورهٔ وایب کدینگ (Quera College)
> **عنوان دوره:** وایب کدینگ: ساخت پروژهٔ واقعی با هوش مصنوعی (Build & Ship Real Projects with AI)
> **مخاطب:** بدون نیاز به دانش برنامه‌نویسی؛ فقط تجربهٔ کاربری کامپیوتر و چت با ابزارهای هوش مصنوعی (طراحان، مدیران محصول، کارآفرینان و متخصصان حوزه‌های مختلف)
> **پیش‌نیاز:** آشنایی با کار با کامپیوتر و اینترنت (بدون نیاز به سابقه برنامه‌نویسی)
> **آمار کل دوره:** ۱۶ فصل | ۱۰۷ درس‌نامه متنی | ۲ آزمون تستی | ۲ نقطهٔ عطف پروژهٔ عملی | ۲۰۰ امتیاز کل
> **سند مرجع نهایی:** [Google Sheets — Vibe Coding Course Syllabus (FINAL)](https://docs.google.com/spreadsheets/d/1E3sD6iRgE_CzRktGRlggvuBLk2NRPPq1k8Mab7TcUMk/edit?gid=652437728#gid=652437728)
---
## جدول خلاصه فصول (Chapter Summary)
| فصل | نام فصل | تعداد درس‌نامه | آزمون تستی | پروژه عملی | جمع امتیاز | محور و تمرکز فصل |
| :---: | :--- | :---: | :---: | :---: | :---: | :--- |
| **۱** | مقدمه | ۴ | ۰ | — | ۰ | آشنایی با دوره، نقشهٔ راه، متدولوژی و شیوه دریافت گواهی |
| **۲** | شروع مسیر Vibe Coding | ۷ | ۱ | — | ۱۰۰ | ذهنیت وایب کدینگ، LLMها، ابزارها و متدولوژی SDD |
| **۳** | راه‌اندازی محیط کار | ۸ | ۱ | — | ۱۰۰ | نصب و راه‌اندازی ابزارهای ادیتور، CLI، وب و Git |
| **۴** | از ایده تا محصول | ۹ | ۰ | — | ۰ | تبدیل ایده به مسئله، داستان کاربر، PRD و Task Breakdown |
| **۵** | طراحی تجربه و هویت محصول | ۹ | ۰ | — | ۰ | طراحی UI/UX با AI، پرهیز از AI Slop و سیستم‌های طراحی |
| **۶** | آماده‌سازی Prototype | ۷ | ۰ | — | ۰ | مبانی فرانت‌اند مدرن، Next.js، ساخت پروتوتایپ با Mock Data |
| **۷** | داده و بک‌اند | ۸ | ۰ | — | ۰ | مفاهیم داده، API، دیتابیس Supabase و احراز هویت |
| **۸** | پروژه ۱ | — | ۰ | نقطهٔ عطف ۱ | ۰ | ساخت کامل پروتوتایپ کاربردی و اتصال آن به پایگاه داده |
| **۹** | تست و Debugging | ۶ | ۰ | — | ۰ | انواع تست، دیباگ سیستماتیک خطاها و رفع خطاهای هوش مصنوعی |
| **۱۰** | اتصال سرویس‌های بیرونی | ۸ | ۰ | — | ۰ | سرویس‌های شخص ثالث (SMS، ایمیل، درگاه پرداخت و API مدل‌های هوش مصنوعی) |
| **۱۱** | امنیت و استفاده مسئولانه | ۹ | ۰ | — | ۰ | چک‌لیست انتشار، مدیریت Secretها، امنیت وب، Rate Limiting و اخلاق |
| **۱۲** | انتشار روی اینترنت | ۷ | ۰ | — | ۰ | محیط‌های استقرار، PaaS، اتصال دیتابیس پروداکشن، دامنه و SSL |
| **۱۳** | نگهداری محصول | ۷ | ۰ | — | ۰ | مانیتورینگ، مدیریت لاگ، سئو فنی، تحلیل رفتار کاربر و مستندسازی |
| **۱۴** | پروژه ۲ | — | ۰ | نقطهٔ عطف ۲ | ۰ | یکپارچه‌سازی کامل سرویس‌ها، تست، ارتقای امنیت و انتشار نهایی |
| **۱۵** | تکامل محصول با AI | ۱۲ | ۰ | — | ۰ | تحلیل فیدبک، ری‌فکتور، ایجنت‌های خودکار، PWA، اپ موبایل و دسکتاپ |
| **۱۶** | ادامه راه | ۶ | ۰ | — | ۰ | گذار به مهندسی ایجنتیک، ارکستراسیون، بررسی موردی غول‌های فناوری و آینده |
| **جمع** | **۱۶ فصل** | **۱۰۷** | **۲** | **۲ پروژه** | **۲۰۰** | — |
---
## جدول تفصیلی فصول و درس‌نامه‌ها (Detailed Syllabus)
### فصل ۱: مقدمه (Ch 1)
| ردیف | شناسه | نوع | عنوان | توضیحات تحت پوشش | امتیاز / سطح |
| :---: | :--- | :--- | :--- | :--- | :---: |
| ۱ | `L1.1` | 📘 درس‌نامه | پیش‌گفتار | معرفی دوره، مسیر یادگیری و آنچه در پایان به‌دست می‌آورید | — |
| ۲ | `L1.2` | 📘 درس‌نامه | نگاه کلی به دوره | چرا وایب کدینگ، نقشهٔ فصل‌ها و پیش‌نیازهای دوره | — |
| ۳ | `L1.3` | 📘 درس‌نامه | قالب کوئرا کالج | نحوهٔ کار درس‌نامه‌ها، ویدیوهای مکمل، تمرین‌ها و سیستم داوری | — |
| ۴ | `L1.4` | 📘 درس‌نامه | گواهی کوئرا کالج | شرایط و نحوهٔ دریافت گواهی پایان دوره | — |
---
### فصل ۲: شروع مسیر Vibe Coding (Ch 2)
| ردیف | شناسه | نوع | عنوان | توضیحات تحت پوشش | امتیاز / سطح |
| :---: | :--- | :--- | :--- | :--- | :---: |
| ۱ | `L2.1` | 📘 درس‌نامه | اهداف فصل | توضیح خلاصه‌ای از آنچه در این فصل گفته می‌شود | — |
| ۲ | `L2.2` | 📘 درس‌نامه | تعریف وایب کدینگ و نقش تازهٔ شما | وایب کدینگ چیست، چه چیزی نیست و چه تفاوتی با «کدنویسی با کمک AI» دارد و چه چیزهایی را شما تعریف می‌کنید | — |
| ۳ | `L2.3` | 📘 درس‌نامه | مدل‌های زبانی چطور کد می‌نویسند | توکن، پنجرهٔ متن (Context)، احتمال‌محور بودن و پدیدهٔ توهم (Hallucination) | — |
| ۴ | `L2.4` | 📘 درس‌نامه | ابزارها Cursor, Claude Code, Codex, Lovable & Bolt | خانوادهٔ ابزارها (ادیتور، ترمینال، مرورگر) و اینکه هرکدام برای چه کاری خوب‌اند | — |
| ۵ | `L2.5` | 📘 درس‌نامه | انتظارات واقع‌بینانه و هزینه | کجا AI عالی است، کجا شکست می‌خورد، و مقایسهٔ پلن‌های رایگان و پولی | — |
| ۶ | `L2.6` | 📘 درس‌نامه | اصول مهندسی پرامپت | چگونه درخواست‌های دقیق و مؤثر برای هوش مصنوعی بنویسیم | — |
| ۷ | `L2.7` | 📘 درس‌نامه | متودولوژی‌های توسعه نرم‌افزار با AI | آشنایی با متدولوژی توسعه مشخصات‌محور (SDD) و چرخهٔ تکرارشوندهٔ ساخت، بازخورد و هدایت ایجنت‌ها | — |
| ۸ | `Q2.1` (`L2.7`) | 📝 تمرین تستی | جمع‌بندی مطالب فصل | داوری تستی خودکار ارزیابی مفاهیم پایه‌ای وایب کدینگ | ۱۰۰ (متوسط) |
---
### فصل ۳: راه‌اندازی محیط کار (Ch 3)
| ردیف | شناسه | نوع | عنوان | توضیحات تحت پوشش | امتیاز / سطح |
| :---: | :--- | :--- | :--- | :--- | :---: |
| ۱ | `L3.1` | 📘 درس‌نامه | اهداف فصل | توضیح خلاصه‌ای از مباحث فصل | — |
| ۲ | `L3.2` | 📘 درس‌نامه | آماده‌سازی سیستم | نصب ابزارهای پایه، مرورگر و ساخت حساب‌های کاربری | — |
| ۳ | `L3.3` | 📘 درس‌نامه | ابزارهای نصبی (Cursor و Codex و Claude Code) | نصب و راه‌اندازی، ویرایشگر هوشمند و قابلیت‌های اصلی | — |
| ۴ | `L3.4` | 📘 درس‌نامه | ابزاری‌های تحت ترمینال (OpenCode و ...) | استفاده از ابزارهای خط فرمان برای توسعه با هوش مصنوعی | — |
| ۵ | `L3.5` | 📘 درس‌نامه | ابزارهای مرورگری (Lovable و Bolt) | ساخت سریع نسخه اولیه در مرورگر بدون نیاز به نصب | — |
| ۶ | `L3.6` | 📘 درس‌نامه | آشنایی با Git و GitHub (به زبان ساده) | آشنایی با سیستم کنترل نسخه به عنوان ماشین زمان کدها و نحوه استفاده از گیت‌هاب | — |
| ۷ | `L3.7` | 📘 درس‌نامه | استفاده از Skillها و MCPها | نحوه افزودن مهارت‌های جدید به AI برای توسعه بهتر | — |
| ۸ | `L3.8` | 📘 درس‌نامه | ساختار و آناتومی پروژه | آشنایی با فایل‌ها و پوشه‌های اصلی یک پروژه نرم‌افزاری | — |
| ۹ | `Q3.1` (`L3.9`) | 📝 تمرین تستی | جمع‌بندی مطالب فصل | داوری تستی خودکار تسلط بر راه‌اندازی محیط و ابزارها | ۱۰۰ (متوسط) |
---
### فصل ۴: از ایده تا محصول (Ch 4)
| ردیف | شناسه | نوع | عنوان | توضیحات تحت پوشش | امتیاز / سطح |
| :---: | :--- | :--- | :--- | :--- | :---: |
| ۱ | `L4.1` | 📘 درس‌نامه | اهداف فصل | توضیح خلاصه‌ای از مباحث و اهداف فصل | — |
| ۲ | `L4.2` | 📘 درس‌نامه | از ایده تا مسئله | تبدیل ایده خام به یک مسئله مشخص و قابل حل | — |
| ۳ | `L4.3` | 📘 درس‌نامه | داستان کاربر | نوشتن User Story برای درک بهتر نیازمندی‌ها | — |
| ۴ | `L4.4` | 📘 درس‌نامه | کاربر هدف و پرسونا | شناخت Target User و نیازهای اصلی او + پرسونای مناسب | — |
| ۵ | `L4.5` | 📘 درس‌نامه | محدوده محصول و تعریف MVP | تعیین ویژگی‌های کلیدی برای اولین نسخه محصول | — |
| ۶ | `L4.6` | 📘 درس‌نامه | فیچرها و معیارهای پذیرش | تعریف دقیق Featureها و شروط تایید آن‌ها (Acceptance Criteria) | — |
| ۷ | `L4.7` | 📘 درس‌نامه | تحلیل نیازمندی‌ها | تفاوت ویژگی‌های سیستمی و کیفی محصول (Functional & Non-Functional Requirements) | — |
| ۸ | `L4.8` | 📘 درس‌نامه | نوشتن PRD با AI | ساخت سند نیازمندی کوتاه و دقیق که مبنای همهٔ پرامپت‌ها باشد | — |
| ۹ | `L4.9` (`L4.10`) | 📘 درس‌نامه | فهرست تسک | تبدیل PRD به تسک‌های قابل‌اجرا و انتخاب ترتیب درست ساخت | — |
---
### فصل ۵: طراحی تجربه و هویت محصول (Ch 5)
| ردیف | شناسه | نوع | عنوان | توضیحات تحت پوشش | امتیاز / سطح |
| :---: | :--- | :--- | :--- | :--- | :---: |
| ۱ | `L5.1` | 📘 درس‌نامه | اهداف فصل | توضیح خلاصه‌ای از مباحث و اهداف فصل | — |
| ۲ | `L5.2` | 📘 درس‌نامه | مبانی تجربه کاربری و User Flow | اصول پایه UX و طراحی مسیر کاربر | — |
| ۳ | `L5.3` | 📘 درس‌نامه | وایرفریم و سلسله‌مراتب بصری | طراحی اولیه صفحات و اولویت‌بندی عناصر | — |
| ۴ | `L5.4`| 📘 درس‌نامه | تایپوگرافی و پالت رنگی | انتخاب فونت و رنگ‌های مناسب برای هویت بصری | — |
| ۵ | `L5.5` | 📘 درس‌نامه | فاصله‌گذاری و چیدمان | اصول ایجاد فضای سفید و ساختاردهی به صفحات | — |
| ۶ | `L5.6` | 📘 درس‌نامه | طراحی واکنش‌گرا | سازگاری محصول با دستگاه‌ها و نمایشگرهای مختلف | — |
| ۷ | `L5.7` | 📘 درس‌نامه | کامپوننت‌ها، وضعیت‌ها و انیمیشن | طراحی اجزای تعاملی و متحرک | — |
| ۸ | `L5.8` | 📘 درس‌نامه | سیستم طراحی | ایجاد یکپارچگی در طراحی با استفاده از Design System | — |
| ۹ | `L5.9` | 📘 درس‌نامه | ایده‌پردازی با AI و جلوگیری از AI Slop | استفاده اصولی از هوش مصنوعی و پرهیز از خروجی‌های بی‌کیفیت با ارائه‌ی نمونه از 21st.dev، Pinterest و ... | — |
---
### فصل ۶: آماده‌سازی Prototype (Ch 6)
| ردیف | شناسه | نوع | عنوان | توضیحات تحت پوشش | امتیاز / سطح |
| :---: | :--- | :--- | :--- | :--- | :---: |
| ۱ | `L6.1` | 📘 درس‌نامه | اهداف فصل | توضیح خلاصه‌ای از مباحث و اهداف فصل | — |
| ۲ | `L6.2` | 📘 درس‌نامه | معرفی مسیر فرانت‌اند و فریم‌ورک‌ها | آشنایی با ابزارها و انتخاب Next.js یا React + استفاده از TypeScript | — |
| ۳ | `L6.3` | 📘 درس‌نامه | کامپوننت‌ها و کتابخانه‌های فرانت‌اند | استفاده از ابزارهایی مثل shadcn/ui و Material UI | — |
| ۴ | `L6.4` | 📘 درس‌نامه | طراحی رابط کاربری با Mock Data | پیاده‌سازی ظاهر صفحات با داده‌های تستی | — |
| ۵ | `L6.5` (`L6.6`) | 📘 درس‌نامه | مدیریت وضعیت‌های مختلف UI | مدیریت حالت‌های بارگذاری (Loading)، خطا (Error) و داده‌های خالی (Empty States) | — |
| ۶ | `L6.6` (`L6.8`) | 📘 درس‌نامه | طراحی واکنش‌گرا و سازگاری | اطمینان از نمایش درست و منعطف در موبایل و دسکتاپ | — |
| ۷ | `L6.7` (`L6.9`) | 📘 درس‌نامه | تعامل با Agentها برای بهبود کد | گرفتن بازخورد و دیباگ کدهای فرانت‌اند با هوش مصنوعی و تکرار و توسعه تدریجی | — |
---
### فصل ۷: داده و بک‌اند (Ch 7)
| ردیف | شناسه | نوع | عنوان | توضیحات تحت پوشش | امتیاز / سطح |
| :---: | :--- | :--- | :--- | :--- | :---: |
| ۱ | `L7.1` | 📘 درس‌نامه | اهداف فصل | توضیح خلاصه‌ای از مباحث و اهداف فصل | — |
| ۲ | `L7.2` (`L7.10`) | 📘 درس‌نامه | مقایسه زبان‌ها و فریمورک‌های سرور | معرفی فریم‌ورک‌های ترند بک‌اند و دیتابیس‌های پر استفاده | — |
| ۳ | `L7.3` (`L7.2`) | 📘 درس‌نامه | مدیریت داده‌ها در سمت کاربر و سرور | تفاوت دادهٔ موقت مرورگر با دادهٔ ماندگار و اینکه هرکدام کِی لازم است | — |
| ۴ | `L7.4` (`L7.3`) | 📘 درس‌نامه | آشنایی با API و ارتباط با سرور | مدل درخواست/پاسخ (Request/Response)، متدهای رایج و شکل دادهٔ JSON در حد کاربردی | — |
| ۵ | `L7.5` (`L7.4`) | 📘 درس‌نامه | طراحی داده‌ها و مدل‌سازی | طراحی Data Model، ERD و ارتباط موجودیت‌ها، و File Storage | — |
| ۶ | `L7.6` (`L7.6`) | 📘 درس‌نامه | پیاده‌سازی چهار عمل اصلی دیتابیس | ساخت، خواندن، ویرایش و حذف رکورد در رابط کاربری (CRUD) | — |
| ۷ | `L7.7` (`L7.8`) | 📘 درس‌نامه | استفاده از دیتابیس آماده (Supabase) | ساخت جدول، تعریف ستون‌ها و وصل کردن پروژه با کمک AI | — |
| ۸ | `L7.8` (`L7.9`) | 📘 درس‌نامه | احراز هویت و کنترل دسترسی | مفاهیم پایه‌ای Authentication و Authorization | — |
---
### فصل ۸: پروژه ۱ (Ch 8)
| ردیف | شناسه | نوع | عنوان | توضیحات تحت پوشش | امتیاز / سطح |
| :---: | :--- | :--- | :--- | :--- | :---: |
| — | `P8` | 🚀 پروژه عملی | نقطهٔ عطف اول: ساخت کامل پروتوتایپ و اتصال دیتابیس | پیاده‌سازی یک محصول کاربردی دارای فرانت‌اند، مدیریت وضعیت و ذخیره‌سازی ابری داده‌ها | نقطهٔ عطف |
---
### فصل ۹: تست و Debugging (Ch 9)
| ردیف | شناسه | نوع | عنوان | توضیحات تحت پوشش | امتیاز / سطح |
| :---: | :--- | :--- | :--- | :--- | :---: |
| ۱ | `L9.1` | 📘 درس‌نامه | اهداف فصل | توضیح خلاصه‌ای از مباحث و اهداف فصل | — |
| ۲ | `L9.2` | 📘 درس‌نامه | چرا Agent اشتباه می‌کند؟ | شناخت دلایل خطای هوش مصنوعی مانند توهم (Hallucination) و محدودیت کانتکست | — |
| ۳ | `L9.3` | 📘 درس‌نامه | انواع تست و اهمیت آن‌ها | آشنایی با تست‌های Unit، Integration و E2E و کاربرد هرکدام | — |
| ۴ | `L9.4` | 📘 درس‌نامه | بررسی و Code Review خروجی | روش‌های بازبینی کد تولید شده و اطمینان از کیفیت و امنیت آن | — |
| ۵ | `L9.5` (`L9.6`) | 📘 درس‌نامه | اصول دیباگ کردن خطاها | خواندن لاگ‌ها، درک پیام‌های خطا و پیدا کردن ریشه مشکل | — |
| ۶ | `L9.6` (`L9.7`) | 📘 درس‌نامه | دیباگ تعاملی با Agent | نحوه ارائه خطاها به Agent برای دریافت راه‌حل و رفع سریع باگ‌ها (+ فیچرهایی که داخل اپ‌های کدکس و کلاد برای Annotation مستقیم وجود دارد) | — |
---
### فصل ۱۰: اتصال سرویس‌های بیرونی (Ch 10)
| ردیف | شناسه | نوع | عنوان | توضیحات تحت پوشش | امتیاز / سطح |
| :---: | :--- | :--- | :--- | :--- | :---: |
| ۱ | `L10.1` | 📘 درس‌نامه | اهداف فصل | توضیح خلاصه‌ای از مباحث و اهداف فصل | — |
| ۲ | `L10.2` | 📘 درس‌نامه | سرویس Third-party چیست؟ | آشنایی با مفهوم سرویس‌های شخص ثالث و کاربرد آن‌ها در توسعه نرم‌افزار | — |
| ۳ | `L10.3` | 📘 درس‌نامه | استفاده از سرویس‌های خارجی | چگونه مستندات APIها را بخوانیم و از آن‌ها در پروژه استفاده کنیم + مدیریت API Key و Credentials | — |
| ۴ | `L10.4` | 📘 درس‌نامه | ارسال SMS و Email | پیاده‌سازی سرویس‌های ارسال پیامک برای ارتباط با کاربران | — |
| ۵ | `L10.5` | 📘 درس‌نامه | ارسال Emailهای کد ورود و تبلیغاتی | پیاده‌سازی سرویس‌های ارسال ایمیل برای ارتباط با کاربران | — |
| ۶ | `L10.6` | 📘 درس‌نامه | احراز هویت (Authentication Provider) | استفاده از سرویس‌های احراز هویت خارجی مانند Google، GitHub و غیره | — |
| ۷ | `L10.7` (`L10.8`) | 📘 درس‌نامه | پرداخت (Payment) | آشنایی با درگاه‌های پرداخت و نحوه اتصال آن‌ها به محصول در حالت Sandbox | — |
| ۸ | `L10.8` (`L10.10`) | 📘 درس‌نامه | اتصال سرویس‌های هوش مصنوعی | نحوه ادغام مدل‌های هوش مصنوعی و APIهای مرتبط در برنامه‌ها | — |
---
### فصل ۱۱: امنیت و استفاده مسئولانه (Ch 11)
| ردیف | شناسه | نوع | عنوان | توضیحات تحت پوشش | امتیاز / سطح |
| :---: | :--- | :--- | :--- | :--- | :---: |
| ۱ | `L11.1` | 📘 درس‌نامه | اهداف فصل | توضیح خلاصه‌ای از مباحث و اهداف فصل | — |
| ۲ | `L11.2` | 📘 درس‌نامه | چک‌لیست پیش از انتشار (Pre-Launch Checklist) | فهرست کارهایی که پیش از نشان دادن پروژه به دیگران باید انجام دهید و ارزیابی نهایی پروژه | — |
| ۳ | `L11.3` | 📘 درس‌نامه | مدیریت Secretها و API Keyها | نحوه نگهداری امن کلیدها و جلوگیری از نشت اطلاعات حساس در پروژه‌های ساخته‌شده با AI | — |
| ۴ | `L11.4` (`L11.5`) | 📘 درس‌نامه | احراز هویت و کنترل دسترسی (Auth & Access) | بررسی Authentication و Authorization و جلوگیری از دسترسی‌های غیرمجاز به بخش‌های حساس | — |
| ۵ | `L11.5` (`L11.6`) | 📘 درس‌نامه | اعتبارسنجی ورودی‌ها و جلوگیری از XSS | اهمیت Validation داده‌های کاربر و مقابله با حملات تزریق کد (Cross-Site Scripting) | — |
| ۶ | `L11.6` (`L11.8`) | 📘 درس‌نامه | امنیت دیتابیس و آپلود فایل | ایمن‌سازی ارتباط با پایگاه داده و بررسی خطرات امنیتی هنگام دریافت فایل از کاربر | — |
| ۷ | `L11.7` (`L11.9`) | 📘 درس‌نامه | مدیریت Dependencyها و کتابخانه‌ها | بررسی امنیت پکیج‌های استفاده شده توسط Agent و جلوگیری از نصب کدهای مخرب | — |
| ۸ | `L11.8` (`L11.10`) | 📘 درس‌نامه | جلوگیری از حملات DDOS با Rate Limiting | پیاده‌سازی مکانیزم‌های محدودسازی نرخ درخواست کاربران برای جلوگیری از حملات DOS | — |
| ۹ | `L11.9` (`L11.11`) | 📘 درس‌نامه | هزینه، مالکیت و اخلاق (Cost & Responsibility) | مدیریت هزینه ابزارها، مالکیت کدهای تولیدشده و پذیرش مسئولیت خروجی نهایی محصول | — |
---
### فصل ۱۲: انتشار روی اینترنت (Ch 12)
| ردیف | شناسه | نوع | عنوان | توضیحات تحت پوشش | امتیاز / سطح |
| :---: | :--- | :--- | :--- | :--- | :---: |
| ۱ | `L12.1` | 📘 درس‌نامه | اهداف فصل | توضیح خلاصه‌ای از مباحث و اهداف فصل | — |
| ۲ | `L12.2` | 📘 درس‌نامه | محیط‌های توسعه و تولید | تفاوت Development، Staging و Production و آشنایی با Build Mode | — |
| ۳ | `L12.3` | 📘 درس‌نامه | مفاهیم پایه وب برای انتشار | آشنایی با Domain، Host، DNS، SSL و CDN | — |
| ۴ | `L12.4` | 📘 درس‌نامه | انتخاب مدل Deployment | آشنایی با PaaS، سرویس‌های دارای Free Tier و Git-based Deployment | — |
| ۵ | `L12.5` | 📘 درس‌نامه | دیپلوی پروژه به همراه Dependencyها | انتشار پروژه روی سرویس‌های PaaS و اتصال Production Database | — |
| ۶ | `L12.6` | 📘 درس‌نامه | تنظیمات محیط تولید | تنظیم Environment Variables در محیط واقعی و تفاوت آن با لوکال | — |
| ۷ | `L12.7` (`L12.8`) | 📘 درس‌نامه | تنظیم دامنه و DNS | اتصال Custom Domain، تنظیمات DNS و فعال‌سازی HTTPS و CDN | — |
---
### فصل ۱۳: نگهداری محصول (Ch 13)
| ردیف | شناسه | نوع | عنوان | توضیحات تحت پوشش | امتیاز / سطح |
| :---: | :--- | :--- | :--- | :--- | :---: |
| ۱ | `L13.1` | 📘 درس‌نامه | اهداف فصل | توضیح خلاصه‌ای از مباحث و اهداف فصل | — |
| ۲ | `L13.2` | 📘 درس‌نامه | Observability - Monitoring | بررسی وضعیت منابع و عملکرد سرور | — |
| ۳ | `L13.3` | 📘 درس‌نامه | Observability - Alerting | بررسی وضعیت آپتایم سرور و تنظیم هشدار | — |
| ۴ | `L13.4` | 📘 درس‌نامه | Logging و رفع خطای Production | ثبت لاگ‌ها و Error Tracking + بررسی مشکلات Production | — |
| ۵ | `L13.5` (`L13.6`) | 📘 درس‌نامه | به‌روزرسانی امنیتی | بررسی Security Updateها و به‌روزرسانی Dependencyها | — |
| ۶ | `L13.6` (`L13.7`) | 📘 درس‌نامه | SEO و Analytics | مبانی سئو پایه و تحلیل داده‌های ترافیک (Analytics) | — |
| ۷ | `L13.7` (`L13.9`) | 📘 درس‌نامه | مستندسازی | داکیومنت‌نویسی برای درک بهتر پروژه برای افراد جدید | — |
---
### فصل ۱۴: پروژه ۲ (Ch 14)
| ردیف | شناسه | نوع | عنوان | توضیحات تحت پوشش | امتیاز / سطح |
| :---: | :--- | :--- | :--- | :--- | :---: |
| — | `P14` | 🚀 پروژه عملی | نقطهٔ عطف دوم: انتشار محصول کامل و امن روی اینترنت | یکپارچه‌سازی سرویس‌های خارجی (پرداخت/پیامک)، اعمال امنیت، بهینه‌سازی و استقرار کامل | نقطهٔ عطف |
---
### فصل ۱۵: تکامل محصول با AI (Ch 15)
| ردیف | شناسه | نوع | عنوان | توضیحات تحت پوشش | امتیاز / سطح |
| :---: | :--- | :--- | :--- | :--- | :---: |
| ۱ | `L15.1` | 📘 درس‌نامه | اهداف فصل | توضیح خلاصه‌ای از مباحث و اهداف فصل | — |
| ۲ | `L15.2` | 📘 درس‌نامه | تحلیل بازخورد و اولویت‌بندی تغییرات | تحلیل Feedback کاربران و انتخاب مهم‌ترین تغییرات برای نسخه بعدی | — |
| ۳ | `L15.3` | 📘 درس‌نامه | تعریف Feature و Specification جدید | تعریف دقیق ویژگی‌های جدید و ایجاد Specification برای Agent | — |
| ۴ | `L15.4` | 📘 درس‌نامه | تحلیل Codebase موجود با Agent | نحوه استفاده از Agent برای درک و بررسی کدهای از پیش نوشته شده | — |
| ۵ | `L15.5` | 📘 درس‌نامه | بهبود کد و Refactoring | بازنویسی و تمیز کردن کدهای قدیمی بدون شکستن قابلیت‌های موجود | — |
| ۶ | `L15.6` (`L15.7`) | 📘 درس‌نامه | اضافه کردن قابلیت‌های AI به محصول | نحوه ادغام ویژگی‌های هوشمند در محصول برای ارائه ارزش بیشتر به کاربران | — |
| ۷ | `L15.7` (`L15.8`) | 📘 درس‌نامه | ساخت Agentic Workflow | طراحی گردش‌کارهای مبتنی بر Agent برای انجام خودکار کارهای تکراری | — |
| ۸ | `L15.8` (`L15.9`) | 📘 درس‌نامه | اتوماسیون نگهداری و توسعه | خودکارسازی فرآیندهای نگهداری، تست و استقرار کدهای جدید | — |
| ۹ | `L15.9` (`L15.10`) | 📘 درس‌نامه | Product Insights با AI | استفاده از هوش مصنوعی برای تحلیل داده‌های Analytics و رفتار کاربر | — |
| ۱۰ | `L15.10` (`L15.11`) | 📘 درس‌نامه | تبدیل وب‌سایت به وب‌اپلیکیشن | پیاده‌سازی قابلیت‌های PWA، کارکرد آفلاین و قابلیت نصب روی دستگاه کاربر | — |
| ۱۱ | `L15.11` (`L15.12`) | 📘 درس‌نامه | ساخت اپ موبایل | خروجی گرفتن نسخه موبایل Android و iOS با استفاده از ابزارهای کراس‌پلتفرم | — |
| ۱۲ | `L15.12` (`L15.13`) | 📘 درس‌نامه | ساخت اپ دسکتاپ | تبدیل وب‌اپلیکیشن به نسخه دسکتاپ با استفاده از Electron یا Tauri | — |
---
### فصل ۱۶: ادامه راه (Ch 16)
| ردیف | شناسه | نوع | عنوان | توضیحات تحت پوشش | امتیاز / سطح |
| :---: | :--- | :--- | :--- | :--- | :---: |
| ۱ | `L16.1` | 📘 درس‌نامه | اهداف فصل | توضیح خلاصه‌ای از مباحث و اهداف فصل | — |
| ۲ | `L16.2` | 📘 درس‌نامه | از Vibe Coding تا Agentic Engineering در سازمان‌ها | تفاوت کدنویسی تفریحی با مهندسی ایجنتیک، اهمیت معماری، حاکمیت (Governance) و تست‌های خودکار در تیم‌های بزرگ | — |
| ۳ | `L16.3` | 📘 درس‌نامه | بررسی موردی: هوش مصنوعی در شرکت‌های بزرگ | نمونه‌های واقعی اسنپ، دیجی‌کالا، کافه‌بازار و دیوار در استفاده از ابزارهای AI و Agentها برای تسریع توسعه | — |
| ۴ | `L16.4` | 📘 درس‌نامه | نقش جدید توسعه‌دهنده: ارکستراتور سیستم‌ها | تبدیل شدن برنامه‌نویس به مدیر و ناظر ایجنت‌ها (Orchestrator)، و مهارت‌های کلیدی برای آینده بازار کار | — |
| ۵ | `L16.5` | 📘 درس‌نامه | مسیر آینده و یادگیری مستمر | چگونه پس از پایان دوره به‌روز بمانیم و پیشرفت کنیم | — |
| ۶ | `L16.6` | 📘 درس‌نامه | جمع‌بندی دوره و منابع تکمیلی | مرور مسیر طی شده و دستاوردهای دوره + معرفی منابع مفید | — |
---
## فهرست تمرین‌ها و سیستم ارزیابی (Problem & Assessment Index)
بر اساس شیت رسمی نهایی، سنجش دوره بر پایه آزمون‌های مفهومی و نقاط عطف پروژه استوار است:
| شماره | فصل | شناسه | عنوان آزمون | نوع داوری | امتیاز | سطح | پیش‌نیاز |
| :---: | :---: | :--- | :--- | :--- | :---: | :---: | :--- |
| ۱ | ۲ | `Q2.1` | جمع‌بندی مطالب فصل ۲ | داوری تستی (خودکار) | ۱۰۰ | متوسط | درس‌نامه‌های فصل ۲ |
| ۲ | ۳ | `Q3.1` | جمع‌بندی مطالب فصل ۳ | داوری تستی (خودکار) | ۱۰۰ | متوسط | درس‌نامه‌های فصل ۳ |
| — | — | — | **مجموع کل امتیازات** | — | **۲۰۰** | — | — |