feat: implement separate CA database with documentation and standardized workflows

This commit is contained in:
dyzulk
2026-01-06 11:06:45 +07:00
parent b10b52e7ab
commit e4932f7795
11 changed files with 653 additions and 2 deletions

View File

@@ -0,0 +1,51 @@
---
description: SOP Deployment (CI/CD via aaPanel)
---
# Alur Kerja Deployment
Proyek ini menggunakan **CI/CD Otomatis** via aaPanel Webhook yang terintegrasi dengan GitHub/Git.
## 1. Automated Deployment (CI/CD)
Setiap kali Anda melakukan push ke branch `main`, script webhook di server akan berjalan.
**Apa yang dilakukan script otomatis:**
1. `git pull origin main`
2. `composer install` & `npm install` + `vite build`
3. **Update Config:** Mengcopy isi `.env.production.editable` ke `.env` (Pastikan file editable sudah benar di repo!).
4. `php artisan migrate --force` (Main & CA Database).
5. `php artisan optimize`.
**Script Reference:**
* **Repo (Public):** `scripts/deploy-webhook.example.sh` (Template aman, gunakan ini untuk copy-paste ke aaPanel lalu edit manual).
* **Local (Private):** `scripts/deploy-webhook.local.sh` (Backup pribadi Anda dengan path asli, ter-ignore oleh git).
## 2. Manual Pre-Requisites (Sebelum Push)
Sebelum Anda push code, pastikan:
1. **Environment Variables**:
* Jika ada perubahan config, update `.env.production.editable`.
* Ingat: Script akan menimpa `.env` server dengan isi `.env.production.editable`.
2. **Database**:
* Jika membuat DB baru (seperti kasus CA ini), pastikan database fisik sudah dibuat di server MySQL (`CREATE DATABASE ...`).
## 3. Manual Post-Deployment (Intervensi Khusus)
Script CI/CD tidak menangani edge-cases. Anda perlu masuk ke server (SSH) untuk kasus berikut:
1. **Data Migration Khusus**:
* Kasus: Memisahkan table CA ke database baru.
* Action: Login SSH, lalu jalankan:
```bash
cd /www/wwwroot/trustlab-api-ftp/trustlab-api.dyzulk.com
php artisan ca:migrate-data
```
2. **Rollback**:
* Jika deploy gagal total, Anda mungkin perlu restore backup database manual via aaPanel atau `php artisan migrate:rollback`.
## 4. Platform Lain (Non-aaPanel)
Jika berpindah dari aaPanel, adaptasi script `scripts/deploy-webhook.example.sh`:
* Ganti Path project (`PROJECT_PATH`).
* Ganti Path PHP Binary (`PHP_BIN`).
* Ganti mekanisme trigger (misal gunakan GitHub Actions, Jenkins, atau Laravel Forge).