--- judul: Bug Report — Deploy SFA CMS Dev 2026-10-06 proyek: SFA CMS · SFA API terkait: Mito · Odoo 18 server: VPS MITO dev `/var/www/sfa_mito` (16.79.56.41) kategori: Bug status: Sebagian besar solved — 1 workaround, 1 rotasi secret belum, temuan super_admin massal tipe: dokumen-internal tags: - sfa - cms - bug - deploy diperbarui: 2026-10-06 --- > Index: [[SFA — Index]] · Kategori: **Bug** · Konteks deploy: [[SFA CMS — Deploy 2026-10-06]] # Bug Report: Deploy SFA CMS Dev (Self Registration + Sync Odoo + CI) **Tanggal:** 6 Oktober 2026 **Server/Environment:** VPS MITO — server **develop** SFA CMS (`/var/www/sfa_mito`, `ip-172-31-21-236`, PHP 8.3.26, Laravel 11.46.1), Gitea `repo.sinerka.id`, Jenkins `108.137.153.186:8080` **Project:** SFA CMS (`MITO/sfa-cms`) · SFA API (`MITO/sfa-api`) **Status:** ⚠️ Sebagian Workaround — 10 dari 12 solved, migration pakai workaround, rotasi secret sfa-api belum --- ## Ringkasan Masalah Deploy pertama Self Registration dan sync Odoo ke server dev, lalu pemasangan deploy otomatis (skrip `sfa-cms`, deploy key Gitea, Jenkins + webhook), memunculkan serangkaian error. Dua di antaranya **bug lama di kode** yang baru terlihat di server karena `composer --optimize-autoloader` dan perbedaan setup server vs lokal (`public/storage` symlink). Sisanya masalah operasional: skema DB server tidak tercatat di tabel `migrations`, file milik root, akses git, dan webhook. Satu bug ditemukan saat pengujian sebelum deploy (hash bcrypt Node ↔ PHP) dan satu temuan keamanan (`.env` sfa-api di riwayat git). --- ## Timeline & Error ### Error 1: `php artisan migrate` gagal — tabel sudah ada ``` 2025_10_20_000001_create_master_tables ....... 2.59ms FAIL In Connection.php line 825: SQLSTATE[42S01]: Base table or view already exists: 1050 Table 'app_params' already exists (Connection: mysql, SQL: create table `app_params` ...) ``` **Penyebab:** tabel DB server dibuat dari dump, bukan migration. Tabel `migrations` server tidak mencatat migration rekonstruksi `2025_10_20_000001`–`000009`, jadi `migrate` mencoba membuat ulang semua tabel. Gagal di langkah pertama → tidak ada yang berubah. **Fix (workaround):** jalankan hanya migration yang dibutuhkan dengan `--path` (keduanya idempotent): ```bash sudo -u ubuntu php artisan migrate --force \ --path=database/migrations/2025_10_20_000008_add_denormalized_columns_to_product_table.php sudo -u ubuntu php artisan migrate --force \ --path=database/migrations/2026_10_01_000001_create_customer_registration_tables.php ``` Skrip `sfa-cms deploy` sekarang otomatis melewati `2025_10_20_0000(01–07|09)` dan menjalankan migration baru per file dengan `--path`. **Status:** ⚠️ Workaround — `php artisan migrate` biasa masih akan gagal di server ini. ### Error 2: `Class ...Pages\Pages\ViewSalesTracking not found` Peringatan saat `composer install --no-dev --optimize-autoloader`: ``` Class App\Filament\Resources\StockTrackingResource\Pages\Pages\ViewStockTracking located in ./app/Filament/Resources/StockTrackingResource/Pages/ViewStockTracking.php does not comply with psr-4 autoloading standard (rule: App\ => ./app). Skipping. Class App\Filament\Resources\SalesTrackingResource\Pages\Pages\ViewSalesTracking located in ./app/Filament/Resources/SalesTrackingResource/Pages/ViewSalesTracking.php does not comply with psr-4 autoloading standard (rule: App\ => ./app). Skipping. ``` Lalu panel error (`GET 16.79.56.41`, `app/Filament/Resources/SalesTrackingResource.php:247`): ``` Class "App\Filament\Resources\SalesTrackingResource\Pages\Pages\ViewSalesTracking" not found ``` **Penyebab:** sejak commit `7159e53` ("split menu stock & sales tracking"), `ViewSalesTracking.php` dan `ViewStockTracking.php` ber-namespace `...\Pages\Pages` padahal file ada di folder `Pages/`, dan `getPages()` merujuk `Pages\Pages\View...`. Autoloader teroptimasi (`-o`) **melewati** kelas yang tidak sesuai PSR-4. Di lokal tidak kelihatan karena cache autoload lama. **Fix:** commit `6ae2249` — namespace jadi `...\Pages`, rujukan jadi `Pages\View...`. Di server: ```bash git pull origin develop sudo -u ubuntu composer dump-autoload --optimize sudo -u ubuntu php artisan filament:cache-components sudo -u ubuntu php artisan route:clear systemctl reload php8.3-fpm ``` **Status:** ✅ Solved — warning PSR-4 hilang di deploy berikutnya. ### Error 3: `git pull` sebagai `ubuntu` gagal — Permission denied ``` Updating ddf8642..f6de53d error: unable to unlink old 'scripts/sfa-cms.sh': Permission denied ``` **Penyebab:** sebelumnya `git pull` dijalankan manual sebagai **root**, sehingga folder `scripts/` dan objek `.git` baru milik root. Skrip `sfa-cms` menjalankan git sebagai `ubuntu` (user PHP-FPM). **Fix:** ```bash sudo chown -R ubuntu:ubuntu /var/www/sfa_mito sfa-cms deploy ``` Skrip (commit `ddc96b2`) sekarang mengecek owner seluruh folder aplikasi dan `chown` otomatis sebelum pull. **Status:** ✅ Solved. ### Error 4: `git status` kotor setelah `chown` — mode change & file "terhapus" ``` M bootstrap/cache/.gitignore D public/storage/.gitignore M storage/app/.gitignore ... $ git diff --summary mode change 100644 => 100755 bootstrap/cache/.gitignore delete mode 100644 public/storage/.gitignore ``` **Penyebab:** permission folder `storage/` di-`chmod` saat setup server (bukan perubahan isi); `public/storage` di server adalah symlink (lihat Error 5). **Fix:** ```bash sudo -u ubuntu git config core.fileMode false ``` **Status:** ✅ Solved (mode change). Bagian `public/storage/.gitignore` → **jangan** di-checkout, lihat Error 5. ### Error 5: `DirectoryNotFoundException` — `public/storage/backgrounds` hilang ``` Symfony\Component\Finder\Exception\DirectoryNotFoundException The "/var/www/sfa_mito/public/storage/backgrounds" directory does not exist. ``` **Penyebab:** di server `public/storage` dibuat lewat `php artisan storage:link` → **symlink** ke `storage/app/public` (di lokal `public/storage` folder biasa). Saran untuk merapikan Error 4 dengan `git checkout -- public/storage/.gitignore` membuat git **mengganti symlink dengan folder** yang hanya berisi `.gitignore`. Data tidak hilang (tetap di `storage/app/public`), hanya penunjuknya rusak. **Fix:** ```bash sudo -u ubuntu rm -rf public/storage sudo -u ubuntu php artisan storage:link ls -la public/ | grep storage # storage -> /var/www/sfa_mito/storage/app/public sudo -u ubuntu git update-index --skip-worktree public/storage/.gitignore sudo -u ubuntu git status --short ``` **Status:** ✅ Solved. Downtime panel beberapa menit, tanpa kehilangan data. ### Error 6: `sfa-cms deploy` minta username/password git ``` ==> Pull origin/develop (fast-forward saja) Username for 'https://repo.sinerka.id': ``` **Penyebab:** kredensial HTTPS tersimpan per user; pull manual tadi pakai root, skrip pakai `ubuntu`. **Fix:** deploy key SSH read-only (Gitea → Deploy Keys): ```bash sudo -u ubuntu ssh-keygen -t ed25519 -C "vps-mito-sfa-cms" -f /home/ubuntu/.ssh/sfa_cms_deploy -N "" sudo -u ubuntu git -C /var/www/sfa_mito remote set-url origin git@repo.sinerka.id:MITO/sfa-cms.git ``` **Status:** ✅ Solved (bersama Error 7–8). ### Error 7: Gitea menolak public key ``` Cannot verify your SSH key: extractTypeFromBase64Key: invalid key format: illegal base64 data at input byte 3 ``` **Penyebab:** teks key tidak tersalin utuh (bagian base64 rusak/terpotong saat copy dari terminal). **Fix:** cek dulu `ssh-keygen -lf …pub` (harus `256 … (ED25519)`, panjang isi key 68, awalan `AAAAC3NzaC1lZDI1NTE5`), salin ulang satu baris utuh. **Status:** ✅ Solved. ### Error 8: SSH ke Gitea ditolak di port 22 ``` ssh: connect to host repo.sinerka.id port 22: Connection refused fatal: Could not read from remote repository. ``` **Penyebab:** SSH Gitea berjalan di **port 222** (banner `SSH-2.0-OpenSSH_9.3`), bukan 22. **Fix:** ```bash sudo -u ubuntu sed -i '/^Host repo.sinerka.id$/a\ Port 222' /home/ubuntu/.ssh/config sudo -u ubuntu git -C /var/www/sfa_mito fetch origin ``` **Status:** ✅ Solved. ### Error 9: Push ke `develop` tidak memicu build Jenkins Gejala: *Recent Deliveries* di Gitea kosong, job `SFA-CMS-DEV` tidak jalan. **Penyebab:** 1. Token beda: Jenkins `sfa-cms-token`, URL webhook Gitea `sfa-cms-dev-de7f…` (sempat diusulkan pakai `mito-develop-token` — itu token job Odoo dev, akan memicu job yang salah). 2. **Test Delivery Gitea memakai branch default (`main`)** → dilewati oleh Branch filter `develop`, tidak tercatat sama sekali. Belum ada push sungguhan sejak webhook dibuat. **Fix:** samakan token (`sfa-cms-token` di Jenkins & URL Gitea), cek endpoint langsung: ```bash curl -sS -X POST -H 'Content-Type: application/json' -d '{"ref":"refs/heads/__probe__"}' \ 'http://108.137.153.186:8080/generic-webhook-trigger/invoke?token=sfa-cms-token' # {"jobs":{"SFA-CMS-DEV":{...,"triggered":true,...}},"message":"Triggered jobs."} ``` lalu uji dengan push sungguhan (commit `4da680a`). **Status:** ✅ Solved — build otomatis tiap push `develop`. ### Error 10 (ditemukan saat tes, sebelum deploy): hash password Node tidak bisa dipakai login di Laravel ``` FAIL password lama ($2b$) bisa login ``` **Penyebab:** `bcryptjs` (sfa-api) menghasilkan prefix `$2b$`; PHP `password_get_info()` mengembalikan `algoName: unknown` untuk `$2b$`, sehingga cast `hashed` Laravel **meng-hash ulang** hash itu saat aktivasi → user tidak pernah bisa login. Percobaan fix pertama juga salah: `preg_replace('/^\$2[ab]\$/', '$2y$', …)` — di PHP `'$2y$'` dibaca sebagai backreference `$2`, prefix jadi rusak. **Fix:** Node menyimpan dengan prefix `$2y$`; CMS menormalkan dengan `str_starts_with` + `substr` (`CustomerRegistrationService::normalizeBcryptPrefix`). **Status:** ✅ Solved — 17/17 tes workflow lulus. ### Error 11 (temuan keamanan): `.env` sfa-api ada di riwayat git Commit `72bc654` "first commit" (12-08-2025) berisi `.env` lengkap (`DB_PASSWORD`, `JWT_SECRET`, `SECRET_KEY`). **Fix:** riwayat di-rewrite (`git filter-branch`) & force-push `main` → `58e1831`; `.gitignore` kedua repo diperketat. Detail: [[SFA API — Pembersihan .env dari Riwayat Git]]. **Status:** ⚠️ Riwayat bersih, **rotasi secret belum**. ### Error 12: Tidak bisa login panel — akun admin tidak ada ``` These credentials do not match our records. ``` **Penyebab:** `admin@sfa-mito.sinerka.id` (yang tercatat di dokumen deployment) **tidak ada** di tabel `users` server. Saat membuat ulang, percobaan pertama memakai `getenv("S1n3rk4")` — `getenv()` membaca *nama* environment variable, hasilnya `false` → akun id 435 tersimpan dengan password kosong; percobaan kedua `Duplicate entry 'admin@sfa-mito.sinerka.id' for key 'users.users_email_unique'`. **Fix:** update password akun yang sudah ada, password diketik di prompt tersembunyi **dua kali**: ```bash cd /var/www/sfa_mito read -rsp "Password baru: " P1; echo read -rsp "Ulangi password: " P2; echo if [ -z "$P1" ] || [ "$P1" != "$P2" ]; then echo "Password kosong / tidak sama — ulangi" else sudo -u ubuntu env NEWPASS="$P1" php artisan tinker --execute=' $u = App\Models\User::where("email","admin@sfa-mito.sinerka.id")->firstOrFail(); $u->password = getenv("NEWPASS"); $u->save(); echo "id ", $u->id, " | cek: ", Hash::check(getenv("NEWPASS"), $u->fresh()->password) ? "COCOK" : "GAGAL", PHP_EOL;' fi unset P1 P2 ``` **Status:** ✅ Solved — login berhasil. > [!warning] 2026-10-12: password admin "hilang" lagi > Login `admin@sfa-mito.sinerka.id` di server dev gagal ("These credentials do not match our records"). > Akun ada, tapi `Hash::check` = TIDAK. **Penyebab:** perintah reset versi 06-10 hanya sekali ketik di > prompt tersembunyi — salah ketik ikut tersimpan, dan cek "COCOK" membandingkan nilai yang sama sehingga > tidak pernah gagal. Nilai baru juga tidak dicatat di mana pun. > **Fix:** reset ulang dengan konfirmasi dua kali (perintah di atas sudah diganti) + simpan di password > manager tim. > > Catatan diagnosis: pesan Filament itu sama untuk 3 penyebab — user tidak ada, password salah, atau > `canAccessPanel()` false (`user_type = EXTERNAL`). Cek dulu dengan tinker sebelum menebak. **Temuan terkait:** `User::role("super_admin")` di server berisi **±140 user**, termasuk akun sales lapangan → semua bisa masuk panel dengan akses penuh. Belum diubah (lihat to-do Index). --- ## Root Cause Summary | # | Masalah | Penyebab | Fix | |---|---------|----------|-----| | 1 | `migrate` gagal `app_params already exists` | Skema server dari dump, migration rekonstruksi tidak tercatat | `--path` per file; skrip melewati `2025_10_20_*` (workaround) | | 2 | `ViewSalesTracking` / `ViewStockTracking` not found | Namespace `Pages\Pages` sejak `7159e53`, dilewati autoloader `-o` | Commit `6ae2249` | | 3 | `unable to unlink … Permission denied` | `git pull` manual sebagai root | `chown -R ubuntu`, skrip auto-`chown` (`ddc96b2`) | | 4 | `git status` kotor (mode change) | `chmod` storage saat setup | `core.fileMode false` | | 5 | `public/storage/backgrounds` not found | `git checkout` mengganti symlink `storage:link` dengan folder | `storage:link` ulang + `skip-worktree` | | 6 | Pull minta password | Kredensial per user | Deploy key SSH | | 7 | Gitea `illegal base64 data` | Key tersalin tidak utuh | Salin ulang satu baris | | 8 | SSH port 22 refused | SSH Gitea di port 222 | `Port 222` di `~/.ssh/config` | | 9 | Webhook tidak memicu build | Token beda + Test Delivery terfilter branch | Samakan token, uji dengan push | | 10 | Hash `$2b$` di-hash ulang Laravel | PHP tidak mengenali `$2b$`; backreference di `preg_replace` | Simpan `$2y$`, normalisasi tanpa regex | | 11 | `.env` di riwayat git sfa-api | Ter-commit di commit pertama | Rewrite riwayat; **rotasi secret belum** | | 12 | Login panel gagal, akun admin tidak ada | Akun di dokumen tidak pernah ada di DB server; `getenv("")` salah pakai | Buat/update akun lewat tinker + prompt tersembunyi | --- ## Rekomendasi Jangka Panjang - **Fix permanen migration rekonstruksi**: beri `hasTable`/`hasColumn` di `2025_10_20_*` (atau catat sebagai sudah jalan lewat migration resmi), supaya `php artisan migrate` biasa aman di semua server. - **Jangan pernah jalankan `git`/`artisan`/`composer` sebagai root** di server — selalu `sfa-cms …` atau `sudo -u ubuntu`. - **Samakan setup `public/storage` lokal & server**, atau dokumentasikan perbedaannya (lokal: folder + symlink per subfolder; server: `storage:link`). - Tambah cek CI ringan sebelum deploy: `composer dump-autoload -o` + gagal kalau ada warning PSR-4. - Token webhook acak per job; pasang filter branch juga di sisi Jenkins. - **Rotasi `JWT_SECRET`, `SECRET_KEY`, password DB sfa-api.** --- ## Warning / Catatan Tambahan - `public/storage/.gitignore` di server di-`skip-worktree` — **jangan** di-`checkout`/`restore`. - Test Delivery Gitea tidak bisa dipakai menguji webhook yang ber-Branch filter; uji dengan push. - Dry-run sync Odoo di server: product `deleted=191`, customer `deleted=836` — dijalankan karena server masih data uji (bukan bug, keputusan). Lihat [[SFA CMS — Deploy 2026-10-06]] §3.2.