--- judul: SFA CMS — Deployment VPS MITO proyek: SFA CMS terkait: Mito stack: Laravel · Filament · PHP 8.3 · Nginx · MySQL server: AWS EC2 16.79.56.41 (shared dengan 4 instance Odoo Docker) kategori: Deploy & Setup status: Instalasi baru jalan — belum ada domain, SSL, & backup tipe: dokumen-internal tags: - sfa - cms - deployment - vps - laravel - security --- > Index: [[SFA — Index]] · Kategori: **Deploy & Setup** > > Setup production SFA-CMS untuk client MITO di VPS yang **sama dengan server Odoo**. > Ditulis supaya orang yang belum pernah pegang server ini bisa langsung lanjut kerja. > Untuk kerja di laptop: [[SFA CMS — Setup Development Lokal]] # Dokumentasi Deployment SFA-CMS — VPS MITO > Dokumen ini menjelaskan setup production SFA-CMS untuk client **MITO** di VPS > yang sama dengan server Odoo. Ditulis supaya tech lain yang belum pernah > pegang server ini bisa langsung paham konteks & lanjut kerja tanpa harus > explore ulang dari nol. --- ## 1. Konteks Penting — Baca Ini Dulu VPS ini **bukan server baru khusus CMS** — ini adalah VPS yang sudah lama dipakai untuk menjalankan **4 instance Odoo (Docker)** untuk beberapa client, dan ternyata juga sudah punya **instalasi SFA-CMS produksi lama** untuk client MITO dan STEIN yang berjalan native (bukan Docker). **Deployment baru yang dibuat di sesi ini SENGAJA dipasang terpisah** dari instalasi lama, memakai path dan domain akses yang berbeda, karena instalasi lama masih punya data produksi asli yang substansial (lihat [§5](#5-instalasi-lama-yang-masih-hidup---jangan-diganggu)). **Jangan asumsikan salah satu adalah "yang lama" yang aman dihapus** tanpa konfirmasi ke tim/senior dulu. --- ## 2. Spesifikasi Server | Item | Value | |---|---| | Provider | AWS EC2 | | Public IP | `16.79.56.41` | | Hostname internal | `ip-172-31-21-236` | | OS | Ubuntu (PHP 8.3.26, Nginx 1.24.0, MySQL Community Server) | | Web server | Nginx (native, **bukan** di-container) | | Database | MySQL native (native, terpisah dari Postgres yang dipakai Odoo) | ### Port yang sudah terpakai di server ini (cek sebelum pakai port baru!) | Port | Dipakai oleh | |---|---| | 22 | SSH | | 80, 443 | Nginx (multi-site: `cms.mito.co.id`, `cms.stein.co.id`, `devmito.sinerka.id`, dan default_server SFA-CMS baru) | | 3306 | MySQL (⚠️ lihat catatan security [§8](#8-catatan-security-belum-dibereskan)) | | 3000, 3001 | Node.js API pendamping CMS lama (MITO & STEIN, endpoint `/api/sfa`) | | 8069 | Docker — Odoo utama | | 8080 | Docker — Odoo instance "stein" | | 8081 | Docker — Odoo instance "injeksi" | | 8090 | Docker — Odoo instance "mitra" | Cek cepat kalau butuh tahu port mana yang masih kosong: ```bash ss -tlnp docker ps --format 'table {{.Names}}\t{{.Ports}}' ``` --- ## 3. Instalasi Baru (yang dibuat di sesi ini) | Item | Value | |---|---| | Path | `/var/www/sfa_mito` | | Git remote | `https://repo.sinerka.id/MITO/sfa-cms.git` (branch `main`) | | Akses | `http://16.79.56.41` (port 80, **belum ada domain & SSL**) | | Database | MySQL, db `sfa_mito`, user `sfa_mito` | | Owner file | `ubuntu:ubuntu` | | PHP-FPM pool | `sfa_mito` — socket `/run/php/php8.3-fpm-sfa_mito.sock`, jalan sebagai user `ubuntu` | | Nginx config | `/etc/nginx/sites-available/sfa_mito.conf` — `listen 80 default_server;` (nangkep semua request yang gak match domain lain) | | Admin login | `admin@sfa-mito.sinerka.id` (role `super_admin`). Akun ini **tidak ada** di DB server sampai 06-10-2026 → dibuat ulang (id 435) dengan password baru — password tidak dicatat di dokumen, tanya ke Chelvyn | ### Kenapa pakai `default_server` di port 80, bukan port custom? Awalnya dicoba port custom (8080/8088/8067), tapi semuanya bentrok/gak bisa diakses dari luar. Setelah ditelusuri: - Port 8080/8081/8090 sudah dipakai Docker Odoo (lihat tabel port di atas). - Port custom lain butuh buka Security Group AWS (di luar `ufw`) yang belum tentu langsung bisa dikerjakan. - Port 80 & 443 **sudah pasti terbuka** di Security Group (karena `cms.mito.co.id` sudah lama jalan HTTPS di situ). Solusinya: daftarkan site baru sebagai `default_server` di port 80 — ini **tidak mengganggu** routing `cms.mito.co.id` / `cms.stein.co.id` (Nginx tetap prioritaskan `server_name` yang cocok duluan), cuma nangkep request yang Host header-nya gak cocok sama domain manapun (misal akses langsung via IP). > [!warning] Update 2026-10-20 — `APP_URL` harus tanpa port > `.env` server dev masih berisi `APP_URL=http://16.79.56.41:8088` (sisa percobaan port custom), padahal > nginx hanya listen 80/443. Akibatnya semua link file `Storage::disk('public')->url()` (nota IMEI, > dokumen registrasi) **timeout**. Diubah jadi `APP_URL=http://16.79.56.41` (backup `.env.bak_2026-10-20`) > lalu `php artisan config:cache`. Samakan dengan `LARAVEL_BASE_URL` Node (`http://16.79.56.41/storage/`). ### Cara redeploy / update kode (pull perubahan terbaru) > [!tip] Update 2026-10-06 — pakai `sfa-cms deploy` > Skrip `scripts/sfa-cms.sh` (di repo, symlink `/usr/local/bin/sfa-cms`) menggantikan langkah > manual di bawah: `sfa-cms deploy` (pull `--ff-only` branch aktif → composer → migration baru > dengan konfirmasi, melewati `2025_10_20_*` → cache → reload PHP-FPM), `sfa-cms restart`, > `sfa-cms status`, `sfa-cms logs`. Semua jalan sebagai `ubuntu`. Git server pakai **deploy key > SSH** (Gitea, read-only) `~ubuntu/.ssh/sfa_cms_deploy`, SSH Gitea di **port 222** (port 22 > ditolak). Detail: [[SFA CMS — Deploy 2026-10-06#6. Skrip `sfa-cms` & Deploy Key\|§6]]. > [!danger] Update 2026-10-06 — `php artisan migrate --force` biasa GAGAL di server ini > Error `Table 'app_params' already exists`: migration rekonstruksi `2025_10_20_*` tidak > tercatat di tabel `migrations` server. Sampai diperbaiki, jalankan migration baru satu per > satu dengan `--path=database/migrations/.php`, dan jalankan artisan/composer sebagai > `sudo -u ubuntu` (user PHP-FPM). Detail: [[SFA CMS — Deploy 2026-10-06]]. ```bash cd /var/www/sfa_mito git pull origin main composer install --no-dev --optimize-autoloader php artisan migrate --force php artisan config:clear ``` Kalau ada perubahan ke `app/Providers/Filament/AdminPanelProvider.php`, plugin, atau apa pun yang mempengaruhi cache Filament, tambahkan: ```bash php artisan filament:cache-components php artisan route:clear ``` Kalau cuma ganti isi `.env` (tanpa ganti kode), cukup: ```bash php artisan config:clear ``` ### Cek status service ```bash systemctl status nginx --no-pager systemctl status php8.3-fpm --no-pager systemctl status mysql --no-pager ``` Cek proses PHP-FPM pool `sfa_mito` beneran jalan (bukan cuma pool `www` default): ```bash systemctl status php8.3-fpm --no-pager | grep "pool sfa_mito" ``` ### Cara restart service ```bash # restart Nginx (dipakai kalau ubah/nambah file di sites-available) nginx -t && systemctl reload nginx # reload = tanpa downtime, cukup buat perubahan config systemctl restart nginx # restart = kalau reload gak cukup # restart PHP-FPM (dipakai kalau ubah pool config, atau kalau app "nyangkut"/butuh clear opcache) php-fpm8.3 -t && systemctl restart php8.3-fpm # restart MySQL (jarang dibutuhkan, hati-hati — akan disconnect semua koneksi aktif) systemctl restart mysql ``` **Selalu `nginx -t` / `php-fpm8.3 -t` dulu sebelum restart** — kalau ada salah syntax di config dan langsung restart, service bisa gagal nyala lagi dan situs down total (beda sama `reload` yang gagal tapi proses lama tetap jalan). ### Cara lihat log | Log | Perintah | Kapan dicek | |---|---|---| | Laravel (aplikasi) | `tail -f /var/www/sfa_mito/storage/logs/laravel.log` | Error 500, exception PHP, query gagal | | Nginx access | `tail -f /var/log/nginx/access.log` | Mau tahu request apa yang masuk, status code, IP client | | Nginx error | `tail -f /var/log/nginx/error.log` | 502/504, "Primary script unknown", masalah level web server | | PHP-FPM | `journalctl -u php8.3-fpm -f` | FPM crash, pool gagal restart | Catatan: Laravel **tidak selalu log semua exception** — HTTP exception seperti 403/404/419 sengaja tidak di-log by default (dianggap alur normal, bukan bug). Kalau curiga ada masalah otorisasi tapi log kosong, itu wajar, bukan berarti gak ada request yang masuk — cek `nginx access.log` buat konfirmasi status code-nya. --- ## 4. Masalah yang Ditemukan & Cara Fix-nya Dicatat di sini supaya kalau ada masalah serupa di kemudian hari (misal deploy ulang di server lain), gak perlu debug dari nol lagi. ### 4.1 `AppParams::first()` gagal saat container/artisan baru naik **Gejala:** semua command `artisan` (termasuk `key:generate`) gagal karena `AdminPanelProvider` query tabel `app_params` yang belum ada (belum migrate). **Fix:** bungkus query itu dengan `try/catch` di `app/Providers/Filament/AdminPanelProvider.php` (sudah di-commit, lihat riwayat git — dulu perbaikan ini sempat cuma ada di lokal dan gak ke-push, jadi kalau clone dari commit lama, masalah ini bisa muncul lagi). ### 4.2 Migration tabel domain & Policy belum pernah masuk git Migration untuk tabel domain (`customer`, `product`, `sales`, `inventory`, dst.) dan semua file di `app/Policies/` **sempat cuma ada di lokal**, gak pernah ke-commit. Sudah diperbaiki dan di-push. Kalau clone repo ini dan migration-nya cuma ada 10 (bukan 17), berarti ke-checkout di commit lama — pastikan pull ke `main` terbaru. ### 4.3 `public/storage/backgrounds` kosong → error `array_rand()` Plugin `swisnl/filament-backgrounds` butuh minimal 1 gambar di `storage/app/public/backgrounds/`. Kalau fresh install dan folder ini kosong, copy salah satu gambar bawaan package-nya: ```bash php artisan storage:link cp vendor/swisnl/filament-backgrounds/resources/images/curated-by-swis/01.jpg \ storage/app/public/backgrounds/default.jpg ``` ### 4.4 403 Forbidden setelah login berhasil (paling makan waktu debug-nya) **Gejala:** login sukses (redirect terjadi), tapi halaman dashboard langsung 403 — padahal role `super_admin` sudah benar dan punya semua 440 permission. **Akar masalah:** `Filament\Http\Middleware\Authenticate` punya default behavior: ```php abort_if( $user instanceof FilamentUser ? (! $user->canAccessPanel($panel)) : (config('app.env') !== 'local'), 403, ); ``` Karena model `App\Models\User` **tidak implement interface `FilamentUser`**, Filament fallback ke aturan: *"boleh akses panel HANYA kalau `APP_ENV=local`"*. Di production (`APP_ENV=production`), semua user — termasuk super_admin — otomatis 403, terlepas dari permission apa pun. **Fix (sudah di-commit):** `App\Models\User` implement `FilamentUser` + method `canAccessPanel()`: ```php use Filament\Models\Contracts\FilamentUser; use Filament\Panel; class User extends Authenticatable implements FilamentUser { // ... public function canAccessPanel(Panel $panel): bool { return true; } } ``` Otorisasi per-resource/per-action tetap jalan normal lewat Policy (Shield), `canAccessPanel()` cuma gerbang awal "boleh masuk panel atau tidak". --- ## 5. Instalasi Lama yang Masih Hidup — JANGAN DIGANGGU Ditemukan saat proses deploy: ada instalasi SFA-CMS produksi lain yang sudah lama jalan di server yang sama. | Item | MITO (lama) | STEIN (lama) | |---|---|---| | Domain | `cms.mito.co.id` | `cms.stein.co.id` | | Path | `/var/www/html/sfa-cms` | `/var/www/html/sfa-cms-stein` | | Git remote | `gitlab.com/sinerka.id/product-internal/sfa-cms.git` | (kemungkinan sama, belum dicek) | | Database | MySQL `sfacms` (user `glut0r`) | belum dicek | | Node API pendamping | port 3000 (`/api/sfa`) | port 3001 (`/api/sfa`) | | SSL | Certificate custom di `/home/ubuntu/ssl/MITO/` | `/home/ubuntu/ssl/Stein/` | **Database `sfacms` (punya MITO lama) dicek isinya dan TERNYATA BUKAN data kosong** — ada 1.496 customer, 499 employee, 94 product, dll. Sempat ada rencana redirect domain `cms.mito.co.id` ke instalasi baru, tapi **dibatalkan** karena risiko kehilangan akses ke data ini kalau ternyata masih dipakai. **Keputusan final soal nasib instalasi lama ini (migrasi data? tetap jalan paralel? deprecate resmi?) belum diambil** — perlu dikoordinasikan dengan tim/client MITO sebelum ada tindakan lebih lanjut ke `/var/www/html/sfa-cms` atau domain `cms.mito.co.id`. File `/etc/nginx/sites-available/default` yang meng-handle kedua domain lama ini **tidak pernah diubah** selama proses deploy instalasi baru — aman, tidak ada backup yang perlu di-restore. --- ## 6. Struktur Skema Database (Instalasi Baru) Migration tabel domain di repo `MITO/sfa-cms.git` **direkonstruksi dari kode** (`app/Models`, Filament Resource, Importer/Exporter), bukan salinan struktur database produksi asli. Tipe kolom, panjang string, dan presisi decimal bisa saja berbeda dari database `sfacms` yang lama. Kalau suatu saat mau migrasi data dari `sfacms` (lama) ke `sfa_mito` (baru), **bandingkan dulu skema keduanya**, jangan asumsikan identik. Konvensi tanda qty di tabel `invent_trans`: | trans_type | qty | Arti | |---|---|---| | `RESERVE` | negatif | stok dikunci saat SO dikonfirmasi | | `RELEASE` | positif | kunci dilepas saat packing dibuat | | `ISSUE` | negatif | barang benar-benar keluar | | `RECEIPT` | positif | barang masuk lewat journal yang di-post | --- ## 7. Development Lokal Untuk kerja di laptop/lokal, project ini dijalankan **native PHP** (bukan Docker) — lihat `SETUP.md` di root repo untuk detail lengkap (versi PHP, cara jalanin `php artisan serve`, kredensial MySQL lokal, dll). --- ## 8. Catatan Security — Belum Dibereskan Ditemukan saat setup, **belum ditindaklanjuti**, dicatat supaya gak kelewat: - **Port `3306` (MySQL) terbuka ke `0.0.0.0/0`** di `ufw` — seharusnya cuma perlu diakses dari `localhost`. Sebelum ditutup, pastikan dulu tidak ada sistem eksternal yang memang connect ke MySQL ini dari luar VPS. - Port `8002`, `8003`, `4000`, `4001` juga kebuka di `ufw` — belum diketahui dipakai untuk apa, perlu ditelusuri siapa yang butuh. - Ada system update pending di Ubuntu ("System restart required") — gak urgent, tapi sebaiknya dijadwalkan reboot kalau ada waktu maintenance. --- ## 9. To-Do Selanjutnya - [ ] Siapkan domain/subdomain resmi untuk CMS baru ini (mis. lewat DNS `sinerka.id`), lalu ganti `sfa_mito.conf` dari `default_server` jadi `server_name` spesifik + pasang SSL (`certbot --nginx`). - [ ] Ganti password admin default (`S1n3rk4`) setelah dokumen ini dibaca. - [ ] Putuskan bareng tim/client soal nasib instalasi lama MITO (`/var/www/html/sfa-cms` + database `sfacms`) — lihat [§5](#5-instalasi-lama-yang-masih-hidup---jangan-diganggu). - [ ] Tutup port `3306` dari akses publik kalau memang tidak dibutuhkan. - [ ] Setup backup rutin untuk database `sfa_mito` (belum ada sama sekali).