first

README.md

@@ -0,0 +1,77 @@
+# Hafiz Tunggakan
+
+Aplikasi Laravel untuk carian dan cetakan data RateMas tahunan.
+
+## Docker
+
+Setup Docker ini menjalankan aplikasi Laravel sahaja. MySQL tidak dibuat dalam Docker kerana aplikasi disambung ke external MySQL:
+
+```text
+172.17.200.16:3306
+```
+
+Sediakan environment Docker:
+
+```bash
+cp .env.docker.example .env.docker
+```
+
+Kemudian edit `.env.docker` untuk credential MySQL sebenar:
+
+```env
+DB_DATABASE=db_cobol
+DB_USERNAME=root
+DB_PASSWORD=
+```
+
+Build dan run:
+
+```bash
+docker compose --env-file .env.docker up -d --build
+```
+
+Aplikasi boleh dibuka di:
+
+```text
+http://localhost:8000
+```
+
+Untuk jalankan migration dan seeder semasa container start, set:
+
+```env
+RUN_MIGRATIONS=true
+RUN_SEEDERS=true
+```
+
+Seeder akan cipta login:
+
+```text
+User biasa: cukai / 123
+Admin: admin / admin123
+```
+
+## Docker Commands
+
+Lihat log:
+
+```bash
+docker compose logs -f app
+```
+
+Jalankan migration manual:
+
+```bash
+docker compose exec app php artisan migrate --force
+```
+
+Jalankan seeder manual:
+
+```bash
+docker compose exec app php artisan db:seed --force
+```
+
+Stop container:
+
+```bash
+docker compose down
+```