Day 26 — Konsep Deployment & Persiapan Production

Fase: 3 — Deployment | Minggu: 6 | Hari: Senin

---

🎯 Tujuan Hari Ini

• Memahami perbedaan mendasar antara development dan production environment.
• Menyiapkan codebase agar siap untuk di-deploy (production-ready).
• Membuat README.md yang profesional sebagai dokumentasi project.
• Memahami file .env dan variabel mana yang WAJIB dijaga kerahasiaannya.

---

📖 Penjelasan: Development vs Production

Selama magang, kamu bekerja di development environment — di laptopmu sendiri, untuk dirimu sendiri. Production adalah saat aplikasi dijalankan di server nyata dan diakses oleh pengguna nyata.

Aspek	Development	Production
APP_ENV	local	production
APP_DEBUG	true	false
Database	SQLite / MySQL lokal	MySQL/PostgreSQL di server
Error display	Detail lengkap di browser	Halaman error generic
Cache	Tidak di-cache	Di-cache untuk performa
Storage	storage/app/public/ lokal	Cloud Storage / server path

CAUTION

APP_DEBUG=true di production adalah celah keamanan serius. Ketika debug aktif, Laravel menampilkan detail error termasuk isi variabel, kode sumber, dan bahkan isi .env di browser. Hacker bisa memanfaatkan ini untuk mempelajari struktur aplikasimu.

---

🔧 Step-by-Step Persiapan Production

Step 1: Audit File .env

Periksa file .env dan pastikan semua variabel sudah sesuai. Buat juga file .env.example yang berisi semua kunci tapi tanpa nilai sensitif:

# .env.example (aman untuk di-commit ke GitHub)

APP_NAME="SIMAS"
APP_ENV=production
APP_KEY=           # ← diisi dengan: php artisan key:generate
APP_DEBUG=false
APP_URL=https://your-app.railway.app

LOG_CHANNEL=stack
LOG_LEVEL=error

DB_CONNECTION=mysql
DB_HOST=           # ← isi dari dashboard hosting
DB_PORT=3306
DB_DATABASE=       # ← isi dari dashboard hosting
DB_USERNAME=       # ← isi dari dashboard hosting
DB_PASSWORD=       # ← ← JANGAN DIISI DI SINI

FILESYSTEM_DISK=public

CAUTION

File .env (yang mengandung password dan secret key) JANGAN PERNAH di-commit ke GitHub. Pastikan .env sudah ada di file .gitignore.

---

Step 2: Bersihkan dan Audit .gitignore

Pastikan file .gitignore di root project sudah memuat hal-hal berikut:

/vendor
/node_modules
/.env          # ← WAJIB ada ini
/storage/app/public/*
!/storage/app/public/.gitkeep
/storage/logs/*
!/storage/logs/.gitkeep
/bootstrap/cache/*
!/bootstrap/cache/.gitkeep
*.zip

---

Step 3: Buat File README.md yang Profesional

File README.md adalah "wajah" repository GitHub-mu. Ini yang pertama dilihat recruiter dan mentor.

# SIMAS — Sistem Manajemen Aset Sederhana

Aplikasi web manajemen aset yang dibangun menggunakan **Laravel 11** 
dalam program Magang SMK RPL BRIN.

## 🚀 Fitur Utama

-  Manajemen Kategori Aset (CRUD)
-  Manajemen Aset dengan Upload Foto
-  Modul Peminjaman & Pengembalian Aset
-  Dashboard Statistik Real-time
-  Export Data ke Excel dan PDF

## 🛠️ Teknologi

- **Backend:** Laravel 11, PHP 8.2
- **Database:** MySQL 8
- **Frontend:** Bootstrap 5, Blade Template
- **Package:** Maatwebsite Excel, Barryvdh DomPDF

## ⚙️ Instalasi (Development)

```bash
# 1. Clone repository
git clone https://github.com/username/simas.git
cd simas

# 2. Install dependencies
composer install

# 3. Konfigurasi environment
cp .env.example .env
php artisan key:generate

# 4. Konfigurasi database di .env, lalu:
php artisan migrate --seed

# 5. Setup storage
php artisan storage:link

# 6. Jalankan server
php artisan serve

👤 Kredit

Dibangun oleh [Nama Tim] dalam Program Magang RPL SMK — BRIN 2026.

---

### Step 4: Final Commit Sebelum Deploy

```bash
# Pastikan semua perubahan tersimpan
git add .
git commit -m "feat: production ready - add README and env.example"
git push origin main

---

🧪 Checklist Persiapan Hari Ini

• [ ] File .env diperiksa, tidak ada nilai sensitif di .env.example
• [ ] File .gitignore sudah memuat .env
• [ ] README.md sudah dibuat dan berisi informasi yang lengkap
• [ ] Semua perubahan sudah di-push ke GitHub
• [ ] Repository GitHub masih dalam kondisi bersih (tidak ada file yang tidak perlu)

---

💡 Pertanyaan Refleksi

Diskusikan bersama tim:

1. Mengapa kita tidak boleh menyimpan password database di GitHub, meski repository-nya private?
2. Apa bedanya APP_KEY dengan password database? Keduanya sama-sama rahasia, tapi untuk tujuan apa masing-masing?
3. Jika APP_DEBUG=false dan ada error di production, bagaimana kita tahu ada masalah?