/bpsdmd-web

Primary LanguagePHP

BPSDM WebApp

Aplikasi ini menggunakan framework Laravel dan menganut standar PSR-2.

Cara install aplikasi:

  1. Clone git clone git@gitlab.com:datains/projects/bpsdm-webapps.git
  2. Copy .env.example menjadi .env dan ubah sesuai kebutuhan. a. Tambahkan key berikut untuk captcha
NOCAPTCHA_SECRET=6LdedLoUAAAAAH5GqQnBHxYfyWi6Zkrizr17jghF
NOCAPTCHA_SITEKEY=6LdedLoUAAAAAE8HF0BJcYUdTTuSBiRldxsK7d3x
  1. Run composer install
  2. Run php artisan doctrine:generate:proxies
  3. Run php artisan doctrine:migrations:migrate
  4. Run php artisan db:seed
  5. Run php artisan serve dan buka website di URL: http://localhost:8000

Cara develop:

  1. Gunakan branch feature/nama untuk membuat fitur baru
  2. Rebase berkala dari branch origin/dev, terutama ketika akan merge request ke branch master
  3. Update perubahan database (jika ada) dengan command pg_dump -U postgres namadb --clean > dev-sql/latest.pgsql
  4. Lakukan commit hanya jika perubahan file tidak breaking the app
  5. Jangan lupa test dahulu sebelum melakukan push

Cara buat new migration:

  1. Cek entity dan database menggunakan command: php artisan doctrine:schema:validate
  2. Migrate the migration dengan command: php artisan doctrine:migrations:migrate
  3. Jika muncul Nothing to migrate., buat migration baru dengan command: php artisan doctrine:migrations:diff
  4. Jalankan migration dengan command: php artisan doctrine:migrations:migrate

Database standard:

  1. Prevent use table prefix, we don't want mix all database in one schema.
  2. 3rd party database use new schema instead.
  3. Always use underscore "_" for more than 1 word.
  4. Foreign key use table1.id and table2.table1_id
  5. Priority columns to move: columns with data
  6. Always consider to implement 3NF
  7. Update sql file from branch database/redesign

Merge ke branch dev akan auto-deploy ke server staging. Merge ke branch master akan auto-deploy ke server production.