Laravel API Setup

Laravel API Setup Skill (Laravel 13)

Skill ini membantu Gemini CLI untuk membangun infrastruktur Backend API (Headless) profesional menggunakan Laravel 13, dengan fokus pada pengujian menggunakan Pest, arsitektur yang bersih, dan lokalisasi Bahasa Indonesia otomatis.

Alur Kerja Utama

0. Pemeriksaan Prasyarat

• php -v (8.2+), composer -V, node -v.
• Pastikan database server (MySQL/MariaDB/PostgreSQL) berjalan.

1. Pengumpulan Informasi Awal

Tanyakan kepada pengguna:

• APP_NAME: Nama aplikasi.
• Database Settings: DB_CONNECTION, DB_DATABASE, DB_USERNAME, DB_PASSWORD.
• Redis: Apakah menggunakan Redis?
• Git: Inisialisasi Git di akhir?

2. Inisialisasi Proyek & API Routing (Tahap 1)

1. composer create-project laravel/laravel {nama_proyek}.
2. php artisan install:api.

3. Setup Testing (Pest PHP) (Tahap 2)

1. composer require pestphp/pest --dev --with-all-dependencies.
2. ./vendor/bin/pest --init.
3. Hapus file tests/Unit/ExampleTest.php dan tests/Feature/ExampleTest.php bawaan jika diperlukan.

4. Konfigurasi Environment & Database (Tahap 3)

1. Update file .env:
   • APP_NAME.
   • Konfigurasi Database sesuai input langkah 1.
   • Konfigurasi Redis:
     • Jika Redis digunakan: CACHE_STORE=redis, QUEUE_CONNECTION=redis, SESSION_DRIVER=redis.
     • Jika client adalah predis:
       • Jalankan composer require predis/predis.
       • Set REDIS_CLIENT=predis di .env.
     • Jika client adalah phpredis:
       • Set REDIS_CLIENT=phpredis di .env.
2. Jalankan migrasi: php artisan migrate.

5. Lokalisasi ID Otomatis (Tahap 4)

Lakukan lokalisasi secara otomatis:

1. Publish file bahasa: php artisan lang:publish.
2. Buat direktori lang/id dan salin semua file dari lang/en.
3. Agen Tugas: Terjemahkan isi file auth.php, pagination.php, password.php, dan validation.php ke Bahasa Indonesia secara langsung. Dilarang menerjemahkan komentar kode.
4. Update .env: APP_LOCALE=id dan APP_FALLBACK_LOCALE=en.

6. Setup Arsitektur Lanjutan (Boilerplate) (Tahap 5 - Eksekusi Bertahap)

Lakukan pembuatan file satu per satu dengan konfirmasi jika diperlukan: Generate file arsitektur berikut dengan standar Clean Code:

• Repositories/BaseRepository.php: Implementasikan method:
  • Read: get, pagination (default per_page 10), getById, getBy (multiple criteria), trash (untuk data soft deleted).
  • Write: insert, insertBulk, upsert, updateOrCreate.
  • Restore: restore, restoreBulk.
  • Delete: delete, deleteBulk, forceDelete, forceDeleteBulk.
  • Query Support: Mendukung multiple orderBy, pencarian (search) pada banyak kolom, dan filter dinamis pada banyak kolom.
• Services/BaseService.php: Wrapper logika bisnis yang mengimplementasikan method dari BaseRepository.
• Services/BaseApiService.php: Wrapper Laravel Http Client dengan fitur:
  • Configuration: setBaseUrl, setHeader, setToken, setCookies.
  • Request Type: asForm, attach.
  • Verbs: get, post, put, delete.
  • Execution: buildRequest untuk mengeksekusi panggilan API.
• Traits/ApiResponse.php: Standarisasi respons JSON global:
  • successResponse: Mengembalikan { success: true, code: string, message: string, data: mixed, meta: array|null }. Meta otomatis menangani paginasi Laravel.
  • errorResponse: Mengembalikan { success: false, code: string, message: string, errors: mixed|null }.
  • Contoh: code: "LOGIN_SUCCESS", code: "VALIDATION_ERROR".
• Supports & Adapters: Tambahkan folder dengan .gitkeep.

7. Git Initialization (Tahap 6)

git init && git add . && git commit -m "feat: initial commit - setup laravel 13 api with pest and clean architecture"

Instruksi bagi Agen

[ROLE] Bertindaklah sebagai seorang Senior Backend Architect yang ahli dalam Laravel 13 dan Pest PHP.

[TASK] Lakukan setup Laravel API dengan eksekusi bertahap:

1. Selesaikan satu Tahap (misal: Inisialisasi) sebelum lanjut ke Tahap berikutnya (misal: Setup Arsitektur).
2. Khusus untuk Tahap 6 (Boilerplate), buatlah file secara berurutan satu per satu. Jangan mencoba membuat semua file arsitektur dalam satu turn jika isi kodenya sangat panjang.
3. Laporkan progres setiap kali satu tahapan selesai.

[CONSTRAINT]

• Patuhi urutan alur kerja.
• Pastikan respons API selalu konsisten menggunakan Trait ApiResponse.
• Bahasa Indonesia untuk interaksi, Bahasa Inggris untuk kode.

Tips Keamanan & Performa

• Gunakan Redis untuk throttling dan caching.
• Pastikan semua endpoint API terproteksi oleh middleware Sanctum secara default.