Pengembangan & deployment

Persyaratan lokal

Sesuai README backend:

• PHP dan Composer
• Node.js dan npm (aset front build: Vite / Mix)
• MySQL dan akses database (staging/production sesuai kebijakan)
• Salin .env dari .env.example, lalu php artisan key:generate

Perintah umum:

composer install
npm install
php artisan serve          # salah satu terminal
npm run dev                # terminal lain untuk aset

Aplikasi web default: http://localhost:8000 — admin di /admin, Swagger di /swagger jika view tersedia.

Versi PHP

composer.json mensyaratkan PHP ^8.0.2. Image Docker internal memakai PHP 8.1 (FPM Alpine); samakan dengan environment deployment agar perilaku konsisten.

Docker

Repositori backend menyertakan Dockerfile (PHP-FPM Alpine, ekstensi pdo_mysql, gd, zip, bcmath, Supervisor, opsi DataDog trace) dan beberapa docker-compose*.yml (staging, production, php-fpm, dll.). Sesuaikan file compose dengan environment Anda (port, volume .env, jaringan ke MySQL/Redis).

Gunakan .dockerignore pada backend untuk mengecualikan vendor/, node_modules/, dan file sensitif dari konteks build.

Queue & worker

Jika job antrian dipakai untuk webhook atau trading, jalankan worker (php artisan queue:work atau Supervisor) di server produksi. File supervisor.conf di repo dapat menjadi acuan proses PHP-FPM/queue.

CI/CD

Ada bitbucket-pipelines.yml — pipeline mengikuti definisi tersebut untuk build/test/deploy ke lingkungan Bitbucket.

Migrasi database

php artisan migrate

Jalankan di lingkungan terkendali; backup database sebelum migrasi produksi.

Referensi cepat file

File	Isi
routes/api.php	API v1
routes/admin.php	Panel admin
routes/web.php	Web publik & Swagger
app/Http/Kernel.php	Middleware
config/	Layanan pihak ketiga & app