# Login mobile online — 18 November 2026

## Implementasi

- Flutter karyawan dan outlet memakai paket bersama `packages/mahaelang_auth`.
- Default API: `https://att.mahaelang.site/api/mobile/v1`, bukan localhost.
- Identitas/password dibaca dari `cwwrxvka_mahaelangdb2.table_user`, outlet dari
  `table_outlet`. Database website tidak ditulis; password tidak disalin/di-rehash dari
  backend mobile.
- Sesi, hash token dan log masuk ke `cwwrxvka_mahaelangmobile`.
- Username case-sensitive mengikuti login website. Sesi website tidak disentuh.
- Beberapa perangkat/sesi diperbolehkan. Setiap login eksplisit membuat sesi baru;
  restore tidak membuat log login baru. Logout mencabut sesi saat ini saja. Sesi lama
  pada login ulang tetap berlaku sampai expiry/logout; fitur pencabutan semua sesi dan
  admin panel belum dibuat.
- Sesi persisten berlaku absolut 30 hari (dapat dikonfigurasi maksimum 90 hari), tanpa
  refresh token pada fase ini. Setelah expiry, login ulang. Tidak mengklaim mekanisme
  refresh sebelumnya sudah diimplementasikan.
- Native: token acak 256 bit disimpan secure storage, dikirim Bearer. Web: token hanya
  cookie Secure/HttpOnly/SameSite Lax/host-only; tidak localStorage. Channel
  employee/outlet memiliki cookie berbeda. Origin exact allowlist dan header khusus
  wajib untuk web.
- Login outlet hanya admin `user_role=1` untuk penyiapan. Ini bukan aktivasi media
  permanen atau izin menerbitkan QR. Tablet nantinya tetap memakai aktivasi sekali; sesi
  admin dapat dilepas setelah aktivasi, tetapi fitur itu belum tersedia.
- Registrasi/kunci penandatangan perangkat, persetujuan, pengenalan fisik permanen,
  scan, lokasi, wajah dan absensi belum diaktifkan. Device ID saat ini hanya identitas
  instalasi native/cookie browser, dapat berubah saat reset; metadata client bukan bukti
  integritas.

## File yang diunggah

Upload isi `backend/public`, `backend/api`, `backend/lib` ke lokasi folder yang sama
pada hosting sebelumnya. Document root subdomain tetap `public/`. Upload contoh
konfigurasi bila diperlukan, tetapi **jangan menimpa config.local.php yang sudah
diisi**. Jangan upload `tests/` atau runtime fixture.

PHP hosting 8.1+ dengan `pdo_mysql`; HTTPS wajib. Matikan display_errors pada produksi.
Endpoint health tetap tidak membuka koneksi DB, sehingga sukses health tidak membuktikan
login siap.

## Migrasi database

1. Backup kedua database dari panel hosting.
2. Pilih **cwwrxvka_mahaelangmobile** di phpMyAdmin.
3. Import hanya `backend/migrations/20261118_mobile_login.sql`.
4. Jangan import ulang dump website dan jangan menjalankan migrasi ini pada database
   website.

Tabel baru: `mobile_auth_session`, `mobile_auth_login_log`, `mobile_auth_rate`. Tidak
ada FK lintas database yang memaksa penghapusan riwayat saat akun sumber dihapus.

## Konfigurasi dua koneksi

Edit file privat `backend/config/config.local.php` berdasarkan `config.example.php`
terbaru:

- `database`: nama `cwwrxvka_mahaelangmobile`, user dengan SELECT/INSERT/UPDATE pada
  tiga tabel auth. CREATE hanya diperlukan saat import migrasi oleh admin database.
- `identity_database`: nama `cwwrxvka_mahaelangdb2`, user cukup SELECT pada `table_user`
  dan `table_outlet`.
- `auth.pepper`: string acak minimal 64 karakter, simpan tetap. Menggantinya memutus
  konsistensi identitas perangkat dan bucket rate; token sesi hash terpisah tidak
  memakai pepper.
- `auth.allowed_origins`: origin web yang diizinkan secara tepat, misalnya
  `https://mahaelang.site` dan subdomain frontend yang Anda pakai. Jangan wildcard atau
  merefleksikan semua Origin.

