Codebook Bot

Aiogram tabanli Telegram botu. Acik kaynak proje olusturma, admin onayi, proje listesi, katilim talepleri ve GitHub organization entegrasyonu saglar.

Ozellikler

• Kullanici kaydi (Telegram kimligi + GitHub kullanici adi)
• Proje olusturma akisi (isim, aciklama, detay)
• Proje olusturmada admin onayi
• Onaylanan projelerin listelenmesi
• Projelere katilim talebi gonderme
• Proje sahibinin katilim taleplerini onay/reddetmesi
• Onaylanan projeler icin GitHub organization altinda AGPL-3 lisansli repo olusturma
• Katilim onayinda ilgili kullaniciyi GitHub reposuna collaborator olarak ekleme
• Text disi mesajlarda guvenli sekilde hata mesaji donme

Kurulum (uv)

1. Bagimliliklari kur:

uv sync

2. Ortam degiskenlerini ayarla:

cp .env.example .env

3. Botu calistir:

uv run python main.py

Gerekli Ortam Degiskenleri

• TELEGRAM_BOT_TOKEN: Bot token
• ADMIN_IDS: Virgulle ayrilmis Telegram admin ID listesi. Ornek: 123456789,987654321
• GITHUB_TOKEN: GitHub token (repo ve collaborator ekleme yetkili)
• GITHUB_ORG: Reponun olusacagi organization adi
• SQLITE_PATH: (Opsiyonel) SQLite dosya yolu. Varsayilan: codebook_bot.db
• GITHUB_REPO_VISIBILITY: (Opsiyonel) public veya private. Varsayilan: public

Komutlar

• /start: Kayit/hos geldin
• /help: Kullanim bilgisi
• /setgithub: GitHub kullanici adini guncelle
• /newproject: Yeni proje olustur
• /projects: Onaylanan projeleri listele

Notlar

• Bot GitHub API uzerinden repo olusturur ve kullanici ekler.
• Katilim icin kullanicinin GitHub kullanici adini tanimlamasi gerekir.
• Text disi mesajlar desteklenmez; bot aciklayici bir yanit doner.