Kendi sunucunuzda, kendi derneğiniz için.

Başlamadan önce

Bu rehber INSTALLING.md dosyasındaki temel adımları, mevcut paket yapılandırması ve proje notlarıyla tamamlar. Aşağıdaki akış yeni bir geliştirme kurulumu içindir; mevcut veritabanına uygulanmadan önce yedek alınmalıdır.

1. Kaynak kodunu alın

git clone https://github.com/dernekyazilimi/dernekyazilimi.git
cd dernekyazilimi
cp .env.example .env
composer install
composer check-platform-reqs

Kurulumda platform denetimlerini atlamak yerine eksik PHP uzantılarını tamamlayın. Örnek ortam dosyası LKD'ye özgü değerler ve açık modüller içerir; bunları kendi kurumunuza göre düzenleyin.

2. Ortamı yapılandırın

Önce MySQL'de boş bir veritabanı ve bu veritabanına erişebilen kullanıcı oluşturun. .env içinde uygulama adresini, veritabanını ve e-posta ayarlarını düzenleyin. Yerel geliştirmede gerçek ileti göndermemek için aşağıdaki sürücüler kullanılabilir:

APP_ENV=local
APP_DEBUG=true
APP_URL=http://localhost:8000
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=dernek
DB_USERNAME=dernek
DB_PASSWORD=yerel_veritabani_parolaniz
MAIL_MAILER=log
MESSAGING_SMS_DRIVER=log
MESSAGING_WHATSAPP_DRIVER=log
QUEUE_CONNECTION=database

log e-postaları teslim etmez; içerikleri uygulama günlüğüne yazar. Gerçek üyelik ve parola e-postaları için SMTP veya uygun e-posta sağlayıcısını yapılandırın.

php artisan key:generate

Bu komut yeni kurulum içindir. Çalışan bir kurulumun uygulama anahtarını değiştirmeyin; şifreli kayıtlar mevcut anahtara bağlıdır.

3. Veritabanı ve ön yüzü hazırlayın

php artisan migrate
php artisan db:seed --class=CitiesTableSeeder
php artisan db:seed --class=UniversitiesTableSeeder
npm ci
npm run production

Şehir ve üniversite kayıtları ilk kurulumun referans verilerini oluşturur. Kuruma özgü LKD seed dosyalarını genel bir dernek kurulumunda çalıştırmayın.

4. Yerel ortamda çalıştırın

php artisan serve

Uygulamayı http://localhost:8000 adresinde açın. Kuyruğa alınan işleri işlemek için ayrı bir terminalde:

php artisan queue:work

İlk yönetici hesabını oluşturmak için belgelerde hazır bir kurulum komutu tanımlanmıyor. Hesap kaydı ve ilk sahip yetkisinin atanması, kurulumu yapan geliştirici tarafından mevcut kullanıcı/rol modeli üzerinden tamamlanmalıdır. Bu işlem tamamlanmadan yönetim paneli kurulumunu bitmiş saymayın.

5. Kurumunuzu ve modülleri ayarlayın

Yönetim erişimi sağlandıktan sonra kurum adı, logo, iletişim adresleri, sözleşmeler ve e-posta şablonlarını gözden geçirin. .env içindeki MODULE_* değişkenleriyle gereken modülleri seçin.

MODULE_MEMBERSHIP=true
MODULE_DUES=true
MODULE_DONATION=true

Değişiklikten sonra önbelleğe alınmış yapılandırmayı temizleyin:

php artisan optimize:clear

Modül bağımlılıklarını inceleyin →

Canlı ortamda işletim

• Web sunucusunun belge kökünü projenin public/ dizinine yönlendirin; HTTPS kullanın.
• APP_ENV=production, APP_DEBUG=false ve gerçek APP_URL değerini ayarlayın.
• Web uygulamasının storage/ ve bootstrap/cache/ dizinlerine yazabilmesini sağlayın.
• Kuyruk çalışanını servis olarak çalıştırın; güncellemelerde php artisan queue:restart kullanın.
• Zamanlayıcının her dakika php artisan schedule:run çalıştırmasını sağlayın. Hatırlatmalar ve bekleyen kart ödemesi kontrolleri buna bağlıdır.
• Veritabanını, yüklenen dosyaları ve uygulama anahtarını güvenli biçimde yedekleyin; güncellemelerden önce geri dönüş planınızı kontrol edin.

Yazışma PDF desteği gerekiyorsa sunucunuza qpdf kurun. Ödeme, e-posta, SMS ve diğer servislerin hesaplarını ayrıca yapılandırın.