راهنمای ساخت و مدیریت ریپوی شخصی برای دوره

برای نظم‌دهی بهتر به پروژه‌ها، لطفاً مطابق این راهنما ریپوی شخصی خودت رو بساز و تسک‌هات رو تحویل بده.

---

📁 ساخت ریپوی شخصی

هر دانشجو باید یک ریپوی اختصاصی با فرمت زیر بسازه:

student-[نام]-[نام خانوادگی]

مثال:

• student-zahra-sarami

✅ این ریپو باید public باشه و داخل سازمان گیت‌هاب دوره ساخته بشه.

✅ داخل ریپو یک پوشه به اسم docs بذار و مستندات و تکالیف تئوری رو داخل اون تخویل بده

---

🌿 ساختار برنچ‌ها

برای هز تحویل هر تکلیف، یک برنچ جدید با فرمت زیر بساز:

task-[شماره تسک]-[عنوان تسک]

مثال:

• task-1-project-initialization
• task-2-impliment-login-portal

در این برنچ کدت رو بنویس و تسک‌ها رو انجام بده.

✅ ساختار استاندارد کامیت

برای اینکه تاریخچه تغییرات پروژه قابل فهم، منظم و قابل پیگیری باشد، همه‌ی دانشجوها باید هنگام کامیت کردن از ساختار زیر استفاده کنند:

<type>(task-<number>): <short summary>

type (نوع تغییر):

نوع	توضیح
feat	اضافه کردن قابلیت یا پیاده‌سازی اولیه‌ی یک تسک
fix	رفع باگ یا مشکل فنی
docs	مستندسازی یا نوشتن گزارش تحقیقاتی
style	تغییرات ظاهری مانند فرمت‌بندی یا حذف console.log
refactor	بازسازی یا بهینه‌سازی کد بدون تغییر در رفتار برنامه
test	اضافه یا اصلاح تست‌ها
chore	تغییرات جانبی مثل تنظیمات ابزارها یا به‌روزرسانی .gitignore

مثال:

• feat: اضافه کردن حل سوال اول
• fix: اصلاح خطای منطقی در تابع احراز هویت
• docs: نوشتن گزارش تحقیقاتی مربوط به OAuth
• refactor: بهبود ساختار کد بدون تغییر عملکرد

---

🚀 روند تحویل تسک

1. کدت رو در یک برنچ با نام task-[n] بنویس.
2. در پایان، برنچ رو با main مرج (merge) کن.
3. سپس در ریپوی خودت، یک Pull Request بساز از task-[n] به main.
4. داخل توضیحات PR بنویس که تسک هفته چندمه و چه کار کردی.
5. منتوزها کدت رو بررسی می‌کنن و کامنت می‌ذارن و دز صوزت تایید میتونی با main اون رو مزج کنی.

---

📚 دریافت تسک‌های هفتگی

هر هفته، تسک‌ها در ریپوی مرکزی زیر قرار می‌گیرن:

https://github.com/TechStack-Backend/course-tasks

لطفاً هر هفته به این ریپو سر بزن و تسک هفته جدید رو بررسی کن.

---

📌 قواعد تگ کردن، ریویو و کامنت‌ها

• برای سوال از منتور در کامنت ها، از تگ کردن با @ استفاده کن:

  • @zahrasarami لطفاً این بخش رو بررسی کن

• وقتی کامنتی دریافت کردی:

  • اصلاح مورد نظر رو انجام بده
  • روی کامنت گزینه ✅ Resolve رو بزن که نشون بده رسیدگی کردی

---

⏰ ددلاین تسک‌ها

تحویل تسک‌ها باید تا پایان مهلت تعیین‌شده انجام بشه. در غیر این صورت:

⚠️ تسک مورد بررسی و ریویو قرار نمی‌گیره

---

با آرزوی موفقیت و یادگیری مؤثر 🌱