Laravel/Lumen Online Editor & Rest API Generator

Online Editor

Fitur editing project laravel atau lumen secara online dengan protocol HTTP(s) dengan editor online: https://ngopi.netlify.app atau https://ngopi.vercel.app secara aman dan sangat cepat.

Background

Editor online untuk development sangat bermanfaat untuk mengurangi kelambatan development, publikasi aplikasi, bahkan bisa langsung dilakukan di server staging hingga umur laptop developer bisa lebih lama karena tak pernah menjalankan versi localhost.

Berbagai macam editor online yang pernah kita temui:

Online Gitlab/Github Editor yang dapat dimanfaatkan hingga melakukan committing tanpa harus melakukan push dari local. Server git sudah memfasilitasi hal ini dengan keterbatasan editornya (rata-rata menggunakan library Monaco Editor yakni pendukung utama core dari VSCode)
Ekstensi-ekstensi pada editor misal VSCode, Atom, Sublime, atau yang lain berbasis FTP. Developer dapat melakukan editing project dengan editor andalannya secara online dengan protokol FTP. Namun sayangnya tracking dari perubahan file adalah issue besar, belum lagi jika banyak developer yang mengotak-atik file yang sama. Refresh dari list file pun tidak realtime.
Ekstensi lain dengan protokol berbeda yakni SSH. Developer dapat langsung mengotak-atik file di server dengan protocol secure ini dengan sesuka hati sebagaimana melakukan editting di local. Ini cara sebagaimana sultan merasa menjadi pemilik folder project pada si server. Namun jika kita memberikan akses SSH hanya untuk edit online ke developer yang tidak seharusnya mendapat hak tinggi ke server, rasanya cukup mengerikan.

Ketiganya sangat bermanfaat terutama jika project dikerjakan tidak secara keroyokan alias single fighter. Sedangkan cara normal yakni localhost dan git dipadu dengan CI/CD untuk deployment ke server sebenarnya sudah powerful dan ideal. Namun untuk bebarapa kasus khusus, CI/CD memerlukan cost besar entah di biaya service maupun kesukarelaan untuk menukar security key agar dapat masuk ke server tujuan. Selain itu, pengumpulan garapan dari banyak developer yang sekiranya sudah mumpuni (tanpa perlu banyak direview kodingnya) menjadi sangat lambat. Sehingga dari development ke publikasi hingga review para tester di sisi aplikasi penuh menjadi lambat.

Pada akhirnya package ini menjadi solusi lain bagi kita untuk mengotak atik project dengan mudah dan cepat, aman (karena protocol HTTP(s) seperti web pada umumnya), realtime, dan pastinya membatasi gerak-gerik tidak penting dari developer. Apa maksudnya membatasi gerak gerik? Editor online ini memiliki pattern yang mudah dipahami dengan mengarahkan developer ke pattern kerja yang khusus (tidak dapat secara bebas create file).

Online Editor API

Fitur:

Instalasi:

Create laravel project baru seperti di Tutorial Official
Masuk ke root project yang baru dibuat
Install package dengan composer:

   composer require starlight93/laravel-smart-api

Daftarkan Provider Editor dan API Generator
Laravel: buka file config/app.php, tambahkan di bagian key: providers Starlight93\LaravelSmartApi\ApiServiceProvider::class
Lumen: buka file bootstrap/app.php tambahkan baris berikut:

   $app->register(Starlight93\LaravelSmartApi\ApiServiceProvider::class);

Untuk lumen tak perlu mengaktifkan withFacades() dan withEloquent() karena akan auto dinyalakan oleh provider generator

Start Project:

Matikan tracking file permission di git ROOT Project (jika project anda sudah di git init sebelumnya)

   git config core.fileMode false

Buka console command line posisi di ROOT Project, dan lakukan step berikut:

   php artisan project:start

Environment Variable

Lihat vendor/starlight93/config/ untuk lebih lengkapnya. Variable di bawah dapat dipasang di .env folder project

Basic Env Key

Key	Description	Default
EDITOR_PASSWORD	Password untuk diisikan di header request dengan key header: laradev, cek Middleware	12345
EDITOR_FRONTENDERS	List user untuk developer frontend yang akan hanya mendapat akses blade dan js di editor online, misal: 001-dev-fe,002-dev-fe,dst cek Middleware	-
EDITOR_BACKENDERS	List user untuk developer backend yang akan hanya mendapat akses migration,model,dan bebarapa hal terkait Backend saja di editor online cek Middleware	-
EDITOR_OWNERS	List user untuk root dveloper yang akan dapat melihat semua fitur Middleware	dev-owner
GOOGLE_CLIENT_ID	Untuk keperluan config google auth (Laravel Socialite) Usage	-
GOOGLE_CLIENT_SECRET	Untuk keperluan config google auth (Laravel Socialite) Usage	-
LOG_SENDER	Untuk logging websocket Usage	-
LOG_PATH	Untuk path channel logging websocket Usage	-
CLIENT_CHANNEL	Untuk trigger send websocket ke listener lain seperti frontend misalnya Usage	-
API_ROUTE_PREFIX	Prefix Endpoint route untuk restful API Usage	api
API_USER_TABLE	Default User's table name Usage	users
API_PROVIDER	Register Provider Class Name Tambahan, contoh "\App\Your\Class" Usage	-

Setelah melakukan pengaturan di .env file, usahakan setting database connection telah benar, maka aplikasi akan mampu melakukan create models (di /app/Models/CustomModels) secara otomatis sesuai isi table di database (reverse engineering). Lakukan command CLI berikut:

   php artisan project:model

Rest API Generator

Dengan membuat file migration, atau struktur DB yang ada maka akan mendapatkan fitur lengkap berikut:

RasyidMF/laravel-smart-api