4Byte.dev, geliştiriciler için tasarlanmış; makaleler, kurslar, haberler ve etkileşimli kod alanları (CodeSpace) sunan açık kaynaklı bir topluluk platformudur.

Proje, ölçeklenebilirlik ve bakım kolaylığı sağlamak için Laravel Modules yapısı üzerine inşa edilmiştir ve modern bir React + Inertia.js ön yüzü kullanır.

Bu proje, her biri kendi iş mantığına sahip bağımsız modüllerden oluşur:

• Modüler Mimari: Article, Course, News, Entry, User, Tag, Category gibi ayrıştırılmış modüller.
• CodeSpace: Tarayıcı tabanlı kod editörü ve çalışma alanı (Monaco Editor entegrasyonu).
• Öneri Sistemi: Kullanıcı etkileşimlerine dayalı içerik önerileri için Gorse entegrasyonu.
• Admin Paneli: İçerik ve kullanıcı yönetimi için Filament tabanlı güçlü bir yönetim paneli.
• Güçlü Arama: Meilisearch ile desteklenen hızlı ve typo-tolerant (yazım hatası toleranslı) arama.
• Sosyal Etkileşim: Beğeni, yorum, takip etme ve kaydetme özellikleri.
• Rol ve İzinler: Spatie Permission ve Filament Shield ile detaylı yetkilendirme.

Backend & Altyapı:

• Framework: Laravel 11/12
• Veritabanı: PostgreSQL (Uygulama), MySQL (Gorse verisi)
• Cache & Queue: Redis
• Arama Motoru: Meilisearch
• Öneri Motoru: Gorse
• Admin Paneli: FilamentPHP
• Konteynerizasyon: Docker & Docker Compose

Frontend:

• Framework: React
• Adaptör: Inertia.js
• Stil: TailwindCSS & Shadcn UI (Radix)
• Paket Yöneticisi: Bun / NPM
• Build Tool: Vite

Proje, geliştirme ortamını hızlıca ayağa kaldırmak için Docker Compose kullanır.

• Docker ve Docker Compose
• Make (Opsiyonel, ancak önerilir)

1. Repoyu klonlayın:

   git clone [https://github.com/4byte-dev/4byte.dev.git](https://github.com/4bytedev/4byte.dev.git)
   cd 4byte.dev

2. Ortam dosyasını hazırlayın:

   cp .env.example .env

3. Docker konteynerlerini başlatın:

   docker compose --env-file .env --profile app --profile production up -d

   (Geliştirme profili için .env dosyasındaki ayarları ve Makefile içindeki profilleri kontrol edebilirsiniz.)

4. Uygulama kurulumunu tamamlayın: Veritabanı tablolarını oluşturmak, izinleri ayarlamak ve örnek verileri yüklemek için aşağıdaki make komutlarını kullanabilirsiniz:

   make migrate
   make create-permissions
   make seed

   Eğer make kurulu değilse, docker exec ile php artisan migrate, php artisan db:seed komutlarını manuel çalıştırabilirsiniz.

5. Erişim:

   • Web: http://localhost:8000
   • Admin Paneli: http://localhost:8000/admin

Seed işlemi sonrası aşağıdaki bilgilerle giriş yapabilirsiniz:

• Email: admin@example.com
• Şifre: password

Makefile içerisinde tanımlı bazı yararlı komutlar:

• make up: Konteynerleri başlatır.
• make down: Konteynerleri durdurur.
• make logs: Logları izler.
• make shell:app: Uygulama konteynerine terminal erişimi sağlar.
• make test: Testleri çalıştırır.

Katkılarınızı bekliyoruz! Lütfen bir "Pull Request" göndermeden önce mevcut testlerin geçtiğinden ve kod standartlarına (ESLint/Prettier/PHP-CS-Fixer) uyduğunuzdan emin olun.

1. Projeyi Fork'layın.
2. Yeni bir özellik dalı (branch) oluşturun (git checkout -b feature/HarikaOzellik).
3. Değişikliklerinizi Commit'leyin (git commit -m 'feat: HarikaOzellik eklendi').
4. Dalınızı Push'layın (git push origin feature/HarikaOzellik).
5. Bir Pull Request oluşturun.

Bu proje Conventional Commits standardını kullanır.
Commit mesajları okunabilir, anlamlı ve otomasyon dostu olmalıdır.

(): <kısa açıklama>

• type: Yapılan değişikliğin türü
• scope (opsiyonel ama önerilir): Etkilenen modül veya alan
• açıklama: Kısa, net ve emir kipinde

Scope olarak Laravel Modules yapısına uygun isimler kullanılır:

user, role, article, course, news, entry, page, codespace, recommend, search, auth, ci ...

Bu proje GNU General Public License v3.0 (GPL-3.0) altında lisanslanmıştır. Daha fazla bilgi için LICENSE dosyasına bakabilirsiniz.