# Panduan Deployment & Penggunaan: Enterprise App Update Center

Sistem Update Center Terpusat telah selesai dibangun dan teruji 100%:
1. **Backend API (PHP + MySQL)**: `D:\Kerjaan Kantor\apps-center-manager-be`
2. **Web Dashboard Admin (Angular 21)**: `D:\Kerjaan Kantor\apps-center-manager`
3. **Mobile Client (Warehouse V2)**: `d:\github\warehouse-v2` (Telah terhubung ke `https://tokossonlineshop.com/api/public/check-update.php`)

---

## 1. Langkah Setup di Hosting cPanel (`tokossonlineshop.com`)

### A. Buat Database MySQL & Import Schema
1. Masuk ke cPanel `tokossonlineshop.com` -> menu **MySQL Databases**.
2. Buat database baru (misal: `u12345_apps_center`) dan user database dengan hak akses penuh (*ALL PRIVILEGES*).
3. Buka **phpMyAdmin** -> pilih database tersebut -> klik tab **Import**.
4. Upload file:
   `D:\Kerjaan Kantor\apps-center-manager-be\schema.sql`
   *(Otomatis membuat tabel `users`, `apps`, `app_releases`, akun default admin, dan record awal Warehouse V2).*

### B. Konfigurasi Koneksi Database di Backend
Buka file `D:\Kerjaan Kantor\apps-center-manager-be\config\database.php` dan sesuaikan:
```php
private static $host = 'localhost';
private static $db_name = 'u12345_apps_center'; // nama database cPanel
private static $username = 'u12345_user';       // username database cPanel
private static $password = 'PasswordDBAnda';    // password database cPanel
```

### C. Upload Backend PHP ke cPanel
1. Compress seluruh isi folder `D:\Kerjaan Kantor\apps-center-manager-be` menjadi file `.zip`.
2. Di File Manager cPanel, buat folder di dalam `public_html/`:
   `public_html/api/` (atau taruh langsung di subfolder yang diinginkan).
3. Upload dan ekstrak file zip tersebut di sana.
4. Pastikan folder `storage/apks/` memiliki permission `755`.

---

## 2. Mengakses & Menggunakan Web Dashboard Admin

Dashboard telah di-build di: `D:\Kerjaan Kantor\apps-center-manager\dist\apps-center-manager\browser`

### A. Menjalankan Dashboard di Komputer Anda (Local Development):
```bash
cd "D:\Kerjaan Kantor\apps-center-manager"
npm start
```
Buka browser: `http://localhost:4200`

### B. Login Default:
- **Username:** `admin`
- **Password:** `Admin123!`

### C. Alur Mem-Publish Rilis APK Baru:
1. Setelah login, Anda akan melihat kartu **Warehouse V2** (dan aplikasi kantor lainnya yang bisa Anda tambahkan via tombol *+ Tambah Aplikasi*).
2. Klik tombol **"Kelola Rilis ->"** pada aplikasi **Warehouse V2**.
3. Klik tombol **"Publish Rilis Baru"**:
   - Masukkan **Version Code**: misal `3`
   - Masukkan **Version Name**: misal `1.0.2`
   - Pilih file APK yang baru di-build: `D:\github\warehouse-v2\android\app\build\outputs\apk\release\app-release.apk`
   - Isi Catatan Pembaruan (Changelog)
   - Centang *Force Update* jika pengguna wajib memperbarui sebelum menggunakan app.
   - Klik **"Upload & Terbitkan"**.
4. Selesai! Versi tersebut akan langsung aktif secara global.

---

## 3. Fitur Instant Rollback (Penanganan Bug Mendesak)
Jika suatu saat rilis versi baru memiliki bug kritis:
1. Buka halaman detail rilis aplikasi di Web Dashboard.
2. Pada rilis versi lama yang stabil, klik tombol **"Jadikan Aktif"**.
3. Seketika itu juga, semua HP tim gudang akan disajikan versi stabil tersebut tanpa Anda perlu build ulang aplikasi!