Generate pepper di terminal hosting PHP:
`php -r "echo bin2hex(random_bytes(32)), PHP_EOL;"`. Jangan kirim hasilnya ke chat.

Host database `localhost` pada config berarti PHP hosting menghubungi MySQL hosting;
**bukan** aplikasi memanggil localhost. Jika provider memberi host lain, gunakan host
tersebut.

## Menjalankan Flutter dari komputer menuju API online

Di masing-masing proyek: `flutter pub get`, lalu `flutter run -d ID_HP` atau
`flutter run -d chrome --web-port=5178`.

Untuk Chrome lokal, tambahkan `http://localhost:5178` pada allowed_origins hanya selama
pengujian. Cookie API lintas site localhost dapat diblokir browser. Pengujian web paling
andal melalui frontend HTTPS pada subdomain Mahaelang, misalnya
`absensi.mahaelang.site`, yang ditambahkan ke allowlist. Subdomain frontend tersebut
masih harus dibuat sendiri; tidak otomatis dideploy oleh kode ini.

Alamat default API adalah endpoint online yang sebelumnya aktif. Jika memang API
dipindahkan ke path domain utama, build/run memakai
`--dart-define=API_BASE_URL=https://mahaelang.site/PATH_API_YANG_BENAR`. Jangan memakai
path yang belum dirouting. Flutter membatasi URL ke HTTPS pada
mahaelang.site/subdomainnya.

Jangan memakai cookie `Domain=.mahaelang.site`; cookie sesi tetap host-only pada host
API. Pada Apache/proxy, pastikan header Authorization diteruskan; contoh .htaccess sudah
ditambahkan.

Plugin native baru mungkin memerlukan Windows Developer Mode untuk symlink. Jika pub get
meminta itu, aktifkan Settings → For developers → Developer Mode lalu jalankan lagi.
Tidak memerlukan Visual Studio untuk build Android/web. Untuk iOS masih diperlukan setup
signing dan akses Keychain yang diuji pada perangkat; belum diuji dalam perubahan ini.

## Cara melihat log di phpMyAdmin

```sql
SELECT id, user_id, username_snapshot, channel, event,
       platform, device_model, os_version, ip_address, occurred_at
FROM mobile_auth_login_log
ORDER BY id DESC
LIMIT 100;
```

Waktu disimpan UTC, tampilkan WITA dengan konversi +08:00 pada laporan. Log tidak memuat
password/token mentah. user_agent dan IP berasal dari request server; REMOTE_ADDR tidak
mempercayai X-Forwarded-For tanpa konfigurasi trusted proxy. Lokasi belum diminta saat
login dan belum disimpan. Model browser tidak dijanjikan dapat mengetahui model iPhone
tepat.

Event: login_success, login_failed, access_denied, rate_limited, logout. Jumlah login
baru tidak sama dengan membuka ulang aplikasi. Endpoint daftar log/admin panel belum
dibuat; lihat tabel melalui akun admin database. Tidak ada endpoint publik yang
membocorkan riwayat login.

## Status deployment dan batasan

Kode/migrasi siap diunggah untuk pengujian online, tetapi belum diunggah atau dijalankan
pada hosting oleh agent. Tidak ada kredensial nyata yang digunakan atau database
produksi yang diubah. Setelah konfigurasi dan migrasi hosting selesai, login akan
memakai akun website yang sebenarnya.

Sediakan kebijakan retensi/pembersihan sesi kedaluwarsa, bucket lama, dan audit sebelum
operasional penuh. Jangan hapus log otomatis tanpa kebijakan. Rate limit awal: 15
percobaan per akun per 15 menit dan 100 per IP; ini termasuk login berhasil, sehingga
pertimbangkan banyak karyawan satu Wi-Fi. Akun tidak memiliki kolom status aktif pada
dump yang diperiksa; hanya penghapusan akun/perubahan role outlet dicek pada /me.
Integrasi pencabutan saat password berubah, endpoint bisnis, dan otorisasi scope absensi
menyusul sebelum absensi resmi.
