288 lines
15 KiB
Markdown
288 lines
15 KiB
Markdown
---
|
||
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("<password>")` 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.
|