Doc_chelvyn/Mito/Sfa/Bug/2026-10-06_deploy-sfa-cms-d...

288 lines
15 KiB
Markdown
Raw Permalink Normal View History

---
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.