English

توسعه محلی

تنظیم سیکرت‌های محلی

یک فایل .dev.vars در روت پروژه بسازید:

BOT_TOKEN=توکن-ربات-خود-را-اینجا-قرار-دهید
BOT_INFO={"id":123456789,"is_bot":true,"first_name":"MyBot","username":"MyBot","can_join_groups":true,"can_read_all_group_messages":false,"supports_inline_queries":true}

راه‌اندازی دیتابیس محلی

npm run db:init:local

شروع سرور توسعه

npm run dev

Wrangler یک سرور محلی در آدرس http://localhost:8787 راه‌اندازی می‌کند.

اکسپوز کردن با تانل

برای دریافت webhook های تلگرام به صورت محلی، باید سرور محلی خود را با یک تانل اکسپوز کنید:

با استفاده از cloudflared:

cloudflared tunnel --url http://localhost:8787

یا با استفاده از ngrok:

ngrok http 8787

بعد webhook را روی آدرس تانل ثبت کنید:

https://your-tunnel-url.trycloudflare.com/setup

دستورات موجود

دستور	توضیحات
npm run dev	شروع سرور توسعه محلی (پورت 8787)
npm run db:init:local	اعمال مایگریشن‌ها روی D1 محلی
npm run check	بررسی TypeScript + ESLint + Prettier
npm run lint	اجرای ESLint
npm run lint:fix	اجرای ESLint با رفع خودکار
npm run format	فرمت کردن با Prettier
npm run format:check	بررسی فرمت بدون تغییر