راهنمای Git کیاشو

۱) تصویر کلی

1. مسنجر (app.kiasho.ir) — چت + ساخت اکانت Git
2. Git (git.kiasho.ir) — سورس، تاریخچه، PR
3. لایو (app.kiasho.ir/apps/…) — سایت نهایی کاربر

edit → push branch → Pull Request → merge main → auto build & live

۲) واژه‌نامه

Repository / ریپو

یک پروژه روی Git. مثال: kiasho/anti4 یا kiasho/daftarchat

Clone

دانلود سورس روی لپ‌تاپ

Branch

برگهٔ جدا برای کار تو؛ main نسخهٔ اصلی است

Commit / Push

ذخیره با توضیح، بعد فرستادن به سرور

Pull Request / Merge

درخواست چسباندن شاخه به main؛ بعد از merge سایت لایو می‌شود

CI / Actions

ربات بیلد و دیپلوی روی سرور

Slug

نام اپ در آدرس لایو؛ مثل anti4 → /apps/anti4/

۳) ساخت اکانت Git

1. وارد مسنجر شو: app.kiasho.ir
2. برو پروفایل → اکانت Git (کیاشو)
3. یوزرنیم = همان یوزر مسنجر
4. یک رمز مخصوص Git بساز (جدا از رمز مسنجر)
5. با همان یوزر/رمز وارد git.kiasho.ir شو

یک اکانت برای همهٔ پروژه‌ها کافی است.

۴) کلون

git clone https://git.kiasho.ir/kiasho/anti4.git
cd anti4

نمونهٔ مسنجر:

git clone https://git.kiasho.ir/kiasho/daftarchat.git

اگر دامنه resolve نشد، در hosts بگذار:
171.22.24.49 git.kiasho.ir

۵) شاخه و تغییر

مستقیم روی main کار نکن.

git checkout -b feature/ui-fix
# تغییرات…
git add .
git commit -m "توضیح کوتاه"
git push -u origin feature/ui-fix

۶) لایو کردن

1. در git.kiasho.ir یک Pull Request بساز
2. به main Merge کن
3. Actions بیلد و دیپلوی می‌کند
4. باز کن: app.kiasho.ir/apps/anti4/

merge به main = لایو

۷) سایت / اپ جدید

1. پوشهٔ پروژه را بساز
2. در PowerShell:

   irm https://app.kiasho.ir/kit/up.ps1 | iex

3. یک slug بده → لایو زیر /apps/slug/
4. در Vite: base: '/apps/slug/'
5. ریپو در Git بساز، workflow دیپلوی و Secret به نام KIASHO_TOKEN بگذار

۸) دستورهای روزمره

۹) عیب‌یابی

• رمز مسنجر برای Git کار نمی‌کند — از پروفایل اکانت Git بساز
• بعد از merge لایو نشد — تب Actions و Secret KIASHO_TOKEN را چک کن
• صفحه سفید — مقدار base در Vite باید /apps/slug/ باشد
• دسترسی ریپو نداری — از ادمین بخواه collaborator شوی

آموزش داخل مسنجر (بعد از ورود): منو → آموزش Git