# Magic Starter Laravel

**Uygulama backend'ini controller yazmadan yayına alın.**

Magic Starter'ın Laravel backend'i: giriş, iki adımlı doğrulama, takım, bildirim ve faturalama Sanctum token'lı JSON route'ları olarak gelir. Her özellik bir anahtardır, her aksiyon değiştirilebilir.

Çalıştığı platformlar: PHP 8.2+, Laravel 12.32+, Laravel 13

## Uygulamanızın API'si, hazır.

Giriş, takım, bildirim ve faturalama, özellik anahtarlarının arkasında JSON route'ları olarak gelir. Uygulamanın ihtiyacı olanı açın, istediğiniz aksiyonu kendi sınıfınızla değiştirin.

### Her yoldan giriş

Giriş, kayıt ve şifre sıfırlama bir Sanctum token'ı ile cevap verir; e-posta, telefon ya da ikisiyle. Sosyal, misafir ve telefon OTP girişi özellik anahtarlarının arkasındadır.

- `two-factor-authentication` QR kodlu TOTP, kurtarma kodları ve giriş doğrulamasını ekler
- Telefon OTP yalnızca log'a yazan bir `LogOtpProvider` ile gelir: önce `SendsOtpCodes` bağlayın

[Dokümanı okuyun: Her yoldan giriş](https://anilcancakir.com/magic-starter-laravel/docs/basics/authentication.md)

### Takımlar ve davetler

Takım oluşturun, e-postayla davet edin, üye rollerini değiştirin ve aktif takıma geçin. `restorable-teams` ile silinen takım bir süre geri alınabilir.

- `teams` seçilince kurulum `Team`, `TeamUser`, `TeamInvitation` modellerini ve bir `TeamPolicy` yayınlar
- `magic-starter:purge-trashed-teams` komutunu kendiniz zamanlayın: paket onu kaydeder ama hiçbir şeyi zamanlamaz

[Dokümanı okuyun: Takımlar ve davetler](https://anilcancakir.com/magic-starter-laravel/docs/basics/teams.md)

### İki kanallı abonelik

Laravel Cashier üzerinden Stripe, RevenueCat üzerinden App Store ve Google Play; kullanıcı ya da takım üzerinde tek bir erişim hakkı olarak tutulur.

- `cashier-migrations` yayınlamayın: `billing.billable` ne derse desin `users` tablosunu ve tamsayı birincil anahtarları hedefler
- `billing:manifest` sağlayıcıların neye sahip olması gerektiğini yazdırır, `billing:doctor` bunu denetler

[Dokümanı okuyun: İki kanallı abonelik](https://anilcancakir.com/magic-starter-laravel/docs/basics/billing.md)

### Bildirim ve push

Okunmamış sayısı ve tür başına, kanal başına bir tercih matrisiyle veritabanı bildirimleri. `onesignal` açıkken push OneSignal üzerinden gider.

- OneSignal uyuşmayan bir external id'yi kabul eder ve kimseye ulaştırmaz: öneki istemcinin önekiyle aynı tutun
- Mail, bir router transport ile OneSignal'a her seferinde bir mail sınıfı olarak taşınır

[Dokümanı okuyun: Bildirim ve push](https://anilcancakir.com/magic-starter-laravel/docs/basics/notifications.md)

### Filament ile isteğe bağlı yönetim paneli

`magic-starter:filament:install` kullanıcı, takım, faturalama, denetim, sürüm notu ve destek kaynakları olan bir panel ekler; her kaynak yalnızca özelliği açıkken görünür.

- Yöneticileri `MAGIC_STARTER_ADMIN_EMAILS` içinde listeleyin: boş liste kimseyi içeri almaz
- Her yazma, API'nin çağırdığı aksiyon sözleşmesinden geçer

```php
use Filament\Models\Contracts\FilamentUser;
use AnilcanCakir\MagicStarter\Filament\Concerns\AuthorizesAdminPanel;

class User extends Authenticatable implements FilamentUser
{
    use AuthorizesAdminPanel;
}
```

[Dokümanı okuyun: Filament ile isteğe bağlı yönetim paneli](https://anilcancakir.com/magic-starter-laravel/docs/basics/admin-panel.md)

### Her aksiyon değiştirilebilir

Controller'lar ince kalır ve `Contracts\` altındaki bir sözleşmeyi enjekte eder. Kendi sınıfınızı bağlayın, API ve yönetim paneli birlikte değişir.

- `vendor:publish --tag=magic-starter-stubs` siz gerçekleştirene kadar hata fırlatan iskeletleri kopyalar
- Modeller çalışma anında `MagicStarter::userModel()`, `teamModel()` ve `billableModel()` ile çözülür

```php
// app/Providers/AppServiceProvider.php
use AnilcanCakir\MagicStarter\Contracts\CreatesUsers;
use App\Actions\MagicStarter\CreateUser; // your class

public function register(): void
{
    $this->app->bind(CreatesUsers::class, CreateUser::class);
}
```

[Dokümanı okuyun: Her aksiyon değiştirilebilir](https://anilcancakir.com/magic-starter-laravel/docs/architecture/action-contracts.md)

## Sorular, cevaplar.

Magic Starter Laravel paketini bir Laravel uygulamasına eklemeden önce sorulanlar.

### Magic Starter Laravel nedir?

Magic Starter Laravel; kimlik doğrulama, iki adımlı doğrulama, sosyal giriş, profil, takım, bildirim, faturalama ve bir destek masasını Sanctum token'lı JSON route'ları olarak sunan bir Laravel paketidir. Flutter başlangıç paketi `magic_starter`'ın backend'idir.

### Magic Starter Laravel nasıl kurulur?

`composer require anilcancakir/magic-starter-laravel` çalıştırın, ardından `php artisan magic-starter:install` ve `php artisan migrate`. Kurulum hangi özelliklerin açılacağını sorar, `users` tablonuza bakarak UUID ya da tamsayı birincil anahtar seçer ve config'i, migration'ları ve bir `User` modelini yayınlar.

### Magic Starter Laravel neye ihtiyaç duyar?

`ext-gd` ve `ext-exif` ile PHP 8.2 ya da üstü ve Laravel 12.32 ya da üstü, ya da Laravel 13. İsteğe bağlı yönetim paneli Filament `^4.13.3` ya da `^5.8.3` ister.

### Kullanmak için Flutter uygulaması gerekir mi?

Paket ona bağımlı değildir: route'lar Sanctum token'lı JSON'dur. `magic_starter` onları bire bir çağıran Flutter istemcisidir; bu yüzden burada değiştirilen bir route orada da değişmelidir.

### Bir özelliği nasıl açarım?

Anahtarını `config/magic-starter.php` içindeki `features` dizisine ekleyin ya da `magic-starter:install` sırasında seçin. Kapalı bir özellik route'larını, komutlarını ve zamanlanmış görevlerini kaydetmez; uç noktaları 404 döner.

### Bir route'un yaptığı işi değiştirebilir miyim?

Evet. Controller'lar `Contracts\` altındaki bir sözleşmeyi enjekte eder ve service provider her birini `Actions\` altındaki bir varsayılana bağlar. Sözleşmeyi `AppServiceProvider::register()` içinde kendi sınıfınıza bağlayın; API ve yönetim paneli ikisi de onu kullanır.

### Magic Starter Laravel yapay zeka kodlama ajanlarıyla çalışır mı?

Evet. Laravel Boost, paketin sunduğu `magic-starter-development` skill'ini kurar; dokümanlarına `llms.txt` olarak ve MCP üzerinden de erişilebilir.

### Magic Starter Laravel açık kaynak mı?

Evet. Magic Starter Laravel, MIT lisansıyla açık kaynaktır.

## Saniyeler içinde ekleyin

```bash
composer require anilcancakir/magic-starter-laravel
```

Sonra `php artisan magic-starter:install` ve `php artisan migrate` çalıştırın. Ya da `composer.json` dosyasına ekleyin:

```json
{
    "require": {
        "anilcancakir/magic-starter-laravel": "^1.0.3"
    }
}
```

Ya da yapay zeka ajanınıza şu istemi verin:

```text
https://anilcancakir.com/magic-starter-laravel/docs/llms.txt adresini oku ve Magic Starter Laravel paketini bu projeye kur.
```

## Dokümanlar

### Getting Started

- [Installation](https://anilcancakir.com/magic-starter-laravel/docs/getting-started/installation.md)
- [Configuration](https://anilcancakir.com/magic-starter-laravel/docs/getting-started/configuration.md)
- [Migrating from fluttersdk/magic-starter-laravel](https://anilcancakir.com/magic-starter-laravel/docs/getting-started/migrating-from-fluttersdk.md)

### The Basics

- [Authentication](https://anilcancakir.com/magic-starter-laravel/docs/basics/authentication.md)
- [Two-Factor Authentication](https://anilcancakir.com/magic-starter-laravel/docs/basics/two-factor-authentication.md)
- [Social Login](https://anilcancakir.com/magic-starter-laravel/docs/basics/social-login.md)
- [Sign-in Handoff](https://anilcancakir.com/magic-starter-laravel/docs/basics/sign-in-handoff.md)
- [Profile Management](https://anilcancakir.com/magic-starter-laravel/docs/basics/profile.md)
- [Account Deletion](https://anilcancakir.com/magic-starter-laravel/docs/basics/account-deletion.md)
- [Teams](https://anilcancakir.com/magic-starter-laravel/docs/basics/teams.md)
- [Notifications](https://anilcancakir.com/magic-starter-laravel/docs/basics/notifications.md)
- [Billing](https://anilcancakir.com/magic-starter-laravel/docs/basics/billing.md)
- [Support Desk](https://anilcancakir.com/magic-starter-laravel/docs/basics/support.md)
- [Support AI Tools](https://anilcancakir.com/magic-starter-laravel/docs/basics/support-tools.md)
- [Support Proposals](https://anilcancakir.com/magic-starter-laravel/docs/basics/support-proposals.md)
- [Admin Panel](https://anilcancakir.com/magic-starter-laravel/docs/basics/admin-panel.md)
- [Audit Trail](https://anilcancakir.com/magic-starter-laravel/docs/basics/audit.md)
- [Releases](https://anilcancakir.com/magic-starter-laravel/docs/basics/releases.md)

### Architecture

- [Action-Contracts Architecture](https://anilcancakir.com/magic-starter-laravel/docs/architecture/action-contracts.md)
- [Models Architecture](https://anilcancakir.com/magic-starter-laravel/docs/architecture/models.md)
- [Service Provider](https://anilcancakir.com/magic-starter-laravel/docs/architecture/service-provider.md)

### Guides

- [Mail on OneSignal](https://anilcancakir.com/magic-starter-laravel/docs/guides/mail-onesignal.md)
- [AI Prompt Overrides](https://anilcancakir.com/magic-starter-laravel/docs/guides/ai-prompts.md)
- [AI Run Log](https://anilcancakir.com/magic-starter-laravel/docs/guides/ai-runs.md)
