کیاشو تکنولوژی مسنجر

۱) تصویر کلی — این سیستم چیه؟

فرض کن سه تا جای جدا داریم:

1. مسنجر (app.kiasho.ir) — چت تیم + ساخت اکانت Git + همین آموزش
2. Git (git.kiasho.ir) — انبار سورس کد، تاریخچه، شاخه، Pull Request
3. سایت لایو (app.kiasho.ir/apps/…) — جایی که کاربر نهایی اپ را می‌بیند

جریان طلایی:

کد بنویس → push → Pull Request → merge به main → خودکار بیلد و لایو

مثل دفتر نقاشی مشترک: روی برگهٔ خودت بکش، بعد بگو به دفتر اصلی بچسبانند.

۲) واژه‌نامه — هر چیز به چه کاری می‌آید؟

Git

ابزار ذخیرهٔ تاریخچهٔ کد. می‌فهمد چه چیزی عوض شد، کی عوض کرد، و می‌شود به عقب برگشت.

Forgejo / git.kiasho.ir

سایت Git خودمان (شبیه GitHub). ریپو، PR، و Actions اینجاست.

Repository / ریپو

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

Clone

دانلود کل پروژه + تاریخچه‌اش روی لپ‌تاپ خودت.

Branch / شاخه

یک خط جدا برای کار تو. main شاخهٔ اصلی/لایو است؛ تو روی feature/… کار می‌کنی.

Commit

عکس فوری از تغییرات با یک توضیح کوتاه. مثل «ذخیره با یادداشت».

Push

فرستادن commitها از لپ‌تاپ به سرور Git.

Pull Request (PR)

درخواست: «لطفاً شاخهٔ من را به main بچسبانید». جایی برای بررسی قبل از لایو.

Merge

چسباندن شاخه به main. بعد از merge، CI شروع می‌شود.

CI / Actions

ربات روی سرور: بیلد می‌گیرد و با kiasho deploy لایو می‌کند.

Slug

اسم کوتاه اپ در آدرس لایو. مثال: anti4 → /apps/anti4/

kiasho push / deploy

دستور CLI برای آپلود بیلد به سرور Apps (جدا از Git، ولی CI از همین استفاده می‌کند).

KIASHO_TOKEN

رمز دیپلوی برای CI/CLI. برای git clone لازم نیست؛ برای لایو کردن لازم است.

رمز Git vs رمز مسنجر

دو تا رمز جدا. مسنجر برای چت؛ Git برای ورود به git.kiasho.ir و push.

۳) ساخت اکانت Git (اولین قدم)

1. در مسنجر برو پروفایل
2. کارت اکانت Git (کیاشو)
3. یوزرنیم = همان یوزر مسنجر (عوض نمی‌شود)
4. یک رمز مخصوص Git بگذار (حداقل ۸ حرف) و بساز
5. برو git.kiasho.ir و با همان یوزر/رمز وارد شو

این اکانت برای همهٔ پروژه‌ها یکی است؛ برای هر سایت رمز جدید لازم نیست.

۴) کلون کردن پروژه

بعد از ساخت اکانت، روی لپ‌تاپ:

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

اگر یوزر/پسورد خواست: همان اکانت Git از پروفایل.

اگر آدرس باز نشد، این خط را به فایل 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

• checkout -b = برگهٔ جدید برای خودت
• add + commit = ذخیره با یادداشت
• push = فرستادن به سرور

۶) چطور سایت لایو می‌شود؟

1. برو git.kiasho.ir
2. روی ریپو → Pull Request بساز (شاخه‌ات → main)
3. Merge کن
4. منتظر Actions بمان (بیلد + دیپلوی)
5. باز کن: app.kiasho.ir/apps/anti4/

راه میانبر ادمین (بدون PR): روی لپ‌تاپ kiasho push — برای تیم معمولی همان PR بهتر است.

۷) سایت / اپ جدید از صفر

1. پوشهٔ پروژه را بساز (مثلاً Vite + Tailwind، اختیاری .NET)
2. داخل پوشه بزن:

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

3. یک slug بده (مثل shop) → لایو می‌شود روی /apps/shop/
4. در Vite مقدار base: '/apps/shop/' را بگذار
5. در git.kiasho.ir ریپو بساز، سورس را push کن، workflow دیپلوی را اضافه کن، Secret به نام KIASHO_TOKEN بگذار

از آن به بعد همان چرخه: شاخه → PR → merge → لایو.

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

۹) مشکل داری؟

• git.kiasho.ir باز نمی‌شود — hosts یا DNS؛ IP سرور: 171.22.24.49
• clone رمز می‌خواهد و رد می‌شود — اول از پروفایل اکانت Git بساز؛ رمز مسنجر کار نمی‌کند
• بعد از merge لایو نشد — در ریپو تب Actions را ببین؛ Secret به نام KIASHO_TOKEN لازم است
• صفحه سفید / مسیر اشتباه — base در Vite باید /apps/slug/ باشد
• دسترسی به ریپو ندارم — از ادمین بخواه تو را collaborator کند (بعد از ساخت اکانت معمولاً anti4 خودکار است)

لینک‌های مهم: Git · نمونه لایو anti4