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

288 lines
15 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters!

This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.

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