اگر در دنیای توسعه‌ی بک‌اند با NestJS فعالیت می‌کنی، حتماً می‌دونی که مستندسازی درست APIها چقدر در سرعت توسعه، همکاری تیمی و کاهش خطا مؤثره.
در این دوره آموزش صفر تا صد Swagger با NestJS، یاد می‌گیری چطور با استفاده از Swagger و OpenAPI، مستندات خودکار و کاملاً قابل‌اجرا برای APIهای پروژه‌هات تولید کنی.

در طول دوره، تمام مثال‌ها با NestJS و ابزار رسمی آن یعنی @nestjs/swagger پیاده‌سازی می‌شن تا دقیقاً بدونی در پروژه‌های واقعی باید چطور از Swagger استفاده کنی.

سرفصل‌های دوره آموزش Swagger با NestJS 

۱. Swagger و Open APIs

• آشنایی با Swagger و OpenAPI

• مزایای مستندسازی خودکار API

۲. نصب Swagger در NestJS

• نصب پکیج‌ها و آماده‌سازی پروژه

• تنظیمات اولیه برای راه‌اندازی Swagger

۳. تنظیمات پیشرفته Swagger (Options)

• پیکربندی گزینه‌های Swagger

• شخصی‌سازی مستندات و اطلاعات API

۴. Swagger Options تکمیلی

• استفاده از گزینه‌های پیشرفته‌تر

• تعریف تنظیمات global و جزئیات API

۵. ایجاد اولین API و مستندسازی آن

• طراحی اولین endpoint

• افزودن توضیحات، پارامترها و پاسخ‌ها

۶. مستندسازی APIهای RESTful با Swagger

• پیاده‌سازی CRUD و نمایش مستندات خودکار

• بررسی تفاوت‌های REST و نحوه مستندسازی

۷. DTO و ApiProperty و Schemaها

• تعریف DTOها برای درخواست و پاسخ

• استفاده از ApiProperty برای مستندسازی دقیق

۸. Generics و Circular Dependency

• مدیریت مدل‌های پیچیده و Generic

• حل مشکل Circular Dependency در Swagger

۹. Enumها در Swagger

• مستندسازی مقادیر Enum

• نمایش مقادیر قابل قبول در Swagger UI

۱۰. Nested Structures در Swagger

• مستندسازی مدل‌های Nested

• نحوه نمایش سلسله مراتبی داده‌ها

۱۱. Upload فایل‌ها و مستندسازی آن

• افزودن endpointهای آپلود فایل

• مستندسازی پارامترهای فایل در Swagger

۱۲. امنیت و احراز هویت در Swagger

• افزودن JWT و Bearer Token

• محدود کردن دسترسی به مستندات

۱۳. اطلاعات تکمیلی و نکات پیشرفته

• نکات نهایی و Best Practices

• بررسی نکات کاربردی برای مستندسازی حرفه‌ای

🎯 مخاطبان این دوره آموزش Swagger

• برنامه‌نویسان بک‌اند (Node.js / NestJS / Express)

• توسعه‌دهندگان فول‌استک

• اعضای تیم‌های DevOps و QA

• هرکسی که با API کار می‌کند و می‌خواهد مستندات حرفه‌ای بسازد

⚙️ پیش‌نیازها

• شناخت مفاهیم REST API

• آشنایی کامل با NestJS

❓ سوالات متداول (FAQ)

1. آیا برای شروع باید Swagger بلد باشم؟
خیر، از صفر همه چیز را یاد می‌گیرید.

2. آیا این دوره فقط مخصوص NestJS است؟
خیر، مفاهیم Swagger عمومی است، فقط مثال‌ها در NestJS اجرا شده‌اند.

3. بعد از این دوره چه مهارتی کسب می‌کنم؟
قادر خواهید بود مستندات API هر پروژه‌ای را با Swagger به‌صورت حرفه‌ای ایجاد و منتشر کنید.